Create Zone With Custom Settings operation

The Create Zone With Custom Settings operation creates a new Zone with advanced configuration options. This operation enables you to add virtual devices, such as a hard disk or an ethernet card, to a newly created Zone.

The following figure shows the <items> XML template for the Create Zone With Custom Settings operation:

<items> XML template for the Create Zone With Custom Settings operation

The following table describes the elements for the adapter request.

Note

You can use the Fair Share Scheduler (FSS) to control the allocation of available CPU resources among Zones, based on their importance. This importance is expressed by the number of shares of CPU resources that you assign to each Zone.

Adapter request elements for the Create Zone With Custom Settings operation

Element	Definition	Required
<operation-type>	Specifies the type of operation: Configure_Zone	Yes
<operation-name>	Specifies the operation: Create_Zone_With_Custom_Settings	Yes
<zone-name>	Specifies the name for the Zone that you want to create	Yes
<host>	Specifies the name of the computer hosting Solaris Zones	No
<port>	Specifies the port on which the SSH service is running on the host computer Default value: 22	No
<operation-timeout-secs>	Specifies the time, in seconds, to wait for the operation to finish on the target server If the operation is not successful within this interval, the adapter returns an error message. Default value: 300 seconds	No
<zone-path>	Specifies the path in which the Zone files are installed You must have access permission for the specified Zone path.	Yes
<autoboot>	Specifies whether the Zone is booted when the associated Global Zone is booted Valid values: true = Zone booted false = Zone not booted (default)	No
<pool>	Specifies the configured pool name for the new Zone to bind	No
<boot-arguments>	Specifies persistent boot arguments for the Zone	No
<dedicated-cpu>	Specifies the number of dedicated CPUs for the Zone	No
<no-of-cpu>	Sets the number of CPUs for the Zone	Conditional Required if you specify the <dedicated-cpu> element
<cpu-importance>	Sets the importance for the CPU	No
<cpu-shares>	Specifies the number of Fair Share Scheduler (FSS) shares to allocate to this Zone This property is incompatible with the <dedicated-cpu> element.	No
<privileges>	Specifies the privileges to revise the default set of privileges For example, to add the ability to set the system clock to the default set of privileges, you can use this element.	No
<scheduling-class>	Provides different CPU access characteristics to threads, based on algorithmic logic Valid values: Real-time scheduling class (RT) Interactive scheduling class (IA) Fixed-priority scheduling class (FX) Timesharing scheduling class (TS) Fair-share scheduling class (FSS)	No
<capped-memory>	Sets the memory capacity for the Zone; enables you to place a soft restriction on the amount of memory that the Zone can use For example, to set the memory capacity for the Zone to 500 MB, set this element to 500m.	No
<physical>	Sets the physical memory capacity for the Zone; enables you to restrict the amount of physical memory that the Zone can use For example, to set the physical memory of the Zone to 500 MB, set this element to 500m.	Conditional If you specify <capped-memory>, you must also specify <physical>, <swap>, or <locked>.
<swap>	Sets the swap memory capacity for the Zone; enables you to restrict the amount of virtual memory that the Zone can use For example, to set the virtual memory of the Zone to 1 GB, set this element to 1g.	Conditional If you specify <capped-memory>, you must also specify <physical>, <swap>, or <locked>.
<locked>	Sets the locked memory capacity for the Zone; enables you to place a locked memory cap on the amount of physical memory that the Zone can use For example, to set the locked memory capacity of the Zone to 50 MB, set this element to 50m.	Conditional If you specify the <capped-memory> element, you must also specify <physical>, <swap>, or <locked>.
<file-systems>	Contains file systems to add to the Zone	No
<file-system>	Specifies a file system to add to the Zone	Conditional Required if you specify <file-systems>
<dir>	Sets the mount point for the file system	Conditional Required if you specify <file-system>
<special>	Sets the special file system for the Zone	Conditional Required if you specify the <file-system> element
<type>	Specifies the type of file system for <file-system>	Conditional Required if you specify <file-system>
<datasets>	Contains Zettabyte File System (ZFS) datasets in the storage pool	No
<dataset>	Specifies a ZFS dataset to add to the Zone	Conditional Required if you specify <datasets>
<name>	Specifies path for the ZFS dataset	Conditional Required if you specify <datasets>
<inherit-packages>	Contains file systems that are loopback mounted from the Global Zone	No
<inherit-pkg>	Adds a shared file system that is loopback mounted from the Global Zone	Conditional Required if you specify <inherit-packages>
<dir>	Specifies the directory on the Global Zone to mount in the read-only mode	Conditional Required if you specify <inherit-pkg>
<ip-type>	Sets the Internet protocol type for the Zone to Exclusive-IP Default value: Shared-IP	No
<network-interfaces>	Contains network interfaces	No
<network-interface>	Specifies a network interface to add to the Zone	Conditional Required if you specify <network-interfaces>
<address>	Sets the IP address for the network interface	Conditional Required if you specify <network-interfaces>
<physical>	Sets the physical device type for the network interface	Conditional Required if you specify <network-interfaces>
<default-router>	Sets the default router for the network interface	No
<devices>	Contains network devices	No
<device>	Specifies a device to add to the Zone	Conditional Required if you specify <devices>
<match>	Sets the device match	Conditional Required if you specify <device>
<max-sem-ids>	Sets the maximum number of semaphore IDs for the Zone	No
<attributes>	Contains properties for the Zone	No
<attribute>	Specifies an attribute to add for the Zone	Conditional Required if you specify <attributes>
<name>	Specifies the name for the attribute	Conditional Required if you specify <attribute>
<type>	Specifies the type of the attribute	Conditional Required if you specify <attribute>
<value>	Contains the value for the attribute	Conditional Required if you specify <attributes>
<user-name>	Specifies the user name for the Solaris computer If you specify no user name, the request is executed with the user name specified in the adapter configuration.	No
<password>	Specifies the password corresponding to the user name	Conditional Required if you specify <user-name>

