Go to main content

Creating and Using Oracle® Solaris Zones

Exit Print View

Updated: August 2019
 
 

Administering the Zones Delegated Restarter

This section provides instructions for administering the zones delegated restarter. For information about the zones delegated restarter, see Zones Delegated Restarter and the svc.zones(8) man page. For information common to all restarters, see the smf_restarter(7) man page.

  • Use the svcs -R command to show whether svc:/system/zones:default is the restarter for the non-global zone:

    global$ svcs -R svc:/system/zones:default
        STATE          STIME    FMRI
        online         12:11:12 svc:/system/zones/zone:zonename
  • Use the following command to set a property of the zones delegated restarter:

    global$ pfbash svccfg -s svc:/system/zones:default setprop config/property=value
    global$ svcadm refresh svc:/system/zones:default

    Properties for the zones delegated restarter are as follows:

    config/concurrent-boot-shutdown

    The maximum number of concurrent zones booting up or shutting down.

    config/concurrent-suspend-resume

    The maximum number of concurrent zones performing suspend or resume operations.

    For additional information about zones delegated restarter properties, see the svc.zones(8) man page.

Zones Delegated Restarter

Non-global zones are managed by the zones delegated restarter service. The zones delegated restarter runs under the zones service Fault Management Resource Identifier (FMRI), svc:/system/zones:default.

How the Zones Delegated Restarter Works

Each SMF service instance is managed by a restarter. The restarter retrieves instance configuration and provides an execution environment. See the smf_restarter(7) man page for information common to all restarters.

A zone SMF instance with the FMRI svc:/system/zones/zone:zonename is created by an install, attach, or clone zone operation. The zone SMF instance is removed from the system upon uninstall and detach zone operations.

Upon startup, the zones delegated restarter creates a zone SMF instance for any non-global zone that requires an SMF instance. If there is an existing zone SMF instance for a zone but it is in a state lesser than the instance configured, the restarter will remove the existing SMF instance.

    The zones delegated restarter sets up the infrastructure necessary for each zone. The restarter performs the following steps when started:

  • Initiates a zoneadmd daemon for each zone, restarting it when necessary. There will be a running zoneadmd for each zone that is in a state greater than configured.

  • Runs the zoneadm boot command for all zones in the state installed, and runs the zoneadm attach command for all zones in the state unavailable. For more information, see the zoneadm(8) man page.

A zones delegated restarter provides the script in the zones service methods. The zones delegated restarter will be running under the existing zones service FMRI.

Zones Delegated Restarter Properties

The zones delegated restarter can limit the number of concurrent zones booting up or shutting down, and suspending or resuming. The limits are set with the svccfg and svcadm commands by setting the following properties for the zones delegated restarter:

config/concurrent-boot-shutdown

The maximum number of concurrent zones booting up or shutting down.

config/concurrent-suspend-resume

The maximum number of concurrent zones performing suspend or resume operations.

By default the zones delegated restarter performs tasks for all zones in parallel. There is no limit for concurrent zones operations by the zones restarter if the properties are absent, have no value, or have a value set to zero.

The booting process of a non-global zone is considered completed when the zone SMF instance reaches the online state or the maintenance state. See About the Zone SMF Instance Service State for more information about the SMF states for zones.

For more information about the zones delegated restarter, see the svc.zones(8) man page.