<chapter id="netinstallref-28995"><title>Installing From the Network (Command Reference)</title><highlights><para>This chapter lists the commands used to set up network installations.
This chapter includes the following topics.</para><itemizedlist><listitem><para><olink targetptr="netinstall-91595" remap="internal">Network Installation Commands</olink></para>
</listitem><listitem><para><olink targetptr="gazva" remap="internal">GRUB Menu Commands for Installation</olink></para>
</listitem>
</itemizedlist>
</highlights><sect1 id="netinstall-91595"><title>Network Installation Commands</title><para>This table describes the commands you use to install Solaris software
over the network. The table also indicates to which platform the commands
apply.</para><informaltable frame="topbot" pgwide="1"><tgroup cols="3" colsep="0" rowsep="0"><colspec colname="column1" colwidth="132*"/><colspec colname="column2" colwidth="44*"/><colspec colname="column3" colwidth="220*"/><thead><row rowsep="1"><entry><para>Command</para>
</entry><entry><para>Platform</para>
</entry><entry><para>Description</para>
</entry>
</row>
</thead><tbody><row><entry><para><command>add_install_client</command></para>
</entry><entry><para>All</para>
</entry><entry><para>A command that adds network installation information about a system
to an install server or boot server from the network. The <command>add_install_client</command>(1M) man page contains more information.</para>
</entry>
</row><row><entry><para><command>setup_install_server</command></para>
</entry><entry><para>All</para>
</entry><entry><para>A script that copies the current Solaris release DVD or CDs to an install server's
local disk or copies the boot software to a boot server. The <olink targetdoc="refman1m" targetptr="setup-install-server-1m" remap="external"><citerefentry><refentrytitle>setup_install_server</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink> man page contains more information.</para>
</entry>
</row><row><entry><para>(CD media only) <command>add_to_install_server</command> </para>
</entry><entry><para>All</para>
</entry><entry><para>A script that copies additional packages within a product tree on the
CDs to the local disk on an existing install server. The <olink targetdoc="refman1m" targetptr="add-to-install-server-1m" remap="external"><citerefentry><refentrytitle>add_to_install_server</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink> man page contains more information.</para>
</entry>
</row><row><entry><para><command>mount</command> </para>
</entry><entry><para>All</para>
</entry><entry><para>A command that enables the mounting of file systems and shows the mounted
file systems, including the file system on the Solaris DVD or Solaris Software and Solaris Languages CDs.
The <olink targetdoc="refman1m" targetptr="mount-1m" remap="external"><citerefentry><refentrytitle>mount</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink> man
page contains more information.</para>
</entry>
</row><row><entry><para><command>showmount -e</command> </para>
</entry><entry><para>All</para>
</entry><entry><para>A command that lists all the shared file systems that are located on
a remote host. The <olink targetdoc="refman1m" targetptr="showmount-1m" remap="external"><citerefentry><refentrytitle>showmount</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink> man
page contains more information.</para>
</entry>
</row><row><entry><para><command>uname
-i</command>    </para>
</entry><entry><para>All</para>
</entry><entry><para>A command for determining a system's platform name, for example, SUNW,Ultra-5_10,
or i86pc. You might need the system's platform name when you install the Solaris
software. The <olink targetdoc="refman1" targetptr="uname-1" remap="external"><citerefentry><refentrytitle>uname</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink> man
page contains more information.</para>
</entry>
</row><row><entry><para><command>patchadd -C</command> <replaceable>net_install_image</replaceable></para>
</entry><entry><para>All</para>
</entry><entry><para>A command to add patches to the files that are located in the miniroot, <filename>Solaris_11 /Tools/Boot</filename>, on a net installation image of a DVD or CD that is created by <command>setup_install_server</command>. This facility enables you to patch Solaris
installation commands and other miniroot-specific commands. <replaceable>net_install_image</replaceable> is the absolute path name of the net installation image. The <olink targetdoc="refman1m" targetptr="patchadd-1m" remap="external"><citerefentry><refentrytitle>patchadd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink> man page
contains more information.</para><caution><para>Don't use the <command>patchadd -C</command> command unless
you have read the <filename>Patch README</filename> instructions or have contacted
your local Sun support office.</para>
</caution>
</entry>
</row><row><entry><para><command>reset</command>   </para>
</entry><entry><para>SPARC</para>
</entry><entry><para>An Open Boot PROM command for resetting the system and rebooting the
machine. Or, if you boot and see a series of error messages about I/O interrupts,
press the Stop and A keys at the same time, and then type <command>reset</command> at
the <literal>ok</literal> or <literal>></literal> PROM prompt.</para>
</entry>
</row><row><entry><para><command>banner</command> 
 </para>
