Go to main content

Installing Oracle® Solaris 11.3 Systems

Exit Print View

Updated: April 2019
 
 

Providing Configuration Profiles

System configuration profiles specify system configuration as a set of configuration parameters in the form of an SMF profile. The system configuration profile sets SMF properties for appropriate SMF services.

System configuration profiles are applied during the first boot of the system after AI installation. SMF services responsible for particular configuration areas process SMF properties and configure the system accordingly.

Each AI client can use any number of system configuration profiles. For example, a AI client might be assigned one profile that provides just the host name and IP address for that client. The same AI client and many other clients might be assigned other profiles that set more broadly applicable property values.

If no system configuration profile is provided for a particular AI client, the interactive configuration tool opens on that system upon the first boot after installation. You would need to manually provide the information as prompted.

Creating System Configuration Profiles

    Use one of the following methods to create a system configuration profile:

  • Run the interactive configuration tool and save the output to a file. The following command creates a valid profile called sc_profile.xml from responses you enter interactively:

    # sysconfig create-profile [-o directory] [other-options]

    For other options you can use, see the sysconfig(1M) man page.

    By default, the profile is created in the /system/volatile/profile/ directory. To create sc_profile.xml elsewhere, specify the –o directory option. Before issuing the command, ensure first that directory exists. The new profile overwrites any sc_profile.xml existing in directory.

  • Create the system configuration profile manually, using the property specifications shown in Specifying Configuration in a System Configuration Profile and Example System Configuration Profiles.

    Include the following lines in every system configuration profile:

    <!DOCTYPE service_bundle SYSTEM "/usr/share/lib/xml/dtd/service_bundle.dtd.1">
    <service_bundle type="profile" name="sysconfig">
      <!-- service, property_group, property, and propval specifications -->
    </service_bundle>

    If you specify a service or property that does not apply, that specification is ignored.

    Do not specify any particular property more than one time.

  • A derived manifest script can create a system configuration profile when the script is run. See Example 65, Adding a System Configuration Profile.

    A system configuration profile can express property and attribute values in two ways. One profile can use both methods.

  • Values can be entered explicitly before the profile is added to the install service using the property specifications shown in this chapter.

  • A system configuration profile can include variables that are replaced with valid values when the profile is used to install a system

Validating System Configuration Profiles

Use the installadm validate command to validate system configuration profiles under development for syntactic correctness. The install service you plan to add this profile to must already exist. See Validating a System Configuration Profile for more information about the validate subcommand.

Adding System Configuration Profiles to an Install Service

Use the installadm create-profile command to add a system configuration profile to an install service. The create-profile subcommand validates profiles before adding them to the install service.

Specify criteria so that appropriate AI clients select that system configuration profile. If no criteria are specified, all AI clients use this profile.

Specify the environment for which the profile will be applied to the AI client with the –e option. The environment can be set to one of the following: install for a profile used in the installation environment, system for a profile to be used after installing or all for a profile that can be used in either environment.

A single AI client can match and use more than one system configuration profile. Make sure that no AI client uses a set of profiles such that a particular property is specified more than one time. If an AI client receives more than one specification for any particular property, even if the value of the property is the same in each specification, the behavior of the SMF service being configured is undefined.

If a AI client does not match any criteria specified for any system configuration profile in the install service, the interactive configuration tool opens on that system on first boot after installation.

Use the installadm list command to list profiles that have been added to a given install service and list the criteria and environment that are specified for each profile.

You can use the installadm set-criteria command to change or add to the client selection criteria specified for a profile.

Use the installadm set-profile command to rename a profile or set the environment value of a profile so that the profile will be used in the install environment.

Use the installadm export command to retrieve a copy of the contents of a profile that has been added to an install service. You could modify that copy to create another profile.

Use the installadm update-profile command to replace the contents of a profile that has already been added to an install service.

See Working With Install Services and the installadm(1M) man page for more information about these subcommands.