Skip to Content

Advanced Zone operation

This section describes the adapter request and response for the Advanced Zone operation.

Use the <items> element when you call an adapter from an out-of-the-box process in TrueSight Orchestration Development Studio. Use the adapter request XML when you create a custom process by using the Call Adapter activity in TrueSight Orchestration Development Studio.

Move Zone operation

The Move Zone operation, the only operation in the Advanced Zone category, enables you to move a Zone to a new location by specifying the new zone path.

The following figure shows an <items> XML template for the Move Zone operation:

<items> XML template for the Move Zone operation

<items>
<item>
<parameters>
<new-zone-path></new-zone-path>
</parameters>
</item>
</items>

The following table describes the elements for the adapter request:

Adapter request elements for the Move Zone operation

Element

Definition

Required

<operation-type>

Defines the type of operation: Advanced_Zone

Yes

<operation-name>

Defines the name of operation: Move_Zone

Yes

<zone-name>

Specifies the name of the Zone that you want to move

Yes

<new-zone-path>

Specifies the new zone path for the Zone

Yes

<host>

Specifies the host name of the Solaris 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 complete on the target server
If the operation is not successful within this interval, the adapter returns an error message.
Default value: 300 seconds

No

<user-name>

Specifies the user name for the Solaris computer
If no user name is specified, 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 the <user-name> element

The following figure shows the sample adapter request for the Move Zone operation:

Sample adapter request for the Move Zone operation

<solaris-zones-request>
<target>
<host>vm-sol-abc<host>
<user-name>admin<user-name>
<password>adminpass</password>
<port>8888</port>
</target>
<operation-type>Advanced_Zone</operation-type>
<operation-name>Move_Zone</operation-name>
<operation-timeout-secs>300</operation-timeout-secs>
<zone-name>testzone</zone-name>
<parameters>
<new-zone-path>/zones/samplezone</new-zone-path>
</parameters>
</solaris-zones-request>


Warning

Note

You need to specify the elements in the <target> block of the adapter request only if you want to override the elements specified in the adapter configuration.

The following figure shows the response for the sample adapter request:

Sample adapter response for the Move Zone operation

<solaris-zones-response>
<metadata>
<status>success</status>
</metadata>
<target-output host="vm-sol-abc">
<metadata>
<os-id>SunOS</os-id>
<os-version>5.10</os-version>
<status>success</status>
</metadata>
<operation-output>
<metadata>
<command>zoneadm -z "testzone" halt; zoneadm -z "testzone"
move "/zones/samplezone"</command>
<line-count>1</line-count>
<execution-milliseconds>4258</execution-milliseconds>
<exit-code>0</exit-code>
<status>success</status>
</metadata>
<output>
<line index="1">Operation Move_Zone executed successfully!!</line>
</output>
</operation-output>
</target-output>
</solaris-zones-response>

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

TrueSight Orchestration Content 24.3