Non-Global Zone Configuration and Installation Data

The following files are used to configure and install non-global zones:

config file

Required. The config file is the zone's configuration in file form from the output of the zonecfg export command.

The location of the config file is specified by the source attribute of the configuration element in the AI manifest. AI copies this config file onto the installed client system to be used to configure the zone.

AI manifest

Optional. This AI manifest for zone installation specifies packages to be installed in the zone, along with publisher information and certificate and key files as necessary. See Non-Global Zone AI Manifest for information about creating a custom AI manifest for a zone.

To provide a custom AI manifest for a zone, add the manifest to the install service that is installing the global zone. In the create-manifest command, specify the zonename criteria keyword with the names of all zones that should use this AI manifest.

If you do not provide a custom AI manifest for a non-global zone, the default AI manifest for zones is used as shown in Example 12-1.

Configuration profile

Optional. You can provide zero or more configuration files for a non-global zone. These configuration profiles are similar to the system configuration profiles for configuring the global zone. See Chapter 11, Configuring the Client System for information about system configuration profile files. You might want to provide configuration profile files to specify zone configuration such as users and the root password for the zone administrator. See Non-Global Zone Configuration Profiles for an example configuration profile for a non-global zone.

To provide configuration profile files for a zone, add the configuration profiles to the install service that is installing the global zone. In the create-profile command, specify the zonename criteria keyword with the names of all zones that should use this configuration profile.

If you do not provide any configuration profile files, the system configuration interactive tool runs and queries for required data on first boot of the zone. See Configuring a System for information about using the interactive configuration tool.

The following example adds the /tmp/zmanifest.xml AI manifest to the s11-sparc install service and specifies that zone1 and zone2 should use this manifest.

# installadm create-manifest -n s11-sparc -f /tmp/zmanifest.xml \
-m zmanifest -c zonename="zone1 zone2"

The following example adds the /tmp/z1profile.xml configuration profile to the s11-sparc install service and specifies that zone1 and zone2 should use this profile.

# installadm create-profile -n s11-sparc -f /tmp/z1profile.xml \
-p z1profile -c zonename="zone1 zone2"

The following example adds the /tmp/z2profile.xml configuration profile to the s11-sparc install service and specifies that zone2 should use this profile.

# installadm create-profile -n s11-sparc -f /tmp/z2profile.xml \
-p z2profile -c zonename=zone2

The following example shows the AI manifests and configuration profiles that have been added to the s11-sparc install service.

# installadm list -n s11-sparc -m -p

Manifest         Status   Criteria
--------         ------   --------
orig_default     Default  None
line1-netra2000           mac       = 00:14:4F:2D:7A:DC
zmanifest                 zonename  = zone1 zone2

Profile    Criteria
-------    --------
z1profile  zonename  = zone1 zone2
z2profile  zonename  = zone2

Non-Global Zone AI Manifest

This AI manifest for non-global zone installation is similar to the AI manifest for installing the global zone. See the ai_manifest(4) man page for information about AI manifest elements and attributes.

Do not use the following elements or attributes in a non-global zone AI manifest:

The auto_reboot attribute of the ai_instance element
The http_proxy attribute of the ai_instance element
The disk child element of the target element
The noswap attribute of the logical element
The nodump attribute of the logical element
The configuration element

Only the logical child element of the target element can be used in a non-global zone AI manifest. The logical section defines additional file systems, or datasets.

In the zpool element of the logical element, only the filesystem and be child elements can be used in a non-global zone AI manifest.

The only value supported for the type attribute of the software element is IPS, which is the default value.

Example 12-1 Default Zone AI Manifest

The following file shows the default AI manifest for non-global zones. This manifest is used if you do not provide a custom AI manifest for a zone. This manifest is available at /usr/share/auto_install/manifest/zone_default.xml.

<?xml version="1.0" encoding="UTF-8"?>
<!--

 Copyright (c) 2011, Oracle and/or its affiliates. All rights reserved.

-->
<!DOCTYPE auto_install SYSTEM "file:///usr/share/install/ai.dtd.@DTD_VERSION_AI@">

