installation notes. still much work to be done here.

This commit is contained in:
pooka 2002-05-18 17:31:43 +00:00
parent 1ba0247f4a
commit af36ff0cba
7 changed files with 136 additions and 0 deletions

View File

@ -0,0 +1,5 @@
# $NetBSD: Makefile,v 1.1 2002/05/18 17:31:43 pooka Exp $
MERGED_SRCS+=${.CURDIR}/../common/sysinst ${.CURDIR}/../common/upgrade
.include <bsd.man.mk>

View File

@ -0,0 +1,12 @@
.\" $NetBSD: hardware,v 1.1 2002/05/18 17:31:43 pooka Exp $
.
.Nx*M
is aimed to run on MIPS-based computers manufactured by SGI.
.Ss2 Supported machines
.(bullet -compact
Indy
.It
Indigo2
.bullet)
There is some initial support for the SGI O2, but it is known to currently
have various problems.

View File

@ -0,0 +1,80 @@
.\" $NetBSD: install,v 1.1 2002/05/18 17:31:43 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.
.\"
.
The steps taken for installing
.Nx*M
are different for diskless and hard disk configurations.
.Ss2 Installation for diskless configurations
This sections assumes you know how to configure DHCP, TFTP,
and NFS services on your server.
.Pp
.(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
.Pa 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.
.Pp
.Dl server# Ic cp netbsd-GENERIC /tftpboot/netbsd-sgimips
.Dl server# Ic cp netbsd-GENERIC_INDY /tftpboot/netbsd-sgimips-indy
.Pp
Note that your DHCP server must be configured to specify
this file as the boot file for the client.
.It
Unpack the distribution sets into the client's root directory
on the server.
.Pp
.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 ]
.It
Load the kernel from the TFTP server:
.Pp
.Dl > setenv SystemPartition bootp():
.Dl > setenv netaddr your.ip.here.please
.Dl > boot
.enum)
For more tricks with the bootprom, try reading the "prom" manual page
on found on IRIX.
.Pp
The installation of your diskless
.Nx*M
system is now complete! You may now skip ahead to any post-installation
instructions.
.

View File

@ -0,0 +1,2 @@
.\" $NetBSD: legal,v 1.1 2002/05/18 17:31:43 pooka Exp $
.

View File

@ -0,0 +1,30 @@
.\" $NetBSD: prep,v 1.1 2002/05/18 17:31:43 pooka Exp $
.
First and foremost, before beginning the installation process,
.Em make sure you have a reliable backup
of any data (e.g., an old IRIX installation) you wish to preserve.
.Pp
Booting
.Nx*M
for the first time is most commonly done from the network. You must
set up DHCP, TFTP, and NFS for the installation procedure to be
successful. Some SGI bootproms, such as the ones found on O2s, can read
ELF kernels directly from the network, others require that you boot
an ECOFF version of the kernel. You can convert the standard ELF
format kernel into an ECOFF kernel using the
.Pa elf2ecoff
tool.
.Pp
Note that some older bootproms have an interesting bug in reading the
kernel via TFTP. They handle the port number as a signed entity, and
can thus not connect to ports >32767. You can work around this problem
on the TFTP server (given that it is a NetBSD host) by using
.Dq sysctl
to set
.Dq net.inet.ip.anonportmin
and
.Dq net.inet.ip.anonportmax
to more suitable values.
.Pp
The O2 internal MACE Ethernet chip isn't supported yet, so to boot the O2
and mount nfsroot, you will need an external NIC in the PCI slot.

View File

@ -0,0 +1,5 @@
.\" $NetBSD: whatis,v 1.1 2002/05/18 17:31:43 pooka Exp $
.
This is the first major release of
.Nx
for the \*M platform.

View File

@ -0,0 +1,2 @@
.\" $NetBSD: xfer,v 1.1 2002/05/18 17:31:43 pooka Exp $
.