Home | History | Annotate | Line # | Download | only in amiga
install revision 1.6.4.1
      1 Installing NetBSD is a relatively complex process, but, if you have
      2 this document in hand and are careful to read and remember the
      3 information which is presented to you by the install program, it
      4 shouldn't be too much trouble.
      5 
      6 Before you begin, you must have already prepared your hard disk as
      7 detailed in the section on preparing your system for install.
      8 
      9 The following is a walk-through of the steps necessary to get NetBSD
     10 installed on your hard disk.  If you wish to stop the installation,
     11 you may hit Control-C at any prompt, but if you do, you'll have to
     12 begin again from scratch.
     13 
     14 	Transfer the install miniroot filesystem onto the hard disk
     15 	partition used by NetBSD for swapping, as described in the
     16 	"Preparing your System for NetBSD Installation" section above.
     17 
     18 	You then need to have "ixemul.library" in your LIBS: directory
     19 	on AmigaDOS.  You also need to have the "loadbsd" program
     20 	in your command path.  If AmigaDOS complains about loadbsd
     21 	not being an executable file, be sure that the "Execute"
     22 	protection bit is set.  If not, set it with the command:
     23 		Protect loadbsd add e
     24 
     25 	Next you need to get yourself into NetBSD by loading the
     26 	kernel from AmigaDOS with loadbsd like so:
     27 
     28 		loadbsd -b netbsd
     29 
     30 	If you have an AGA machine, and your monitor will handle
     31 	the dblNTSC mode, you may also include the "-A" option to
     32 	enable the dblNTSC display mode.
     33 
     34 	If your machine has a fragmented physical memory space, as, 
     35 	e.g., DraCo machines, you should add the "-n2" option to 
     36 	enable the use of all memory segments.
     37 
     38 	You should see the screen clear and some information about
     39 	your system as the kernel configures the hardware.  Note which
     40 	hard disk device(s) are configured (sd0, sd1, etc).  Then
     41 	you will be prompted for a root device.  At this time type
     42 	'sd0*', where '0' is the device which contains the swap
     43 	partition you created during the hard disk preparation.
     44 
     45 	If the system should hang after entering the root device, try
     46 	again with
     47 
     48 		loadbsd -I ff -b netbsd
     49 
     50 	This disables synchronous transfer on all SCSI devices.
     51 
     52 	The system should continue to boot.  For now ignore WARNING:
     53 	messages about bad dates in clocks.  Eventually you will be
     54 	asked to enter the pathname of the shell, just hit return.
     55 	After a short while you should see a welcome message and a
     56 	prompt, asking if you wish to proceed with the installation.
     57 
     58 	If you wish to proceed, enter "y" and then return.
     59 
     60 	If you have configured your hard drive[s] correctly it
     61 	should find the drive and partition that you selected to
     62 	use as your root.  You will be prompted for which device
     63 	you want to use for your root.  If you have multiple disks
     64 	present with root partitions defined, you will need to be
     65 	sure you enter the device name of the correct partition you
     66 	want to install NetBSD on.
     67 
     68 	YOU ARE NOW AT THE POINT OF NO RETURN.  If you confirm that
     69 	you want to install NetBSD, your hard drive will be modified,
     70 	and perhaps its contents scrambled at the whim of the install
     71 	program.
     72 
     73 	If you are sure you want to proceed, enter "yes" at the
     74 	prompt.
     75 
     76 	The install program will now make the root filesystem you
     77 	specified.  There should be only one error in this section
     78 	of the installation.  It will look like so:
     79 
     80 		newfs: ioctl (WDINFO): Invalid argument
     81 		newfs: /dev/rsd0a: can't rewrite disk label
     82 
     83 	If there are any others, restart from the the beginning of
     84 	the installation process.  This error is ok as the Amiga
     85 	does not write disklabels currently.  You should expect
     86 	this error whenever using newfs.
     87 
     88 	Next the install program will ask you which drive and
     89 	partition you wish to use as /usr.  First it will list the
     90 	available drives.  Choose one.  Next it will give you a
     91 	list of the partitions on that disk along with their sizes,
     92 	types, etc..  Choose the letter that corresponds to the
     93 	partition you wish to use for /usr.  If you are doing a
     94 	full install this should be at the very least 45M-50M large.
     95 	If everything is ok the install program will then format
     96 	and mount your /usr.  If not then it will ask again for a
     97 	drive and partition.
     98 
     99 	When this completes your root partition will be mounted on
    100 	/mnt and your /usr partition on /mnt/usr.  An fstab will
    101 	have been created and initialized to correctly mount these
    102 	two file systems.  This fstab will be in /mnt/etc.
    103 
    104 	What you do from this point on depends on which media you're
    105 	using to install NetBSD.  Follow the appropriate instructions,
    106 	given below.
    107 
    108 	To install from an AmigaDOS partition:
    109 
    110 		You first need to mount the AmigaDOS partition
    111 		using the mount_ados command.  If e.g. your AmigaDOS
    112 		partition is the first partition on sd0 you could
    113 		type:
    114 			
    115 			mkdir /mnt/ados
    116 			mount_ados -o ro /dev/sd0d /mnt/ados
    117 
    118 		You can use `disklabel sd0' to find out what types
    119 		of partitions are on the disk `sd0'.
    120 
    121 		Next goto the directory in which you stored the
    122 		distribution sets.  If e.g. you stored them in the
    123 		root directory of the partition:
    124 
    125 			cd /mnt/ados
    126 
    127 		When there, run "Set_tmp_dir" and choose the default
    128 		temporary directory, by hitting return at the
    129 		prompt.
    130 
    131 		Run the "Extract" command, giving it as its sole
    132 		argument the name of the distribution set you wish
    133 		to extract.  For example, to extract the base
    134 		distribution, use the command:
    135 
    136 			Extract base12
    137 
    138 		and to extract the games distribution:
    139 
    140 			Extract game12
    141 
    142 		If the distribution sets are in different directories,
    143 		you will need to cd to each directory in turn, runing
    144 		"Set_tmp_dir" and the appropriate "Extract" command(s).
    145 
    146 		Continue this process until you've finished installing
    147 		all of the sets which you desire to have on your
    148 		hard disk.  Once you have extracted all sets and
    149 		are at the "#" prompt again, proceed to the section
    150 		"Configuring Your System," below.
    151 
    152 	To install from tape:
    153 
    154 		The first thing you should do is pick a temporary
    155 		directory where the distribution files can be stored.
    156 		To do this, use the command "Set_tmp_dir" and enter
    157 		your choice.  The default is /mnt/usr/distrib.
    158 
    159 		After you have picked a temporary directory,
    160 		you should issue the load command:
    161 
    162 			Load_tape
    163 
    164 		Next, you will be told to insert the media into
    165 		the appropriate drive, and hit return.  Continue
    166 		to follow instructions until you are returned to
    167 		the "#" prompt.
    168 
    169 		Go to the directory which contains the first
    170 		distribution set you wish to install.  This is
    171 		either the directory you specified above, or possibly
    172 		a subdirectory of that directory.
    173 
    174 		When there, run "Set_tmp_dir" again, and choose
    175 		the default temporary directory, by hitting
    176 		return at the prompt.
    177 
    178 		Run the "Extract" command, giving it as its sole
    179 		argument the name of the distribution set you
    180 		wish to extract.  For example, to extract the base
    181 		distribution, use the command:
    182 
    183 			Extract base12
    184 
    185 		and to extract the games distribution:
    186 
    187 			Extract game12
    188 
    189 		After the extraction is complete, go to the location
    190 		of the next set you want to extract, "Set_tmp_dir"
    191 		again, and once again issue the appropriate
    192 		extract command.  Continue this process until
    193 		you've finished installing all of the sets which you
    194 		desire to have on your hard disk.
    195 
    196 		After each set is finished, if you know that you
    197 		are running low on space you can remove the
    198 		distribution files for that set by saying:
    199 
    200 			rm set_name.??
    201 
    202 		For example, if you wish to remove the distribution
    203 		files for the game09 set, after the "Extract game09"
    204 		command has completed, issue the command:
    205 
    206 			rm game12.??
    207 
    208 		Once you have extracted all sets and are at the "#" prompt
    209 		again, proceed to the section "Configuring Your System,"
    210 		below.
    211 
    212 	To install via FTP or NFS:
    213 
    214 		First, use Set_tmp_dir to pick a temporary directory
    215 		for the installation files.  /mnt/usr/distrib is
    216 		suggested.
    217 
    218 		Configure the appropriate ethernet interface i.e. le0
    219 		if you have a 2065 or ed0 if you have a AMIGNET from
    220 		Hydra Systems.
    221 		
    222 			ifconfig <ifname> <ipaddr> [netmask <netmask>]
    223 
    224 		where <ifname> is the interface name (e.g. ed0, etc.),
    225 		and <ipaddr> is the numeric IP address of the interface.
    226 		If the interface has a special netmask, supply
    227 		the word "netmask" and that netmask at the end of the
    228 		command line.  For instance, without a special netmask:
    229 
    230 			ifconfig ed0 129.133.10.10
    231 
    232 		or with a special netmask
    233 
    234 			ifconfig ed0 128.32.240.167 netmask 0xffffff00
    235 
    236 		You should also be able to use SLIP or PPP as the network
    237 		connection.
    238 		[XXX instructions for ppp or slip would be usefull
    239 		perhaps the next release]
    240 
    241 		If the NFS server or FTP server is not on a directly-
    242 		connected network, you should set up a route to it
    243 		with the command:
    244 
    245 			route add default <gate_ipaddr>
    246 
    247 		where <gate_ipaddr> is your gateway's numeric IP address.
    248 
    249 		If you are NFS-mounting the distribution sets,
    250 		mount them on the temporary directory with the command:
    251 
    252 			mount -t nfs <serv_ipaddr>:<dist_dir> <tmp_dir>
    253 
    254 		where <serv_ipaddr> is the server's numeric IP address,
    255 		<dist_dir> is the path to the distribution files on
    256 		the server, and <tmp_dir> is the name of the local
    257 		temporary directory.
    258 
    259 		Once this is done, proceed as if you had loaded the
    260 		files from tape, "cd"ing to the appropriate directories
    261 		and running "Set_tmp_dir" and "Extract" as appropriate.
    262 
    263 		If you are retrieving the distribution sets using ftp,
    264 		cd into the temp directory, and execute the command:
    265 
    266 			ftp <serv_ipaddr>
    267 
    268 		where <serv_ipaddr> is once again the server's
    269 		numeric IP address.  Get the files with FTP,
    270 		taking care to use binary mode to transfer
    271 		all files.
    272 
    273 		Once you have all of the files for the distribution sets
    274 		you wish to install, you can proceed using the instructions
    275 		above as if you had installed the files from a tape.
    276 
    277 
    278 Configuring Your System:
    279 ----------- ---- ------
    280 
    281 Once you have finished extracting all of the distribution sets that
    282 you want on your hard drive and are back at the "#" prompt,
    283 you are ready to configure your system.
    284 
    285 The configuration utility expects that you have installed the base
    286 system.  If you have not, you will not be able to run it successfully
    287 (nor will you have a functional system regardless of configuration).
    288 
    289 To configure the newly installed operating system, run the
    290 command "Configure".
    291 
    292 Configure will ask for the machine's hostname, domain name, and other
    293 network configuration information.
    294 
    295 Once you have supplied `Configure' all that it requests, your machine
    296 will be configured well enough that when you reboot it it will
    297 almost be a completely functional NetBSD system.
    298 
    299 >>> Copy the kernel from the miniroot filesystem at this point <<<
    300 
    301 Once you are done with `Configure', halt the system with the "halt"
    302 command (wait for "halted" to be displayed) and reboot.  Then again
    303 boot NetBSD this time with the command:
    304 
    305 
    306 	loadbsd netbsd
    307 
    308 You need to do your final tweeks now.  First mount your file systems
    309 like so:
    310 
    311 	mount -av
    312 
    313 Your system is now complete but not completely configured; you
    314 should adjust the /etc/sendmail.cf file as necessary to suit your
    315 site and/or disable sendmail and other network related programs.
    316 These things can be found in /etc/netstart.  Use vi, if you installed
    317 the man pages you can type `man vi' or `man ed' for instructions
    318 on how to use these somewhat non-intuitive editors.
    319 
    320 You should also put a copy of the netbsd kernel in your root partition.
    321 This can be done easily by mounting the AmigaDOS partition containing
    322 the kernel you used to start NetBSD and copying the "netbsd" file to
    323 the root:
    324 	mount -r -t ados /dev/sd0d /mnt
    325 	cp /mnt/netbsd /
    326 (where /dev/sd0d is the AmigaDOS partition where you have netbsd, and
    327 /mnt/netbsd is the appropriate path of the netbsd file).
    328 
    329 Once you are done with the rest of configuration unmount your file
    330 systems and halt your system, then reboot:
    331 
    332 	cd /
    333 	umount -av
    334 	halt
    335 	<reboot>
    336 
    337 Finally you can now boot your system and it will be completely
    338 functional:
    339 
    340 	loadbsd -a netbsd
    341 
    342 When it boots off of the hard drive, you will have a complete
    343 NetBSD system!  CONGRATULATIONS! (You really deserve them!!!)
    344