Installing and Booting Zones

Use
the zoneadm command described in the zoneadm(1M) man
page to perform installation tasks for a non-global zone. You must be the
global administrator to perform the zone installation. The examples in this
chapter use the zone name and zone path established in Configuring, Verifying, and Committing a Zone.

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

You
can verify a zone prior to installing it. If you skip this procedure, the
verification is performed automatically when you install the zone.

You must be the global administrator in the global zone to perform this
procedure.

Verify a configured zone named my-zone by using the -z option with the name of the zone
and the verify subcommand.

global# zoneadm -z my-zone verify

This message regarding verification of the zone path will be displayed:

Warning: /export/home/my-zone does not exist, so it cannot be verified.
When 'zoneadm install' is run, 'install' will try to create
/export/home1/my-zone, and 'verify' will be tried again,
but the 'verify' may fail if:
the parent directory of /export/home/my-zone is group- or other-writable
or
/export/home1/my-zone overlaps with any other installed zones.

However, if an error message is displayed and the zone fails to verify,
make the corrections specified in the message and try the command again.

If no error messages are displayed, you can install the zone.

How to Install a Configured Zone

You must be the global administrator
in the global zone to perform this procedure.

Solaris 10 8/07: How to Obtain the UUID of an Installed
Non-Global Zone

A
universally unique identifier (UUID) is assigned to a zone when it is installed.
The UUID can be obtained by using zoneadm with the list subcommand and the -p option. The UUID is the fifth
field of the display.

Example 20–1 How to Use the UUID in a Command

If both -uuuid-match and -zzonename are present, the match is done
based on the UUID first. If a zone with the specified UUID is found, that
zone is used, and the -z parameter is ignored. If no zone
with the specified UUID is found, then the system searches by the zone name.

About the UUID

Zones can be uninstalled and reinstalled under the same name with different
contents. Zones can also be renamed without the contents being changed. For
these reasons, the UUID is a more reliable handle than the zone name.

How to Boot a Zone

Booting
a zone places the zone in the running state. A zone can be booted from the
ready state or from the installed state. A zone in the installed state that
is booted transparently transitions through the ready state to the running
state. Zone login is allowed for zones in the running state.

Tip –

Note that you perform the internal zone configuration when you
log in to the zone for the first time. This is described in Internal Zone Configuration.

Example 20–2 Specifying Boot Arguments for Zones

Zone administrator reboot of the zone my-zone,
using the -mverbose option:

my-zone# reboot -- -m verbose

Troubleshooting

If a message indicating that the system was unable to find the netmask
to be used for the IP address specified in the zone's configuration displays,
see netmasksWarning Displayed When Booting Zone.
Note that the message is only a warning and the command has succeeded.

How to Boot a Zone in Single-User Mode

You must be the global administrator in the global zone to perform
this procedure.