Sync usage with man page.
[netbsd-mini2440.git] / distrib / notes / sgimips / prep
blob5d48457dd0aaf7a373f037a20b40f21cb9f7131d
1 .\"     $NetBSD: prep,v 1.9 2008/10/29 17:01:50 tsutsui Exp $
3 First and foremost, before beginning the installation process,
4 .Em make sure you have a reliable backup
5 of any data (e.g., an old IRIX installation) you wish to preserve.
6 .Pp
7 Booting
8 .Nx*M
9 for the first time is most commonly done from the network.
10 You must set up DHCP, TFTP, and possibly NFS for the installation
11 procedure to be successful.
12 Although newer SGI bootproms can read ELF kernels directly from the
13 network, others require that you boot an ECOFF version of the kernel.
14 Attempting to boot an ELF kernel on a system with a PROM that only
15 supports ECOFF binaries will result in the following message being
16 displayed by the PROM:
17 .Pp
18 .Dl Illegal f_magic number 0x7f45, expected MIPSELMAGIC or MIPSEBMAGIC.
19 .Pp
20 You can convert the standard ELF
21 format kernel into an ECOFF kernel using the
22 .Pa objcopy
23 tool.
24 .Pp
25 .\" Different SGI hardware will require the executable code in the loadable
26 .\" image to start at a different address.
27 .\" You must decide which image your system is capable of loading.
28 .\" The current options are:
29 .\" .(bullet
30 .\" Indigo2, Indy, Challenge M, Challenge S
31 .\" .It
32 .\" O2
33 .\" .bullet)
34 .\" .Pp
35 .\" Additionally there may be a third type in the future for 64bit machines.
36 .\" From now on this document assumes you are familiar with selecting the
37 .\" correct image for your system.
38 .Pp
39 Note that some older bootproms have an interesting bug in reading the
40 kernel via TFTP.
41 They handle the port number as a signed entity, and
42 can thus not connect to ports \*[Gt]32767.
43 You can work around this problem on the TFTP server
44 (given that it is a NetBSD host) by using
45 .Dq sysctl
46 to set
47 .Dq net.inet.ip.anonportmin
48 and
49 .Dq net.inet.ip.anonportmax
50 to more suitable values.  For example:
51 .Pp
52 .Dl # Ic sysctl -w net.inet.ip.anonportmin=16384
53 .Dl # Ic sysctl -w net.inet.ip.anonportmax=32767
54 .Pp
55 .Dl "# cu -l /dev/ttyXX
56 .Pp
57 where XX is the serial port used on your remote machine (usually
58 .Pa /dev/tty00
60 .Pa /dev/tty01 ) .
61 Enter the Command Monitor from the System Maintenance Menu. In
62 order to boot the kernel properly you also have to modify the PROM
63 environment with
64 .Pp
65 .Dl "\*[Gt] setenv console serial
66 .Pp
67 Afterwards, just continue with the normal installation procedure.