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 in the global zone to perform this procedure.

1. Become superuser, or assume the Primary Administrator role.

   To create the role and assign the role to a user, see Using the Solaris Management Tools With RBAC (Task Map) in System Administration Guide: Basic Administration.

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 / native shared 1 my-zone running /export/home/my-zone native 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 / native shared - my-zone installed /export/home/my-zone native shared

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

   global# zoneadm -z my-zone boot

Troubleshooting

If the halt operation fails, see Zone Does not Halt for troubleshooting tips.