Go to main content

Automatically Installing Oracle® Solaris 11.4 Systems

Exit Print View

Updated: July 2019
 
 

Administering the AI Server and its Components

This section describes more options for administering and maintaining the AI server and the install services that the AI server hosts.

Selected Options for Setting Up the AI Server

These examples show how to use different options to set up the AI server. The examples assume that your role has the appropriate rights profile to issue the commands. See Using Rights Profiles to Install Oracle Solaris.

Example 8  Disabling AI Support on a Network (–L Option)

By default, the AI server is configured to serve clients on all networks to which the system is connected. In this example, the 192.0.2.0/24 network is removed from servicing AI requests.

$ installadm set-server -L 192.0.2.0/24
Example 9  Including Networks to Be Supported by an AI Server (–l Option)

The following command shows how to allow install services on two networks.

$ installadm set-server -l 192.0.2.0/24, 198.51.100.0/24
Example 10  Configuring the AI Web Server Port Number (–p Option)

An AI server hosts install services by using a web server. By default, the AI web server is hosted on port 5555. The following command changes the port number:

$ installadm set-server -p 7000
Example 11  Configuring the Secure AI Web Server Port Number (–P Option)

A secure AI server hosts install services by using a web server. By default, the secure AI web server is hosted on port 5556. The following command changes the port number:

$ installadm set-server -P 7001
Example 12  Configuring the Default Image Path (–d Option)

By default, images for all install services in the AI server are created in /export/auto_install/service-name. The following command changes the default location.

$ installadm set-server -d /export/aiimages

To override the default directory location for a specific service, use the –d option when creating the service. For example:

$ installadm create-service -d /var/tmp -n myservice
Example 13  Disabling Automatic Updates of the Local DHCP Service on an AI Server (–M Option)

By default, the local ISC DHCP configuration is automatically updated when client and service configurations are modified in the AI server. This example shows how to disable automatic maintenance of the local ISC DHCP configuration.

$ installadm set-server -M
Changed Server
Disabling SMF service svc:/network/dhcp/server:ipv4
Refreshing SMF service svc:/system/install/server:default 

Updating an Existing Install Service

The update-service subcommand updates the image associated with a service alias. The subcommand creates a new service with the updated image. The existing alias is reassigned to the new service.

The –p option specifies a different repository for the image with which the service is updated. If the option is not specified, the same repository as when the service was first created is used. If you specify a publisher, then as an option, you can also specify the key and cert that are needed to create or update that service. See Example 15, Using a Different Repository When Updating an Install Service.

If the –s option is not specified, the newest available version of the install-image/solaris-auto-install package is used from the publisher.

Example 14  Updating an Install Service

Suppose that the following services exist in the AI server.

$ installadm list
Service Name      Base Service       Status Arch  Type Ali Cli Man Pro
------------      ------------       ------ ----  ---- --- --- --- ---
default-i386      solaris11-i386     on     i386  pkg  0   1   1   0
solaris11-i386    -                  on     i386  pkg  1   0   1   0

You update the service:

$ installadm update-service -n default-i386

$ installadm list
Service Name      Base Service         Status Arch  Type Ali Cli Man Pro
------------      ------------         ------ ----  ---- --- --- --- ---
default-i386      solaris11-1-i386     on     i386  pkg  0   1   1   0
solaris11-i386    -                    on     i386  pkg  1   0   1   0
solaris11-1-i386  -                    on     i386  pkg  1   0   1   0

The new service with the updated image is solaris11-i386-1 and becomes the base service of the default-i386 alias.

Example 15  Using a Different Repository When Updating an Install Service

This example shows how to identify the publisher associated with the solaris11_4-i386 service. First type installadm list -v to determine the image path for the service. Then use the image path to identify the current publisher.

Note that the option to specify the key or cert can be used with either the installadm update-service command or the installadm create-service.

$ installadm list -v -n solaris11_4-i386
Service Name      Status Arch  Type Alias Aliases Clients Profiles Manifests
------------      ------ ----  ---- ----- ------- ------- -------- ---------
solaris11_4-i386  on     i386  iso  no    1       0       1        1

   Image Path ........ /export/auto_install/solaris11_4-i386
    ....

$ pkg -R /export/auto_install/solaris11_4-i386 publisher
PUBLISHER        TYPE     STATUS   URI
solaris          origin   online   http://pkg.oracle.com/solaris/release/

