<chapter id="customjumpsample-1"><title>Installing With Custom JumpStart (Examples)</title><highlights><para>This chapter provides an example of setting up and installing Solaris
software on both SPARC based and x86 based systems by using a custom JumpStart
installation.</para><itemizedlist><listitem><para><olink targetptr="customjumpsample-2" remap="internal">Sample Site Setup</olink></para>
</listitem><listitem><para><olink targetptr="customjumpsample-5" remap="internal">Create an Install Server</olink></para>
</listitem><listitem><para><olink targetptr="customjumpsample-6" remap="internal">Create a Boot Server
for Marketing Systems</olink></para>
</listitem><listitem><para><olink targetptr="customjumpsample-7" remap="internal">Create a JumpStart Directory</olink></para>
</listitem><listitem><para><olink targetptr="customjumpsample-8" remap="internal">Share the JumpStart
Directory</olink></para>
</listitem><listitem><para><olink targetptr="customjumpsample-9" remap="internal">Create the Engineering
Group's Profile</olink></para>
</listitem><listitem><para><olink targetptr="customjumpsample-15" remap="internal">Create the Marketing
Group's Profile</olink></para>
</listitem><listitem><para><olink targetptr="customjumpsample-21" remap="internal">Update the rules File</olink></para>
</listitem><listitem><para><olink targetptr="customjumpsample-22" remap="internal">Validate the rules
File</olink></para>
</listitem><listitem><para><olink targetptr="customjumpsample-23" remap="internal">Set Up Engineering
Systems to Install From the Network</olink></para>
</listitem><listitem><para><olink targetptr="customjumpsample-24" remap="internal">Set Up Marketing Systems
to Install From the Network</olink></para>
</listitem><listitem><para><olink targetptr="customjumpsample-25" remap="internal">Boot the  Engineering
Systems and Install Solaris Software</olink></para>
</listitem><listitem><para><olink targetptr="customjumpsample-26" remap="internal">Boot the Marketing Systems and Install Solaris Software</olink></para>
</listitem>
</itemizedlist>
</highlights><sect1 id="customjumpsample-2"><title>Sample Site Setup</title><para><olink targetptr="customjumpsample-fig-3" remap="internal">Figure 7&ndash;1</olink> shows the site
setup for this example. </para><figure id="customjumpsample-fig-3"><title>Sample Site Setup</title><mediaobject><imageobject><imagedata entityref="fig492.epsi"/>
</imageobject><textobject><simpara>This illustration shows an install server on the engineering
subnet and a boot server on the marketing subnet.</simpara>
</textobject>
</mediaobject>
</figure><para>At this sample site, the conditions are as follows:</para><itemizedlist><listitem><para>SPARC: The engineering group is located on its own subnet.
This group uses <trademark>SPARCstation</trademark> systems for software development.</para>
</listitem><listitem><para>x86: The marketing group is located on its own subnet. This
group uses x86 based systems for running word processors, spreadsheets, and
other office productivity tools.</para>
</listitem><listitem><para>The site uses NIS. The Ethernet addresses, IP addresses, and
host names of the systems are preconfigured in the NIS maps. The subnet mask,
date and time, and geographic region for the site are also preconfigured in
the NIS maps.</para><note><para>The peripheral devices for the marketing systems are preconfigured
in the <filename>sysidcfg</filename> file.</para>
</note>
</listitem><listitem><para>Both
the engineering and marketing systems are to be installed with Solaris Express 5/07 software
from the network.</para>
</listitem>
</itemizedlist>
</sect1><sect1 id="customjumpsample-5"><title>Create an Install Server</title><para>Because the groups need to install Solaris Express 5/07 software
from the network, you make <literal>server-1</literal> an install server for
both groups. You use the <olink targetdoc="refman1m" targetptr="setup-install-server-1m" remap="external"><citerefentry><refentrytitle>setup_install_server</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink> command to
copy the images  to the <literal>server-1</literal> local disk (in the <filename>/export/install</filename> directory). Copy the images from the either of
the following media.</para><itemizedlist><listitem><para>Solaris Software CDs and the Solaris Languages CDs</para>
</listitem><listitem><para>Solaris Operating System DVD</para>
</listitem>
</itemizedlist><para>You must copy the image from the disc to an empty directory, in these
examples the <filename>sparc_11</filename> directory
and the <filename>x86_11</filename> directory.</para><example id="customjumpsample-ex-1" arch="sparc"><title>Copying the Solaris Express 5/07 CDs</title><para>Insert the Solaris Software for SPARC Platforms - 1 CD in the CD-ROM drive that is attached
to <literal>server-1</literal> and type the following commands:</para><screen>server-1# <userinput>mkdir -p /export/install/sparc_11</userinput>
server-1# <userinput>cd /<replaceable>CD_mount_point</replaceable>/Solaris_11/Tools</userinput>
server-1# <userinput>./setup_install_server /export/install/sparc_11</userinput></screen><para>Insert the Solaris Software for SPARC Platforms - 2 CD in the CD-ROM drive that is attached
to <literal>server-1</literal> and type the following commands:</para><screen>server-1# <userinput>cd /<replaceable>CD_mount_point</replaceable>/Solaris_11/Tools</userinput>
server-1# <userinput>./add_to_install_server /export/install/sparc_11</userinput></screen><para>Repeat the previous command for each Solaris Software you want to
install.</para><para>Insert the first SPARC: Solaris Languages for SPARC Platforms CD in the
CD-ROM drive that is attached to <literal>server-1</literal> and type the
following commands:</para><screen>server-1# <userinput>cd /<replaceable>CD_mount_point</replaceable>/Solaris_11/Tools</userinput>
server-1# <userinput>./add_to_install_server /export/install/sparc_11</userinput></screen><para>Repeat the
previous command for each SPARC: Solaris Languages for SPARC Platforms CD you want to install.</para>
</example><example id="customjumpsample-ex-2" arch="x86"><title>Copying the Solaris Express 5/07 CDs</title><para>Insert the Solaris Software for x86 Platforms - 1 CD in the CD-ROM drive that is attached
to <literal>server-1</literal> and type the following commands:</para><screen>server-1# <userinput>mkdir -p /export/install/x86_11</userinput>
server-1# <userinput>cd /<replaceable>CD_mount_point</replaceable>/Solaris_11/Tools</userinput>
server-1# <userinput>./setup_install_server /export/install/x86_11</userinput><userinput></userinput></screen><para>Insert the Solaris Software for x86 Platforms - 2 CD in the CD-ROM drive that is attached
to <literal>server-1</literal> and type the following commands:</para><screen>server-1# <userinput>cd /<replaceable>CD_mount_point</replaceable>/Solaris_11/Tools</userinput>
server-1# <userinput>./add_to_install_server /export/install/x86_11</userinput><userinput></userinput></screen><para>Repeat the previous command for each Solaris Software you want to
install.</para><para>Insert the first Solaris Languages for x86 Platforms CD in the
CD-ROM drive that is attached to <literal>server-1</literal> and type the
following commands:</para><screen>server-1# <userinput>cd /<replaceable>CD_mount_point</replaceable>/Solaris_11/Tools</userinput>
server-1# <userinput>./add_to_install_server /export/install/x86_11</userinput></screen><para>Repeat the
previous command for each Solaris Languages for x86 Platforms CD you want to install.</para>
</example><example id="customjumpsample-ex-3" arch="sparc"><title>Copying the Solaris Express 5/07 DVD</title><para>Insert the Solaris Operating System for SPARC Platforms DVD in the DVD-ROM drive that is attached to <literal>server-1</literal> and type the following commands:</para><screen>server-1# <userinput>mkdir -p /export/install/sparc_11</userinput>
server-1# <userinput>cd /<replaceable>DVD_mount_point</replaceable>/Solaris_11/Tools</userinput>
server-1# <userinput>./setup_install_server /export/install/sparc_11</userinput></screen>
</example><example id="customjumpsample-ex-4" arch="x86"><title>Copying the Solaris Operating System for x86 Platforms DVD</title><para>Insert the Solaris Operating System for x86 Platforms DVD in the DVD-ROM drive that is attached to <literal>server-1</literal> and type the following commands:</para><screen>server-1# <userinput>mkdir -p /export/install/x86_11</userinput>
server-1# <userinput>cd /<replaceable>DVD_mount_point</replaceable>/Solaris_11/Tools</userinput>
server-1# <userinput>./setup_install_server /export/install/x86_11</userinput><userinput></userinput></screen>
</example>
</sect1><sect1 id="customjumpsample-6" arch="x86"><title>Create a Boot Server for
Marketing Systems</title><para>Systems
cannot boot from an install server on a different subnet, so you make <literal>server-2</literal> a boot server on the marketing group's subnet. You use the <olink targetdoc="refman1m" targetptr="setup-install-server-1m" remap="external"><citerefentry><refentrytitle>setup_install_server</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink> command to copy the boot software from the Solaris Operating System for x86 Platforms DVD or
 the Solaris Software for x86 Platforms - 1 CD. The boot software is copied to the <literal>server-2</literal> local disk in the <filename>/export/boot</filename> directory.</para><para>Choose the media and install the boot software to local disk.</para><itemizedlist><listitem><para>If you insert the Solaris Software for x86 Platforms - 1 CD in the CD-ROM
