245 lines
9.8 KiB
Plaintext
245 lines
9.8 KiB
Plaintext
.\" $NetBSD: install,v 1.18 1999/01/13 07:30:08 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.
|
|
.\"
|
|
.
|
|
.(tag Reminder:
|
|
Always back up files before installing or upgrading.
|
|
If installing from source, always install and boot a new kernel
|
|
before installing a new userland!
|
|
.tag)
|
|
.Pp
|
|
If at all possible, you should consult the
|
|
.Em Installation Guide
|
|
document on the NetBSD/pmax web page, at
|
|
.Lk http://www.netbsd.org/Ports/pmax
|
|
It has not been possible to reproduce the pmax installation Web page
|
|
in fixed-font hardcopy format for the \*V release. You must either visit
|
|
the URL above, or request a rendered version (e.g., PostScript).
|
|
.Pp
|
|
Please check the NetBSD/pmax \*V installation instructions at
|
|
.Lk http://www.netbsd.org/Ports/pmax/pmax-install.html
|
|
now, and return to this document when you used those instructions to
|
|
install a diskimage, and used sysinst to label a disk and extract the
|
|
NetBSD/pmax _VER installation tar sets.
|
|
.
|
|
.Ss2 Install\ via\ a\ NetBSD\ CDROM
|
|
.
|
|
You can obtain the disk image or diskless boot tar file from the
|
|
.Nx \*V
|
|
.Tn CDROM .
|
|
.Pp
|
|
To mount the CDROM from a NetBSD/pmax host, type
|
|
.D1 Ic mount\ -r\ -t\ cd9660\ /dev/rz Ns Ar X Ns Ic c\ /mnt
|
|
and from an Ultrix host
|
|
.D1 Ic mount\ -r\ -t\ cdfs\ -o\ nodefperm,noversion\ /dev/rz Ns Ar X Ns Ic c\ /mnt
|
|
.No where Ar X
|
|
is the SCSI id of the CDROM.
|
|
.(Note
|
|
Ultrix does not have Rock Ridge extensions so leave out
|
|
everything between the first and last . in the paths on the CD.
|
|
For example, the path
|
|
.Pa NetBSD-1.3.2
|
|
would show up as
|
|
.Pa NetBSD-1.2 .
|
|
.Note)
|
|
.Pp
|
|
The diskimage file can be found on the CDROM at the following
|
|
location (relative to the mount point of the CD)
|
|
.Dl NetBSD-\*V/pmax/installation/diskimage/diskimage.gz
|
|
and the diskless boot tar file can be found at
|
|
.Dl NetBSD-\*V/pmax/installation/netboot/diskimage.tgz
|
|
Once you have located these files, continue on to either
|
|
.Sx Install via diskless boot ,
|
|
.Sx Install via diskimage
|
|
or
|
|
.Sx Installing from Ultrix
|
|
section later in the INSTALL notes.
|
|
.
|
|
.Ss2 Install\ via\ diskless\ boot
|
|
.
|
|
The preferred path is to upgrade or install by diskless-booting a
|
|
minimal system via NFS, and using that to upgrade or install. The file
|
|
.Dl installation/netboot/diskimage.tar.gz
|
|
contains a suitable set of files. (It is a tar copy of the contents of
|
|
a root filesystem diskimage.) You will need to find an NFS server,
|
|
unpack the tarfile, and setup BOOTP/dhcp service for your pmax.
|
|
Complete instructions are in the installation notes or the pmax web
|
|
page.
|
|
.Pp
|
|
Since the system install utility, sysinst, requires a read/write root,
|
|
netbooting is only feasible if your NFS server exports the diskless
|
|
root read-write. If this is not possible, you should install via
|
|
diskimage.
|
|
.
|
|
.Ss2 Install via diskimage
|
|
.
|
|
If netbooting with a
|
|
.Em writable
|
|
.Tn NFS
|
|
root is not possible, the
|
|
recommended installation is to unpack and copy a diskimage onto the
|
|
raw partition of a disk. The diskimage file is in
|
|
.Dl installation/diskimage/diskimage.gz
|
|
It is shipped compressed and is around 8020 kBytes, uncompressing to
|
|
exactly 32Mbytes.
|
|
.Pp
|
|
To install the diskimage onto disk rzX on a NetBSD/pmax system, do:
|
|
.D1 Ic disklabel -W /dev/rrzXc
|
|
.D1 Ic gunzip -c diskimage.gz\ |\ dd of=/dev/rrzXc bs=10240
|
|
.Pp
|
|
When installing on a disk with no NetBSD or Ultrix label, you may get a
|
|
message like:
|
|
.Dl rzX: WARNING: trying Ultrix label, no disk label
|
|
or when installing on an old Ultrix disk, you may get a message like:
|
|
.Dl rzX: WARNING: using ULTRIX partition information
|
|
when issuing the "disklabel -W /dev/rrzXc" command. This can safely be
|
|
ignored.
|
|
.Pp
|
|
Most other NetBSD ports are similar, but use rsdXc instead of rrzXc.
|
|
.Pp
|
|
On NetBSD/i386, the `raw disk partition' is the 'd' parttion, so do:
|
|
.D1 Ic disklabel -W /dev/rsdXd
|
|
.D1 Ic gunzip -c diskimage.gz\ |\ dd of=/dev/rsdXd bs=10240
|
|
.Pp
|
|
On NetBSD, be sure to use
|
|
.Ic disklabel -W
|
|
to enable writing to the label
|
|
area of the disk. If you forget this and/or use the `block' device,
|
|
the dd command will silently fail.
|
|
.Pp
|
|
On MS-DOS, use an unzip utlility, then use rawrite.
|
|
.Pp
|
|
Then, boot using, e.g,
|
|
.Bd -literal -offset indent
|
|
\*>\*> boot -f rz(0,X,0)netbsd # 3100
|
|
\*>\*> boot 5/rzX/netbsd # 5000/200
|
|
\*>\*> boot 3/rzX/netbsd # other machines
|
|
.Ed
|
|
.(Note
|
|
replace the X with the unit number of your disk:
|
|
boot 3/rz2/netbsd to boot drive 2 on a 5000/xxx.
|
|
.Note)
|
|
.Pp
|
|
then continue from ``Once you've booted the diskimage''.
|
|
.
|
|
.Ss2 Installing from Ultrix
|
|
.
|
|
The Ultrix bootloader can boot ECOFF-format NetBSD kernels.
|
|
So the technique of dd'ing a disk image into swap, copying
|
|
a kernel to the root, and then booting via the "n" argument
|
|
should work with Ultrix too. Since Ultrix cannot mount
|
|
4.4BSD format FFS filesystems, just dd the diskimage into
|
|
your swap partition, copy a netbsd.ecoff kernel from the FTP site,
|
|
and proceed from step #5 of the `Upgrade via diskimage' above.
|
|
.Pp
|
|
You should do this from single-user mode, to ensure that swapping is
|
|
not enabled when you copy the diskimage into the swap partition.
|
|
.Pp
|
|
On Ultrix, use the
|
|
.Ic chpt -q /dev/rz?c
|
|
command to be sure your swap
|
|
partition (typically "b") is big enough to hold the diskimage (32Mbytes
|
|
or more).
|
|
.Pp
|
|
Again, be sure to specify the partition where you dd'ed the NetBSD
|
|
diskimage as your root device in step #7!
|
|
.Pp
|
|
Details of dd'ing a disk image into the swap partition are covered in the
|
|
.Pa QUICK.INSTALL
|
|
file, which should be in the same directory where
|
|
these install notes are located.
|
|
.
|
|
.Ss2 Once you've booted the diskimage
|
|
.
|
|
Once you'e booted a diskimage and pointed the kernel at the approriate
|
|
devices to use for root, and dump, NetBSD kernel will prompt you for
|
|
a single-user shell
|
|
.Dl Enter pathname of shell or RETURN for sh:
|
|
At this point, press the RETURN key. When you get a standalone root
|
|
prompt, set your terminal type
|
|
.D1 Ic TERM=pmax; export TERM;
|
|
for a framebuffer console, or
|
|
.D1 Ic TERM=vt100; export TERM
|
|
.Pp
|
|
if using a serial console with a vt100-compatible terminal.
|
|
Pp
|
|
Next, you need to ensure that the root filesystem is writable so that
|
|
sysinst can create temporary files, temporary disklabels, etc.
|
|
If you booted via NFS, the diskless root should already be writable.
|
|
If you booted from disk, type
|
|
.D1 Ic mount /dev/rzXY /
|
|
where X is the disk unit you booted from, and Y is either a or b,
|
|
(e.g., use /dev/rz2a for drive 2 with diskimage in the 'a' partition,
|
|
and rz2b for diskimage in swap.)
|
|
.Em CD-ROM installation note:
|
|
If you are installing from a CD-ROM, sysinst
|
|
will offer you a default choice of "cd0" for the CD-ROM device. Unlike
|
|
other NetBSD ports, NetBSD/pmax currently uses the same device driver
|
|
for both hard disks and CD-ROMs. You will need to specify "rzX" (where
|
|
X is the SCSI id of the CD-ROM) as the CD-ROM device. Also note that
|
|
sysinst doesn't expect a partition - just the base device. If you still
|
|
have problems, you can try issuing the following command before starting
|
|
sysinst
|
|
.Dl Ic mount -r -t cd9660 /dev/rzXc /mnt2
|
|
where X is the SCSI id of the CD-ROM. You can then ignore any errors
|
|
trying to mount the CD-ROM from within sysinst.
|
|
.Pp
|
|
Then, start sysinst
|
|
.D1 Ic sysinst
|
|
Then, choose 'install' or 'upgrade'.
|
|
.Pp
|
|
When you've finished the install/upgrade, be sure to edit /etc/rc.conf
|
|
and set "rc_configured" to YES when you are done. If you're doing an
|
|
upgrade, merge your old etc from /etc.old into /etc.
|
|
.Pp
|
|
You're then ready to reboot!
|
|
.
|
|
.Ss2 Post-Installation Notes
|
|
.
|
|
Some of the files in the NetBSD \*V distribution might need to be
|
|
tailored for your site. In particular, the /etc/sendmail.cf file will
|
|
almost definitely need to be adjusted, and other files in /etc will
|
|
probably need to be modified. If you are unfamiliar with UN*X-like
|
|
system administration, it's recommended that you buy a book that
|
|
discusses it.
|
|
.Pp
|
|
NetBSD/pmax \*V uses an X11R5 X server. These servers cannot read the
|
|
compressed fonts which are shipped with standard X11R6 configurations.
|
|
.Pp
|
|
If you installed X11 and want to run a local Xserver, you must take
|
|
post-installation steps to make the X11R5 server work that are
|
|
standard for X11R6.3. The distribution file /usr/X11R6/bin/README.pmax
|
|
contains information on how to choose an Xserver and how to access
|
|
compressed fonts via a font server or to decompress the X fonts
|
|
after installation. Please follow the directions there.
|