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!
p 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).
p 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 .
p 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
a NetBSD-1.3.2 would show up as
a NetBSD-1.2 . .Note)
p 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.
p 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.
p 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
p 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.
p Most other NetBSD ports are similar, but use rsdXc instead of rrzXc.
p 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
p On NetBSD, be sure to use c 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.
p On MS-DOS, use an unzip utlility, then use rawrite.
p Then, boot using, e.g, d -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)
p 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.
p You should do this from single-user mode, to ensure that swapping is not enabled when you copy the diskimage into the swap partition.
p On Ultrix, use the c chpt -q /dev/rz?c command to be sure your swap partition (typically "b") is big enough to hold the diskimage (32Mbytes or more).
p Again, be sure to specify the partition where you dd'ed the NetBSD diskimage as your root device in step #7!
p Details of dd'ing a disk image into the swap partition are covered in the
a 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
p 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.
p Then, start sysinst .D1 Ic sysinst Then, choose 'install' or 'upgrade'.
p 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.
p 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.
p NetBSD/pmax \*V uses an X11R5 X server. These servers cannot read the compressed fonts which are shipped with standard X11R6 configurations.
p 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.