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 ZoneThis 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 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 suspendExample 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.