JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris 11.1 Administration: Oracle Solaris Zones, Oracle Solaris 10 Zones, and Resource Management     Oracle Solaris 11.1 Information Library
search filter icon
search icon

Document Information

Preface

Part I Oracle Solaris Resource Management

1.  Introduction to Resource Management

2.  Projects and Tasks (Overview)

3.  Administering Projects and Tasks

4.  Extended Accounting (Overview)

5.  Administering Extended Accounting (Tasks)

6.  Resource Controls (Overview)

7.  Administering Resource Controls (Tasks)

8.  Fair Share Scheduler (Overview)

9.  Administering the Fair Share Scheduler (Tasks)

10.  Physical Memory Control Using the Resource Capping Daemon (Overview)

11.  Administering the Resource Capping Daemon (Tasks)

12.  Resource Pools (Overview)

13.  Creating and Administering Resource Pools (Tasks)

14.  Resource Management Configuration Example

Part II Oracle Solaris Zones

15.  Introduction to Oracle Solaris Zones

16.  Non-Global Zone Configuration (Overview)

17.  Planning and Configuring Non-Global Zones (Tasks)

18.  About Installing, Shutting Down, Halting, Uninstalling, and Cloning Non-Global Zones (Overview)

19.  Installing, Booting, Shutting Down, Halting, Uninstalling, and Cloning Non-Global Zones (Tasks)

Zone Installation (Task Map)

Installing and Booting Zones

(Optional) How to Verify a Configured Zone Before It Is Installed

How to Install a Configured Zone

How to Obtain the UUID of an Installed Non-Global Zone

How to Mark an Installed Non-Global Zone Incomplete

(Optional) How to Transition the Installed Zone to the Ready State

How to Boot a Zone

How to Boot a Zone in Single-User Mode

Where to Go From Here

Shutting Down, Halting, Rebooting, Uninstalling, Cloning, and Deleting Non-Global Zones (Task Map)

Shutting Down, Halting, Rebooting, and Uninstalling Zones

How to Shutdown a Zone

How to Halt a Zone

How to Reboot a Zone

How to Uninstall a Zone

Cloning a Non-Global Zone on the Same System

How to Clone a Zone

Moving a Non-Global Zone

How to Move a Zone That Is Not on Shared Storage

Deleting a Non-Global Zone From the System

How to Remove a Non-Global Zone

20.  Non-Global Zone Login (Overview)

21.  Logging In to Non-Global Zones (Tasks)

22.  About Zone Migrations and the zonep2vchk Tool

23.  Migrating Oracle Solaris Systems and Migrating Non-Global Zones (Tasks)

24.  About Automatic Installation and Packages on an Oracle Solaris 11.1 System With Zones Installed

25.  Oracle Solaris Zones Administration (Overview)

26.  Administering Oracle Solaris Zones (Tasks)

27.  Configuring and Administering Immutable Zones

28.  Troubleshooting Miscellaneous Oracle Solaris Zones Problems

Part III Oracle Solaris 10 Zones

29.  Introduction to Oracle Solaris 10 Zones

30.  Assessing an Oracle Solaris 10 System and Creating an Archive

31.  (Optional) Migrating an Oracle Solaris 10 native Non-Global Zone Into an Oracle Solaris 10 Zone

32.  Configuring the solaris10 Branded Zone

33.  Installing the solaris10 Branded Zone

34.  Booting a Zone, Logging in, and Zone Migration

Glossary

Index

Shutting Down, Halting, Rebooting, and Uninstalling Zones

How to Shutdown a Zone

The shut down procedure cleanly shuts down the zone.

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

  1. Become root or assume an equivalent role.
  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 shutdown subcommand shut down the given zone.
    global# zoneadm -z my-zone shutdown
  4. Also specify the -r option to reboot the zone.
    global# zoneadm -z my-zone shutdown -r boot_options

    See Example 19-2

  5. List the zones running on the system to confirm that the zone has been shut down.
    global# zoneadm list -v

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 root or assume an equivalent role.
  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.

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. Also see How to Shutdown a Zone.

  1. Become root or assume an equivalent role.
  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 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      /                              solaris    shared
     2  my-zone  running      /zones/my-zone                 solaris    excl  

    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

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. Become root or assume an equivalent role.
  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      /                              solaris    shared
     -  my-zone  installed    /zones/my-zone                 solaris    excl  
  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      /                              solaris    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.

If the zonepath is not removed, this could be an indication that this zone is installed in another boot environment. The zonepath and various datasets that exist within the zonepath dataset are not removed while a boot environment exists that has an installed zone with a given zonepath. See beadm(1M) for more information about boot environments.

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