Install the solaris10 Branded Zone

The zoneadm command described in Part II, Oracle Solaris Zones and in the zoneadm(1M) man page
is the primary tool used to install and administer non-global zones. Operations using
the zoneadm command must be run from the global zone on the
target system.

In addition to unpacking files from the archive, the install process performs checks,
required postprocessing, and other functions to ensure that the zone is optimized to
run on the host.

If you created an Oracle Solaris system archive from an existing system and
use the -p (preserve sysidcfg) option when you install the zone, then the
zone will have the same identity as the system used to create the
image.

If you use the -u (sys-unconfig) option when you install the target zone,
the zone produced will not have a hostname or name service configured.

Caution - You must use either the -p option or the -u option. If you
do not specify one of these two options, an error results.

Installer Options

Option

Description

-a

Location of archive
from which to copy system image. Full flash archive and pax, cpio, gzip
compressed cpio, bzip compressed cpio, and level 0 ufsdump are supported.

-cpath

Pass a
sysidcfg file to use in configuring the zone after the install completes.

-dpath

Location
of directory from which to copy system image.

-d—

Use the -d option
with the dash parameter to direct that the existing directory layout be used
in the zonepath. Thus, if the administrator manually sets up the zonepath directory before
the installation, the -d— option can be used to indicate that the
directory already exists.

-p

Preserve system identity.

Either the -p or the -u must be
used.

-s

Install silently.

-u

sys-unconfig the zone.

Either the -p or the -u must be used.

The
-c can be used in addition to the -u option, to pass in
a sysidcfg file to use in configuring the zone after the installation completes.

-v

Verbose
output.

The -a and -d options are mutually exclusive.

How to Install the solaris10 Branded Zone

A configured solaris10 branded zone is installed by using the zoneadm command with
the install subcommand.

For information about creating images of Oracle Solaris 10 systems, see Creating the Image for Directly Migrating Oracle Solaris 10 Systems Into Zones. To
retain the sysidcfg identity from a system image that you created, without altering
the image, use the -p option after the install subcommand. To remove the
system identity from a system image that you created, without altering the image,
use the -u option. The sys-unconfig occurs to the target zone. The -c
option can be used to include a sysidcfg file that contains the
information used to configure the zone after the install completes.

The example procedure shows how to use the -a option with the created
archive image of a physical installed Oracle Solaris 10 system.

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

Become an administrator.

Install the configured zone s10-zone by using the zoneadminstall command with
the -a option and the path to the archive: