xref: /netbsd/distrib/notes/sgimips/install (revision bf9ec67e)
$NetBSD: install,v 1.2 2002/05/23 05:44:50 pooka Exp $

Copyright (c) 1999, 2000, 2002 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.

.

p To install or upgrade .Nx , you need to first boot an installation program and then interact with the screen-menu program c sysinst . The installation program actually consists of the .Nx kernel plus an in-memory file system of utility programs.

p The installation methods are: .(enum Installation from an existing .Nx or .Tn IRIX system by booting the install kernel from an existing file system. t Copying a bootable diskimage onto the beginning of a disk and installing onto that disk. See the .Sx Diskless installation section later in these INSTALL notes. .\} t Installation in a diskless environment. This means that you will install your entire system onto a remotely shared disk. t Booting the install kernel over the network and installing onto a local disk. The beginning of the procedure is similar to diskless installation, but you will eventually end up writing the system onto your local disk. t Using a helper machine with a SCSI controller to copy the bootable diskimage onto the beginning of a disk, and moving the disk to the target machine. See the .Sx Install via diskimage section later in these INSTALL notes. .\} .enum)

p You should familiarize yourself with the console PROM environment and the hardware configuration. A good place to study PROM tricks is the IRIX "prom" manual page. Be sure you know how to print the configuration of your machine, and how to boot from disk or network, as appropriate.

p To boot from disk, use:

p .(bullet c "All machine types:"

p .Dl ">> setenv systempartition scsi(0)disk(X)rdisk(0)partition(8)" .Dl ">> setenv osloadpartition scsi(0)disk(X)rdisk(0)partition(0)" .Dl ">> setenv osloadfilename netbsd" .Dl ">> setenv osloader boot" .bullet)

p For all drives (including all SCSI-2 drives), the kernel should correctly detect the disk geometry.

p If you're installing .Nx*M for the first time it's a very good idea to pre-plan partition sizes for the disks onto which you're installing .Nx . Changing the size of partitions after you've installed is difficult. If you do not have a spare bootable disk, it may be simpler to re-install .Nx again from scratch.

p To be able to boot from local disk an SGI Volume Header partition is required. This special partition is accessed by the PROM to load the .Nx*M boot program. The partition should be about 2 MB in size, but can be reduced somewhat. The minimum size can approach 150k, but this doesn't leave room for upgrade boot programs. . .Ss2 Install via a bootable CD-ROM . The .Nx*M CD-ROM is not ISO-formatted. Since the older SGI PROMs do not understand ISO/CD-9660 formats, the CD-ROM image is generated with an SGI Volume Header and an FFS-formatted (BSD4.2) partition for the distribution. Furthermore, since the filesystem is FFS, the CD cannot be mounted under IRIX.

p To install from a .Nx*M CD-ROM, follow the procedure above for setting the PROM environment for SystemPartition, OSLoadPartition, OSLoader and OSLoadFilename. The SCSI and DISK values used should be for your attached CD-ROM drive, where .Ar X is the SCSI-ID of the CD-ROM. . Using the PROM command-line interface, you can boot the CD-ROM installation kernel as follows:

p .(tag 12n -offset indent -compact t Ic ">> boot"

p .Ss2 Installation for diskless configurations This sections assumes you know how to configure DHCP, TFTP, and NFS services on your server.

p .(enum Place the kernel into the TFTP server's download area. If the kernel has a .Dq .gz suffix, you must first uncompress it using the

a gunzip program. You must also decide which kernel you need to boot. Because of differences in SGI hardware between different machines, the kernel load addresses differ. You will need GENERIC_INDY for the Indy and Indigo2, while GENERIC should be enough for the O2.

p .Dl server# Ic cp netbsd-GENERIC /tftpboot/netbsd-sgimips

p Note that your DHCP server must be configured to specify this file as the boot file for the client. t Unpack the distribution sets into the client's root directory on the server.

p .Dl server# Ic cd /export/client/mipseb .Dl server# Ic gzcat .../base.tgz | tar xvpf - .Dl server# Ic gzcat .../etc.tgz | tar xvpf - .Dl [ repeat for all sets you wish to unpack ] t Load the kernel from the TFTP server:

p .Dl ">> setenv SystemPartition bootp():" .Dl ">> setenv netaddr your.ip.here.please" .Dl ">> boot" .enum)

p The installation of your diskless .Nx*M system is now complete! You may now skip ahead to any post-installation instructions. .Ss2 Once you've booted the diskimage . Once you've booted the installation kernel you will need to select your terminal type. Use c iris-ansi for an SGI graphics console (Not currently supported) c vt100 for a serial console with a vt100-compatible terminal, or c xterm or c xterms for a .Xr tip 1 or .Xr cu 1 connection running in an .Xr xterm 1 .

p The system will then start the c sysinst program. .so ../common/sysinst