3.2 Using the Automated Installer (AI) for Oracle VM Server for SPARC

Oracle Solaris and the Oracle VM Agent for SPARC can be automatically installed on SPARC servers over the network using Solaris Automated Installer (AI). This allows for the rapid deployment of Oracle VM Server for SPARC across multiple SPARC systems, reducing administrative overhead and the likelihood of configuration or installation errors. Solaris AI is described in detail in the document titled Installing Oracle Solaris 11.3 Systems at:

http://docs.oracle.com/cd/E53394_01/html/E54756/useaipart.html

In this section we assume that you already have a sufficient understanding of Solaris AI and are able to set up an Install Server to deploy Solaris to your SPARC systems. This section highlights the additional steps that you need to perform to ensure that the Oracle VM Agent for SPARC and any other required packages are also installed and configured on your SPARC systems.

To set up and configure SPARC AI for rapid deployment of Oracle VM Server for SPARC across multiple SPARC systems, the following steps must be taken:

  • Set up an IPS repository with the Oracle VM Agent for SPARC software.

  • Create an Oracle Solaris Installation Service.

  • Create an installation manifest for Oracle VM Agent for SPARC.

  • Create a configuration profile for the installation of Oracle VM Server for SPARC.

  • Install Oracle VM Server for SPARC on your SPARC hardware.

3.2.1 Installing the Distributed Lock Manager (DLM) Package

If you have not already installed the DLM package, you should download and install it before you install Oracle VM Agent. The DLM package is required to support server pool clustering.

Download the DLM package, ovs-dlm-3.4.x-bxxx.p5p, from https://edelivery.oracle.com/oraclevm. For more information about downloading software, see Section 1.2, “Getting Installation ISOs and Packages”.

Note

You can add the DLM package to an IPS repository and install from there. See Section 3.2.2, “Setting up an IPS repository”.

To install the DLM package, do the following:

  1. Stop the ovs-config service:

    # svcadm disable -s ovs-config
  2. Install the DLM package:

    # pkg install -g ovs-dlm-3.4.x-bxxx.p5p dlm
  3. Restart the ovs-config service:

    # svcadm enable ovs-config

3.2.2 Setting up an IPS repository

In addition to installing Solaris, your IPS repository must be configured to install the Oracle VM Agent for SPARC software. To do this, you must set up an IPS repository that contains the Oracle VM Agent for SPARC software packages to be used during the installation.

To set up an IPS repository for Oracle VM Agent for SPARC

  1. If you have not already created a package repository that is accessible over HTTP, you must create one by performing the following actions on the system where you intend to host your repositories:

    # pkgrepo create /path/to/my-repository
    # svccfg -s application/pkg/server setprop pkg/inst_root=/path/to/my-repository
    # svccfg -s application/pkg/server setprop pkg/port=8888
    # svcadm refresh application/pkg/server
    # svcadm enable application/pkg/server
  2. Check that the package repository server is online:

    # svcs pkg/server
    STATE          STIME    FMRI
    online         timestamp svc:/application/pkg/server:default
  3. Download the latest Oracle VM Agent for SPARC software from https://edelivery.oracle.com/oraclevm, as described in Section 1.2, “Getting Installation ISOs and Packages”.

  4. Extract the software, for example:

    # tar xzf ovs-ldoms-3.4.x-bxxx.tar.gz
  5. Copy the software to the package repository, for example:

    # pkgrecv -s ovs-ldoms-3.4.x-bxxx/ovs-ldoms.p5p -d /path/to/my-repository 'ovm/*'
    # pkgrecv -s ovs-dlm-3.4.x-bxxx.p5p -d /path/to/my-repository 'ovm/*'
  6. Restart the package repository server and ensure that it is online:

    # svcadm restart application/pkg/server
    # svcs pkg/server
  7. If the package repository server is in maintenance status, clear the service:

    # svcadm clear pkg/server
  8. Check that the contents of the repository are available, for example:

    # pkgrepo list -s /path/to/my-repository
    # pkgrepo list -s http://my-repo-server:8888/

3.2.3 Creating an Oracle Solaris Installation Service

To install Oracle Solaris 11.3 over the network, you must create an Oracle Solaris installation service using the installadm create-service command.

Note

The Automatic Installation (AI) tools package provides the installadm command. You can install the AI tools package with the pkg install install/installadm command.

For instructions to create an Oracle Solaris installation service, see Installing Oracle Solaris 11.3 Systems at:

http://docs.oracle.com/cd/E53394_01/html/E54756/useaipart.html

After the procedure is completed, you can check that your installation service is correctly set up by using the installadm list command. The output from this command should look similar to the following:

# installadm list

Service Name             Alias Of Status  Arch   Image Path
------------             -------- ------  ----   ----------
solaris11_3_12_5_0-sparc -        on      sparc  /export/auto_install/solaris11_3_12_5_0-sparc

In the example output, the installation service is solaris11_3_12_5_0-sparc.

To download the software, refer to Oracle Solaris 11.3 Support Repository Updates (SRU) Index ID 2045311.1 from My Oracle Support, available at:

https://support.oracle.com/epmos/faces/DocumentDisplay?id=2045311.1

Note

Oracle VM Server for SPARC 3.3 has been integrated into Oracle Solaris 11.3.

3.2.4 Creating an Installation Manifest

You need to create a custom XML AI manifest file to install an configure the Oracle VM Agent automatically. For more information about custom XML AI manifest file, see Customizing an XML AI Manifest File at:

http://docs.oracle.com/cd/E53394_01/html/E54756/gmfbv.html#scrolltoc

