UKOUG Technology Conference

UKOUG Technology Conference
UKOUG Technology Conference 2018 Call for Papers

Wednesday, November 26, 2014

Oracle Solaris 11 Derived Manifest with Automated Installation

I have been looking at Derived Manifest recently so that I can have one manifest to control the installation of Oracle Solaris 11.2 FCS on our dual boot desktops.


Derived Manifest

As you know the manifest controls how Solaris is installed on the system (disk layout, locales, software) , so I use the following manifest to install Solaris on to 2nd partition of windows desktops.

The script is run at install time (by a non-privileged user aiuser plus the additional privileges,*) and it will be passed some defined variable.  For example:
SI_NUMDISKS   - The number of disk
SI_DISKNAME_# - Disk name
SI_DISKSIZE_# - Size of disk
Note: There is a problem with the following script. I should examine the existing partitions on the client using fdisk, but aiuser does not have permission to do this. I can get over it by modify the solaris boot environment (see future blog entry).

# cat
function handler
trap handler ERR

# Load a default manifest (must be a local file)
/usr/bin/aimanifest load /usr/share/auto_install/manifest/default.xml

# This script only works with 1 disk
if [[ $SI_NUMDISKS -gt "1" ]] ; then
    print -u2 "System has too many disks for this script."


# System will reboot after installation = true (otherwise false)
/usr/bin/aimanifest set \
    /auto_install/ai_instance@auto_reboot true

# Make Disk 1 the target disk
/usr/bin/aimanifest add \
    /auto_install/ai_instance/target/disk/disk_name@name $SI_DISKNAME_1

