Locale Selection in the Automated Installer

The following sections describe possible adjustments to Automated Installer manifests that alter the locale, keyboard, and timezone preferences.

Selecting Locales to Be Installed

The selection of locales to be installed is done by setting the appropriate facets in the AI manifest. The <software><image> element contain the element facet with the following syntax:

<facet set="true|false">facet-name</facet>

The following sample manifest uses the facet elements to make sure that only the German (in Germany) and English (in the United States) locales and translations are installed on the target machine:

<!DOCTYPE auto_install SYSTEM "file:///usr/share/install/ai.dtd.1">
<auto_install>
    <ai_instance auto_reboot="true" name="ai-german">
...
    <software type="IPS">
        <destination>
            <image>
                <!-- deselect all locales -->
                <facet set="false">facet.locale.*</facet>
                <!-- specify specific locales to install -->
                <!-- install German and English only -->
                <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>
            </image>
        </destination>
...
    </software>
    </ai_instance>
</auto_install>

You can obtain a list of available locale facets from the system/locale package by issuing a command similar to the following example:

$ pkg contents -m system/locale | /usr/gnu/bin/grep -o facet.locale.[^\ ]* | sort -u

For more details about manifest creation, see the ai_manifest(4) man page.

Non UTF-8 Locales

Non UTF-8 (legacy) locales are not part of the default installation, but are still available in the system/locale/extra package. For example, in order to install the de_DE.ISO8859-1 locale, the package system/locale/extra has to be added to the AI manifest too.

...
    <software_data action="install">
        <name>pkg:/entire@release</name>
        <name>pkg:/group/system/solaris-desktop</name>
        <name>pkg:/system/locale/extra</name>
    </software_data>
...

Setting the Default System Locale, Keymap and Timezone

The default system locale of a machine installed through the Automated Installer can be specified in the System Configuration (SC) profile, as described in the service_bundle(4) and installadm(1M) man pages. For more information, see Providing Configuration Profiles in Installing Oracle Solaris 11 Systems

The following example shows a system configuration profile which sets the default system locale to German.

<!DOCTYPE service_bundle SYSTEM "/usr/share/lib/xml/dtd/service_bundle.dtd.1">
<service_bundle type="profile" name="system configuration">
...
    <service name='system/environment' version='1'>
        <instance name='init' enabled='true'>
            <property_group name='environment'>
                <propval name='LANG' value='de_DE.UTF-8'/>
            </property_group>
        </instance>
    </service>
...
</service_bundle>

Other international environment settings that were transitioned to the Service Management Facility (SMF) can be set in a similar fashion. The following example shows a part of a system configuration profile that sets the installed machine to use the UK-English keyboard layout and the GMT timezone.

<!DOCTYPE service_bundle SYSTEM "/usr/share/lib/xml/dtd/service_bundle.dtd.1">
<service_bundle type="profile" name="system configuration">
...
    <service name='system/keymap' version='1'>
        <instance name='default' enabled='true'>
            <property_group name='keymap'>
                <propval name='layout' value='UK-English'/>
            </property_group>
        </instance>
    </service>

    <service name='system/timezone' version='1'>
        <instance name='init' enabled='true'>
            <property_group name='timezone'>
                <propval name='localtime' value='GMT'/>
            </property_group>
        </instance>
    </service>
...
</service_bundle>