Create an Installation Manifest

  1. Start by copying the default manifest of your install service:

    # installadm list -n solaris11_3_12_5_0-sparc -m
    Service/Manifest Name            Status       Criteria
    ---------------------            ------       --------
    solaris11_3_12_5_0-sparc
        orig_default                 Default      None
    
    # installadm export -n solaris11_3_12_5_0-sparc -m orig_default -o manifest_ai_ovm.xml
  2. Open the exported manifest_ai_ovm.xml in a text editor and customize it in the following way:

    • In the <source> section, make sure that a Solaris publisher is defined and that it points to a Solaris IPS repository for the Solaris 11.3 version that also contains the Oracle VM Server for SPARC Release 3.3 or higher packages. For example:

      <publisher name="solaris">
         <origin name="http://solaris-11-repository"/>
      </publisher>
    • In the <source> section, add the Oracle VM (ovm) publisher with a reference to the IPS repository that you have set up with Oracle VM Agent for SPARC software. For example:

      <publisher name="ovm">
         <origin name="http://my-repo-server:8888"/>
      </publisher>
    • In the <software_data> install section, add the following lines to have the Oracle VM Agent for SPARC software and the DLM software installed:

      <name>pkg:/ovm/ovs-agent</name>
      <name>pkg:/ovm/dlm</name>
  3. Add the manifest to the installation service. In addition, you can specify criteria associated with this manifest. This manifest is only applicable to SPARC sun4v system, so you should at least use the sun4v criteria:

    # installadm create-manifest -n solaris11_3_12_5_0-sparc -f manifest_ai_ovm.xml -m ovm -c \
      arch="sun4v"
    
    # installadm list -m -n solaris11_3_12_5_0-sparc
    Service/Manifest Name            Status         Criteria
    ---------------------            ------         --------
    solaris11_3_12_5_0-sparc
       ovm                                          arch = sun4v
       orig_default                  Default        None

3.2.5 Creating a Configuration Profile

To have the server automatically configured after the installation, you need to provide a configuration profile. For more information about creating a configuration profile, see Creating System Configuration Profiles at:

http://docs.oracle.com/cd/E53394_01/html/E54756/syscfg-2.html

To create a configuration profile, run the interactive configuration tool and save the output to a file. The following command creates a valid profile in profile_ovm.xml from responses you enter interactively:

# sysconfig create-profile -o profile_ovm.xml
Important

In the interactive configuration tool, you must select the option to configure the network manually or it will not be possible to automatically configure Oracle VM Agent for SPARC using the installation service.

To have the Oracle VM Agent for SPARC configured automatically during the installation, add the following section inside the <service_bundle> section of the generated profile_ovm.xml file:

<service version="1" type="service" name="ovm/ovs-config">
  <instance enabled="true" name="default">
    <property_group type="application" name="config">
      <propval type="astring" name="password" value="encrypted-password"/>
      <propval type="boolean" name="autoconfig" value="true"/>
    </property_group>
  </instance>
</service>

Replace the encrypted-password value with the encrypted version of the password that you want to use for the Oracle VM Agent.

You can generate the encrypted version of the password on any system using the following command:

# python -c "import crypt, sys; print crypt.crypt(sys.argv[-1], \
      '\$6\$%s\$' % sys.argv[-2])" $(pwgen -s 16 1) password

Substitute password with the password that you want to use for the Oracle VM Agent, for example:

# python -c "import crypt, sys; print crypt.crypt(sys.argv[-1], \
     '\$6\$%s\$' % sys.argv[-2])" $(pwgen -s 16 1) s3cr3tp4ssw0rd
$6$-c$pgcCqd6Urrepi9EzdK93x5XSpyiNzup7SAcDNjVOtsqm6HFNeg385wMu1GjE.J.S.FL8J7gtl5VZnq7tOAd/N0

The output from this command is the encrypted-password value that you should substitute in the section that you added to the configuration profile.

Finally, add the configuration profile to the installation service. In addition, you can specify criteria associated with this profile. This profile is only applicable to SPARC sun4v system, so you should at least use the sun4v criteria:

# installadm create-profile -n solaris11_3_12_5_0-sparc --file profile_ovm.xml -c arch=sun4v

# installadm list -p
Service/Profile Name      Criteria
--------------------      --------
solaris11_3_12_5_0-sparc
   profile_ovm.xml        arch = sun4v

3.2.6 Performing an Installation

For more information about installing a server with the Solaris Auto-Install, see Installing Client Systems at:

http://docs.oracle.com/cd/E53394_01/html/E54756/client.html

On the installation server, you must associate the MAC address of each server, that you wish to install, with the installation service that you have set up. This is achieved by running the following command:

# installadm create-client -n solaris11_3_12_5_0-sparc -e mac-address

Substitute mac-address with the actual MAC address for the network interface on the server that is used to connect to the installation service.

On your target servers, if you have configured your DHCP to provide the information for the installation service, you can issue the following command at boot:

ok boot net:dhcp - install

If you have not configured DHCP, on your target server issue the following commands at boot:

ok setenv network-boot-arguments host-ip=client-ip,router-ip=router-ip,\
      subnet-mask=subnet-mask,hostname=hostname,\
      file=http://install-server-ip-address:5555/cgi-bin/wanboot-cgi
ok boot net - install

Substitute client-ip with the IP address that you intend to allocate to the server, router-ip with the IP address of your router or default gateway, subnet-mask with the subnet mask of your network, and hostname with the hostname that you wish to use for your server. Finally, ensure that the URL that you provide for the file parameter matches the URL to access your Solaris AI server.