Go to main content

Creating and Using Oracle® Solaris Kernel Zones

Exit Print View

Updated: December 2018

Configuring the suspend Resource

Suspend and resume are supported for a kernel zone only if a kernel zone has a suspend resource property in its configuration. You must add the suspend resource and set its path or storage property before you can suspend the kernel zone.

Suspend and resume is necessary for warm migration. If you want to perform a warm migration, the suspend resource must use a shared storage location that is accessible to the source host and the target host.

Other uses for suspend and resume include enabling the ability to pause a zone instead of shutting it down when system maintenance is needed. Suspend and resume can enable the kernel zone and its running applications to be ready for use more quickly.

You can also set the autoshutdown=suspend property to enable a kernel zone to be suspended automatically instead of shut down when the global zone is shut down. See Resource Types and Properties in Oracle Solaris Zones Configuration Resources or zonecfg(1M) for more information about the autoshutdown property.

Example 15  Configure the suspend Resource to Enable Pausing a Kernel Zone

This example shows how to set the suspend resource to use a local path to enable suspend and resume so you can pause the kernel zone on the host.

global$ zonecfg -z kz1
zonecfg:kz1> add suspend
zonecfg:kz1:suspend> set path=/system/zones/kz1/suspend
zonecfg:kz1:suspend> end
zonecfg:kz1> info suspend
        path: /system/zones/kz1/suspend
zonecfg:kz1> exit

The zone can be suspended with the following command and later resumed with a zoneadm boot command.

global$ zoneadm -z kz1 suspend
Example 16  Configure the suspend Resource to Enable Warm Migration

This example shows how to reset the suspend resource to use a storage URI for an iSCSI device.

global$ zonecfg -z kz1
zonecfg:kz1> select suspend
zonecfg:kz1:suspend> clear path
zonecfg:kz1:suspend> set storage=iscsi://system/luname.naa.501337600144f0dbf8af1900
zonecfg:kz1:suspend> end
zonecfg:kz1> exit

See Using Warm Migration to Migrate a Kernel Zone for more information.

See the solaris-kz(5) man page for more information on suspend resource property requirements.