summaryrefslogtreecommitdiffstats
path: root/release/doc
diff options
context:
space:
mode:
authorue <ue@FreeBSD.org>2002-04-18 01:27:19 +0000
committerue <ue@FreeBSD.org>2002-04-18 01:27:19 +0000
commit431577d47c148bc21bb3bb402bf92354832c65e1 (patch)
treeb2313fd877eb157c1c374b7d66dd8926a058c8af /release/doc
parent7316f95396198d32b1b30c51d5648217b0006a5b (diff)
downloadFreeBSD-src-431577d47c148bc21bb3bb402bf92354832c65e1.zip
FreeBSD-src-431577d47c148bc21bb3bb402bf92354832c65e1.tar.gz
Whitespace fix after the restructuring, no content changes
Diffstat (limited to 'release/doc')
-rw-r--r--release/doc/en_US.ISO8859-1/installation/sparc64/install.sgml658
1 files changed, 331 insertions, 327 deletions
diff --git a/release/doc/en_US.ISO8859-1/installation/sparc64/install.sgml b/release/doc/en_US.ISO8859-1/installation/sparc64/install.sgml
index 1c71ded..6af1820 100644
--- a/release/doc/en_US.ISO8859-1/installation/sparc64/install.sgml
+++ b/release/doc/en_US.ISO8859-1/installation/sparc64/install.sgml
@@ -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>
-
- <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
+
+ <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>
+
+ <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>
-
- 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>
- <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>
-
- <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>
+ <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>
+
+ <screenco>
+ <areaspec>
+ <area id="prompt-single" coords="1 5">
+ <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>
+
+ <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>
-
- <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>
-
- <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>
-
- <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>
-
+ <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>
+
+ <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>
+
+ <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>
-
- <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>
+ <sect3>
+ <title>rarpd</title>
- <programlisting>0:3:ba:b:92:d4 your.host.name</programlisting>
+ <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>The Ethernet address is usually displayed in the boot
- message.</para>
+ <programlisting>0:3:ba:b:92:d4 your.host.name</programlisting>
- <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>
+ <para>The Ethernet address is usually displayed in the boot
+ message.</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>
-
- <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>
-
- <programlisting>.default:\
+ <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>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:\
: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>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> {
+ <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>
+
+ <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>
-
- <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>
+ <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>
</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>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>
-
- <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>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>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>
<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>
-
- <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>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>
+
+ <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>
OpenPOWER on IntegriCloud