sys/man/8/booting

   1 .TH BOOTING 8
   2 .SH NAME
   3 booting \- bootstrapping procedures
   4 .SH SYNOPSIS
   5 none
   6 .SH DESCRIPTION
   7 This manual page collects the incantations required to bootstrap Plan 9 machines.
   8 Some of the information here is specific to the installation at Bell Labs;
   9 some is generic.
  10 .PP
  11 If a CPU server is up, BOOTP/DHCP and TFTP will run from there;
  12 if not, the necessary files and services must be available on a separate machine,
  13 such as a Unix system, to use these protocols for bootstrapping.
  14 .PP
  15 Be sure to read
  16 .IR boot (8)
  17 to understand what happens after the kernel is loaded.
  18 .SS Terminals
  19 To bootstrap a diskless terminal or a CPU server, a file server must be running.
  20 .SS PCs
  21 On a PC, the
  22 .IR 9boot (8)
  23 program is used to load the kernel
  24 .B /386/9pc
  25 into memory.
  26 .PP
  27 Once the kernel is booted, it behaves like the others.
  28 See
  29 .IR boot (8)
  30 for details.
  31 .SS CPU Servers
  32 The Plan 9 CPU servers are multi-user, so they do not request a user name
  33 when booting.
  34 .SS PC CPU Server
  35 Proceed as for the PC terminal, but have
  36 .B service=cpu
  37 set in
  38 .IR plan9.ini (8).
  39 .SS SGI Challenge multiprocessor CPU Server
  40 The Challenge ROM monitor can boot from the Ethernet.
  41 To boot from the Ethernet, type
  42 .IP
  43 .EX
  44 .B bootp()/mips/9ch
  45 .EE
  46 .PP
  47 or use the ROM command
  48 .B setenv
  49 to set the variable
  50 .B bootfile
  51 to that same string and type
  52 .BR boot .
  53 To load a different file, tell
  54 .B bootp
  55 which file to load,
  56 and to force the download to come from a particular system,
  57 .BR bootp()system:file .
  58 Any arguments after
  59 .B bootp()file
  60 are passed to
  61 .BR /boot .
  62 If you are running a Plan 9
  63 .SM BOOTP
  64 server (see
  65 .IR dhcpd (8)),
  66 the file name can be omitted and the
  67 file specified by the
  68 .B bootf
  69 parameter for the machine in
  70 .B /lib/ndb
  71 will be downloaded by default.
  72 .PP
  73 Once the kernel is loaded,
  74 it prompts for the Ethernet
  75 protocol to use to reach the root file server; request the default.
  76 .
  77 .SS ARM CPU Servers
  78 All ARM systems are started by
  79 .I U-boot
  80 using similar commands.
  81 The kernels
  82 (and thus
  83 .I ndb
  84 .L bootf
  85 parameters)
  86 are
  87 .L /arm/9gd
  88 for the Marvell PXA168-based Guruplug Display,
  89 .L /arm/9plug
  90 for all Marvell Kirkwood plugs (Sheevaplug, Guruplug, Openrd, etc.),
  91 and
  92 .L /arm/9beagle
  93 for TI OMAP3 boards (IGEPv2 from ISEE, Gumstix Overo).
  94 In the following,
  95 replace
  96 .I MAC
  97 with your board's MAC address without colons,
  98 in lower case
  99 (the format of the
 100 .L ether
 101 .I ndb
 102 attribute).
 103 .PP
 104 First, establish a
 105 .I /cfg/pxe
 106 (\c
 107 .IR plan9.ini )
 108 file for the new CPU server.
 109 For Kirkwood plugs,
 110 .IP
 111 .EX
 112 cd /cfg/pxe; cp example-kw \fIMAC
 113 .EE
 114 .PP
 115 and edit
 116 .L /cfg/pxe/\fIMAC
 117 to taste.
 118 For PXA plugs, replace
 119 .L kw
 120 with
 121 .LR pxa ;
 122 for OMAP boards, replace
 123 .L kw
 124 with
 125 .LR omap
 126 and
 127 be sure to edit the line for
 128 .L ether0
 129 to set
 130 .IP
 131 .EX
 132 ea=\fIMAC
 133 .EE
 134 .PP
 135 Second,
 136 configure
 137 .I U-boot
 138 to load the appropriate kernel and
 139 .I /cfg/pxe
 140 file at suitable addresses and start the kernel.
 141 For Sheevaplugs and Openrd boards,
 142 type this at U-boot once:
 143 .IP
 144 .EX
 145 setenv bootdelay 2
 146 # \fItype the next two lines as one\fP
 147 setenv bootcmd 'bootp; bootp; tftp 0x1000 /cfg/pxe/\fIMAC\fP; bootp;
 148         tftp 0x800000; go 0x800000'
 149 saveenv
 150 .EE
 151 .PP
 152 For Guruplugs Displays,
 153 do the same but type this after
 154 .L "setenv bootcmd"
 155 instead:
 156 .IP
 157 .EX
 158 \&'dhcp; tftpboot; tftpboot 0x1000 /cfg/pxe/\fIMAC\fP; bootz 0x500000'
 159 .EE
 160 .PP
 161 For Kirkwood Guruplugs,
 162 type this after
 163 .LR "setenv bootcmd" :
 164 .IP
 165 .EX
 166 \&'dhcp 0x800000; tftp 0x1000 /cfg/pxe/\fIMAC\fP; go 0x800000'
 167 .EE
 168 .PP
 169 For IGEPv2 boards,
 170 type this after
 171 .LR "setenv bootcmd" :
 172 .IP
 173 .EX
 174 \&'tftp 0x80300000 /cfg/pxe/\fIMAC\fP; dhcp 0x80310000; go 0x80310000'
 175 .EE
 176 .PP
 177 For Gumstix Overo boards,
 178 type this after
 179 .LR "setenv bootcmd" :
 180 .IP
 181 .EX
 182 \&'bootp 0x80310000; bootp 0x80300000 /cfg/pxe/\fIMAC\fP; go 0x80310000'
 183 .EE
 184 .PP
 185 Thereafter, the boards will automatically boot via BOOTP and TFTP
 186 when reset.
 187 .
 188 .SH "SEE ALSO"
 189 .IR ndb (6),
 190 .IR 9boot (8),
 191 .IR boot (8),
 192 .IR init (8),
 193 .IR plan9.ini (8)
 194 .SH SOURCE
 195 Sources for the various boot programs are under
 196 .BR /sys/src/boot .