Whitespace fix after the restructuring, no content changes
This commit is contained in:
ue
parent
eb50b9aec7
commit
730ccf3e32
@ -9,16 +9,18 @@ This file contains sparc64-specific installation instructions.
|
||||
<sect1>
|
||||
<title>Installing &os;</title>
|
||||
|
||||
<para>This text describes how to install and boot the &arch;
|
||||
port. Users of this port are encouraged to subscribe to the
|
||||
<para>This text describes how to install and boot the &arch; port.
|
||||
Users of this port are encouraged to subscribe to the
|
||||
&a.sparc;.</para>
|
||||
|
||||
<warning><para>The kernel and userland binaries mentioned below are
|
||||
highly experimental (for example, the kernel contains some ATA
|
||||
changes and EEPROM handling code which could potentially be
|
||||
dangerous). Unless you know what you are doing and are willing to
|
||||
cope with any damage that might arise, you should probably not be
|
||||
trying this.</para></warning>
|
||||
<warning>
|
||||
<para>The kernel and userland binaries mentioned below are highly
|
||||
experimental (for example, the kernel contains some ATA changes
|
||||
and EEPROM handling code which could potentially be dangerous).
|
||||
Unless you know what you are doing and are willing to cope with
|
||||
any damage that might arise, you should probably not be trying
|
||||
this.</para>
|
||||
</warning>
|
||||
|
||||
<para>Unlike &os;/i386 or &os;/alpha, there is no version of
|
||||
&man.sysinstall.8; for &os;/&arch;. The installation procedure
|
||||
@ -29,100 +31,94 @@ This file contains sparc64-specific installation instructions.
|
||||
optionally to copy the &os; distribution to the local disk to make
|
||||
a stand-alone machine.</para>
|
||||
|
||||
<para>Currently, there are two ways to install &os;/&arch; on a
|
||||
new machine. By far the easier of the two is to install from
|
||||
CDROM; this method allows you to install &os; without any
|
||||
dependencies on any other computers.</para>
|
||||
<para>Currently, there are two ways to install &os;/&arch; on a new
|
||||
machine. By far the easier of the two is to install from CDROM;
|
||||
this method allows you to install &os; without any dependencies on
|
||||
any other computers.</para>
|
||||
|
||||
<para>If installing from CDROM is impossible or undesirable, the
|
||||
alternative is to install over the network. This requires
|
||||
another machine, suitably configured, to serve the boot loader,
|
||||
kernel, and root file system to the new machine, via a
|
||||
combination of RARP, TFTP, and either BOOTP or DHCP. This
|
||||
netboot server can be another &os; machine, but is not required
|
||||
to be.</para>
|
||||
<para>If installing from CDROM is impossible or undesirable, the
|
||||
alternative is to install over the network. This requires another
|
||||
machine, suitably configured, to serve the boot loader, kernel,
|
||||
and root file system to the new machine, via a combination of
|
||||
RARP, TFTP, and either BOOTP or DHCP. This netboot server can be
|
||||
another &os; machine, but is not required to be.</para>
|
||||
|
||||
<para>You will need to decide which of these methods you want to
|
||||
use for installation, as this will determine the set of files
|
||||
you need to download (if any), as well as the steps required to
|
||||
do the installation.</para>
|
||||
<para>You will need to decide which of these methods you want to use
|
||||
for installation, as this will determine the set of files you need
|
||||
to download (if any), as well as the steps required to do the
|
||||
installation.</para>
|
||||
|
||||
<!-- this should read "in this document" after the re-structure -->
|
||||
<important>
|
||||
<para>The URLs in this section are provisional and subject to
|
||||
change. Please see the archives of the &a.sparc; for the
|
||||
most recent locations of files. This notice will be removed
|
||||
when more permanent URLs have been determined.</para>
|
||||
</important>
|
||||
|
||||
<sect2 id="getting-to-prom-prompt">
|
||||
<title>Getting to the PROM Prompt</title>
|
||||
<para>Most &arch; systems are set up to boot automatically from
|
||||
disk. To install &os;, you need to boot over the network or
|
||||
from a CDROM, which requires you to break into the PROM
|
||||
(OpenFirmware).</para>
|
||||
<important>
|
||||
<para>The URLs in this section are provisional and subject to
|
||||
change. Please see the archives of the &a.sparc; for the most
|
||||
recent locations of files. This notice will be removed when
|
||||
more permanent URLs have been determined.</para>
|
||||
</important>
|
||||
|
||||
<para>To do this, reboot the system, and wait until the boot
|
||||
message appears. It depends on the model, but should look about
|
||||
like: </para>
|
||||
<screen>Sun Blade 100 (UltraSPARC-IIe), Keyboard Present
|
||||
<sect2 id="getting-to-prom-prompt">
|
||||
<title>Getting to the PROM Prompt</title>
|
||||
|
||||
<para>Most &arch; systems are set up to boot automatically from
|
||||
disk. To install &os;, you need to boot over the network or
|
||||
from a CDROM, which requires you to break into the PROM
|
||||
(OpenFirmware).</para>
|
||||
|
||||
<para>To do this, reboot the system, and wait until the boot
|
||||
message appears. It depends on the model, but should look about
|
||||
like:</para>
|
||||
|
||||
<screen>Sun Blade 100 (UltraSPARC-IIe), Keyboard Present
|
||||
Copyright 1998-2001 Sun Microsystems, Inc. All rights reserved.
|
||||
OpenBoot 4.2, 128 MB memory installed, Serial #51090132.
|
||||
Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</screen>
|
||||
|
||||
<para>If your system proceeds to boot from disk at this point,
|
||||
you need to press
|
||||
<keycombo action="simul">
|
||||
<keycap>L1</keycap>
|
||||
<keycap>A</keycap>
|
||||
</keycombo>
|
||||
or
|
||||
<keycombo action="simul">
|
||||
<keycap>Stop</keycap>
|
||||
<keycap>A</keycap>
|
||||
</keycombo>
|
||||
<para>If your system proceeds to boot from disk at this point, you
|
||||
need to press <keycombo
|
||||
action="simul"><keycap>L1</keycap><keycap>A</keycap></keycombo>
|
||||
or <keycombo
|
||||
action="simul"><keycap>Stop</keycap><keycap>A</keycap></keycombo>
|
||||
on the keyboard, or send a <command>BREAK</command> over the
|
||||
serial console (using for example <command>~#</command> in
|
||||
&man.tip.1; or &man.cu.1;) to get to the PROM prompt. It looks
|
||||
like this:</para>
|
||||
|
||||
on the keyboard, or send a
|
||||
<command>BREAK</command> over the serial console (using for
|
||||
example <command>~#</command> in &man.tip.1; or &man.cu.1;) to
|
||||
get to the PROM prompt. It looks like this:</para>
|
||||
<screenco>
|
||||
<areaspec>
|
||||
<area id="prompt-single" coords="1 5">
|
||||
<area id="prompt-smp" coords="2 5">
|
||||
</areaspec>
|
||||
|
||||
<screenco>
|
||||
<areaspec>
|
||||
<area id="prompt-single" coords="1 5">
|
||||
<screen><prompt>ok </prompt>
|
||||
<prompt>ok {0} </prompt></screen>
|
||||
|
||||
<area id="prompt-smp" coords="2 5">
|
||||
</areaspec>
|
||||
<screen><prompt>ok </prompt>
|
||||
<prompt>ok {0} </prompt> </screen>
|
||||
<calloutlist>
|
||||
<callout arearefs="prompt-single">
|
||||
<para>This is the prompt used on systems with just one
|
||||
CPU.</para>
|
||||
</callout>
|
||||
|
||||
<calloutlist>
|
||||
<callout arearefs="prompt-single">
|
||||
<para>This is the prompt used on systems with just
|
||||
one CPU.</para>
|
||||
</callout>
|
||||
|
||||
<callout arearefs="prompt-smp">
|
||||
<para>This is the prompt used on SMP systems, the digit
|
||||
indicates the number of the active CPU.</para>
|
||||
</callout>
|
||||
</calloutlist>
|
||||
</screenco>
|
||||
<callout arearefs="prompt-smp">
|
||||
<para>This is the prompt used on SMP systems, the digit
|
||||
indicates the number of the active CPU.</para>
|
||||
</callout>
|
||||
</calloutlist>
|
||||
</screenco>
|
||||
</sect2>
|
||||
|
||||
<sect2 id="prepare-cd">
|
||||
<title>Preparing for a CDROM Installation</title>
|
||||
|
||||
<para>If you want to do a CDROM installation, an ISO
|
||||
image with a snapshot of &os;/&arch; can be found at
|
||||
<ulink url="&release.url;"></ulink>. This file can be used
|
||||
to create a bootable CDROM which contains everything
|
||||
necessary to boot and load at least a minimal &os;
|
||||
installation.</para>
|
||||
<para>If you want to do a CDROM installation, an ISO image with a
|
||||
snapshot of &os;/&arch; can be found at <ulink
|
||||
url="&release.url;"></ulink>. This file can be used to create a
|
||||
bootable CDROM which contains everything necessary to boot and
|
||||
load at least a minimal &os; installation.</para>
|
||||
|
||||
<!-- XXX ISO location?-->
|
||||
<para>Place the CDROM into your drive, and break into the PROM as
|
||||
described above. On the PROM prompt, type <command>boot
|
||||
described above. On the PROM prompt, type <command>boot
|
||||
cdrom</command>. The system should boot into single-user mode
|
||||
now, and you can create the disk label and install the base
|
||||
system archive as described in <xref
|
||||
@ -133,112 +129,115 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</screen>
|
||||
<sect2 id="prepare-network">
|
||||
<title>Preparing for a Network Installation</title>
|
||||
|
||||
<para>A &os;/&arch; kernel is booted by having the firmware
|
||||
retrieve and execute a <application>loader</application>,
|
||||
which in turn fetches and executes the actual kernel. For
|
||||
this boot process, you need to set up &man.rarpd.8; and
|
||||
&man.tftpd.8; (for the firmware) and &man.bootpd.8; (for the
|
||||
<application>loader</application>) on another networked
|
||||
system. The loader can fetch a kernel using TFTP or NFS. All
|
||||
of this is covered in detail below.</para>
|
||||
<para>A &os;/&arch; kernel is booted by having the firmware
|
||||
retrieve and execute a <application>loader</application>, which
|
||||
in turn fetches and executes the actual kernel. For this boot
|
||||
process, you need to set up &man.rarpd.8; and &man.tftpd.8; (for
|
||||
the firmware) and &man.bootpd.8; (for the
|
||||
<application>loader</application>) on another networked system.
|
||||
The loader can fetch a kernel using TFTP or NFS. All of this is
|
||||
covered in detail below.</para>
|
||||
|
||||
<sect3 id="downloading">
|
||||
<title>Getting the Required Files</title>
|
||||
<sect3 id="downloading">
|
||||
<title>Getting the Required Files</title>
|
||||
|
||||
<para>For a network installation, you will need several files.
|
||||
First, you will need to download a &os;/&arch; loader for
|
||||
&man.tftpd.8; to serve to your &arch; client. The loader
|
||||
will use either TFTP or NFS to retrieve the &os; kernel from
|
||||
the netboot server. There is a separate loader for each of
|
||||
these methods (i.e. a loader for TFTP and a loader for NFS).
|
||||
You should download one of the following files, as
|
||||
appropriate:</para>
|
||||
<para>For a network installation, you will need several files.
|
||||
First, you will need to download a &os;/&arch; loader for
|
||||
&man.tftpd.8; to serve to your &arch; client. The loader will
|
||||
use either TFTP or NFS to retrieve the &os; kernel from the
|
||||
netboot server. There is a separate loader for each of these
|
||||
methods (i.e. a loader for TFTP and a loader for NFS). You
|
||||
should download one of the following files, as
|
||||
appropriate:</para>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem><para><ulink url="&release.url;loader-tftp.gz"></ulink></para></listitem>
|
||||
<listitem><para><ulink url="&release.url;loader-nfs.gz"></ulink></para></listitem>
|
||||
</itemizedlist>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><ulink
|
||||
url="&release.url;loader-tftp.gz"></ulink></para>
|
||||
</listitem>
|
||||
|
||||
<para>A network installation also requires a kernel to be
|
||||
served to the netboot client. A suitable kernel can be
|
||||
found at
|
||||
<ulink url="&release.url;"></ulink>.</para>
|
||||
<listitem>
|
||||
<para><ulink
|
||||
url="&release.url;loader-nfs.gz"></ulink></para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
|
||||
<para>A network installation also requires a kernel to be served
|
||||
to the netboot client. A suitable kernel can be found at
|
||||
<ulink url="&release.url;"></ulink>.</para>
|
||||
<!-- XXX kernel filename?-->
|
||||
|
||||
<para>Finally, you will need a &man.tar.1; archive which
|
||||
contains the binaries and configuration files from the base
|
||||
system. This file is available from <ulink
|
||||
url="&release.url;distrib.tar.gz"></ulink>.</para>
|
||||
</sect3>
|
||||
<para>Finally, you will need a &man.tar.1; archive which
|
||||
contains the binaries and configuration files from the base
|
||||
system. This file is available from <ulink
|
||||
url="&release.url;distrib.tar.gz"></ulink>.</para>
|
||||
</sect3>
|
||||
|
||||
<!-- put the words "netboot server" in here -->
|
||||
<sect3>
|
||||
<title>rarpd</title>
|
||||
<sect3>
|
||||
<title>rarpd</title>
|
||||
|
||||
<para>You need to add the Ethernet address of your &os;/&arch;
|
||||
system to <filename>/etc/ethers</filename> on the netboot
|
||||
server. An entry looks like:</para>
|
||||
<para>You need to add the Ethernet address of your &os;/&arch;
|
||||
system to <filename>/etc/ethers</filename> on the netboot
|
||||
server. An entry looks like:</para>
|
||||
|
||||
<programlisting>0:3:ba:b:92:d4 your.host.name</programlisting>
|
||||
<programlisting>0:3:ba:b:92:d4 your.host.name</programlisting>
|
||||
|
||||
<para>The Ethernet address is usually displayed in the boot
|
||||
message.</para>
|
||||
<para>The Ethernet address is usually displayed in the boot
|
||||
message.</para>
|
||||
|
||||
<para>Make sure <hostid>your.host.name</hostid> is in
|
||||
<filename>/etc/hosts</filename> or has a valid DNS entry (or
|
||||
use an IP address). Then, start &man.rarpd.8; on a network
|
||||
interface that is on the same subnet as the &os;/&arch;
|
||||
system.</para>
|
||||
|
||||
</sect3>
|
||||
<para>Make sure <hostid>your.host.name</hostid> is in
|
||||
<filename>/etc/hosts</filename> or has a valid DNS entry (or
|
||||
use an IP address). Then, start &man.rarpd.8; on a network
|
||||
interface that is on the same subnet as the &os;/&arch;
|
||||
system.</para>
|
||||
</sect3>
|
||||
|
||||
<!-- put the words "netboot server" in here -->
|
||||
<sect3>
|
||||
<title>tftpd</title>
|
||||
<sect3>
|
||||
<title>tftpd</title>
|
||||
|
||||
<para>Activate &man.tftpd.8; in your &man.inetd.8;
|
||||
configuration by uncommenting the following line in
|
||||
<filename>/etc/inetd.conf</filename>:</para>
|
||||
<para>Activate &man.tftpd.8; in your &man.inetd.8;
|
||||
configuration by uncommenting the following line in
|
||||
<filename>/etc/inetd.conf</filename>:</para>
|
||||
|
||||
<programlisting>tftp dgram udp wait nobody /usr/libexec/tftpd tftpd /tftpboot</programlisting>
|
||||
<programlisting>tftp dgram udp wait nobody /usr/libexec/tftpd tftpd /tftpboot</programlisting>
|
||||
|
||||
<para>Copy the unpacked loader to your
|
||||
<filename>/tftpboot</filename> directory, and name it with
|
||||
the &os;/&arch; host's IP address in upper-case hexadecimal
|
||||
notation without dots (or use appropriately-named symbolic
|
||||
links). For example, your setup may look like this, for an
|
||||
IP address of
|
||||
<hostid>192.168.0.16</hostid>:</para>
|
||||
<para>Copy the unpacked loader to your
|
||||
<filename>/tftpboot</filename> directory, and name it with the
|
||||
&os;/&arch; host's IP address in upper-case hexadecimal
|
||||
notation without dots (or use appropriately-named symbolic
|
||||
links). For example, your setup may look like this, for an IP
|
||||
address of <hostid>192.168.0.16</hostid>:</para>
|
||||
|
||||
<screen> lrwx------ 1 tmm users 9 Jul 24 17:05 /tftpboot/C0A80010 -> boot/loader
|
||||
<screen> lrwx------ 1 tmm users 9 Jul 24 17:05 /tftpboot/C0A80010 -> boot/loader
|
||||
-rw-r--r-- 1 tmm users 1643021 Oct 20 18:04 /tftpboot/boot/loader</screen>
|
||||
|
||||
<para>If you have trouble booting, it is very helpful to use
|
||||
&man.tcpdump.1; to monitor the TFTP requests. This will
|
||||
allow you to see the file name you need to use for the
|
||||
loader. Error replies by the TFTP server are most often due
|
||||
to incorrect file permissions.</para>
|
||||
</sect3>
|
||||
<para>If you have trouble booting, it is very helpful to use
|
||||
&man.tcpdump.1; to monitor the TFTP requests. This will allow
|
||||
you to see the file name you need to use for the loader.
|
||||
Error replies by the TFTP server are most often due to
|
||||
incorrect file permissions.</para>
|
||||
</sect3>
|
||||
|
||||
<!-- put the words "netboot server" in here -->
|
||||
<sect3>
|
||||
<title>Setting up bootpd/dhcpd</title>
|
||||
<sect3>
|
||||
<title>Setting up bootpd/dhcpd</title>
|
||||
|
||||
<para>You can use either BOOTP or DHCP (both not both) to
|
||||
provide some parameters to the boot loader, such as a
|
||||
machine's IP address. If you are using another &os; machine
|
||||
as a netboot server, the BOOTP functionality is provided by
|
||||
&man.bootpd.8;, which is a part of the &os; base system.
|
||||
Several DHCP servers are provided in the &os; Ports
|
||||
Collection.</para>
|
||||
<para>You can use either BOOTP or DHCP (both not both) to
|
||||
provide some parameters to the boot loader, such as a
|
||||
machine's IP address. If you are using another &os; machine
|
||||
as a netboot server, the BOOTP functionality is provided by
|
||||
&man.bootpd.8;, which is a part of the &os; base system.
|
||||
Several DHCP servers are provided in the &os; Ports
|
||||
Collection.</para>
|
||||
|
||||
<para>If you are going to use &man.bootpd.8;, create entries
|
||||
for your &os;/&arch; system in the server's
|
||||
<filename>/etc/bootptab</filename> (see &man.bootptab.5; for
|
||||
more details):</para>
|
||||
<para>If you are going to use &man.bootpd.8;, create entries for
|
||||
your &os;/&arch; system in the server's
|
||||
<filename>/etc/bootptab</filename> (see &man.bootptab.5; for
|
||||
more details):</para>
|
||||
|
||||
<programlisting>.default:\
|
||||
<programlisting>.default:\
|
||||
:bf="kernel":dn=local:ds=<replaceable>name-server-ip-address</replaceable>:\
|
||||
:gw=<replaceable>gateway-ip-address</replaceable>:ht=ether:hd="/tftpboot/boot/kernel":hn:\
|
||||
:sa="<replaceable>tftp-server-ip-address</replaceable>":\
|
||||
@ -248,29 +247,30 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</screen>
|
||||
<replaceable>name-of-the-entry</replaceable>:\
|
||||
ha=<replaceable>sparc64-ethernet-address</replaceable>:ip=<replaceable>sparc64-ip-address</replaceable>:tc=.default</programlisting>
|
||||
|
||||
<para>The Ethernet address must be the same as the one in the
|
||||
TFTP example above, but it is specified hexadecimal notation
|
||||
without colons (for the example above, this would be
|
||||
<literal>0003ba0b92d4</literal>). NFS/TFTP specific entries
|
||||
can be omitted if the given method is not used. The strings
|
||||
given in the <literal>hd</literal> and
|
||||
<literal>bf</literal> properties are concatenated to give the boot
|
||||
file name. If your kernel is named differently or you use
|
||||
another directory, change these values as required. If you
|
||||
are booting using NFS, remove the <literal>bf</literal>
|
||||
and <literal>hd</literal> settings (or change them to
|
||||
specify the directory and file inside the NFS root hierarchy
|
||||
in which the kernel will reside). The name of the host entry
|
||||
is conventionally the host name without the domain appended.</para>
|
||||
<para>The Ethernet address must be the same as the one in the
|
||||
TFTP example above, but it is specified hexadecimal notation
|
||||
without colons (for the example above, this would be
|
||||
<literal>0003ba0b92d4</literal>). NFS/TFTP specific entries
|
||||
can be omitted if the given method is not used. The strings
|
||||
given in the <literal>hd</literal> and <literal>bf</literal>
|
||||
properties are concatenated to give the boot file name. If
|
||||
your kernel is named differently or you use another directory,
|
||||
change these values as required. If you are booting using
|
||||
NFS, remove the <literal>bf</literal> and
|
||||
<literal>hd</literal> settings (or change them to specify the
|
||||
directory and file inside the NFS root hierarchy in which the
|
||||
kernel will reside). The name of the host entry is
|
||||
conventionally the host name without the domain
|
||||
appended.</para>
|
||||
|
||||
<para>For a DHCP server, add an entry similar to the following
|
||||
to your <filename>dhcpd.conf</filename> file. An example
|
||||
entry for <application>ISC DHCP</application> version 2
|
||||
(available in the &os; Ports Collection as <filename
|
||||
role="package">net/isc-dhcp2</filename>) is shown
|
||||
below:</para>
|
||||
<para>For a DHCP server, add an entry similar to the following
|
||||
to your <filename>dhcpd.conf</filename> file. An example
|
||||
entry for <application>ISC DHCP</application> version 2
|
||||
(available in the &os; Ports Collection as <filename
|
||||
role="package">net/isc-dhcp2</filename>) is shown
|
||||
below:</para>
|
||||
|
||||
<programlisting>host <replaceable>name-of-entry</replaceable> {
|
||||
<programlisting>host <replaceable>name-of-entry</replaceable> {
|
||||
hardware ethernet <replaceable>sparc64-ethernet-address</replaceable>;
|
||||
option host-name "<replaceable>sparc64-fully-qualified-domain-name</replaceable>";
|
||||
fixed-address <replaceable>sparc64-ip-address</replaceable>;
|
||||
@ -279,18 +279,18 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</screen>
|
||||
option root-path "<replaceable>tftp-server-ip-address</replaceable>:<replaceable>nfs-root-directory</replaceable>";
|
||||
}</programlisting>
|
||||
|
||||
<para>The <literal>filename</literal> option corresponds to
|
||||
the concatenation of <literal>hd</literal> and
|
||||
<literal>bf</literal> in
|
||||
<filename>/etc/bootptab</filename>. The Ethernet address is
|
||||
specified in hexadecimal with colons, just like in the
|
||||
&man.rarpd.8; example above. <literal>options
|
||||
root-path</literal> corresponds to <literal>rp</literal> in
|
||||
<filename>/etc/bootptab</filename>. If the name given in
|
||||
<literal>option host-name</literal> is resolvable, i.e. has
|
||||
a DNS entry or is associated with an address in
|
||||
<filename>/etc/hosts</filename>, the
|
||||
<literal>fixed-address</literal> specification can be omitted.</para>
|
||||
<para>The <literal>filename</literal> option corresponds to the
|
||||
concatenation of <literal>hd</literal> and
|
||||
<literal>bf</literal> in <filename>/etc/bootptab</filename>.
|
||||
The Ethernet address is specified in hexadecimal with colons,
|
||||
just like in the &man.rarpd.8; example above.
|
||||
<literal>options root-path</literal> corresponds to
|
||||
<literal>rp</literal> in <filename>/etc/bootptab</filename>.
|
||||
If the name given in <literal>option host-name</literal> is
|
||||
resolvable, i.e. has a DNS entry or is associated with an
|
||||
address in <filename>/etc/hosts</filename>, the
|
||||
<literal>fixed-address</literal> specification can be
|
||||
omitted.</para>
|
||||
</sect3>
|
||||
|
||||
<sect3>
|
||||
@ -300,35 +300,35 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</screen>
|
||||
next step is to copy the kernel (obtained during the steps of
|
||||
<xref linkend="downloading">) to an appropriate directory.
|
||||
There are two ways of retrieving a kernel over the network:
|
||||
TFTP and NFS. (You specified one of these two alternatives
|
||||
by picking a loader.)</para>
|
||||
TFTP and NFS. (You specified one of these two alternatives by
|
||||
picking a loader.)</para>
|
||||
|
||||
<para>For both TFTP and NFS, the loader will use the parameters
|
||||
that it obtained via BOOTP or DHCP to find the kernel.</para>
|
||||
|
||||
<sect4>
|
||||
<title>Loading the Kernel over TFTP</title>
|
||||
<title>Loading the Kernel over TFTP</title>
|
||||
|
||||
<para>Place the kernel in the directory you specified using
|
||||
<literal>bf</literal> and <literal>hd</literal> in the
|
||||
<filename>/etc/bootptab</filename> or the
|
||||
<literal>filename</literal> parameter to
|
||||
<filename>dhcpd.conf</filename>.</para>
|
||||
<para>Place the kernel in the directory you specified using
|
||||
<literal>bf</literal> and <literal>hd</literal> in the
|
||||
<filename>/etc/bootptab</filename> or the
|
||||
<literal>filename</literal> parameter to
|
||||
<filename>dhcpd.conf</filename>.</para>
|
||||
</sect4>
|
||||
|
||||
<sect4>
|
||||
<title>Loading the Kernel over NFS</title>
|
||||
<title>Loading the Kernel over NFS</title>
|
||||
|
||||
<para>Export the directory that was specified by the
|
||||
<literal>rp</literal> property in
|
||||
<filename>/etc/bootptab</filename> or the
|
||||
<literal>root-path</literal> parameter in
|
||||
<filename>dhcpd.conf</filename> (see &man.exports.5;).
|
||||
Copy the kernel to the directory you specified using
|
||||
<literal>bf</literal> and <literal>hd</literal> in the
|
||||
<filename>/etc/bootptab</filename> or the
|
||||
<literal>filename</literal> parameter to
|
||||
<filename>dhcpd.conf</filename>.</para>
|
||||
<para>Export the directory that was specified by the
|
||||
<literal>rp</literal> property in
|
||||
<filename>/etc/bootptab</filename> or the
|
||||
<literal>root-path</literal> parameter in
|
||||
<filename>dhcpd.conf</filename> (see &man.exports.5;). Copy
|
||||
the kernel to the directory you specified using
|
||||
<literal>bf</literal> and <literal>hd</literal> in the
|
||||
<filename>/etc/bootptab</filename> or the
|
||||
<literal>filename</literal> parameter to
|
||||
<filename>dhcpd.conf</filename>.</para>
|
||||
</sect4>
|
||||
</sect3>
|
||||
|
||||
@ -347,33 +347,33 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</screen>
|
||||
distribution on the &arch; client's local disk.</para>
|
||||
|
||||
<para>Using whatever editing tools you have on the netboot
|
||||
server, you probably will want to edit the &arch;'s
|
||||
<filename>/etc/fstab</filename> and
|
||||
<filename>/etc/rc.conf</filename> and set a
|
||||
<username>root</username> password.</para>
|
||||
server, you probably will want to edit the &arch;'s
|
||||
<filename>/etc/fstab</filename> and
|
||||
<filename>/etc/rc.conf</filename> and set a
|
||||
<username>root</username> password.</para>
|
||||
</sect3>
|
||||
|
||||
<sect3>
|
||||
<title>Booting</title>
|
||||
|
||||
<para>If all goes well, you can now boot the &os; on your &arch;
|
||||
machine by dropping into the PROM prompt as described in <xref
|
||||
linkend="getting-to-prom-prompt">. Now, just type
|
||||
<command>boot net</command> and the system should
|
||||
boot. Specifically, the loader is retrieved via TFTP, it then
|
||||
does a BOOTP request and will proceed to load the kernel
|
||||
(either using TFTP or NFS, depending on your choice of
|
||||
loader). Then, it should wait 10 seconds for user input and
|
||||
proceed to execute the kernel.</para>
|
||||
machine by dropping into the PROM prompt as described in <xref
|
||||
linkend="getting-to-prom-prompt">. Now, just type
|
||||
<command>boot net</command> and the system should boot.
|
||||
Specifically, the loader is retrieved via TFTP, it then does a
|
||||
BOOTP request and will proceed to load the kernel (either
|
||||
using TFTP or NFS, depending on your choice of loader). Then,
|
||||
it should wait 10 seconds for user input and proceed to
|
||||
execute the kernel.</para>
|
||||
|
||||
<para>If something does not work in between, and you suspect
|
||||
TFTP/NFS/BOOTP problems, <application>Ethereal</application>
|
||||
(available in the &os; Ports Collection as <filename
|
||||
role="package"> net/ethereal</filename>) is usually
|
||||
helpful. The most common problems are related to bad file
|
||||
permissions. Also note that &man.rarpd.8; will not answer to
|
||||
packets under some circumstances, refer to the manual page for
|
||||
details.</para>
|
||||
TFTP/NFS/BOOTP problems, <application>Ethereal</application>
|
||||
(available in the &os; Ports Collection as <filename
|
||||
role="package"> net/ethereal</filename>) is usually helpful.
|
||||
The most common problems are related to bad file permissions.
|
||||
Also note that &man.rarpd.8; will not answer to packets under
|
||||
some circumstances, refer to the manual page for
|
||||
details.</para>
|
||||
</sect3>
|
||||
</sect2>
|
||||
|
||||
@ -384,14 +384,14 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</screen>
|
||||
label the disks you want to use with &os; from Solaris.</para>
|
||||
|
||||
<para>&os; disk labels must currently be created by hand, as
|
||||
&man.sysinstall.8; is not yet available on &os;/&arch;. Please
|
||||
&man.sysinstall.8; is not yet available on &os;/&arch;. Please
|
||||
refer to the <ulink
|
||||
url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/">FreeBSD
|
||||
Handbook</ulink> for more information about labels and special
|
||||
partitions.</para>
|
||||
|
||||
<para>On &os;/&arch;, a Sun compatibility label is embedded in the
|
||||
&os; label; this is needed for the PROM to boot from disk. This
|
||||
&os; label; this is needed for the PROM to boot from disk. This
|
||||
imposes an additional restriction on the disk label format:
|
||||
partitions are required to start on a cylinder boundary.</para>
|
||||
|
||||
@ -400,22 +400,21 @@ Ethernet address 0:3:ba:b:92:d4, Host ID: 830b92d4.</screen>
|
||||
|
||||
<procedure>
|
||||
<step>
|
||||
<para>Run
|
||||
<command>disklabel -w -r <replaceable>device</replaceable> auto</command>
|
||||
to create a basic disk label. The third argument you need
|
||||
specify here is just the name of the device, not the complete
|
||||
path to the device node (e.g. <devicename>ad0</devicename> for
|
||||
the first ATA disk).</para>
|
||||
<para>Run <command>disklabel -w -r
|
||||
<replaceable>device</replaceable> auto</command> to create a
|
||||
basic disk label. The third argument you need specify here
|
||||
is just the name of the device, not the complete path to the
|
||||
device node (e.g. <devicename>ad0</devicename> for the first
|
||||
ATA disk).</para>
|
||||
</step>
|
||||
|
||||
<step>
|
||||
<para>
|
||||
Use
|
||||
<command>disklabel -e <replaceable>device</replaceable></command>
|
||||
to open an editor in which you can edit the disk
|
||||
label. The information presented to you should look like:</para>
|
||||
<para> Use <command>disklabel -e
|
||||
<replaceable>device</replaceable></command> to open an
|
||||
editor in which you can edit the disk label. The
|
||||
information presented to you should look like:</para>
|
||||
|
||||
<screen># /dev/ad6c:
|
||||
<screen># /dev/ad6c:
|
||||
type: unknown
|
||||
disk: amnesiac
|
||||
label:
|
||||
@ -438,24 +437,28 @@ drivedata: 0
|
||||
# size offset fstype [fsize bsize bps/cpg]
|
||||
c: 80418240 0 unused 0 0 # (Cyl. 0 - 79779)</screen>
|
||||
|
||||
<para>You can now add new partitions in the same format as the already
|
||||
present line. Using <literal>*</literal> in the offset field makes the procedure
|
||||
easier; please refer to the &man.disklabel.8; manual page for more
|
||||
information.</para>
|
||||
<para>You can now add new partitions in the same format as the
|
||||
already present line. Using <literal>*</literal> in the
|
||||
offset field makes the procedure easier; please refer to the
|
||||
&man.disklabel.8; manual page for more information.</para>
|
||||
|
||||
<para>To make sure the restriction mentioned above is met, the
|
||||
size of each partition must be a multiple of the number of
|
||||
sectors per cylinder as shown in the information that is
|
||||
presented in the editor (1008 in the example above).</para>
|
||||
<para>To make sure the restriction mentioned above is met, the
|
||||
size of each partition must be a multiple of the number of
|
||||
sectors per cylinder as shown in the information that is
|
||||
presented in the editor (1008 in the example above).</para>
|
||||
|
||||
<para>When you are done, save your changes and quit the
|
||||
editor. This will cause the disk label to be written. </para>
|
||||
<para>When you are done, save your changes and quit the
|
||||
editor.i This will cause the disk label to be
|
||||
written.</para>
|
||||
|
||||
<warning><para>This procedure will overwrite any disk label that
|
||||
may be already present on the disk. Any existing filesystems on
|
||||
this disk must have their respective partition entries in the
|
||||
old and new label match <emphasis>exactly</emphasis>, or they
|
||||
will be lost.</para></warning>
|
||||
<warning>
|
||||
<para>This procedure will overwrite any disk label that may
|
||||
be already present on the disk. Any existing filesystems
|
||||
on this disk must have their respective partition entries
|
||||
in the old and new label match
|
||||
<emphasis>exactly</emphasis>, or they will be
|
||||
lost.</para>
|
||||
</warning>
|
||||
|
||||
<para>If you want to double-check that your partitions end on
|
||||
cylinder boundaries, run <command>disklabel -e
|
||||
@ -470,44 +473,45 @@ drivedata: 0
|
||||
</step>
|
||||
|
||||
<step>
|
||||
<para>Use <command>disklabel -B</command> if you want to make the
|
||||
disk bootable for &os;/&arch;.</para>
|
||||
<para>Use <command>disklabel -B</command> if you want to make
|
||||
the disk bootable for &os;/&arch;.</para>
|
||||
|
||||
<warning><para>Using <command>disklabel -B</command> on a disk
|
||||
will overwrite any preexisting boot block, so it will likely
|
||||
render any other operating system installed on the same disk
|
||||
unbootable.</para></warning>
|
||||
<warning>
|
||||
<para>Using <command>disklabel -B</command> on a disk will
|
||||
overwrite any preexisting boot block, so it will likely
|
||||
render any other operating system installed on the same
|
||||
disk unbootable.</para>
|
||||
</warning>
|
||||
|
||||
<para>If you do not want to overwrite the boot block, it is
|
||||
possible to load the <application>loader</application> via TFTP
|
||||
as described above, but have it boot the kernel from disk. This
|
||||
requires a special loader binary, which is available at
|
||||
<ulink
|
||||
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/development/sparc64/loader-ufs.gz"></ulink>
|
||||
</para>
|
||||
<para>If you do not want to overwrite the boot block, it is
|
||||
possible to load the <application>loader</application> via
|
||||
TFTP as described above, but have it boot the kernel from
|
||||
disk. This requires a special loader binary, which is
|
||||
available at <ulink
|
||||
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/development/sparc64/loader-ufs.gz"></ulink></para>
|
||||
</step>
|
||||
</procedure>
|
||||
|
||||
</sect2>
|
||||
|
||||
|
||||
<sect2 id="creating-root-filesystem">
|
||||
<title>Creating the Root Fileystem</title>
|
||||
|
||||
<para>If you want to boot from a local disk, you will need
|
||||
to create a root file system to hold the base system binaries and
|
||||
<para>If you want to boot from a local disk, you will need to
|
||||
create a root file system to hold the base system binaries and
|
||||
configuration files (and optionally other file systems mounted
|
||||
in places such as <filename>/usr</filename> and
|
||||
<filename>/var</filename>).</para>
|
||||
|
||||
<para>The kernel contains support for Sun disklabels, so you can
|
||||
use Solaris disks, which may even be prepared using
|
||||
<application>newfs</application> under Solaris. NetBSD disk
|
||||
<application>newfs</application> under Solaris. NetBSD disk
|
||||
labels and file systems are also usable from &os;.</para>
|
||||
|
||||
<warning><para>Do <emphasis>not</emphasis> run Solaris
|
||||
<application>fsck</application> on file systems modified by
|
||||
&os;. Doing so will damage the file
|
||||
permissions.</para></warning>
|
||||
<warning>
|
||||
<para>Do <emphasis>not</emphasis> run Solaris
|
||||
<application>fsck</application> on file systems modified by
|
||||
&os;. Doing so will damage the file permissions.</para>
|
||||
</warning>
|
||||
|
||||
<para>To create file systems and to install the base system, boot
|
||||
from CDROM or via NFS and create a disk label as described in
|
||||
@ -517,23 +521,24 @@ drivedata: 0
|
||||
root partition into <filename>/etc/fstab</filename> yet, you may
|
||||
need to specify your root partition on the mountroot prompt when
|
||||
booting (use a format like
|
||||
<command>ufs:<replaceable>disk</replaceable><replaceable>partition</replaceable></command>, i.e. leave the
|
||||
slice specification out). If the kernel does automatically
|
||||
attempt to boot from another file system, press a key other than
|
||||
<keycap>Enter</keycap> on the <application>loader</application>
|
||||
prompt:</para>
|
||||
<screen>Hit [Enter] to boot immediately, or any other key for command prompt.</screen>
|
||||
<para>Then, boot the kernel using <command>boot -a -s</command>, which
|
||||
will cause the kernel to ask you for the root partition and
|
||||
then boot into single-user mode. Once the root file system has
|
||||
been entered into <filename>/etc/fstab</filename>, it should be
|
||||
automatically mounted as <filename>/</filename> on the next
|
||||
<command>ufs:<replaceable>disk</replaceable><replaceable>partition</replaceable></command>,
|
||||
i.e. leave the slice specification out). If the kernel does
|
||||
automatically attempt to boot from another file system, press a
|
||||
key other than <keycap>Enter</keycap> on the
|
||||
<application>loader</application> prompt:</para>
|
||||
|
||||
<screen>Hit [Enter] to boot immediately, or any other key for command prompt.</screen>
|
||||
|
||||
<para>Then, boot the kernel using <command>boot -a -s</command>,
|
||||
which will cause the kernel to ask you for the root partition
|
||||
and then boot into single-user mode. Once the root file system
|
||||
has been entered into <filename>/etc/fstab</filename>, it should
|
||||
be automatically mounted as <filename>/</filename> on the next
|
||||
boot.</para>
|
||||
|
||||
<para>If you are booting over the network (via NFS), the above
|
||||
BOOTP entries should suffice to have the kernel find and mount
|
||||
the root filesystem via NFS.</para>
|
||||
|
||||
</sect2>
|
||||
|
||||
<sect2 id="installing-base-system">
|
||||
@ -541,20 +546,19 @@ drivedata: 0
|
||||
|
||||
<para>If you booted the kernel from the network, you downloaded a
|
||||
&man.tar.1; archive with the base system and exported it from
|
||||
the netboot server via NFS. You can unpack this same archive
|
||||
to your local disk to create a stand-alone system (remember to
|
||||
copy the kernel over as well).</para>
|
||||
the netboot server via NFS. You can unpack this same archive to
|
||||
your local disk to create a stand-alone system (remember to copy
|
||||
the kernel over as well).</para>
|
||||
|
||||
<para>If you booted from CDROM, the same archive is available in
|
||||
<filename>/root/</filename> on the CDROM.</para>
|
||||
|
||||
<para>Before booting the system stand-alone, you will want to edit
|
||||
<filename>/etc/fstab</filename> and
|
||||
<filename>/etc/rc.conf</filename> and set a
|
||||
<username>root</username> password.</para>
|
||||
|
||||
<para>Note that some programs from the base system may not be
|
||||
present in the archive, or may not work properly yet.</para>
|
||||
</sect2>
|
||||
<para>Before booting the system stand-alone, you will want to edit
|
||||
<filename>/etc/fstab</filename> and
|
||||
<filename>/etc/rc.conf</filename> and set a
|
||||
<username>root</username> password.</para>
|
||||
|
||||
<para>Note that some programs from the base system may not be
|
||||
present in the archive, or may not work properly yet.</para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user