The following figure shows a sample adapter request for the Create Zone With Custom Settings operation, using only the required elements:

<solaris-zones-request>
   <operation-type>Configure_Zone</operation-type>
   <operation-name>Create_Zone_With_Custom_Settings</operation-name>
   <zone-name>Testzone</zone-name>
   <parameters>
     <zone-path>/export/home/zones</zone-path>
   </parameters>
</solaris-zones-request>

The following figure shows a sample adapter request for the Create Zone With Custom Settings operation with the optional elements:

Sample adapter request for the Create Zone With Custom Settings operation with the optional elements

<solaris-zones-request>
   <target>
     <host>vm-sol-abc<host>
     <user-name>admin<user-name>
     <password>adminpass</password>
     <port>8888</port>
   </target>
   <operation-type>Configure_Zone</operation-type>
   <operation-name>Create_Zone_With_Custom_Settings</operation-name>
   <zone-name>testzone</zone-name>
   <parameters>
       <zone-path>/zone/Demozone3</zone-path>
       <autoboot>true</autoboot>
       <pool></pool>
       <network-interfaces>
         <network-interface>
            <address>10.118.243.40</address>
            <physical>eri0</physical>
         </network-interface>
       </network-interfaces>
       <dedicated-cpu>
           <no-of-cpu>2</no-of-cpu>
           <cpu-importance>89</cpu-importance>
       </dedicated-cpu>
       <capped-memory>
           <physical>1M</physical>
           <swap>50M</swap>
           <locked>10</locked>
       </capped-memory>
       <scheduling-class>FSS</scheduling-class>
       <privileges></privileges>
       <file-systems>
         <file-system>
            <dir>/usr/local</dir>
            <special>/export/home/zones</special>
            <type>lofs</type>
         </file-system>
       </file-systems>
       <datasets>
         <dataset>
            <name>/zones</name>
         </dataset>
       </datasets>
       <inherit-packages>
         <inherit-pkg>
            <dir>/export/home/zones</dir>
         </inherit-pkg>
       </inherit-packages>
       <ip-type>exclusive</ip-type>
       <devices>
         <device>
            <match></match>
         </device>
       </devices>
       <max-sem-ids>10485200</max-sem-ids>
       <attributes>
         <attribute>
            <name>comment</name>
            <type>string</type>
            <value>"This is my work zone."</value>
         </attribute>
       </attributes>
       <operation-timeout-secs>700</operation-timeout-secs>
     </parameters>
</solaris-zones-request>

The following figure shows the response for the sample Create Zone With Custom Settings operation:

Sample adapter response for the Create Zone With Custom Settings operation

<solaris-zones-response>
<metadata>
   <status>success</status>
</metadata>
<target-output host="10.128.30.62">
   <metadata>
     <os-id>SunOS</os-id>
     <os-version>5.10</os-version>
     <status>success</status>
   </metadata>
   <operation-output>
     <metadata>
       <command>echo . | zonecfg -z "Testzone" "create ; set
zonepath="/export/home/zones"; exit;"</command>
       <line-count>1</line-count>
       <execution-milliseconds>170</execution-milliseconds>
       <exit-code>0</exit-code>
       <status>success</status>
     </metadata>
     <output>
       <line index="1">Operation Create_Zone_With_Custom_Settings
executed successfully!!</line>
     </output>
   </operation-output>
</target-output>
</solaris-zones-response>

Create Zone With Custom Settings operation

TrueSight Orchestration Content 24.3

On this page