ecaaa69b6d
Reported by Ken Seefried.
721 lines
21 KiB
Plaintext
721 lines
21 KiB
Plaintext
.\" $NetBSD: install,v 1.14 2001/10/23 22:13:35 scw Exp $
|
|
.\"
|
|
.\" Copyright (c) 1999, 2000 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
|
|
.Nx
|
|
is a relatively complex process, but if you have
|
|
this document in hand it should not be too difficult.
|
|
.Pp
|
|
There are several ways to install
|
|
.Nx
|
|
onto your disk. If your
|
|
machine has a tape drive the easiest way is
|
|
.Sx "Installing from tape"
|
|
(details below). If your machine is on a network with a suitable
|
|
NFS server, then
|
|
.Sx "Installing from NFS"
|
|
is the next best method.
|
|
Otherwise, if you have another \*M machine running
|
|
.Nx
|
|
you can
|
|
initialize the disk on that machine and then move the disk.
|
|
.
|
|
.Ss2 Installing from tape
|
|
.
|
|
Create the
|
|
.Nx*M
|
|
\*V boot tape as described in the section
|
|
entitled
|
|
.Sx "Preparing a boot tape" .
|
|
Then, with the tape in the drive, type the following at the Bug prompt:
|
|
.Pp
|
|
.Dl 147-Bug\*> Ic "bo 5"
|
|
.Pp
|
|
.Dl 16x-Bug\*> Ic "bo 0,50"
|
|
.Pp
|
|
As mentioned earlier, this assumes your tape is jumpered for SCSI-ID 5.
|
|
.Pp
|
|
As the tape loads (which may take 20 to 30 seconds), you will see a
|
|
series of status messages. It may be useful if you can capture these
|
|
messages to a file, or a scrollable xterm window. In particular, you
|
|
should make a note of the lines which describe the geometry of the
|
|
SCSI disks detected by
|
|
.Nx .
|
|
They are of the form:
|
|
.(disp
|
|
sd0 at scsibus0 targ 0 lun 0: \*<Maker, Disk, Foo\*> SCSI1 0/direct fixed
|
|
sd0: 800 MB, 800 cyl, 16 head, 128 sec, 512 bytes/sect x 1638400 sectors
|
|
.disp)
|
|
.Pp
|
|
The information of most interest is the number of sectors; for the fictitious
|
|
disk above, it's 1638400. You will need this number when you come to create
|
|
a disklabel for that drive.
|
|
.Pp
|
|
Here is an example of an MVME147 system booting from tape:
|
|
.(disp
|
|
RAM address from VMEbus = $00000000
|
|
|
|
Booting from: VME147, Controller 5, Device 0
|
|
Loading: Operating System
|
|
|
|
Volume: NBSD
|
|
|
|
IPL loaded at: $003F0000
|
|
\*>\*> BSD MVME147 tapeboot [$Revision: 1.14 $]
|
|
578616+422344+55540+[46032+51284]=0x11a6e4
|
|
Start @ 0x8000 ...
|
|
Copyright (c) 1996, 1997, 1998, 1999, 2000
|
|
The NetBSD Foundation, Inc. All rights reserved.
|
|
Copyright (c) 1982, 1986, 1989, 1991, 1993
|
|
The Regents of the University of California. All rights reserved.
|
|
|
|
NetBSD 1.5 (RAMDISK) #1: Sun Oct 29 16:19:04 GMT 2000
|
|
steve@fatbob:/usr/src/sys/arch/mvme68k/compile/RAMDISK
|
|
Motorola MVME-147S: 25MHz MC68030 CPU+MMU, MC68882 FPU
|
|
real mem = 7237632
|
|
avail mem = 6381568
|
|
using 88 buffers containing 360448 bytes of memory
|
|
mainbus0 (root)
|
|
pcc0 at mainbus0: Peripheral Channel Controller, rev 0, vecbase 0x40
|
|
clock0 at pcc0 offset 0x0 ipl 5: Mostek MK48T02, 2048 bytes of NVRAM
|
|
\&.
|
|
\&.
|
|
|
|
.disp)
|
|
.Pp
|
|
.(Note
|
|
The exact text of the messages will vary depending on which
|
|
\*M
|
|
variant you're using.
|
|
.Note)
|
|
.Pp
|
|
Finally, you will see the following "welcome" message:
|
|
.(disp
|
|
Welcome to the NetBSD/\*M RAMDISK root!
|
|
|
|
This environment is designed to do only four things:
|
|
1: Partition your disk (use the command: edlabel /dev/rsd0c)
|
|
2: Copy a miniroot image into the swap partition (/dev/rsd0b)
|
|
3: Make that partition bootable (using 'installboot')
|
|
4: Reboot (using the swap partition, i.e. /dev/sd0b).
|
|
|
|
Copying the miniroot can be done several ways, allowing the source
|
|
of the miniroot image to be on any of these:
|
|
boot tape, NFS server, TFTP server, rsh server
|
|
|
|
The easiest is loading from tape, which is done as follows:
|
|
mt -f /dev/nrst0 rewind
|
|
mt -f /dev/nrst0 fsf 3
|
|
dd bs=8k if=/dev/nrst0 of=/dev/rsd0b
|
|
(For help with other methods, please see the install notes.)
|
|
|
|
To reboot using the swap partition after running installboot, first
|
|
use
|
|
.Ic halt ,
|
|
then at the Bug monitor prompt use a command like:
|
|
1x7Bug> bo 0,,b:
|
|
|
|
To view this message again, type: cat /.welcome
|
|
ssh:
|
|
.disp)
|
|
.Pp
|
|
You must now create a disklabel on the disk you wish to use for the
|
|
root file system
|
|
.Pq Pa / .
|
|
This will usually be
|
|
.Li sd0 .
|
|
The disklabel is used by
|
|
NetBSD to identify the starting block and size of each partition on
|
|
the disk.
|
|
.Pp
|
|
Partitions are named
|
|
.Li sd0a ,
|
|
.Li sd0b ,
|
|
.Li sd0c ,
|
|
etc,
|
|
up to
|
|
.Li sd0h .
|
|
The \*M port of
|
|
.Nx
|
|
makes some assumptions about the first three partitions on a boot disk:
|
|
.Pp
|
|
.(tag sd0c -compact
|
|
.It Li sd0a
|
|
The root file system
|
|
.Pq Pa / .
|
|
.It Li sd0b
|
|
The swap partition.
|
|
.It Li sd0c
|
|
The whole disk. Also known as the
|
|
.Em raw partition .
|
|
.tag)
|
|
.Pp
|
|
The
|
|
.Em raw partition No is special;
|
|
.Nx
|
|
is able to use it even if the
|
|
disk has no label. You should never create a file system on the Raw
|
|
Partition, even on a non-boot disk.
|
|
.Pp
|
|
It is good practice to put
|
|
.Pa /usr
|
|
on a different partition than
|
|
.Pa /
|
|
(root, AKA
|
|
.Li sd0a ) .
|
|
So, the first available partition for
|
|
.Pa /usr
|
|
is
|
|
.Li sd0d .
|
|
Refer to the section entitled
|
|
.Sx NetBSD System Requirements and Supported Devices
|
|
for information on the recommended sizes of the
|
|
.Pa /
|
|
(root),
|
|
.Pa /usr
|
|
and swap partitions.
|
|
.Pp
|
|
You are not required to define any partitions beyond
|
|
.Li sd0d ,
|
|
but if you
|
|
have a large disk drive, you might want to create several other partitions
|
|
for file systems such as
|
|
.Pa /home
|
|
or
|
|
.Pa /usr/src .
|
|
Note that at this time you
|
|
are only required to partition the root/boot disk; you will get the
|
|
opportunity to partition any other disks in your system from the main
|
|
.Ic miniroot
|
|
installation program.
|
|
.Pp
|
|
To create the disklabel and partitions, use the
|
|
.Li edlabel
|
|
program, passing it the name of the Raw Partition of your root/boot disk.
|
|
.Pp
|
|
.Dl ssh: Ic "edlabel /dev/rsd0c"
|
|
.Dl edlabel menu:
|
|
.Dl print - display the current disk label
|
|
.Dl modify - prompt for changes to the label
|
|
.Dl write - write the new label to disk
|
|
.Dl quit - terminate program
|
|
.Dl edlabel\*>
|
|
.Pp
|
|
The program shows what commands it recognizes;
|
|
.Ic print ,
|
|
.Ic modify ,
|
|
.Ic write ,
|
|
and
|
|
.Ic quit .
|
|
It will accept the first letter of a command if
|
|
you don't feel like typing each one in full.
|
|
.Pp
|
|
To start creating the basic partitions, you should enter
|
|
.Ic m No (modify)
|
|
at the edlabel prompt, then enter the letter corresponding to the first
|
|
.No partition, Sy a .
|
|
.Pp
|
|
.Dl edlabel\*> Ic m
|
|
.Pp
|
|
.Dl modify subcommands:
|
|
.Dl @ : modify disk parameters
|
|
.Dl a-h : modify partition
|
|
.Dl s : standardize geometry
|
|
.Dl q : quit this subcommand
|
|
.Dl edlabel/modify\*> Ic a
|
|
.Dl a (root) 0 (0/00/00) 0 (0/00/00) unused
|
|
.Dl start as \*<blkno\*> or \*<cyls/trks/sects\*> : Ic 0
|
|
.Dl length as \*<nblks\*> or \*<cyls/trks/sects\*> : Ic 65536
|
|
.Dl type: Ic 4.2BSD
|
|
.Dl edlabel/modify\*>
|
|
.Pp
|
|
When you enter the start and length of a partition, you can use either
|
|
blocks or cylinder/track/sector notation. If this is the first time
|
|
you've partitioned a disk for
|
|
.Nx ,
|
|
it's probably easiest to use block
|
|
notation. The above example creates partition
|
|
.Sq Li a ,
|
|
starting at block zero
|
|
and with a size of 65536 blocks. Note that the usual size of a block is
|
|
512 bytes, so this creates a 32 MB partition.
|
|
.Pp
|
|
The
|
|
.Li type
|
|
of the partition should be
|
|
.Li 4.2BSD ,
|
|
otherwise you won't be able to create a file system on it.
|
|
.Pp
|
|
Next, create a swap partition (b). Note that the minimum size of this
|
|
swap partition should be 8 MB, otherwise you won't be able to use a
|
|
miniroot to complete the
|
|
.Nx
|
|
installation!
|
|
.Pp
|
|
.Dl edlabel/modify\*> Ic b
|
|
.Dl b (swap) 0 (0/00/00) 0 (0/00/00) unused
|
|
.Dl start as \*<blkno\*> or \*<cyls/trks/sects\*> : Ic 65536
|
|
.Dl length as \*<nblks\*> or \*<cyls/trks/sects\*> : Ic 32768
|
|
.Dl type: Ic swap
|
|
.Dl edlabel/modify\*>
|
|
.Pp
|
|
Here, we specify a value for
|
|
.Li start
|
|
such that the swap partition follows immediately after partition
|
|
.Sq Li a ,
|
|
i.e. 65536. The length of the swap
|
|
partition should be a multiple of the amount of RAM you have in your
|
|
system. Here, we've chosen 32768, or 16 MB. The next available block on the
|
|
drive is thus 65536 + 32768. We will use this to create partition
|
|
.Sq Li d
|
|
for our
|
|
.Pa /usr
|
|
file system. (Note that for a busy system, or a system with more
|
|
than 8 MB of RAM, you'll be better off with a 32 or 64 MB swap partition.)
|
|
.Pp
|
|
.Dl edlabel/modify\*> Ic d
|
|
.Dl d (user) 0 (0/00/00) 0 (0/00/00) unused
|
|
.Dl start as \*<blkno\*> or \*<cyls/trks/sects\*> : Ic 98304
|
|
.Dl length as \*<nblks\*> or \*<cyls/trks/sects\*> : Ic 1540096
|
|
.Dl type: Ic 4.2BSD
|
|
.Dl edlabel/modify\*> Ic q
|
|
.Dl edlabel\*>
|
|
.Pp
|
|
As you can see, we've chosen to assign the remainder of the disk to
|
|
.Pa /usr .
|
|
Since there are 1638400 sectors on the example disk (did you remember to
|
|
note down the number of sectors on your disk during boot?), and partition
|
|
.Sy d
|
|
starts at sector 98304, a simple bit of arithmetic (1638400 - 98304)
|
|
gives
|
|
.Sy d No a size of 1540096.
|
|
.Pp
|
|
Note that the above partition sizes are just guidelines. If your disk is
|
|
large enough, you should resize the partitions appropriately and
|
|
perhaps also create a /var partition as well.
|
|
.Pp
|
|
You now need to write this new disklabel, together with the partition
|
|
details you've just entered, to disk. You might also try the
|
|
.Sq Ic p
|
|
command
|
|
to view the partitions. Once written, you can quit back to ssh using
|
|
.Sq Ic q .
|
|
.Pp
|
|
.Dl edlabel\*> Ic p
|
|
.(disp
|
|
type_num: 4
|
|
sub_type: 0
|
|
type_name: SCSI disk
|
|
pack_name: fictitious
|
|
bytes/sector: 512
|
|
sectors/track: 128
|
|
tracks/cylinder: 16
|
|
cylinders: 800
|
|
sectors/cylinder: 2048
|
|
partition start (c/t/s) nblks (c/t/s) type
|
|
|
|
a (root) 0 (0/00/00) 65536 (32/00/00) 4.2BSD
|
|
b (swap) 65536 (32/00/00) 32768 (48/00/00) swap
|
|
c (disk) 0 (0/00/00) 1638400 (800/00/00) unused
|
|
d (user) 98304 (48/00/00) 1540096 (752/00/00) 4.2BSD
|
|
.disp)
|
|
.Pp
|
|
.Dl edlabel\*> Ic w
|
|
.Dl edlabel\*> Ic q
|
|
.Dl ssh:
|
|
.Pp
|
|
Now that your disk's partitioned, you need to get the proper installation
|
|
miniroot image onto it. The miniroot image is designed to be copied into
|
|
the swap partition of your disk. This is a safe place which won't be
|
|
overwritten by the installation procedure. From the ssh prompt, use the
|
|
following commands to copy the miniroot image from tape to swap (b).
|
|
.Pp
|
|
.Dl ssh: Ic "mt -f /dev/nrst0 rewind"
|
|
.Dl ssh: Ic "mt -f /dev/nrst0 fsf 3"
|
|
.Dl ssh: Ic "dd bs=8k if=/dev/nrst0 of=/dev/rsd0b"
|
|
.Pp
|
|
The disk and the miniroot must now be made bootable using the
|
|
.Xr installboot 8
|
|
command. To do this, issue the following commands:
|
|
.Pp
|
|
.Dl ssh: Ic "mount /dev/sd0b /mnt"
|
|
.Dl ssh: Ic "installboot /mnt/usr/mdec/bootsd /bootxx /dev/rsd0b"
|
|
.Dl ssh: Ic "umount /dev/sd0b"
|
|
.Pp
|
|
You can now shutdown the system.
|
|
.Pp
|
|
.Dl ssh: Ic halt
|
|
.Dl signal 15
|
|
.Dl ssh: syncing disks... done
|
|
.Dl unmounting / (root_device)...
|
|
.Dl halted
|
|
.Pp
|
|
.Dl 147-Bug\*> Ic reset
|
|
.Dl Reset Local SCSI Bus [Y,N] N? Ic y
|
|
.Dl Automatic reset of known SCSI Buses on RESET [Y,N] Y?
|
|
.Dl Cold/Warm Reset flag [C,W] = C?
|
|
.Dl Execute Soft Reset [Y,N] N? Ic y
|
|
.Pp
|
|
Resetting the other types of MVME boards are very similar.
|
|
You should now reboot from that just installed miniroot. See the section
|
|
entitled
|
|
.Sx "Booting the miniroot"
|
|
for details.
|
|
.
|
|
.Ss2 Installing from NFS
|
|
.
|
|
Before you can install from NFS, you must have already configured
|
|
your NFS server to support your machine as a bootable client.
|
|
Instructions for configuring the server are found in the section
|
|
entitled
|
|
.Sx Getting the NetBSD System onto Useful Media
|
|
above.
|
|
.Pp
|
|
To get started on the MVME147, you need to download
|
|
.Pa sboot
|
|
into RAM (you will find
|
|
.Ic sboot
|
|
in the
|
|
.Pa install
|
|
directory of the \*M distribution).
|
|
You can either do that through the console line or through a 2nd serial
|
|
connection. For example, an MVME147 connected to a sun4/110 and accessed via
|
|
.Xr tip 1
|
|
can be loaded as follows:
|
|
.Pp
|
|
.(disp
|
|
lo 0
|
|
~Ccat sboot
|
|
go 4000
|
|
.disp)
|
|
.Pp
|
|
Which will look like this:
|
|
.Pp
|
|
.Dl 147-Bug\*> Ic "lo 0"
|
|
.Dl ~CLocal command? Ic "cat sboot"
|
|
.Pp
|
|
.Em away for 11 seconds
|
|
.Pp
|
|
.Dl !
|
|
.Pp
|
|
.Dl 147-Bug\*> Ic "g 4000"
|
|
.Dl Effective address: 00004000
|
|
.Pp
|
|
.Dl sboot: serial line bootstrap program (end = 6018)
|
|
.Pp
|
|
.Dl \*>\*>\*>
|
|
.Pp
|
|
Now, if you want to do it through serial line 1, then connect serial
|
|
line one to a machine. At the
|
|
.Li 147-Bug\*> No prompt type Ic \&tm 1
|
|
You should then login to the machine it is connected to.
|
|
Then press
|
|
.Key CONTROL-A
|
|
to escape to Bug. do
|
|
.Ic lo 1;x=cat sboot Em ...
|
|
then when that is done you can reconnect
|
|
.Ic tm 1 No and logout.
|
|
.No Then do Ic go 4000
|
|
and you've got the
|
|
.Li "\*>\*>\*> "
|
|
prompt of
|
|
.Ic sboot .
|
|
.Pp
|
|
Once you've got the
|
|
.Li "\*>\*>\*> "
|
|
prompt, you can boot the
|
|
.Li RAMDISK
|
|
kernel from the server:
|
|
.Pp
|
|
.Dl \*>\*>\*> Ic b
|
|
.Pp
|
|
.(disp
|
|
le0: ethernet address: 8:0:3e:20:cb:87
|
|
My ip address is: 192.168.1.4
|
|
Server ip address is: 192.168.1.1
|
|
4800
|
|
Download was a success!
|
|
.disp)
|
|
.Pp
|
|
See below for the next step in booting MVME147.
|
|
.Pp
|
|
The MVME162, MVME167, MVME172 and MVME177 boards are able to download netboot
|
|
directly using TFTP.
|
|
To enable this, you must first configure the networking parameters
|
|
on the board as described in the section entitled "Preparing your System
|
|
for
|
|
.Nx
|
|
Installation. On a properly configured MVME162/172 or MVME167/177, all you need
|
|
to type is:
|
|
.Pp
|
|
.Dl 1xx-Bug\*> Ic nbo
|
|
.Pp
|
|
For all board types, the boot messages are very similar:
|
|
.Pp
|
|
.(disp
|
|
Start @ 0x8000 ...
|
|
\*>\*> BSD MVME147 netboot (via sboot) [$Revision: 1.14 $]
|
|
device: le0 attached to 08:00:3e:20:cb:87
|
|
boot: client IP address: 192.168.1.4
|
|
boot: client name: soapy
|
|
root addr=192.168.1.1 path=/export/soapy
|
|
578616+422344+55540+[46032+51284]=0x11a6e4
|
|
Start @ 0x8000 ...
|
|
Copyright (c) 1996, 1997, 1998, 1999, 2000
|
|
The NetBSD Foundation, Inc. All rights reserved.
|
|
Copyright (c) 1982, 1986, 1989, 1991, 1993
|
|
The Regents of the University of California. All rights reserved.
|
|
|
|
NetBSD 1.5 (RAMDISK) #1: Sun Oct 29 16:19:04 GMT 2000
|
|
steve@fatbob:/usr/src/sys/arch/mvme68k/compile/RAMDISK
|
|
Motorola MVME-147S: 25MHz MC68030 CPU+MMU, MC68882 FPU
|
|
real mem = 7237632
|
|
avail mem = 6381568
|
|
using 88 buffers containing 360448 bytes of memory
|
|
mainbus0 (root)
|
|
pcc0 at mainbus0: Peripheral Channel Controller, rev 0, vecbase 0x40
|
|
clock0 at pcc0 offset 0x0 ipl 5: Mostek MK48T02, 2048 bytes of NVRAM
|
|
\&.
|
|
\&.
|
|
.disp)
|
|
.Pp
|
|
After the boot program loads the
|
|
.Li RAMDISK
|
|
kernel, you should see the
|
|
welcome screen as shown in the "tape boot" section above.
|
|
.Pp
|
|
You now need to create a disklabel with partition information on the
|
|
SCSI disk on which you intend to create your root file system
|
|
.Pq Pa / .
|
|
Follow the instructions in the previous section entitled
|
|
.Sx "Installing from tape"
|
|
to do this. (But stop short of the part which describes how to
|
|
copy the miniroot from tape.)
|
|
.Pp
|
|
You must now configure the network interface before you can access the
|
|
NFS server containing the miniroot image. For example the command:
|
|
.Pp
|
|
.Dl ssh: Ic "ifconfig le0 inet 192.168.1.4 up"
|
|
.Pp
|
|
will bring up the MVME147 network interface
|
|
.Li le0
|
|
with that address.
|
|
The command:
|
|
.Pp
|
|
.Dl ssh: Ic "ifconfig ie0 inet 192.168.1.4 up"
|
|
.Pp
|
|
will bring up the MVME162/172 or MVME167/177 network interface
|
|
.Li ie0
|
|
with that address.
|
|
The next
|
|
step is to copy the miniroot from your server. This can be done using
|
|
either NFS or remote shell. (In the examples that follow, the server has
|
|
IP address 192.168.1.1) You may then need to add a default route if the
|
|
server is on a different subnet:
|
|
.Pp
|
|
.Dl ssh: Ic "route add default 192.168.1.2 1"
|
|
.Pp
|
|
You can look at the route table using:
|
|
.Pp
|
|
.Dl ssh: Ic "route show"
|
|
.Pp
|
|
Now mount the NFS file system containing the miniroot image:
|
|
.Pp
|
|
.Dl ssh: Ic "mount -r 192.168.1.1:/export/soapy /mnt"
|
|
.Pp
|
|
The procedure is simpler if you have space for an expanded (not
|
|
compressed) copy of the miniroot image. In that case:
|
|
.Pp
|
|
.Dl ssh: Ic "dd bs=8k if=/mnt/miniroot of=/dev/rsd0b"
|
|
.Pp
|
|
Otherwise, you will need to use
|
|
.Ic zcat
|
|
to expand the miniroot image while copying.
|
|
This is tricky because the
|
|
.Ic ssh
|
|
program (small shell) does not handle
|
|
.Xr sh 1
|
|
pipeline syntax. Instead, you first run the reader
|
|
in the background with its input set to
|
|
.Pa /dev/pipe
|
|
and then run the other program in the foreground with its output to
|
|
.Pa /dev/pipe .
|
|
The result looks like this:
|
|
.Pp
|
|
.Dl ssh: Ic "run -bg dd obs=8k if=/dev/pipe of=/dev/rsd0b"
|
|
.Dl ssh: Ic "run -o /dev/pipe zcat /mnt/install/miniroot.fs.gz"
|
|
.Pp
|
|
To load the miniroot using rsh to the server, you would use a pair
|
|
of commands similar to the above. Here is another example:
|
|
.Pp
|
|
.Dl ssh: Ic "run -b dd obs=8k if=/dev/pipe of=/dev/rsd0b"
|
|
.Dl ssh: Ic "run -o /dev/pipe rsh 192.168.1.1 zcat miniroot.fs.gz"
|
|
.Pp
|
|
You must now make the disk bootable. Refer to the previous section on
|
|
installing from tape, where it describes how to run
|
|
.Ic installboot .
|
|
This is immediately following the part which explains how to copy the
|
|
miniroot from tape.
|
|
.
|
|
.Ss2 Booting the miniroot
|
|
.
|
|
Assuming the miniroot is installed on partition
|
|
.Sq Li b
|
|
of the disk with
|
|
SCSI-ID 0, then the 147Bug boot command is:
|
|
.Pp
|
|
.Dl 147-Bug\*> Ic "bo 0,,b:"
|
|
.Pp
|
|
The corresponding 162Bug, 167Bug, 172Bug or 177Bug boot command is:
|
|
.Pp
|
|
.Dl 1xx-Bug\*> Ic "bo 0,,,b:"
|
|
.Pp
|
|
The command line parameters above are:
|
|
.Pp
|
|
.(tag xxx
|
|
.It Ic 0
|
|
controller (usually zero)
|
|
.It Ic ,, or ,,,
|
|
bug argument separators
|
|
.It Ic \&b:\&
|
|
tell the bootstrap code to boot from partition
|
|
.Li b
|
|
.tag)
|
|
.Pp
|
|
You should see a bunch of boot messages, followed by messages from
|
|
the miniroot kernel just as you did when the
|
|
.Li RAMDISK
|
|
kernel booted.
|
|
.Pp
|
|
You will then be prompted to enter the root device. Since the miniroot
|
|
was booted from the swap partition, you should enter
|
|
.Li sd0b .
|
|
You will
|
|
then be asked for the swap device and file system type. Just press
|
|
.Key RETURN
|
|
twice to accept the defaults. When asked to enter a terminal
|
|
type, either accept the default, or use whatever the TERM environment
|
|
variable is set to in the shell of your host system:
|
|
.Pp
|
|
.Dl boot device: sd0
|
|
.Dl root device (default sd0a): Ic sd0b
|
|
.Dl dump device (default sd0b): Em (return)
|
|
.Dl file system (default generic): Em (return)
|
|
.Dl root on sd0b dumps on sd0b
|
|
.Dl mountroot: trying ffs...
|
|
.Dl root file system type: ffs
|
|
.Dl init: copying out path `/sbin/init' 11
|
|
.Dl erase ^H, werase ^W, kill ^U, intr ^C
|
|
.Dl Terminal type? [vt100] Em return
|
|
.Pp
|
|
Congratulations! The system should now be running the miniroot
|
|
installation program.
|
|
.
|
|
.Ss2 Miniroot install program:
|
|
.
|
|
The miniroot's install program is very simple to use. It will guide
|
|
you through the entire process, and is well automated. Additional
|
|
improvements are planned for future releases.
|
|
.Pp
|
|
The miniroot's install program will:
|
|
.(bullet
|
|
Allow you to place disklabels on additional disks.
|
|
The disk we are installing on should already have
|
|
been partitioned using the
|
|
.Li RAMDISK
|
|
kernel.
|
|
.Pp
|
|
Note that partition sizes and offsets are expressed
|
|
in sectors. When you fill out the disklabel, you will
|
|
need to specify partition types and file system parameters.
|
|
If you're unsure what these values should be, use the
|
|
following defaults:
|
|
.(disp
|
|
fstype: 4.2BSD
|
|
fsize: 1024
|
|
bsize: 4096
|
|
cpg: 16
|
|
.disp)
|
|
.Pp
|
|
If the partition will be a swap partition, use the following:
|
|
.(disp
|
|
fstype: swap
|
|
fsize: 0 (or blank)
|
|
bsize: 0 (or blank)
|
|
cpg: 0 (or blank)
|
|
.disp)
|
|
.Pp
|
|
Note that partition
|
|
.Sq Li c
|
|
is special; it covers then entire
|
|
disk and should not be assigned to a file system.
|
|
.Pp
|
|
The number of partitions is currently fixed at 8.
|
|
.It
|
|
Create file systems on target partitions.
|
|
.It
|
|
Allow you to set up your system's network configuration.
|
|
Remember to specify host names without the domain name
|
|
appended to the end. For example use
|
|
.Li foo
|
|
instead of
|
|
.Li foo.bar.org .
|
|
If, during the process of configuring
|
|
the network interfaces, you make a mistake, you will
|
|
be able to re-configure that interface by simply selecting
|
|
it for configuration again.
|
|
.It
|
|
Mount target file systems. You will be given the opportunity
|
|
to manually edit the resulting
|
|
.Pa /etc/fstab .
|
|
.It
|
|
Extract binary sets from the media of your choice.
|
|
.It
|
|
Copy configuration information gathered during the
|
|
installation process to your root file system
|
|
.Pq Pa / .
|
|
.It
|
|
Make device nodes in your root file system under
|
|
.Pa /dev .
|
|
.It
|
|
Copy a new kernel onto your root partition
|
|
.Pq Pa / .
|
|
.It
|
|
Install a new boot block.
|
|
.It
|
|
Check your file systems for integrity.
|
|
.bullet)
|
|
.Pp
|
|
First-time installation on a system through a method other than the
|
|
installation program is possible, but strongly discouraged.
|