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

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.

1. Become root or assume an equivalent role.
2. Install the configured zone s10-zone by using the zoneadm install command with the -p and -a options and the path to the archive:

   global# zoneadm -z s10-zone install -a /net/machine_name/s10-system.flar -p

   You will see various messages as the installation completes. This can take some time.

3. (Optional) If an error message is displayed and the zone fails to install, use the zoneadm list command and the -c and -v options to get the zone state:

   global# zoneadm list -civ

   ID  NAME     STATUS       PATH                           BRAND      IP
    0  global   running      /                              solaris    shared
    -  s10-zone configured   /zones/s10-zone                solaris10  shared

   • If the state is listed as configured, make the corrections specified in the message and try the zoneadm install command again.

   • If the state is listed as incomplete, first execute this command:

     global# zoneadm -z my-zone uninstall

     Then, make the corrections specified in the message and try the zoneadm install command again.

4. When the installation completes, use the list subcommand with the -i and -v options to list the installed zones and verify the status.

   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
    -  s10-zone  installed    /zones/s10-zone               solaris10   shared

Example 33-1 solaris10 Zone Installation

# zoneadm -z s10sepvar install -a /net/data13/tmp/s10u10_sparc_sepvar.flar -p
The following ZFS file system(s) have been created:
    rpool/zones/s10sepvar
Progress being logged to /var/log/zones/zoneadm.20120519T151123Z.s10sepvar.install
    Installing: This may take several minutes...

Troubleshooting

If an installation fails, review the log file. On success, the log file is in /var/log inside the zone. On failure, the log file is in /var/log/zones in the global zone.

If a zone installation is interrupted or fails, the zone is left in the incomplete state. Use the uninstall command with the -F option to reset the zone to the configured state.