# Check disk being used is bigger enough (> 250GB)
if [[ $SI_DISKSIZE_1 -gt "256000" ]] ; then
    typeset -i PARTN_SIZE=61440

    # First Partitions is Windows so preserve all data on it
    /usr/bin/aimanifest add \
        /auto_install/ai_instance/target/disk[disk_name@name=\"$SI_DISKNAME_1\"]/partition@name 1
    /usr/bin/aimanifest set \
        /auto_install/ai_instance/target/disk/disk_name@name_type ctd
    /usr/bin/aimanifest set \
        /auto_install/ai_instance/target/disk/partition[@name=1]@action preserve

    # Create second partitions and install Solaris (PARTN_SIZE=64GB)
    /usr/bin/aimanifest add \
        /auto_install/ai_instance/target/disk[disk_name@name=\"$SI_DISKNAME_1\"]/partition@name 2
    /usr/bin/aimanifest add \
        /auto_install/ai_instance/target/disk/partition[@name=2]/size@val \
    /usr/bin/aimanifest set \
        /auto_install/ai_instance/target/disk/partition[@name=2]@action create

    print -u2 "System has too smaller disk. $SI_DISKSIZE_1"

# Remove facet which are in default file and only keep locale.* (facet[1])
# Unable to add a facet so added a workround
# Get list of current facets and delete unwanted ones
facets=$(/usr/bin/aimanifest get software/destination/image/facet)
for i in $facets
        if [ $count -gt 3 ]; then
                /usr/bin/aimanifest delete software/destination/image/facet[3]
        count=$((count + 1))

# Replace facet[2] with locale.en and facet[3] with locale.en_G
/usr/bin/aimanifest set \
        software/destination/image/facet[2] facet.locale.en
/usr/bin/aimanifest set \
        software/destination/image/facet[2]@set true
/usr/bin/aimanifest set \
        software/destination/image/facet[3] facet.locale.en_GB
/usr/bin/aimanifest set \
        software/destination/image/facet[3]@set true

# Set the locatiopn of our internal Solaris publisher
/usr/bin/aimanifest set \
        software/source/publisher/origin@name http://193.xx.xx.xx
/usr/bin/aimanifest add \
      software[@type=IPS]/source[publisher@name=solaris]/publisher@name dcsnt  

# Add addition publisher
/usr/bin/aimanifest add \
        publisher[@name=dcsnt]/origin@name \

# Remove default software (pkg:/group/system/solaris-large-server)
/usr/bin/aimanifest delete \

# install our software
/usr/bin/aimanifest add \
    software/software_data[@action='install']/name pkg:/entire@0.5.11-0.175
/usr/bin/aimanifest add \
    software/software_data[@action='install']/name pkg:/group/system/solaris-desktop
/usr/bin/aimanifest add \
    software/software_data[@action='install']/name pkg:/service/network/ntp
/usr/bin/aimanifest add \
    software/software_data[@action='install']/name pkg:/system/dcsntinstall
/usr/bin/aimanifest add \
    software/software_data[@action='install']/name pkg:/system/dcsntXinstall
/usr/bin/aimanifest add \
    software/software_data[@action='install']/name pkg:/library/desktop/aoo340
/usr/bin/aimanifest add \
    software/software_data[@action='install']/name pkg:/system/dcsntExtraSW
/usr/bin/aimanifest add \
    software/software_data[@action='install']/name pkg:/system/dcsntupdate

# uninstall our software
/usr/bin/aimanifest add \
    software[@type="IPS"]/software_data@action uninstall
/usr/bin/aimanifest add \
    software/software_data[@action='uninstall']/name pkg:/system/management/ocm
/usr/bin/aimanifest add \
    software/software_data[@action='uninstall']/name  pkg:/system/management/visual-panels/panel-sysmon
/usr/bin/aimanifest add \
    software/software_data[@action='uninstall']/name pkg:/system/management/visual-panels/panel-sysmon/locale


Test the Derived Manifest Script in an Install Environment

  • Boot an AI image on that client system in "Text Installer and command line" mode
  • Select Shell from the installer initial menu
  • Copy your script to the client (ftp, ssh)
  • as root
# chmod a+x  /var/tmp/
# auto-install -m /var/tmp/ -i

15:50:52    Install Log: /system/volatile/install_log
15:50:52    Using Derived Script: /var/tmp/
15:50:52    Starting installation.
15:50:52    Deriving manifest from: /var/tmp/
15:50:52    Derived /var/tmp/ stored
15:50:52    Registering Derived Manifest Module Checkpoint
15:50:52    0% Preparing for Installation
15:50:52    Derived Manifest Module: Creating/modifying manifest at "/system/volatile/manifest.xml"
15:51:08    Derived Manifest Module: XML validation completed successfully
15:51:09    84% derived-manifest completed.
15:51:09    100% manifest-parser completed.
15:51:09    100% None
15:51:09    DM set manifest to: /system/volatile/manifest.xml
15:51:09    0% Preparing for Installation
15:51:09    1% Preparing for Installation
15:51:09    2% Preparing for Installation
15:51:09    3% Preparing for Installation
15:51:12    64% target-discovery completed.
15:51:12    Creating partition 2 on disk c1t0d0 will destroy existing data.
15:51:12    Selected Disk(s) : c1t0d0
15:51:12    Existing zpool 'rpool' will be destroyed.
15:51:12    82% target-selection completed.
15:51:12    94% ai-configuration completed.
15:51:12    100% var-share-dataset completed.
15:51:12    100% None
15:51:12    Automated Installation paused at checkpoint: target-instantiation
15:51:12    Automated Installation succeeded.
15:51:12    You may wish to reboot the system at this time.

Check out if the manifest it has created looks correct!

# cat /system/volatile/manifest.xml
<!DOCTYPE auto_install SYSTEM "file:///usr/share/install/ai.dtd.1">
  <ai_instance name="default" auto_reboot="true">
        <disk_name name="c1t0d0" name_type="ctd"/>
        <partition name="1" action="preserve"/>
        <partition name="2" action="create">
          <size val="61440mb"/>
        <zpool name="rpool" is_root="true">
          <filesystem name="export" mountpoint="/export"/>
          <filesystem name="export/home"/>
          <be name="solaris"/>
    <software type="IPS">
          <!-- Specify locales to install -->
          <facet set="false">facet.locale.*</facet>
          <facet set="true">facet.locale.en</facet>
          <facet set="true">facet.locale.en_GB</facet>
        <publisher name="solaris">
          <origin name="http://193.xx.xx.xx"/>
        <publisher name="dcsnt">
          <origin name="http://193.xx.xx.xx:10091"/>
      <software_data action="install">
      <software_data action="uninstall">

Quick Setup Guide for AI

# svcadm enable /network/dns/multicast
# svcs /network/dns/multicast
STATE          STIME    FMRI
online         13:58:08 svc:/network/dns/multicast:default
# pkg install install/installadm
# installadm create-service
OK to use subdir of /export/auto_install to store image? [y|N]: y
  0% : Creating service from: pkg:/install-image/solaris-auto-install
  0% : Using publisher(s):
  0% :     emulex:
  0% :     solaris:
  5% : Refreshing Publisher(s) 
  9% : Startup Phase 
 15% : Planning Phase 
 61% : Download Phase 
 90% : Actions Phase 
 91% : Finalize Phase
 91% : Creating i386 service: solaris11_2_1_0_2-i386
 91% : Image path: /export/auto_install/solaris11_2_1_0_2-i386
 91% : Setting "solaris" publisher URL in default manifest to:
 91% :
 91% : DHCP is not being managed by install server.
 91% : SMF Service 'svc:/system/install/server:default' will be enabled
 91% : SMF Service 'svc:/network/tftp/udp6:default' will be enabled
 91% : Creating default-i386 alias
 91% : Setting "solaris" publisher URL in default manifest to:
 91% :
 91% : DHCP is not being managed by install server.
 91% :  No local DHCP configuration found. This service is the default
 91% :  alias for all PXE clients. If not already in place, the following should
 91% :  be added to the DHCP configuration:
 91% : Boot server IP:
 91% : Boot file(s):
 91% :     bios clients (arch 00:00):  default-i386/boot/grub/pxegrub2
 91% :     uefi clients (arch 00:07):  default-i386/boot/grub/grub2netx64.efi
 91% :
 91% : SMF Service 'svc:/system/install/server:default' will be enabled
 91% : SMF Service 'svc:/network/tftp/udp6:default' will be enabled
100% : Created Service: 'solaris11_2_1_0_2-i386'
100% : Refreshing SMF service svc:/network/tftp/udp6:default
100% : Refreshing SMF service svc:/system/install/server:default
100% : Enabling SMF service svc:/system/install/server:default
100% : Enabling SMF service svc:/network/tftp/udp6:default
100% : Service 'solaris11_2_1_0_2-i386' has been added to the mDNS registry
100% : Service 'default-i386' has been added to the mDNS registry

# installadm list
Service Name           Status Arch Type Secure Alias Aliases Clients Profiles Manifests
------------           ------ ---- ---- ------ ----- ------- ------- -------- ---------
default-i386           on     i386 pkg  no     yes   0       0       0        1       
solaris11_2_1_0_2-i386 on     i386 pkg  no     no    1       0       0        1       

# installadm list -m -n solaris11_2_1_0_2-i386
Service Name           Manifest Name Type    Status  Criteria
------------           ------------- ----    ------  --------
solaris11_2_1_0_2-i386 orig_default  derived default none   

# installadm list -m -p
Service Name           Manifest Name Type    Status  Criteria
------------           ------------- ----    ------  --------
default-i386           orig_default  derived default none   
solaris11_2_1_0_2-i386 orig_default  derived default none   
There are no profiles configured for local services.

Create a default profile (see:

# sysconfig create-profile -o sc.xml
# installadm create-profile -n solaris11_2_1_0_2-i386 -f sc.xml
# installadm create-manifest -n solaris11_2_1_0_2-i386 -f
# installadm set-criteria -n solaris11_2_1_0_2-i386 -m -c mac="40:26:7A:A4:1A:41-70:71:BC:7C:85:21"

# installadm create-client -e 40:26:7A:A4:1A:41 -n solaris11_2_1_0_2-i386  -b console=graphics
No local DHCP configuration found. If not already configured, the
following should be added to the DHCP configuration:
    Boot server IP      : 193.xx.xx.xx
    Boot file(s)        :
                        :       bios clients (arch 00:00):  40267AA41A41.bios
                        :       uefi clients (arch 00:07):  40267AA41A41.uefi
Created Client: '40:26:7A:A4:1A:41'

# installadm list -n solaris11_2_1_0_2-i386 -m -c -p
Service Name           Client Address    Arch Secure Custom Args Custom Grub
------------           --------------    ---- ------ ----------- -----------
solaris11_2_1_0_2-i386 40:26:7A:A4:1A:41 i386 no     yes         no        
Service Name           Manifest Name    Type    Status  Criteria                                  
------------           -------------    ----    ------  --------                                  
solaris11_2_1_0_2-i386 derived active  mac = 40:26:7A:A4:1A:41 - 70:71:BC:7C:85:21                   
                       orig_default     derived default none                                      
Service Name           Profile Name Criteria
------------           ------------ --------
solaris11_2_1_0_2-i386 sc.xml      none   

1 comment:

Heider said...

You've discussed in older posts about building a standalone AI dvd with modified manifest/sc_profile/etc. Do you know if it's possible to include the derived manifest script on the DVD as opposed to requiring network connection to the install service?