This example updates the default service's publisher to example.com/solaris/mybuild.

$ installadm update-service -n default-i386 \
   -p solaris=http://example.com/solaris/mybuild \
...[--key path-to-pem-formatted-key \
    --cert path to pem-formatted-certificate]
Example 16  Using a Different Net Image Package When Updating an Install Service

This example specifies a specific net image package.

$ installadm update-service -n default-i386 -s FMRI

Showing Information About Install Services

The installadm list command shows information about install services and associated clients, AI manifests and system configuration profiles.


Note -  For security related information, see Listing Security Information Related to AI.
Example 17  Listing All Install Services on the AI Server

This example displays all of the install services on this AI server. In this example, four enabled install services are found. Disabled services have an off Status value. To obtain information only about a specific service, add the –n service option in the command.

$ installadm list
Service Name      Base Service       Status Arch  Type Ali Cli Man Pro
------------      ------------       ------ ----  ---- --- --- --- ---
default-i386      solaris11-i386     on     i386  pkg  0   1   1   0
default-sparc     solaris11_4-sparc  on     sparc pkg  0   0   0   1
solaris11-i386    -                  on     i386  pkg  1   0   1   0
solaris11_4-sparc -                  on     sparc pkg  1   0   1   2
Example 18  Listing Clients Associated With Install Services

This example lists all the clients that are associated with the install services on this AI server. The clients were associated with the install services by using the installadm create-client command. See Creating Client-Service Associations.

To obtain client information for only a specific service, add the –n service option in the command.

$ installadm list -c

Service Name      Client Address    Arch  Secure Custom Args Custom Grub
------------      --------------    ----  ------ ----------- -----------
solaris11_4-sparc 00:14:4F:A7:65:70 sparc no     no          no
solaris11_4-i386  08:00:27:8B:BD:71 i386  no     no          no
                  01:C2:52:E6:4B:E0 i386  no     no          no
Example 19  Listing All AI Manifests and System Configuration Profiles

This example lists all AI manifests, derived manifest scripts, and system configuration profiles for all install services on this AI server. The Service and Manifest Name and Profile Name columns display the internal names of the manifests, scripts, or profiles. The Status column identifies the default manifest for each service and any inactive manifests. A manifest is inactive if it does not have any associated criteria and also is not the default. The Criteria column shows the associated client criteria.

Manifests that are named orig_default indicate that they are created by a script that creates default manifests for default services.

To obtain information for only a specific service, add the –n service option in the command.

$ installadm list -m -p
Service Name                     Manifest Name      Type      Status    Criteria
------------                     -------------      ----      ------    --------
default-i386                     orig_default       derived   default   none
default-sparc                    orig_default       derived   default   none
solaris1132-i386                 ipv4               xml       active    ipv4 =
                                                                        198.51.100.0/24
                                                                        - 192.0.2.0/24
                                 mem1               derived   default   (Ignored: mem =
                                                                        2048 MB - 
                                                                        4095 MB)
                                 orig_default       derived   inactive  none
solaris11_4-sparc                sparc-ent          xml       active    mem = 4096 MB
                                                                        - unbounded
                                                                        platform =
                                                                        SUNWSPARC-
                                                                        Enterprise
                                 mem1               derived   default   (Ignored: mem =
                                                                        2048 MB - 
                                                                        4095 MB)
                                 orig_default       derived   inactive  none

Service Name                     Profile Name  Environment Criteria
------------                     ------------  ----------- --------
solaris11_4-i386                 mac2          system      mac = 08:00:27:8B:BD:71
                                                           hostname = server2
                                 mac3          system      mac = 01:C2:52:E6:4B:E0
                                                           hostname = server3
                                 ipv4          system      ipv4 = 203.0.113.0/24 - 
                                                           198.51.100.0/24
                                 mem1          system      mem = 2048 MB - 4095 MB
solaris11_4-sparc                mac1          system      mac = 01:C2:52:E6:4B:E0
                                                           hostname = server1
                                                           ipv4 = 192.0.2.0/24
                                 sparc-ent     system      platform = 
                                                           SUNWSPARC-Enterprise
                                                           mem = 4096-unbounded

If you run this command with the rights profile, an additional column in the list of manifests identifies the type of the manifest, either xml or derived.