install revision 1.2
1	$NetBSD: install,v 1.2 1998/01/09 18:47:54 perry Exp $	
2
3Installing NetBSD/vax may be a little bit complex, but it shouldn't be too
4hard if you have this document available.
5
6Device conventions.
7NetBSD standalone system addresses devices like
8'devicename(adapter, controller, unit, partition)'
9Known devicenames are:
10        mt  -  MSCP tape. (TK50, TU81, ...)
11        ts  -  TSV05/TS11 tape.
12        ra  -  RA??/RD?? disks/floppies.
13        hp  -  RP??/RM?? disks.
14        rd  -  RD?? disks on MicroVAX 2000.
15        sd  -  SCSI disks.
16        st  -  SCSI tapes.
17        le  -  LANCE ethernet controller.
18
19You can omit parameters; ra(0,0) refers to disk 0 partition a
20on default controller. On tapes partition refers to file #
21on the tape.
22
23Example: DUB1 (DEC syntax) swap partition will be referred as
24        ra(1,0,1), DRA2 root partition is hp(2,0).
25
26
27The installation principle is to label the root disk, copy a miniroot
28filesystem onto the swap partition, boot up from that miniroot filesystem,
29then create root and the other wanted partitions and put system to it.
30You will have to deal with 2 different "units", one is just a boot
31filesystem containing 3 files: boot, copy and edlabel, the other is an
32image of a miniroot filesystem and can be split into several pieces
33depending of what you are going to install from.
34
35
36Installation from tape: (MicroVAX II/III)
37Take your newly created boot tape and just boot from it:
38
39        >>> B/3 MUA0
40
41This means that you will bring upp boot to aks for boot file from TK50.
42(MUA0 is DEC naming). It will come up something like
43
44          2..1..0..
45
46
47        howto 0x3, bdev 0x12, booting...done. (31248+22252)
48
49	>> NetBSD/vax boot [970610 23:44] <<
50        : 
51
52
53At the prompt you type edlabel to label the disk, see below about
54how to use edlabel.
55When labeling is finished, halt the computer, bring up the boot program
56again and this time load copy, see below about how to use copy.
57Remember that you must copy from the second file (1) on the tape.
58
59Now go to step 3.
60
61
62Installation from RX33/RX50. (MicroVAX II/III)
63The difference between RX33 and RX50 is its size. RX50 is 400k and
64RX33 is 1200k.
65
66To boot from floppy type:
67
68        >>> B/3 DUxy
69
70where x is the controller number and y is device number.
71You will now get up a prompt like
72
73        >> NetBSD/vax boot [970610 23:44] <<
74        :
75
76At the prompt you type edlabel to label the disk, see below about
77how to use it.
78When labeling is finished, halt the computer, bring up the boot program
79again and this time load copy, see below about how to use it.
80Remember that you are will copy from partition 0 when using floppies.
81
82Now go to step 3.
83
84
85Installing over network:
86
87
88You can use the same flags when booting over the net as when
89booting from local disks; like: ">>>B/3 ESA0" will load boot
90in ask state. From here you can load any file you want, even
91copy and edlabel if they are located in the exported root fs.
92
93Note 1: Netbooting of MicroVAX II/III systems with DEQNA/DELUA
94    ethernet does not work does not work yet because lack of standalone
95    drivers. Mounting of root and swap over NFS works goos though.
96Note 2: Mopd won't work on VAXen with de/qe ethernet, due to the
97    lack of bpf support for those interfaces.
98
99Booting up miniroot.
100When copying is ready, bring the boot program up a third
101time, and this time bring up a real system by telling
102boot where you put your miniroot _and_ also the generic
103kernel name. Example: ra(0,1)gennetbsd,  boots gennetbsd
104from swap partition on ra0.
105
106When kernel is loaded, you will after a while get a
107question about Root device?. Respond to this with
108xx?*, where xx is the device name, ? is the unit
109number and * tells that the system shall use the swap
110partition as root partition. Example:
111
112        Root device? ra0*
113
114After that a second question:
115
116        Enter pathname of shell or RETURN for sh:
117
118Just type return. Now you will be in a normal single-user
119shell, and it's just to newfs your partitions, and start installation.
120
121A few things that you must remember to do from miniroot:
122disklabel -B <diskname>  to install boot blocks.
123MAKEDEV devices in the newly created root filesystem.
124Copy gennetbsd and boot from miniroot filesystem
125to the newly created root filesystem.
126
127How to use edlabel:
128Edlabel is a program to edit disklabels on any disks in a standalone
129environment. Mostly it is used to set labels when doing initial
130installation procedure. It is started from boot program prompt.
131You will here be guided through a session, things with ^^^^ under
132is typed in by the user, comments are within /* */.
133
134	>> NetBSD/vax boot [970610 23:44] <<
135	: edlabel
136	  ^^^^^^^
137With this program you can modify everything in the on-disk
138disklabel. To do something useful you must know the exact
139geometry of your disk, and have ideas about how you want
140your partitions to be placed on disk. Some hints:
141The a partition should be at least ~20000 blocks, the
142b (swap) is depending on your use of the machine but it
143should almost never be less than ~32000 blocks.
144
145Disk geometry for most DEC disks can be found in the disktab
146file, and applicable disk names can be found above.
147
148Remember that disk names is given as disk(adapt, ctrl, disk, part)
149when using the installation tools.
150
151Label which disk? ra(1,0,0)     /* See INSTALL text for device types */
152                  ^^^^^^^^^
153getdisklabel: no disk label
154ra(1,0,0): no disk label
155(E)dit, (S)how, (D)efaults, (W)rite, (Q)uit) : e
156                                               ^
157First set disk type. Valid types are:
1580  unknown
1591  SMD
1602  MSCP
1613  old DEC
1624  SCSI
1635  ESDI
1646  ST506
1657  HP-IB
1668  HP-FL
1679  type 9
16810  floppy
16911  ccd
17012  vnd
171
172Numeric disk type? [0] 2    /* All disks supported this far is MSCP */
173Disk name? [] rd54     ^    /* You must know what type your disk is */
174badsect? [n]  ^^^^          /* No badsectoring yet */
175ecc? [n]                    /* ECC is automatic, don't care */
176removable? [n]              /* Removable or not, like RA60 */
177Interleave? [0] 1           /* All MSCP disks is seen like 1 interleave */
178rpm? [0] 3600   ^           /* 3600 rpm is normal */
179trackskew? [0]              /* don't care */
180cylinderskew? [0]           /* don't care */
181headswitch? [0]             /* don't care */
182track-to-track? [0]         /* don't care */
183drivedata 0? [0]            /* don't care */
184drivedata 1? [0]            /* don't care */
185drivedata 2? [0]            /* don't care */
186drivedata 3? [0]            /* don't care */
187drivedata 4? [0]            /* don't care */
188
189bytes/sector? [0] 512       /* Probably only sive on VAX systems */
190                  ^^^
191sectors/track? [0] 17       /* You must know this, check disktab file */
192                   ^^
193tracks/cylinder? [0] 15     /* You must know this, check disktab file */
194                     ^^
195sectors/cylinder? [0] 255   /* sectors/track * tracks/cylinder */
196                      ^^^
197cylinders? [0] 1221         /* You must know this, check disktab file */
198               ^^^^
199a partition: offset? [0]        /* Partition sizes are set by you. */
200             size? [0] 20000    /* Take default sizes from disktab or */
201b partition: offset? [0] 20000  /* calculate your own partition sizes */
202             size? [0] 20000
203c partition: offset? [0] 
204             size? [0] 311200
205d partition: offset? [0] 
206             size? [0] 
207e partition: offset? [0] 40000
208             size? [0] 271200
209f partition: offset? [0] 
210             size? [0] 
211g partition: offset? [0] 
212             size? [0] 
213h partition: offset? [0] 
214             size? [0] 
215
216(E)dit, (S)how, (D)efaults, (W)rite, (Q)uit) : s /* Show what you've typed */
217                                               ^
218
219disk type 2 (MSCP),  rd54: 
220interleave 1, rpm 3600, trackskew 0, cylinderskew 0
221headswitch 0, track-to-track 0, drivedata: 0 0 0 0 0
222
223bytes/sector: 512
224sectors/track: 17
225tracks/cylinder: 15
226sectors/cylinder: 255
227cylinders: 1221
228
2298 partitions:
230     size   offset
231a:   20000,    0
232b:   20000,    20000
233c:   311200,    0
234d:   0,    0
235e:   271200,    40000
236f:   0,    0
237g:   0,    0
238h:   0,    0
239
240(E)dit, (S)how, (D)efaults, (W)rite, (Q)uit) : w /* Write label to disk */
241
242This program does not (yet) write bootblocks, only disklabel.
243Remember to write the bootblocks from the miniroot later with the
244command "disklabel -B <diskname>".
245(E)dit, (S)how, (D)efaults, (W)rite, (Q)uit) : q
246
247
248How to use copy:
249
250Copy is a standalone program that can copy multiple volumes
251from disk/tape to disk/tape. Mostly it is used to copy the 
252miniroot filesystem onto the swap partition during initial
253installation.
254You will here be guided through a session, things with ^^^^ under
255is typed in by the user, comments are within /* */.
256This is an installation from TK50.
257
258
259	>> NetBSD/vax boot [970610 23:44] <<
260	: copy
261	  ^^^^
262
263copy: 
264This program will read miniroot from tape/floppy/disk 
265and install this miniroot onto disk.
266
267Specify the device to read from as xx(N,0), where
268xx is the device-name and N is the unit-number, e.g.
269"mt(0,1)" for the first TMSCP-tape (TK50),
270"ra(2,0)" for the third MSCP-disk/floppy (RX33/RX50)
271
272device to read from ? mt(0,1) /* Tape 0, file 1 */
273                      ^^^^^^^^
274Specify number of blocks to transfer. Usually this is
275sizeof(miniroot) / 512.
276It's safe to transfer more blocks than just the miniroot.
277
278number of blocks ? 4096  /* Miniroot size is 4096 block */
279                   ^^^^
280If your miniroot is split into volumes, then you must
281specify the number of blocks per volume.
282(e.g. 800 blocks per RX50, 2400 blocks per RX33)
283
284number of blocks per volume ? [4096] 
285
286Make sure unit tms(0,1) is online and holds the proper volume.
287Then type 'g' to Go or 'a' to Abort.
288
289OK to go on ? [g/a] g   /* g == go, a == abort */
290                    ^
291Reading ... Reading of miniroot done. (4096 blocks read)
292
293
294Now specify the device to write miniroot to as xx(N,1)
295where xx is the drive type and N is the drive number.
296For example: ra(0,1) refers to MSCP drive #0, b partition
297
298Root disk ? : ra(0,1) /* Actually DUA0, partition b (swap) */
299              ^^^^^^^^^
300Initializing partition ... done.
301(4096 blocks written.)
302
303Halt the machine and reboot from distribution media,
304giving second partition as part to mount as root. Ex:
305: ra(0,1) for ra disk 0, hp(2,1) for massbuss disk 2
306
307Halt/Reboot the machine NOW.
308?02 EXT HLT
309    PC = 001005F3
310>>> 
311
312
313