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