install revision 1.6
1	$NetBSD: install,v 1.6 1998/01/14 06:50:27 scottr Exp $	
2
3Installing NetBSD is a relatively complex process, but, if you have
4this document in hand and are careful to read and remember the
5information which is presented to you by the install program, it
6shouldn't be too much trouble.
7
8Before you begin, you must have already prepared your hard disk as
9detailed in the section on preparing your system for install.
10
11The following is a walk-through of the steps necessary to get NetBSD
12installed on your hard disk.  If you wish to stop the installation,
13you may hit Control-C at any prompt, but if you do, you'll have to
14begin again from scratch.
15
16    1. Booting the miniroot
17    =======================
18	First you need to get yourself into NetBSD.  This can be
19	done in a couple ways, both of which currently require
20	GEMDOS. You need either the bootfloppy provided in the
21	distribution or you can copy the loadbsd.ttp program and
22	kernel to a boot floppy disk (1.4M needed) or put them on a TOS
23	partition.  Select the loadbsd program and it will
24	ask for parameters, supply: '-b netbsd' (or whatever name
25	you copied the kernel to).  You can, of course, also run it
26	from the shell command-line in MiNT:
27
28		loadbsd -b a:/netbsd
29
30	You should see the screen clear and some information about
31	your system as the kernel configures the hardware.  Then
32	you will be prompted for a root device.  At this time remove
33	the GEMDOS kernel boot floppy from the drive if present and
34	insert the BSD install floppy 1.  Now type `md0a' to tell the
35	kernel to load the install filesystem into RAMdisk. While
36	While the kernel is loading, it will show a '.' for each
37	track loaded. After loading 80 tracks, it will ask you
38	to insert the next floppy. At this time, inser the BSD
39	install floppy 2 and hit any key. The kernel continous
40	loading another 40 tracks before it continues to boot.
41
42	Note: If you are using 1.44Mb floppies, you should select 'md1a'
43	      instead of 'md0a'.
44
45	The system should continue to boot.  For now ignore WARNING:
46	messages about bad dates in clocks. Eventually you will be
47	be asked to enter the pathname of the shell, just hit
48	return.  After a short while, you will be asked to select
49	the type of your keyboard. After you have entered a valid
50	response here, the system asks you if you want to install
51	or upgrade your system. Since you are reading the 'install'
52	section, 'i' would be the proper response here...
53
54    2. Entering the installer
55    =========================
56	The installer starts with a nice welcome messages. Read this
57	message carefully, it also informs you of the risks involved
58	in continuing! If you still want to go on, type 'y'. The
59	installer now continues by trying to figure out your disk
60	configuration.  When it is done, you will be prompted to select
61	a root device from the list of disks it has found.
62
63    3. Select your root device
64    ==========================
65	You should know at this point that the disks are NOT numbered
66	according to their scsi-id! The NetBSD kernel numbers the scsi
67	drives (and other devices on the scsi bus) sequentially as it
68	finds them. The drive with the lowest scsi id will be called sd0,
69	the next one sd1, etc.
70	Where you end up after the selection of the root disk depends on
71	the contents of your disk. If it is already partitioned using
72	AHDI, start reading at item 4a, if this disk has no AHDI partitioning
73	but is blank or used by another non-AHDI system, start at item 4b.
74
75	YOU ARE NOW AT THE POINT OF NO RETURN! The programs in section
76	4 will modify your harddisk. Type Control-C NOW if you don't
77	want this.
78
79    4a. Setting AHDI partition id's on your root disk (using edahdi)
80    ================================================================
81	Because NetBSD imposes a special ordering in disk partitions it
82	uses for root & swap. And because it wants to guard you against
83	an unwanted demolition of partitions used by other systems, you
84	have to tell it what partitions it is allowed to use. You have
85	to mark the partition you want to use as swap 'NBS' or 'SWP'
86	and the other partitions as 'NBD'. Note that all the changes
87	you make to the id's are reversable as long as you remember the
88	original value.
89	In the partition-id editor, the partitions are shown in the order
90	that AHDI created them. When you leave this editor and continue
91	at item 4b, your changes to the id's do have consequences to the
92	partition order! They will show up as follows:
93		a          -- the first NBD partition
94                b          -- the first NBS partition
95                d (and up) -- the rest of the partitions in AHDI order
96
97    4b. Labeling your root disk (using edlabel)
98    ===========================================
99	You are now allowed to change the partitioning of your disk. If
100	your disk is already partitioned with AHDI DON'T change anything
101	unless you are absolutely sure what you are doing!
102	If you are labeling an empty SCSI disk, you can make life easy for
103	yourself by selecting 'standarize geometry'. This allows you to
104	select a 'sectors per track' and 'tracks/cylinder' value and have
105	the (fictious) SCSI geometry changed accordingly. So if you select
106	64 sect/track and 32 tracks/cylinder, each cilinder is exactly
107	1Mb in size. Well, go ahead and don't forget to save your work
108	before quitting!
109	NOTE: to make sure that NetBSD can create/mount filesystems on
110	      the partitions you defined, make sure the 'type' is entered
111	      correctly:
112                4.2BSD - filesystems created by NetBSD
113                MSDOS  - filesystems shared with GEM
114	
115	Just ignore it, it's harmless.
116
117    5. Label additional disks
118    =========================
119	Now that your root-disk is labeled, you are given the opportunity
120	to label any of the other disks in your system. The procedure is
121	the same as with your root disk.
122
123    6. Setup the fstab
124    ==================
125	Since all disks you want to use with NetBSD are properly labeled,
126	it is time to tell the installer which partition will be associated
127	with the different filesystems. As mentioned above, it is wise to
128	make at least a separate root and /usr filesystem. Depending on
129	what you are planning to do with your system, you might also consider
130	to make a separate /var, /local or /home.
131	When you tell the installer that all of your filesystems are specified
132	correctly, it starts creating them for you.
133
134    7. Configure your network
135    =========================
136	Don't do this right now. As non of the network cards are supported,
137	it doesn't make any sense.
138
139    8. Edit the fstab - again....
140    =============================
141	Since the network configuration might have lead to additional (nfs)
142	filesystem entries, you get another chance to modify your fstab.
143
144    9. Installing the distribution sets
145    ===================================
146	You are finally at the point where some real data will be put on
147	your freshly-made filesystems. Select the device type you whish
148	to install from and off you go....
149	Some notes:
150	    - If you want to install from tape, please read the section
151	      about how to create such a tape.
152	      The tape device name will be "nrst0" for the first tape
153	      drive, "nrst1" for the second, etc.
154	    - Install at least the base and etc sets.
155	    - If you have to specify a path relative to the mount-point and
156	      you need the mount-point itself, enter '.'.
157	    - For previous NetBSD users:  If you want to install from a
158	      GEMDOS filesystem, you don't need to rename the distribution
159	      sets as you may have done in previous versions of NetBSD.
160
161    10. Timezone selection and device-node building
162    ===============================================
163	The isn't much to say about this. Just select the timezone you
164	are in. The installer will make the correct setup on your root
165	filesystem. After the timezone-link is installed, the installer
166	will proceed by creating the device nodes on your root filesystem.
167	Be patient, this will take a while...
168
169    11. Installing the kernel
170    =========================
171	Because the kernel didn't fit on the install-disks, the installer
172	asks you about the disk your kernel is on. You can specify the
173	floppy with disk 'fd0' and partition 'b' for  720K disks and
174	partition 'c' for 1.4M disks, or one of the hard disk partitions.
175
176    12. Installing the bootstrap
177    ============================
178	Finally, the installer ask you if you want to install the bootblock
179	code on your root disk. This is a matter of personal choise and can
180	also be done from a running NetBSD system. See the 'installboot(8)'
181	manual page about how to do this.
182
183    13. You did it!
184    ===============
185	Congratulations, you just installed NetBSD successfully! If you
186	also installed a bootblock, you only have to reboot your atari to
187	enter your freshly build system. If you didn't, get back to section
188	1 (How to boot the miniroot). Just substitute 'md0a' by your NetBSD
189	root disk.
190
191
192Some extra remarks:
193===================
194
195If you don't want to use the bootloader. You could use the following
196setup:
197	Reserve a small GEMDOS partition of about 4Mb. This is
198	enough to put in a few kernels. Put the netbsd kernel
199	into this partition. Also, edit your /etc/fstab to always
200	mount this partition, say as /kernels. Now make a symlink
201	from /netbsd to /kernels/netbsd.
202	This sceme is particulary handy when you want to make your
203	own kernel. When compilation is finished, you just copy
204	your kernel to /kernels/netbsd and reboot. It's wise to
205	make sure there is _always_ a 'known to work' kernel image
206	present.
207