drive that is attached to <literal>server-2</literal>, type the following
command:</para><screen>server-2# <userinput>cd /<replaceable>CD_mount_point</replaceable>/Solaris_11/Tools</userinput>
server-2# <userinput>./setup_install_server -b /export/boot</userinput></screen>
</listitem><listitem><para>If you insert the Solaris Operating System for x86 Platforms DVD in the DVD-ROM drive that
is attached to <literal>server-2</literal>, type the following command:</para><screen>server-2# <userinput>cd /<replaceable>DVD_mount_point</replaceable>/Solaris_11/Tools</userinput>
server-2# <userinput>./setup_install_server -b /export/boot</userinput></screen>
</listitem>
</itemizedlist><para>In the <command>setup_install_server</command> command, <option>b</option> specifies that <command>setup_install_server</command> is to copy the boot information to the directory that is named <filename>/export/boot</filename>.</para>
</sect1><sect1 id="customjumpsample-7"><title>Create a JumpStart Directory</title><para>Now
that you have the install server and boot server set up, you create a JumpStart
directory on <literal>server-1</literal>. You can use any system on the network.
This directory holds files that are required for a custom JumpStart installation
of Solaris software. You set up this directory by copying the sample directory
from the Solaris Operating System DVD image or from the Solaris Software - 1 CD image that
has been copied to <filename>/export/install</filename>:  </para><screen width="100">server-1# <userinput>mkdir /jumpstart</userinput>
server-1# <userinput>cp -r /export/install/sparc_11/Solaris_11/Misc/jumpstart_sample</userinput> <userinput>/jumpstart</userinput></screen>
</sect1><sect1 id="customjumpsample-8"><title>Share the JumpStart Directory</title><para>To make the <filename>rules</filename> file and profiles accessible
to systems on the network, you share the <filename>/jumpstart</filename> directory.</para><para>Use either the <command>sharemgr</command> utility or the <computeroutput>share</computeroutput> command as
follows:</para><note><para><emphasis role="strong">Starting with the 5/07
Developer release,</emphasis> the <command>sharemgr</command> utility introduces
the concept of share groups. See <olink targetdoc="sysadv4" targetptr="gcrvu" remap="external"><citetitle remap="section">sharemgr Command</citetitle> in <citetitle remap="book">System Administration Guide: Network Services</citetitle></olink>.</para>
</note><itemizedlist><listitem><para>Using the <command>share</command> command, edit the <filename>/etc/dfs/dfstab</filename> file by adding the following entry.</para><para><literal>#</literal> <userinput>share -F nfs -o ro,anon=0 <replaceable>jumpstart_dir_path</replaceable></userinput></para><para>For example, the following entry shares the <filename>/jumpstart</filename> directory:</para><para><literal>#</literal> <userinput>share -F nfs -o ro,anon=0 /jumpstart</userinput></para><para>Then, type <command>shareall</command> and press
Enter.</para>
</listitem><listitem><para>Using the <command>sharemgr</command> utility, enter the following
commands:</para><para><literal>#</literal> <userinput>sharemgr add-share</userinput> <option>s</option> <userinput>/jumpstart default</userinput></para><para><literal>#</literal> <userinput>sharemgr set</userinput> <option>P</option> <replaceable>nfs</replaceable> <option>S</option> <replaceable>sys</replaceable> <option>p</option> <userinput>ro="*"</userinput> <option>s</option> <userinput>/jumpstart default</userinput></para><para><literal>#</literal> <userinput>sharemgr set</userinput> <option>P</option> <replaceable>nfs</replaceable> <option>p</option> <userinput>anon=0</userinput> <option>s</option> <userinput>/jumpstart
default</userinput></para>
</listitem>
</itemizedlist>
</sect1><sect1 id="customjumpsample-9" arch="sparc"><title>Create the Engineering
Group's Profile</title><para>For
the engineering systems, you create a file that is named <literal>eng_prof</literal> in
the <filename>/jumpstart</filename> directory. The <filename>eng_prof</filename> file
contains the following entries, which define the Solaris Express 5/07 software
to be installed on systems in the engineering group:</para><programlisting>install_type  initial_install
system_type   standalone
partitioning  default
cluster       SUNWCprog
filesys       any 512 swap</programlisting><para>The previous example profile specifies the following installation information.</para><variablelist><varlistentry><term><literal>install_type</literal></term><listitem><para>The installation is to be treated as an initial installation,
as opposed to an upgrade.</para>
</listitem>
</varlistentry><varlistentry><term><literal>system_type</literal></term><listitem><para>The engineering systems are standalone systems.</para>
</listitem>
</varlistentry><varlistentry><term><literal>partitioning</literal></term><listitem><para>The JumpStart software uses default disk partitioning for
installing Solaris software on the engineering systems.</para>
</listitem>
</varlistentry><varlistentry><term><literal>cluster</literal></term><listitem><para>The Developer System Support software group is to be installed.</para>
</listitem>
</varlistentry><varlistentry><term><literal>filesys</literal></term><listitem><para>Each system in the engineering group is to have 512 Mbytes
of swap space.</para>
</listitem>
</varlistentry>
</variablelist>
</sect1><sect1 id="customjumpsample-15" arch="x86"><title>Create the Marketing Group's
Profile</title><para>For the marketing systems, you create a file that is named <filename>marketing_prof</filename> in the <filename>/jumpstart</filename> directory.
The <filename>marketing_prof</filename> file contains the following entries,
which define the Solaris Express 5/07 software to be installed on systems
in the marketing group: </para><programlisting>install_type  initial_install
system_type   standalone
partitioning  default
cluster       SUNWCuser
package       SUNWaudio</programlisting><para>The previous example profile specifies the following installation information.</para><variablelist><varlistentry><term><literal>install_type</literal></term><listitem><para>The installation is to be treated as an initial installation,
as opposed to an upgrade.</para>
</listitem>
</varlistentry><varlistentry><term><literal>system_type</literal></term><listitem><para>The marketing systems are standalone systems.</para>
</listitem>
</varlistentry><varlistentry><term><literal>partitioning</literal></term><listitem><para>The JumpStart software is to use default disk partitioning
for installing Solaris on the marketing systems.</para>
</listitem>
</varlistentry><varlistentry><term><literal>cluster</literal></term><listitem><para>The End User Solaris Software Group is to be installed.</para>
</listitem>
</varlistentry><varlistentry><term><literal>package</literal></term><listitem><para>The audio demo software package is to be added to each system.</para>
</listitem>
</varlistentry>
</variablelist>
</sect1><sect1 id="customjumpsample-21"><title>Update the <filename>rules</filename> File</title><para>Now you must add rules to the <filename>rules</filename> file.
The Solaris installation program uses the rules to select the correct installation
(profile) for each system during a custom JumpStart installation. </para><para>At this site, each department is located on its own <emphasis>subnet</emphasis> and
has its own network address. The engineering department is located on subnet
255.222.43.0. The marketing department is located on 255.222.44.0. You can
use this information to control how the engineering and marketing systems
are installed with the Solaris Express 5/07 software. In the <filename>/jumpstart</filename> directory, you edit the <filename>rules</filename> file, delete
all of the example rules, and add the following lines to the file:</para><screen>network 255.222.43.0 - eng_prof -
network 255.222.44.0 - marketing_prof -</screen><para>Basically, these rules state that systems on the 255.222.43.0 network
are to be installed with the Solaris Express 5/07 software by using the <filename>eng_prof</filename> profile. The systems on the 255.222.44.0 network are to
be installed with the Solaris Express 5/07 software by using the <filename>marketing_prof</filename> profile.</para><note><para>You can use the sample rules to use a network
address to identify the systems to be installed with the Solaris Express 5/07 software
by using <filename>eng_prof</filename> and <filename>marketing_prof</filename>,
respectively. You can also use host names, memory size, or model type as the
rule keyword. <olink targetptr="preparecustom-12638" remap="internal">Table 8&ndash;1</olink> contains
a complete list of keywords you can use in a <filename>rules</filename> file.</para>
</note>
</sect1><sect1 id="customjumpsample-22"><title>Validate the <filename>rules</filename> File</title><para>After the <filename>rules</filename> and profiles
are set up, you run the <command>check</command> script to verify that the
files are correct:  </para><screen>server-1# <userinput>cd /jumpstart</userinput>
server-1# <userinput>./check</userinput></screen><para>If the <command>check</command> script does not find any errors, the
script creates the <filename>rules.ok</filename> file. </para>
</sect1><sect1 id="customjumpsample-23" arch="sparc"><title>Set Up Engineering Systems
to Install From the Network</title><para>After
setting up the <filename>/jumpstart</filename> directory and files, you use
the <command>add_install_client</command> command on the install server, <literal>server-1</literal>, to set up the engineering systems to install the Solaris
software from the install server.  <literal>server-1</literal> is also the
boot server for the engineering group's subnet.</para><screen width="100">server-1# <userinput>cd /export/install/sparc_11/Solaris_11/Tools</userinput>
server-1# <userinput>./add_install_client -c server-1:/jumpstart host-eng1 sun4u</userinput>
server-1# <userinput>./add_install_client -c server-1:/jumpstart host-eng2 sun4u</userinput></screen><para>In the <command>add_install_client</command> command,
the options that are used have the following meanings:</para><variablelist><varlistentry><term><option>c</option></term><listitem><para>Specifies the server (<literal>server-1</literal>) and path
(<filename>/jumpstart</filename>) to the JumpStart directory. Use this option
if you are using NFS.</para><note><para>If you are not using NFS, you specify the path to the JumpStart
directory by using the following commands:</para><itemizedlist><listitem><para><emphasis role="strong">For SPARC based systems</emphasis>,
specify the path in the <command>boot</command> command</para>
</listitem><listitem><para><emphasis role="strong">For x86 based systems</emphasis>,
specify the path by editing the GRUB menu entry</para>
</listitem>
</itemizedlist>
</note>
</listitem>
</varlistentry><varlistentry><term>host-eng1</term><listitem><para>The name of a system in the engineering group.</para>
</listitem>
</varlistentry><varlistentry><term>host-eng2</term><listitem><para>The name of another system in the engineering group. </para>
</listitem>
</varlistentry><varlistentry><term>sun4u</term><listitem><para>Specifies the platform group of the systems that use <literal>server-1</literal> as an install server. The platform group is for Ultra 5 systems.</para>
</listitem>
</varlistentry>
</variablelist>
</sect1><sect1 id="customjumpsample-24" arch="x86"><title>Set Up Marketing Systems
to Install From the Network</title><para>Next,
you use the <command>add_install_client</command> command on the boot server
(<literal>server-2</literal>). This command sets up the marketing systems
to boot from the boot server and install the Solaris software from the install
server (<literal>server-1</literal>):</para><screen width="100">server-2# <userinput>cd /marketing/boot-dir/Solaris_11/Tools</userinput>
server-2# <userinput>./add_install_client -s server-1:/export/install/x86_11 \</userinput>
<userinput>-c server-1:/jumpstart host-mkt1 i86pc</userinput>
server-2# <userinput>./add_install_client -s server-1:/export/install/x86_11 \</userinput>
<userinput>-c server-1:/jumpstart host-mkt2 i86pc</userinput>
server-2# <userinput>./add_install_client -d -s server-1:/export/install/x86_11 \</userinput>
<userinput>-c server-1:/jumpstart SUNW.i86pc i86pc</userinput>
server-2# <userinput>./add_install_client -c server-1:/jumpstart host-mkt1 sun4u</userinput>
server-2# <userinput>./add_install_client -c server-1:/jumpstart host-mkt2 sun4u</userinput></screen><para>In the <command>add_install_client</command> command, the options that
are used have the following meanings:</para><variablelist><varlistentry><term>-d</term><listitem><para>Specifies that the client is to use DHCP to obtain
the network install parameters. This option is required for clients to use
PXE network boot to boot from the network. <option>d</option> is optional
for network boot clients that do not use PXE network boot.</para>
</listitem>
</varlistentry><varlistentry><term>-s</term><listitem><para>Specifies
the install server (<literal>server-1</literal>) and the path to the Solaris
software (<filename>/export/install/x86_11</filename>). </para>
</listitem>
</varlistentry><varlistentry><term>-c</term><listitem><para>Specifies the server (<literal>server-1</literal>) and path
(<filename>/jumpstart</filename>) to the JumpStart directory. Use this option
if you are using NFS.</para><note><para>If you are not using NFS, you specify the path to the JumpStart
directory by using the following commands:</para><itemizedlist><listitem><para><emphasis role="strong">For SPARC based systems</emphasis>,
specify the path in the <command>boot</command> command</para>
</listitem><listitem><para><emphasis role="strong">For x86 based systems</emphasis>,
specify the path by editing the GRUB menu entry</para>
</listitem>
</itemizedlist>
</note>
</listitem>
</varlistentry><varlistentry><term>host-mkt1</term><listitem><para>The name of a system in the marketing group.</para>
</listitem>
</varlistentry><varlistentry><term>host-mkt2</term><listitem><para>The name of another system in the marketing group. </para>
</listitem>
</varlistentry><varlistentry><term>sun4u</term><listitem><para>Specifies the platform group of the systems that use <literal>server-1</literal> as an install server. The platform group is for Ultra 5 systems.</para>
</listitem>
</varlistentry><varlistentry><term>SUNW.i86pc</term><listitem><para>The DHCP class name for all Solaris x86 clients.  If you want
to configure all Solaris x86 DHCP clients with a single command, use this
class name.</para>
</listitem>
</varlistentry><varlistentry><term><literal>i86pc</literal></term><listitem><para>Specifies the platform group of the systems that use this
boot server. The platform name represents x86 based systems. </para>
</listitem>
</varlistentry>
</variablelist>
</sect1><sect1 id="customjumpsample-25" arch="sparc"><title>Boot the  Engineering
Systems and Install Solaris Software</title><para>After setting
up the servers and files, you can boot the engineering systems by using the
following <command>boot</command> command at the <literal>ok</literal> (PROM)
prompt of each system:</para><screen>ok <userinput>boot net - install</userinput></screen><para>The Solaris OS is automatically installed on the engineering group's
systems.</para>
</sect1><sect1 id="customjumpsample-26" arch="x86"><title>Boot the Marketing Systems
and Install Solaris Software</title><para>You can boot the system from one of the following: </para><itemizedlist><listitem><para>Solaris Software for x86 Platforms - 1 CD</para>
</listitem><listitem><para>Solaris Operating System for x86 Platforms DVD</para>
</listitem><listitem><para>The network by using PXE network boot</para>
</listitem>
</itemizedlist><para>Solaris software is automatically installed on the marketing group's
systems.</para>
</sect1>
</chapter>