Sun N1 Service Provisioning System User's Guide for Solaris Plug-In 4.0

Solaris Zone Container Component

The Container component is the main component delivered by the Solaris plug-in for use with Solaris zones. The Container component is an untyped component.

The Container component includes several procedures. You can run these procedures directly from the Sun N1 Service Provisioning System interface or from within execution plans.

Component Procedures

create:install

Creating a Container component creates a corresponding local Solaris 10 zone. The host target of this procedure is a Solaris 10 host that is running a provisioning system Remote Agent. The target host type must be set to com.sun.solaris#global_zone. The create procedure uses Solaris 10 zonecfg and zoneadm commands to configure and install a local Solaris 10 zone from the Solaris 10 global zone. After the installation, this procedure then installs a Remote Agent on the newly create local zone. A new host of type com.sun.solaris#local_zone appears on the host page.

attach:install

This procedure is similar to the create procedure, but it does not create the zone. Instead, the procedure attaches to an existing local zone on the host. This procedure creates a Container component in the provisioning system database and installs a remote agent on the existing local zone. The attach procedure is useful for times when a tool other than Sun N1 Service Provisioning System created the zone. For example, you might use the attach procedure when a zone has been created directly through Solaris APIs or by another software management application.

markOnly:install

The markOnly:install procedure adds a Solaris Zone Container Component to the provisioning system database. The markOnly:install procedure does not create a local zone. The markOnly-install procedure does not install a Remote Agent.

delete:uninstall

The delete procedure uses the Solaris 10 zonecfg and zoneadm commands to remove the specified Solaris 10 local zone from the global zone host. The procedure also removes the corresponding Container component from the provisioning system database.

detach:uninstall

The detach procedure is similar to the delete procedure. This procedure removes the Container component from the provisioning system database and uninstalls the Remote Agent. However, the local zone is not removed from the global zone host. If the local zone is booted, it remains booted. If the local zone is halted, it remains halted.

markOnly:uninstall

The markOnly:uninstall procedure removes a Solaris Zone Container Component from the provisioning system database. The markOnly:uninstall procedure does not delete a local zone. The markOnly-delete procedure does not uninstall a Remote Agent.

activate

This procedure activates (boots) a local zone. You select the zone from the list of installed Container components on the targeted Solaris 10 host. The procedure uses the zoneadm -z zonename boot command. This procedure also initiates provisioning system host preparation for unprepared hosts.

deactivate

This procedure deactivates (halts) a local zone. You select the zone from the list of installed Container components on the targeted Solaris 10 host. The procedure uses the zoneadm -z zonename halt command.