<auto_install>
    <ai_instance name="zone_default">
        <target>
            <logical>
                <zpool name="rpool">
                    <filesystem name="export" mountpoint="/export"/>
                    <filesystem name="export/home"/>
                    <be name="solaris">
                        <options>
                            <option name="compression" value="on"/>
                        </options>
                    </be>
                </zpool>
            </logical>
        </target>

        <software type="IPS">
            <destination>
                <image>
                    <!-- Specify locales to install -->
                    <facet set="false">facet.locale.*</facet>
                    <facet set="true">facet.locale.de</facet>
                    <facet set="true">facet.locale.de_DE</facet>
                    <facet set="true">facet.locale.en</facet>
                    <facet set="true">facet.locale.en_US</facet>
                    <facet set="true">facet.locale.es</facet>
                    <facet set="true">facet.locale.es_ES</facet>
                    <facet set="true">facet.locale.fr</facet>
                    <facet set="true">facet.locale.fr_FR</facet>
                    <facet set="true">facet.locale.it</facet>
                    <facet set="true">facet.locale.it_IT</facet>
                    <facet set="true">facet.locale.ja</facet>
                    <facet set="true">facet.locale.ja_*</facet>
                    <facet set="true">facet.locale.ko</facet>
                    <facet set="true">facet.locale.ko_*</facet>
                    <facet set="true">facet.locale.pt</facet>
                    <facet set="true">facet.locale.pt_BR</facet>
                    <facet set="true">facet.locale.zh</facet>
                    <facet set="true">facet.locale.zh_CN</facet>
                    <facet set="true">facet.locale.zh_TW</facet>
                </image>
            </destination>
            <software_data action="install">
                <name>pkg:/group/system/solaris-small-server</name>
            </software_data>
        </software>
    </ai_instance>
</auto_install>

Non-Global Zone Configuration Profiles

You can provide a configuration profile for a zone to configure zone parameters such as language, locale, time zone, terminal, users, and the root password for the zone administrator. You can configure the time zone, but you cannot set the time. You can configure DNS.

If you specify configuration that is not allowed in a zone, those property settings are ignored.

The following file shows a sample configuration profile file for non-global zones.

<!DOCTYPE service_bundle SYSTEM "/usr/share/lib/xml/dtd/service_bundle.dtd.1">
<service_bundle type="profile" name="sysconfig">
  <service version="1" type="service" name="system/config-user">
    <instance enabled="true" name="default">
      <property_group type="application" name="root_account">
        <propval type="astring" name="login" value="root"/>
        <propval type="astring" name="password" value="encrypted_password"/>
        <propval type="astring" name="type" value="normal"/>
      </property_group>
    </instance>
  </service>
  <service version="1" type="service" name="system/timezone">
    <instance enabled="true" name="default">
      <property_group type="application" name="timezone">
        <propval type="astring" name="localtime" value="UTC"/>
      </property_group>
    </instance>
  </service>
  <service version="1" type="service" name="system/environment">
    <instance enabled="true" name="init">
      <property_group type="application" name="environment">
        <propval type="astring" name="LC_ALL" value="C"/>
      </property_group>
    </instance>
  </service>
  <service version="1" type="service" name="system/identity">
    <instance enabled="true" name="node">
      <property_group type="application" name="config">
        <propval type="astring" name="nodename" value="z2-test"/>
      </property_group>
    </instance>
  </service>
  <service version="1" type="service" name="system/keymap">
    <instance enabled="true" name="default">
      <property_group type="system" name="keymap">
        <propval type="astring" name="layout" value="US-English"/>
      </property_group>
    </instance>
  </service>
  <service version="1" type="service" name="system/console-login">
    <instance enabled="true" name="default">
      <property_group type="application" name="ttymon">
        <propval type="astring" name="terminal_type" value="vt100"/>
      </property_group>
    </instance>
  </service>
  <service version="1" type="service" name="network/physical">
    <instance enabled="true" name="default">
      <property_group type="application" name="netcfg"/>
    </instance>
  </service>
</service_bundle>

Skip Navigation Links
Exit Print View
	Installing Oracle Solaris 11 Systems Oracle Solaris 11 Information Library