Halting, Rebooting, and Uninstalling Zones

How to Halt a Zone

The halt procedure is used to remove both the application environment and the virtual platform for a zone. To cleanly shut down a zone, see How to Use zlogin to Shut Down a Zone.

You must be the global administrator or a user with appropriate authorizations in the global zone to perform this procedure.

1. Be superuser, or have equivalent authorizations.

   For more information about roles, see Configuring and Using RBAC (Task Map) in System Administration Guide: Security Services.

2. List the zones running on the system.

   global# zoneadm list -v

   You will see a display that is similar to the following:

   ID  NAME     STATUS       PATH                           BRAND      IP
    0  global   running      /                              ipkg       shared
    1  my-zone  running      /zones/my-zone                 ipkg       shared

3. Use the zoneadm command with the -z option, the name of the zone, for example, my-zone, and the halt subcommand to halt the given zone.

   global# zoneadm -z my-zone halt

4. List the zones on the system again, to verify that my-zone has been halted.

   global# zoneadm list -iv

   You will see a display that is similar to the following:

   ID  NAME     STATUS       PATH                           BRAND      IP
    0  global   running      /                              ipkg       shared
    -  my-zone  installed    /zones/my-zone                 ipkg       shared

5. Boot the zone if you want to restart it.

   global# zoneadm -z my-zone boot

Troubleshooting

If the zone does not halt properly, see Zone Does Not Halt for troubleshooting tips.

How to Reboot a Zone

You must be the global administrator or a user with appropriate authorizations in the global zone to perform this procedure.

1. Be superuser, or have equivalent authorizations.

   For more information about roles, see Configuring and Using RBAC (Task Map) in System Administration Guide: Security Services.

2. List the zones running on the system.

   global# zoneadm list -v

   You will see a display that is similar to the following:

   ID  NAME     STATUS       PATH                           BRAND      IP
    0  global   running      /                              ipkg       shared
    1  my-zone  running      /zones/my-zone                 ipkg       shared

3. Use the zoneadm command with the -z reboot option to reboot the zone my-zone.

   global# zoneadm -z my-zone reboot

4. List the zones on the system again to verify that my-zone has been rebooted.

   global# zoneadm list -v

   You will see a display that is similar to the following:

   ID  NAME     STATUS       PATH                           BRAND      IP
    0  global   running      /                              ipkg       shared
    2  my-zone  running      /zones/my-zone                 ipkg       shared

   ---

   Tip - Note that the zone ID for my-zone has changed. The zone ID generally changes after a reboot.

   ---

How to Uninstall a Zone

---

Caution - Use this procedure with caution. The action of removing all of the files in the zone's root file system is irreversible.

---

The zone cannot be in the running state. The uninstall operation is invalid for running zones.

You must be the global administrator or a user with appropriate authorizations in the global zone to perform this procedure.

1. Be superuser, or have equivalent authorizations.

   For more information about roles, see Configuring and Using RBAC (Task Map) in System Administration Guide: Security Services.

2. List the zones on the system.

   global# zoneadm list -v

   You will see a display that is similar to the following:

   ID  NAME     STATUS       PATH                           BRAND      IP
    0  global   running      /                              ipkg       shared
    -  my-zone  installed    /zones/my-zone                 ipkg       shared

3. Use the zoneadm command with the -z uninstall option to remove the zone my-zone.

   You can also use the -F option to force the action. If this option is not specified, the system will prompt for confirmation.

   global# zoneadm -z my-zone uninstall -F

   Note that when you uninstall a zone that has its own ZFS file system for the zonepath, the ZFS file system is destroyed.

4. List the zones on the system again, to verify that my-zone is no longer listed.

   global# zoneadm list -iv

   You will see a display that is similar to the following:

   ID  NAME     STATUS       PATH                           BRAND      IP
    0  global   running      /                              ipkg       shared

Troubleshooting

If a zone uninstall is interrupted, the zone is left in the incomplete state. Use the zoneadm uninstall command to reset the zone to the configured state.

Use the uninstall command with caution because the action is irreversible.