Previous Topic: dpmzone-clonezone Command--Clone a Zone (Funclet)Next Topic: dpmzone-createpool Command--Create a Resource Pool (Funclet)


dpmzone-createandinstallzone Command--Create and Install a Zone

The createandinstallzone command creates and installs a zone with custom parameters on the Solaris host.

This command has the following format:

dpmzone-createandinstallzone 
[-sc sc_host] 
-host hostname 
-name zonename 
-path zonepath 
-type type
[-archive_path path]
[-autoboot] 
[-if_type name] 
[-ip ip] 
[-pool_name pool] 
[-sched_type sched] 
[-phy_mem pmem] 
[-swap_mem smem] 
[-lock_mem lmem] 
[-desc desc] 
[-pre] 
[-post]
[-locale iso639value]
-sc sc_host

(Optional) Specifies the host name of the Service Controller.

-host hostname

Specifies the Solaris Zones server. This parameter is case-sensitive.

-name zonename

Defines the name of the new zone.

-path zonepath

Defines the path of the new zone.

-type type

Specifies the type of the new zone. Options include the following:

native

Creates a non-global zone with a Solaris 10 operating environment for running applications.

whole-root

Creates a whole root zone that does not inherit packages.

branded

Creates a non-global zone that contains a non-native operating environment for running applications.

Default: native

-archive_path path

(Optional) Specifies the path of the operating environment installer for a branded zone.

Limits: This argument is required for branded zones, but not required for native zones.

-autoboot

(Optional) Specifies that a zone boots automatically at system boot.

Note: If the zones service is disabled on the server, the zone does not autoboot, regardless of the setting of this property. You can enable the service by using the following command:

svcadm enable svc:/system/zones:default
-if_type name

(Optional) Specifies the type of the network interface used by the zone, for example, eri0.

-ip ip

(Optional) Defines the IP address of the zone.

-pool_name pool

(Optional) Specifies the name of the pool with which you associate the zone.

-sched_type shed

(Optional) Specifies the type of scheduler used to allocate CPU time based on shares. Shares are the portion of the system CPU resources allocated to a project. Valid values include the following:

ts

Specifies the Time Share Scheduler which fairly allots CPU resources to every process and does not concentrate CPU resources on a particular process. ts is the default scheduler for the Solaris operating environment.

fss

Specifies the Fair Share Scheduler which allows you to allocate CPU time based on shares.

-phy_mem pmem

(Optional) Defines the physical memory that is assigned to the zone. A scale (K, M, G, T) can be applied to the value of this number, for example, 1M is one megabyte.

-swap_mem smem

(Optional) Defines the swap memory that is assigned to the zone.

-lock_mem lmem

(Optional) Defines the locked memory that is assigned to the zone. Locked memory cannot be paged.

-desc description

(Optional) Defines a description for the zone.

-pre

(Optional) Specifies whether to generate an event before the operation is performed.

-post

(Optional) Specifies whether to generate an event after the operation is performed.

-locale iso639value

(Optional) Specifies an IS0 639_3166 combination to override the default English output, for example, fr_FR for French. To use the locale of the command prompt, specify "native".