</entry><entry><para>SPARC</para>
</entry><entry><para>An Open Boot PROM command that displays system information, such as
model name, Ethernet address, and memory installed. You can issue this command
only at the <literal>ok</literal> or <literal>></literal> PROM prompt.</para>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect1><sect1 id="gazva" arch="x86"><title>GRUB Menu Commands for Installation</title><para><emphasis role="strong">Starting with the Solaris Express Developer Edition 5/07 release,</emphasis> changes
have been made to GRUB that enable the boot loader to directly load and boot
the <literal>unix</literal> kernel. The GRUB multiboot module is no longer
used. This implementation integrates the previous multiboot functionality
directly into the platform-specific <literal>unix</literal> kernel module.
These changes reduce the time, as well as memory requirements, that are needed
to boot the Solaris OS.</para><para>Two new keywords, <literal>kernel$</literal> and <literal>module$</literal>, have been added to GRUB to assist in creating <filename>menu.lst</filename> entries that work with either 32-bit or 64-bit systems. Another
new keyword, <literal>$ISADIR</literal>, displays 32&ndash;bit and 64&ndash;bit
information in the boot command. In addition, the <command>bootadm</command> command
that manages the <filename>menu.lst</filename> file has been modified to create
file entries for the platform-specific <literal>unix</literal> module that
is loaded by GRUB. During an upgrade, the <command>bootadm</command> command
converts any existing multiboot <filename>menu.lst</filename> entries to <literal>unix</literal> entries.</para><note><para>These new keywords are used in normal
installations. However, the miniroot is 32-bit only. Therefore, failsafe installations
do not use the new keywords.</para>
</note><para>For overview and task-related
information, see <olink targetdoc="sysadv1" targetptr="grubtasks-1" remap="external">Chapter 11, <citetitle remap="chapter">Administering the GRUB Bootloader (Tasks),</citetitle> in <citetitle remap="book">System Administration Guide: Basic Administration</citetitle></olink>.
See also <olink targetdoc="sysadv1" targetptr="hbx86boot-68676" remap="external">Chapter 12, <citetitle remap="chapter">Booting a Solaris System With GRUB (Tasks),</citetitle> in <citetitle remap="book">System Administration Guide: Basic Administration</citetitle></olink>.</para><para>For more information, see the <citerefentry><refentrytitle>boot</refentrytitle><manvolnum>1M</manvolnum></citerefentry> and <citerefentry><refentrytitle>bootadm</refentrytitle><manvolnum>1M</manvolnum></citerefentry> man pages.</para><para>You can customize the network boot and installation of your system by editing
the commands in the GRUB menu. This section describes several commands and
arguments you can insert in the commands in the GRUB menu.</para><para>In the GRUB menu, you can access the GRUB command line by typing b at
the prompt. A command line that is similar to the following output is displayed.</para><screen>kernel$ /I86PC.Solaris_11-30/platform/i86pc/$ISADIR/kernel/unix \
     -B install_media=192.168.79.61:/export/Solaris_11-30 
