NetBSD/distrib/notes/vax/install

378 lines
12 KiB
Plaintext

.\" $NetBSD: install,v 1.4 1999/01/13 07:30:09 ross Exp $
.\"
.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by the NetBSD
.\" Foundation, Inc. and its contributors.
.\" 4. Neither the name of The NetBSD Foundation nor the names of its
.\" contributors may be used to endorse or promote products derived
.\" from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.
Installing NetBSD/vax may be a little bit complex, but it shouldn't be too
hard if you have this document available.
.
.Ss2 Device conventions.
.
The
.Nx
standalone system addresses devices like
.Ar devicename Ns Ic (
.Ar adapter,\ controller,\ unit,\ partition Ns Ic )
.No The Ar devicename No values are:
.Pp
.Dl mt No \- MSCP tape. (TK50, TU81, ...)
.Dl ts No \- TSV05/TS11 tape.
.Dl ra No \- RA??/RD?? disks/floppies.
.Dl hp No \- RP??/RM?? disks.
.Dl rd No \- RD?? disks on MicroVAX 2000.
.Dl sd No \- SCSI disks.
.Dl st No \- SCSI tapes.
.Dl le No \- LANCE ethernet controller.
.Pp
You can omit parameters;
.Ic ra(0,0)
refers to disk
.Ic 0
partition
.Ic a
on the default controller. On tapes partition it refers to the file #
on the tape.
.(tag Example:
The DUB1 (DEC syntax) swap partition will be specified as
.Ic ra(1,0,1) ;
the DRA2 root partition is
.Ic hp(2,0) .
.tag)
.Pp
The installation principle is to label the root disk, copy a miniroot
filesystem onto the swap partition, boot up from that miniroot filesystem,
then create root and the other wanted partitions and put system to it.
You will have to deal with 2 different
.Em units ,
one is just a boot
filesystem containing 3 files:
.Li boot, copy No and Li edlabel ,
the other is an image of a miniroot filesystem and can be split
into several pieces depending of what you are going to install from.
.
.Ss2 Installation from tape: (MicroVAX II/III)
.
Take your newly created boot tape and just boot from it:
.Dl \*>\*>\*> Ic B/3 MUA0
This means that you will bring up boot to ask for a boot file from the
TK50. (MUA0 is the DEC name.) It will come up with something like
.Bd -literal -offset indent
2..1..0..
howto 0x3, bdev 0x12, booting...done. (31248+22252)
\*>\*> NetBSD/vax boot [970610 23:44] \*<\*<
:
.Ed
.Pp
At the prompt you type
.Ic edlabel
to label the disk, see below about
how to use edlabel.
When labeling is finished, halt the computer, bring up the boot program
again and this time load copy, see below about how to use copy.
Remember that you must copy from the second file (1) on the tape.
.Pp
Now go to step 3.
.
.Ss2 Installation from RX33/RX50. (MicroVAX II/III)
.
The difference between RX33 and RX50 is its size. An RX50 is 400k and
an RX33 is 1200k.
.Pp
To boot from floppy type:
.Dl \*>\*>\*> Ic B/3 DU Ns Ar xy
.No where Ar x
is the controller number and
.Ar y No is the device number.
.Pp
You will now get a prompt like
.Dl \*>\*> NetBSD/vax boot [970610 23:44] \*<\*<
.Dl :
At the prompt you type
.Ic edlabel
to label the disk, see below about
how to use it.
When labeling is finished, halt the computer, bring up the boot program
again and this time load copy, see below about how to use it.
Remember that you are will copy from partition 0 when using floppies.
.Pp
Now go to step 3.
.
.Ss2 Installing Over a Network
.
You can use the same flags when booting over the net as when
booting from local disks; like: "\*>\*>\*>B/3 ESA0" will load boot
in ask state. From here you can load any file you want, even
copy and edlabel if they are located in the exported root fs.
.(Note
Netbooting of MicroVAX II/III systems with DEQNA/DELUA
ethernet does not work does not work yet because lack of standalone
drivers. Mounting of root and swap over NFS works well though.
.Note)
.(Note
Mopd won't work on VAXen with de/qe ethernet, due to the
lack of bpf support for those interfaces.
.Note)
.
.Ss2 Booting up the miniroot
.
When copying is complete, bring the boot program up a third
time, and this time bring up a real system by telling
boot where you put your miniroot
.Em and
also the generic
kernel name. Example:
.Ic ra(0,1)gennetbsd
boots
.Pa gennetbsd
from the swap partition on
.Li ra0 .
.Pp
When the kernel is loaded, you will after a while get a
question about
.Li Root device?
Respond to this with
.Ar xx?* ,
where
.Ar xx
is the device name,
.Ar ?
is the unit
number and * specifies that the system shall use the swap
partition as root partition. Example:
.Dl Root device? Ic ra0*
.Pp
After that a second question:
.Dl Enter pathname of shell or RETURN for sh:
Just type return. Now you will be in a normal single-user
shell, needing only to
newfs your partitions, and start installation.
.Pp
A few things that you must remember to do from the miniroot:
.D1 Ic disklabel -B Ar diskname
will install boot blocks.
.Pa MAKEDEV
your devices in the newly created root filesystem.
Copy
.Pa gennetbsd No and Pa boot
from the miniroot filesystem
to the newly created root filesystem.
.
.Ss2 How to use edlabel
.
Edlabel is a program to edit disklabels on any disks in a standalone
environment. Mostly it is used to set labels when doing initial
installation procedure. It is started from boot program prompt.
You will here be guided through a session, things with ^^^^ under
are typed in by the user, comments are within /* */.
.Bd -literal -offset indent
\*>\*> NetBSD/vax boot [970610 23:44] \*<\*<
: edlabel
^^^^^^^
With this program you can modify everything in the on-disk
disklabel. To do something useful you must know the exact
geometry of your disk, and have ideas about how you want
your partitions to be placed on disk. Some hints:
The a partition should be at least ~20000 blocks, the
b (swap) is depending on your use of the machine but it
should almost never be less than ~32000 blocks.
Disk geometry for most DEC disks can be found in the disktab
file, and applicable disk names can be found above.
Remember that disk names is given as disk(adapt, ctrl, disk, part)
when using the installation tools.
Label which disk? ra(1,0,0) /* See INSTALL text for device types */
^^^^^^^^^
getdisklabel: no disk label
ra(1,0,0): no disk label
(E)dit, (S)how, (D)efaults, (W)rite, (Q)uit) : e
^
First set disk type. Valid types are:
0 unknown
1 SMD
2 MSCP
3 old DEC
4 SCSI
5 ESDI
6 ST506
7 HP-IB
8 HP-FL
9 type 9
10 floppy
11 ccd
12 vnd
Numeric disk type? [0] 2 /* All disks supported this far is MSCP */
Disk name? [] rd54 ^ /* You must know what type your disk is */
badsect? [n] ^^^^ /* No badsectoring yet */
ecc? [n] /* ECC is automatic, don't care */
removable? [n] /* Removable or not, like RA60 */
Interleave? [0] 1 /* All MSCP disks is seen like 1 interleave */
rpm? [0] 3600 ^ /* 3600 rpm is normal */
trackskew? [0] /* don't care */
cylinderskew? [0] /* don't care */
headswitch? [0] /* don't care */
track-to-track? [0] /* don't care */
drivedata 0? [0] /* don't care */
drivedata 1? [0] /* don't care */
drivedata 2? [0] /* don't care */
drivedata 3? [0] /* don't care */
drivedata 4? [0] /* don't care */
bytes/sector? [0] 512 /* Probably only sive on VAX systems */
^^^
sectors/track? [0] 17 /* You must know this, check disktab file */
^^
tracks/cylinder? [0] 15 /* You must know this, check disktab file */
^^
sectors/cylinder? [0] 255 /* sectors/track * tracks/cylinder */
^^^
cylinders? [0] 1221 /* You must know this, check disktab file */
^^^^
a partition: offset? [0] /* Partition sizes are set by you. */
size? [0] 20000 /* Take default sizes from disktab or */
b partition: offset? [0] 20000 /* calculate your own partition sizes */
size? [0] 20000
c partition: offset? [0]
size? [0] 311200
d partition: offset? [0]
size? [0]
e partition: offset? [0] 40000
size? [0] 271200
f partition: offset? [0]
size? [0]
g partition: offset? [0]
size? [0]
h partition: offset? [0]
size? [0]
(E)dit, (S)how, (D)efaults, (W)rite, (Q)uit) : s /* Show what you've typed */
^
disk type 2 (MSCP), rd54:
interleave 1, rpm 3600, trackskew 0, cylinderskew 0
headswitch 0, track-to-track 0, drivedata: 0 0 0 0 0
bytes/sector: 512
sectors/track: 17
tracks/cylinder: 15
sectors/cylinder: 255
cylinders: 1221
8 partitions:
size offset
a: 20000, 0
b: 20000, 20000
c: 311200, 0
d: 0, 0
e: 271200, 40000
f: 0, 0
g: 0, 0
h: 0, 0
(E)dit, (S)how, (D)efaults, (W)rite, (Q)uit) : w /* Write label to disk */
This program does not (yet) write bootblocks, only disklabel.
Remember to write the bootblocks from the miniroot later with the
command "disklabel -B \*<diskname\*>".
(E)dit, (S)how, (D)efaults, (W)rite, (Q)uit) : q
.Ed
.
.Ss2 How to use copy
.
Copy is a standalone program that can copy multiple volumes
from disk/tape to disk/tape. Mostly it is used to copy the
miniroot filesystem onto the swap partition during initial
installation.
You will here be guided through a session, things with ^^^^ under
is typed in by the user, comments are within /* */.
This is an installation from TK50.
.Bd -literal -offset indent
\*>\*> NetBSD/vax boot [970610 23:44] \*<\*<
: copy
^^^^
copy:
This program will read miniroot from tape/floppy/disk
and install this miniroot onto disk.
Specify the device to read from as xx(N,0), where
xx is the device-name and N is the unit-number, e.g.
"mt(0,1)" for the first TMSCP-tape (TK50),
"ra(2,0)" for the third MSCP-disk/floppy (RX33/RX50)
device to read from ? mt(0,1) /* Tape 0, file 1 */
^^^^^^^^
Specify number of blocks to transfer. Usually this is
sizeof(miniroot) / 512.
It's safe to transfer more blocks than just the miniroot.
number of blocks ? 4096 /* Miniroot size is 4096 block */
^^^^
If your miniroot is split into volumes, then you must
specify the number of blocks per volume.
(e.g. 800 blocks per RX50, 2400 blocks per RX33)
number of blocks per volume ? [4096]
Make sure unit tms(0,1) is online and holds the proper volume.
Then type 'g' to Go or 'a' to Abort.
OK to go on ? [g/a] g /* g == go, a == abort */
^
Reading ... Reading of miniroot done. (4096 blocks read)
.Ed
.Pp
Now specify the device to write miniroot to as xx(N,1)
where xx is the drive type and N is the drive number.
For example: ra(0,1) refers to MSCP drive #0, b partition
.Bd -literal -offset indent
Root disk ? : ra(0,1) /* Actually DUA0, partition b (swap) */
^^^^^^^^^
Initializing partition ... done.
(4096 blocks written.)
Halt the machine and reboot from distribution media,
giving second partition as part to mount as root. Ex:
: ra(0,1) for ra disk 0, hp(2,1) for massbuss disk 2
Halt/Reboot the machine NOW.
?02 EXT HLT
PC = 001005F3
\*>\*>\*>
.Ed