JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
International Language Environments Guide for Oracle Solaris 11.1     Oracle Solaris 11.1 Information Library
PDF
search filter icon
search icon

Document Information

Preface

1.  Introduction

2.  Unicode and UTF-8 Locale Support

3.  Working with Languages and Locales

Locale Selection in GNOME Display Manager

How to Select a Locale in GNOME Desktop Manager

How to Start a Session in a Different Language

Setting the Locale in a Terminal Session

Composite Locales

Installing Additional Locales

Locale Facets

What Is a Facet?

Structure of Locale Facets

How to Add Language Support in Package Manager

Adding Language Support From the Command Line

Setting the System's Default Locale

Legacy Locales

Locale Aliasing

Locale Selection in the Installer

Locale Selection in the Automated Installer

Selecting Locales to Be Installed

Non UTF-8 Locales

Setting the Default System Locale, Keymap and Timezone

4.  Desktop Keyboard Preferences and Input Methods

5.  Configuring Fonts

6.  Advanced Topics

A.  Available Locales

Index

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.1 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>