|
The add-port-to-storage-group operations creates an additional path visible to the set of hosts. This operations is typically used to provide multi-path view of the LUN to the associated hosts.
 This action is applicable only on Symmetrix disk arrays.
Adapter Request Elements for 'add-port-to-storage-group' Operation
|
|
|
|
operation-name
|
Specifies the name of the operation you want to perform.
| • | Valid value: add-port-to-storage-group. |
|
Yes
|
arguments
|
Parent element for <argument> element.
|
Yes
|
argument
|
Specifies a list of arguments that is required for this operation
|
Yes
|
target
|
Specifies the connection information for an EMC SMI-S Provider.
| • | Valid value: The value specified for <target> element must be the same as the value that has been specified for the name attribute of <config> element in the adapter configuration. You can skip this element. In this case the request will be executed on the first defined adapter configuration. You can leave this element empty. In this case the request will be executed on the first defined adapter configuration. |
| • | Default value: The first defined adapter configuration. |
|
No
|
You can specify one or more of the following elements to retrieve specific information. If none of the elements is specified, then all the details are fetched.
|
storage-system-name
|
Specifies the storage system name from which the information has to be collected.
|
Yes
|
storage-group-name
|
Specifies the storage group name to which the LUN must be added.
|
Yes
|
port-name
|
Specifies the name of the port(s) that must be associated to the storage group.
| • | Valid value: Any valid string. |
|
Yes
|
synchronous
|
Specifies whether to wait until the job completes. Any action performed by EMC SMI-S provider results in creating a job. If the 'synchronous' element is set to yes, the adapter will wait until the job completes. Otherwise the job will be queued.
|
No
|
job-completion-timeout-secs
|
Specifies the time in seconds after which the attempt to complete the job times out.
| • | Valid value: A numeric value which specifies the time in seconds. |
| • | Default value: 180 seconds |
|
No
|
Sample Adapter Request for 'add-port-to-storage-group' Operation
<emc-storage-request>
<operation-name>add-port-to-storage-group</operation-name>
<arguments>
<argument>
<storage-system-name>SYMMETRIX+000294901120</storage-system-name>
<storage-group-name>Masking_Group</storage-group-name>
<port-name>FA-8G:0</port-name>
<port-name>FA-8G:1</port-name>
</argument>
</arguments>
</emc-storage-request>
Adapter Response Elements for 'add-port-to-storage-group' Operation
|
|
|
storage-system-name
|
Name of the storage system.
|
storage-group-name
|
Name of the storage group.
|
port-group-name
|
Name of the port group.
|
port-name
|
Name of the port.
|
job-id
|
Number identifying the job.
|
add-port-status
|
Status of the operation.
|
job-status-description
|
Detailed information about the status of the job.
|
Sample Adapter Response for 'add-port-to-storage-group' Operation
<emc-storage-response>
<metadata>
<status>success</status>
<response-count>1</response-count>
</metadata>
<response>
<metadata>
<status>success</status>
<execution-milliseconds>65176</execution-milliseconds>
<line-count>9</line-count>
</metadata>
<output>
<storage-groups>
<storage-group>
<storage-system-name>SYMMETRIX+000294901120</storage-system-name>
<storage-group-name>Masking_Group</storage-group-name>
<port-group-name>4DD5AF0B33A</port-group-name>
<port-names>
<port-name>FA-8G:0</port-name>
<port-name>FA-8G:1</port-name>
</port-names>
<job-id>208985048</job-id>
<add-port-status>Completed</add-port-status>
<job-status-description>Completed - Masking group: Add members - Target Masking Group</job-status-description>
</storage-group>
</storage-groups>
</output>
</response>
</emc-storage-response>
| 