module$ /I86PC.Solaris_11-30/boot_archive</screen><para>You can edit this command line to customize your boot and installation.
The following list describes several common commands you might want to use.
For a complete list of boot arguments that you can use with the <option>B</option> option,
see the <olink targetdoc="refman1m" targetptr="eeprom-1m" remap="external"><citerefentry><refentrytitle>eeprom</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink> man
page.</para><note><para>To add multiple arguments with the <option>B</option> option,
separate the arguments with a comma.</para>
</note><table frame="topbot" pgwide="1" id="gazua" arch="x86"><title>GRUB Menu Commands
and Options</title><tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="14.68*"/><colspec colwidth="42.26*"/><thead><row rowsep="1"><entry valign="top"><para>Command/Option</para>
</entry><entry valign="top"><para>Description and Examples</para>
</entry>
</row>
</thead><tbody><row><entry><para><literal>kernel$</literal> and <literal>module$</literal></para>
</entry><entry><para><emphasis role="strong">Starting with the Solaris Express Developer
Edition 5/07 release,</emphasis> enable GRUB to determine 32-bit or 64-bit
hardware capacity. Results are displayed by using the <literal>$ISADIR</literal> keyword.</para><note><para>These new keywords are used in normal installations. However,
the miniroot is 32-bit only. Therefore, failsafe installations do not display
these keywords.</para>
</note>
</entry>
</row><row><entry><para><literal>$ISADIR</literal></para>
</entry><entry><para><emphasis role="strong">Starting with the Solaris Express Developer
Edition 5/07 release,</emphasis> resolves to <literal>amd64</literal> for
64-bit hardware and to null for 32-bit hardware.</para>
</entry>
</row><row><entry><para><command>install</command></para>
</entry><entry><para>Insert this option before the <option>B</option> option to perform a
custom JumpStart installation.</para><screen>kernel$ /Solaris_11_x86/kernel/unix <userinput>install</userinput> 
-B install_media=192.168.2.1:/export/cdrom0/boot
module /platform/i86pc/boot_archive</screen>
</entry>
</row><row><entry><para><replaceable>url</replaceable>|<command>ask</command></para>
</entry><entry><para>Specifies the location of the custom JumpStart files or prompts you
for the location. Insert either option with the <command>install</command> option.</para><itemizedlist><listitem><para><replaceable>url</replaceable> - Specifies the path to the
files. You can specify a URL for files that are located on an HTTP or HTTPS server:</para><screen>http://<replaceable>server_name:IP_address/jumpstart_dir_path/</replaceable>
<replaceable>compressed_config_file&amp;proxy_info</replaceable></screen><itemizedlist><listitem><para>If you placed a <filename>sysidcfg</filename> file in the
compressed configuration file, you must specify the IP address of the server
that contains the file, as in the following example:</para><screen>kernel$ /Solaris_11_x86/kernel/unix <userinput>install 
http://192.168.2.1/jumpstart/config.tar</userinput> 
-B install_media=192.168.2.1:/export/cdrom0/boot
module /platform/i86pc/boot_archive</screen>
</listitem><listitem><para>If you saved the compressed configuration file on an HTTP
server that is behind a firewall, you must use a proxy specifier during boot.
 You do not need to specify an IP address for the server that contains the
