xref: /netbsd-src/distrib/notes/amiga/install (revision 4e276bb0ec2ffb870726ac647ce5266b87141201)
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>>>	transfer installation file system to the swap partition.
15>>>	Does this go here, or in the hard disk prep section?
16
17>>>	Getting loadbsd, ixemul.library, and netbsd onto AmigaDOS
18>>>	partition.
19	Next you need to get yourself into NetBSD by loading the
20	kernel from AmigaDOS with loadbsd 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.  Note which
26	hard disk device(s) are configured (sd0, sd1, etc).  Then
27	you will be prompted for a root device.  At this time type
28	'sd0*'.
29>>>	Need to document what device number to actually use.
30
31	The system should continue to boot.  For now ignore WARNING:
32	messages about bad dates in clocks and swap space.  Eventually
33>>>	                                       ^^^^^^^^^^???
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 base11
114
115		and to extract the games distribution:
116
117			Extract game11
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 base11
161
162		and to extract the games distribution:
163
164			Extract game11
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 game11.??
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>>> Document using ppp or slip?
196		Configure the appropriate ethernet interface i.e. le0
197		if you have a 2065 or ed0 if you have a AMIGNET from
198		Hydra Systems.
199
200			ifconfig <ifname> <ipaddr> [netmask <netmask>]
201
202		where <ifname> is the interface name (e.g. ed0, etc.),
203		and <ipaddr> is the numeric IP address of the interface.
204		If the interface has a special netmask, supply
205		the word "netmask" and that netmask at the end of the
206		command line.  For instance, without a special netmask:
207
208			ifconfig ed0 129.133.10.10
209
210		or with a special netmask
211
212			ifconfig ed0 128.32.240.167 netmask 0xffffff00
213
214		If the NFS server or FTP server is not on a directly-
215		connected network, you should set up a route to it
216		with the command:
217
218			route add default <gate_ipaddr>
219
220		where <gate_ipaddr> is your gateway's numeric IP address.
221
222		If you are NFS-mounting the distribution sets,
223		mount them on the temporary directory with the command:
224
225			mount -t nfs <serv_ipaddr>:<dist_dir> <tmp_dir>
226
227		where <serv_ipaddr> is the server's numeric IP address,
228		<dist_dir> is the path to the distribution files on
229		the server, and <tmp_dir> is the name of the local
230		temporary directory.
231
232		Once this is done, proceed as if you had loaded the
233		files from tape, "cd"ing to the appropriate directories
234		and running "Set_tmp_dir" and "Extract" as appropriate.
235
236		If you are retrieving the distribution sets using ftp,
237		cd into the temp directory, and execute the command:
238
239			ftp <serv_ipaddr>
240
241		where <serv_ipaddr> is once again the server's
242		numeric IP address.  Get the files with FTP,
243		taking care to use binary mode to transfer
244		all files.
245
246		Once you have all of the files for the distribution sets
247		you wish to install, you can proceed using the instructions
248		above as if you had installed the files from a tape.
249
250
251Configuring Your System:
252----------- ---- ------
253
254Once you have finished extracting all of the distribution sets that
255you want on your hard drive and are back at the "#" prompt,
256you are ready to configure your system.
257
258The configuration utility expects that you have installed the base
259system.  If you have not, you will not be able to run it successfully
260(nor will you have a functional system regardless of configuration).
261
262To configure the newly installed operating system, run the
263command "Configure".
264
265Configure will ask for the machine's hostname, domain name, and other
266network configuration information.
267
268Once you have supplied `Configure' all that it requests, your machine
269will be configured well enough that when you reboot it it will
270almost be a completely functional NetBSD system.  Note you should
271ignore the errors from `chown' they will be corrected shortly.
272
273Once you are done with `Configure', halt the system with the "halt"
274command (wait for "halted" to be displayed) and reboot.  Then again
275boot NetBSD this time with the command:
276
277
278	loadbsd netbsd
279
280You need to do your final tweeks now.  First mount your file systems
281like so:
282
283	mount -av
284
285Next you need to re-make your devices to get the ownership correct:
286
287	cd /dev
288	MAKEDEV all
289>>> Is this step still needed? - check on it!
290
291Your system is now complete but not completely configured; you
292should adjust the /etc/sendmail.cf file as necessary to suit your
293site and/or disable sendmail and other network related programs.
294These things can be found in /etc/netstart.  Use vi, if you installed
295the man pages you can type `man vi' or `man ed' for instructions
296on how to use these somewhat non-intuitive editors.
297
298Once you are done with the rest of configuration unmount your file
299systems and halt your system, then reboot:
300
301	cd /
302	umount -av
303	halt
304	<reboot>
305
306Finally you can now boot your system and it will be completely
307functional:
308
309	loadbsd -a netbsd
310
311When it boots off of the hard drive, you will have a complete
312NetBSD system!  CONGRATULATIONS! (You really deserve them!!!)
313
314>>> Missing the step to transfer the netbsd kernel to /
315