Creating and Using Oracle^® Solaris 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.

1. Become a zone administrator.

   For more information, see Assigning Limited Rights to Zone Administrators.

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.