file.  You must specify an IP address for the proxy server, as in the following
example:</para><screen>kernel$ /Solaris_11_x86/kernel/unix <userinput>install 
http://www.shadow.com/jumpstart/config.tar&amp;proxy=131.141.6.151</userinput> 
-B install_media=192.168.2.1:/export/cdrom0/boot
module /platform/i86pc/boot_archive</screen>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</entry>
</row><row><entry><para><replaceable>url</replaceable>|<command>ask</command> <emphasis>(continued)</emphasis></para>
</entry><entry><itemizedlist><listitem><para><literal>ask</literal> - When used with the <command>install</command> option,
specifies that the installation program prompt you to type the location of
the compressed configuration file after the system boots and connects to the
network. If you use this option, you are not able to do a completely hands
off JumpStart installation.</para><para>If you bypass the prompt by pressing
Return, the Solaris installation program interactively configures the network
parameters.  The installation program then prompts you for the location of
the compressed configuration file.</para><para>The following example performs
a custom JumpStart and boots from a network installation image. You are prompted
to input the location of the configuration file after the system connects
to the network.</para><screen>kernel$ /Solaris_11_x86/kernel/unix <userinput>install ask</userinput> 
-B install_media=192.168.2.1:/export/cdrom0/boot
module /platform/i86pc/boot_archive</screen>
</listitem>
</itemizedlist>
</entry>
</row><row><entry><para><command>dhcp</command></para>
</entry><entry><para>Insert this option before the <option>B</option> option to instruct
the installation programs to use a DHCP server to obtain network installation
information that is needed to boot the system. If you do not specify to use
a DHCP server by typing <literal>dhcp</literal>, the system uses the <filename>/etc/bootparams</filename> file or the naming service <filename>bootparams</filename> database.
For example, you would not specify <literal>dhcp</literal> if you wanted keep
a static IP address.</para><screen>kernel$ /Solaris_11_x86/kernel/unix <userinput>dhcp</userinput> 
-B install_media=192.168.2.1:/export/cdrom0/boot
module /platform/i86pc/boot_archive</screen>
</entry>
</row><row><entry><para><command>- text</command></para>
</entry><entry><para>Insert this option before the <option>B</option> option to perform a
text-based installation in a desktop session.</para><screen>kernel$ /Solaris_11_x86/kernel/unix <userinput>- text</userinput> 
-B install_media=192.168.2.1:/export/cdrom0/boot
module /platform/i86pc/boot_archive</screen>
</entry>
</row><row><entry><para><command>- nowin</command></para>
</entry><entry><para>Insert this option before the <option>B</option> option to perform a
text-based installation in a console session.</para><screen>kernel$ /Solaris_11_x86/kernel/unix <userinput>- nowin</userinput> 
-B install_media=192.168.2.1:/export/cdrom0/boot
module /platform/i86pc/boot_archive</screen>
</entry>
</row><row><entry><para><command>console=<replaceable>serial-console</replaceable></command></para>
</entry><entry><para>Use this argument with the <option>B</option> option to instruct the
system to use a serial console, such as <literal>ttya</literal> (COM1) or <literal>ttyb</literal> (COM2).</para><screen>kernel$ /Solaris_11_x86/kernel/unix -B <userinput>console=ttya</userinput> 
install_media=192.168.2.1:/export/cdrom0/boot
module /platform/i86pc/boot_archive</screen>
</entry>
</row><row><entry><para><command>ata-dma-enabled=[0|1]</command></para>
</entry><entry><para>Use this argument with the <option>B</option> option to enable or disable
Advanced Technology Attachment (ATA) or Integrated Drive Electronics (IDE)
devices and Direct Memory Access (DMA) during the installation.</para><screen>kernel$ /Solaris_11_x86/kernel/unix -B <userinput>ata-dma-enabled=0</userinput> 
install_media=192.168.2.1:/export/cdrom0/boot
module /platform/i86pc/boot_archive</screen>
</entry>
</row><row><entry><para><command>acpi-enum=[0|1]</command></para>
</entry><entry><para>Use this argument with the <option>B</option> option to enable or disable
Advanced Configuration and Power Interface (ACPI ) power management.</para><screen>kernel$ /Solaris_11_x86/kernel/unix -B <userinput>acpi-enum=0</userinput> 
install_media=192.168.2.1:/export/cdrom0/boot
module /platform/i86pc/boot_archive</screen>
</entry>
</row><row><entry><para><command>atapi-cd-dma-enabled=[0|1]</command></para>
</entry><entry><para>Use this argument with the <option>B</option> option to enable or disable
DMA for CD or DVD drives during the installation.</para><screen>kernel$ /Solaris_11_x86/kernel/unix -B <userinput>atapi-cd-dma-enabled=0</userinput>
install_media=192.168.2.1:/export/cdrom0/boot
module /platform/i86pc/boot_archive</screen><note><para>The DMA name <replaceable>atapi</replaceable> is the current variable
name used for DMA. This variable is   subject to change.</para>
</note>
</entry>
</row>
</tbody>
</tgroup>
</table>
</sect1>
</chapter>