Previous
Where to Go From Here
To log in to the zone , see configuration, see Logging In to an lx Branded Zone.
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. | |
Reboot a zone. | The reboot procedure halts the zone and then boots it again. | |
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. | |
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. | |
Delete a non-global zone from the system. | This procedure completely removes a zone from a 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.
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.
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 0 global running / native 1 lx-zone running /export/home/lx-zone lx
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
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 0 global running / native - lx-zone installed /export/home/lx-zone lx
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.
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.
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 0 global running / native 1 lx-zone running /export/home/lx-zone lx
Use the zoneadm command with the -z reboot option to reboot the zone lx-zone.
global# zoneadm -z lx-zone reboot
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 0 global running / native 2 lx-zone running /export/home/lx-zone lx
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.
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.
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 0 global running / native - lx-zone installed /export/home/lx-zone lx
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.
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 0 global running / native
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.
Cloning an lx Branded Zone on the Same System
Cloning is used to provision a new zone on a system by copying the data from a source zonepath to a target zonepath.
When the source zonepath and the target zonepath both reside on ZFS and are in the same pool, the zoneadm clone command automatically uses ZFS to clone the zone. However, you can specify that the ZFS zonepath be copied and not ZFS cloned.
How to Clone an lx Branded Zone
You must configure the new zone before you can install it. The parameter passed to the zoneadm create subcommand is the name of the zone to clone. This source zone must be halted.
You must be the global administrator in the global zone to perform this procedure.
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.
Halt the source zone to be cloned, which is lx-zone in this procedure.
global# zoneadm -z lx-zone halt
Start configuring the new zone by exporting the configuration of the source zone lx-zone to a file, for example, master.
global# zonecfg -z lx-zone export -f /export/zones/master
Note - You can also create the new zone configuration using the procedure How to Configure the Zone instead of modifying an existing configuration. If you use this method, skip ahead to Step 6 after you create the zone.
Edit the file master. At a minimum, you must set a different zonepath for the new zone, but you can change other attributes, such as the IP address, as well.
Create the new zone, zone1, by using the commands in the file master.
global# zonecfg -z zone1 -f /export/zones/master
Install the new zone, zone1, by cloning lx-zone.
global# zoneadm -z zone1 clone lx-zone
The system displays:
Cloning zonepath /export/home/lx-zone...
If the source zonepath is on a ZFS pool, for example, zeepool, the system displays:
Cloning snapshot zeepool/zones/lx-zone@SUNWzone1 Instead of copying, a ZFS clone has been created for this zone.
List the zones on the system.
global# zoneadm list -iv ID NAME STATUS PATH BRAND 0 global running / native - lx-zone installed /export/home/lx-zone lx - zone1 installed /export/home/zone1 lx
More Information
When a Source zonepath on a
ZFS File System Is Cloned
When the zoneadm command clones a source zonepath that is on its own ZFS file system, the following actions are performed:
The zoneadm command takes a software inventory.
The zoneadm command takes a ZFS snapshot and names it SUNWzoneX, for example, SUNWzone1.
The zoneadm command uses ZFS clone to clone the snapshot.