System Administration Guide: Virtualization Using the Solaris Operating System
Previous Next

Halting, Rebooting, Uninstalling, Cloning, and Deleting lx Branded Zones (Task Map)

Task

Description

For Instructions

Halt a zone.

The halt procedure is used to remove both the application environment and the virtual platform for a zone. The procedure returns a zone in the ready state to the installed state. To cleanly shut down a zone, see How to Use zlogin to Shut Down an lx Branded Zone.

How to Halt an lx Branded Zone

Reboot a zone.

The reboot procedure halts the zone and then boots it again.

How to Reboot an lx Branded Zone

Uninstall a zone.

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

How to Uninstall a Branded Zone

Provision a new non-global zone based on the configuration of an existing zone on the same system.

Cloning a zone is an alternate, faster method of installing a zone. You must still configure the new zone before you can install it.

Cloning an lx Branded Zone on the Same System

Delete a non-global zone from the system.

This procedure completely removes a zone from a system.

Deleting an lx Branded Zone From the System

Halting, Rebooting, and Uninstalling lx Branded Zones

How to Halt an lx Branded Zone

The halt procedure is used to remove both the application environment and the virtual platform for an lx branded zone. To cleanly shut down a zone, see How to Use zlogin to Shut Down an lx Branded 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  lx-zone  running      /export/home/lx-zone  lx         shared
  3. Use the zoneadm command with the -z option, the name of the zone, for example, lx-zone, and the halt subcommand to halt the given zone.
    global# zoneadm -z lx-zone halt
  4. List the zones on the system again, to verify that lx-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
    -  lx-zone    installed     /export/home/lx-zone  lx         shared
  5. Boot the zone if you want to restart it.
    global# zoneadm -z lx-zone boot
Troubleshooting

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

How to Reboot an lx Branded 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  lx-zone  running      /export/home/lx-zone  lx         shared
  3. Use the zoneadm command with the -z reboot option to reboot the zone lx-zone.
    global# zoneadm -z lx-zone reboot
  4. List the zones on the system again to verify that lx-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      /                     native     shared
     2  lx-zone  running      /export/home/lx-zone  lx         shared

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


How to Uninstall a Branded Zone

Caution - This procedure removes all of the files in the zone's root file system. The action is irreversible.


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

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 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
    -  lx-zone    installed     /export/home/lx-zone  lx         shared
  3. Use the zoneadm command with the -z uninstall option to remove the zone lx-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 lx-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 lx-zone is no longer listed.
    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
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.

Previous Next