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. Become an administrator.

   For more information, see Using Your Assigned Administrative Rights in Securing Users and Processes in Oracle Solaris 11.2 .

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      /                              solaris    shared
    1  my-zone  running      /zones/my-zone                 solaris    excl  

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      /                              solaris    shared
    -  my-zone  installed    /zones/my-zone                 solaris    excl  

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.