|
The get-storage-group operation lists all of the defined Storage Groups in the EMC SMI-S Provider (or in the specified storage system). The result of this operation provides a comprehensive view of which host can access which LUN through which controller port.
This operation is a mandatory step in the scenario of decommissioning a server and its associated storage volumes.
Adapter Request Elements for 'get-storage-group' Operation
|
|
|
|
operation-name
|
| • | Specifies the name of the operation you want to perform. |
Valid value: get-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
|
timeout-secs
|
Specifies the time in seconds after which the attempt to connect to the EMC SMI-S Provider times out. The "timeout-secs" specified in adapter request overrides the value specified in adapter configuration.
| • | Valid value: A numeric value which specifies the time in seconds. |
| • | Default Value: 180, if no "timeout-secs" is provided in 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 user defined storage system name.
| • | Valid value: Please refer to the get-storage-system operation to list the valid values of this field. |
|
No
|
port-name
|
Specifies the user defined port name.
| • | Valid value: Please refer to the get-port operation to list the valid values of this field. |
|
No
|
lun-name
|
Specifies the user defined lun name.
| • | Valid value: Please refer to the get-lun operation to list the valid values of this field. |
|
No
|
storage-group-name
|
Specifies the user defined storage group name.
| • | Valid value: Please refer to the get-storage-goup operation to list the valid values of this field. |
|
No
|
wwn
|
Returns the complete information of the host group(s) to which this specific wwn is associated. When the "wwn" element is not present, the command reports on all host groups.
| • | Valid value: Any valid string. |
|
No
|
iqn
|
Returns the complete information of the host group(s) to which this specific iSCSI host is associated. When the "iqn" element is not present, the command reports on all host groups.
| • | Valid value: Any valid string. |
|
No
|
device-group-name
|
Returns the complete information of the host group(s) to which this specific device-group is associated. This element is applicable only on Symmetrix arrays running Enginuity 5874 or above.
| • | Valid value: Any valid string. |
|
No
|
initiator-group-name
|
Returns the complete information of the host group(s) to which this specific initiator-group is associated. This element is applicable only on Symmetrix arrays running Enginuity 5874 or above.
| • | Valid value: Any valid string. |
|
No
|
port-group-name
|
Returns the complete information of the host group(s) to which this specific port-group is associated. This element is applicable only on Symmetrix arrays running Enginuity 5874 or above.
| • | Valid value: Any valid string. |
|
No
|
Sample Adapter Request for 'get-storage-group' Operation
<emc-storage-request>
<operation-name>get-storage-group</operation-name>
<arguments>
<argument>
<storage-system-name />
<storage-group-name/>
<lun-name/>
<port-name/>
<wwn />
<iqn />
<device-group-name />
<initiator-group-name />
<port-group-name />
</argument>
</arguments>
</emc-storage-request>
Adapter Response Elements for 'get-storage-group' Operation
|
|
|
storage-system-name
|
Name of the storage system.
|
storage-group-name
|
Name of the storage group.
|
lun-name
|
Name of the LUN.
|
port-name
|
Name of the port.
|
iqn
|
iSCSI host that belongs to the storage group.
|
wwn
|
WWN that belongs to the storage group.
|
fast-policy-name
|
Name of the FAST policy that is associated with the specified device-group-name.
|
device-group-name
|
Name of the device group that specifies the associated LUN.
|
initiator-group-name
|
Name of the initiator group that specifies the associated WWN.
|
port-group-name
|
Name of the port group.
|
Sample Adapter Response for 'get-storage-group' Operation
<emc-storage-response>
<metadata>
<status>success</status>
<response-count>1</response-count>
</metadata>
<responses>
<response>
<metadata>
<status>success</status>
<execution-milliseconds>33165</execution-milliseconds>
<line-count>144</line-count>
<storage-group-count>15</storage-group-count>
<target>locke-2</target>
<config-name>default</config-name>
</metadata>
<output>
<storage-groups>
<storage-group>
<storage-system-name>CLARiiON+CKM00083900053</storage-system-name>
<storage-group-name>testiScsi</storage-group-name>
<lun-name>02044</lun-name>
<port-names>
<port-name>SP_A:2</port-name>
<port-name>SP_B:2</port-name>
</port-names>
<iqn>iqn.1991-05.com.microsoft:pnetag.internal.sentrysoftware.net</iqn>
</storage-group>
<storage-group>
<storage-system-name>CLARiiON+CKM00083900053</storage-system-name>
<storage-group-name>10000000C96EB8DA</storage-group-name>
<lun-name>00001</lun-name>
<port-names>
<port-name>SP_A:1</port-name>
<port-name>SP_B:1</port-name>
</port-names>
<wwn>10000000C96EB8DA</wwn>
</storage-group>
<storage-group>
<storage-system-name>SYMMETRIX+000294901120</storage-system-name>
<storage-group-name>Locke2</storage-group-name>
<lun-name>0013E</lun-name>
<port-names>
<port-name>FA-7E:0</port-name>
<port-name>FA-7E:1</port-name>
<port-name>FA-8E:0</port-name>
<port-name>FA-8E:1</port-name>
<port-name>FA-7F:0</port-name>
<port-name>FA-7F:1</port-name>
<port-name>FA-8F:0</port-name>
<port-name>FA-8F:1</port-name>
<port-name>FA-7G:0</port-name>
<port-name>FA-7G:1</port-name>
<port-name>FA-8G:0</port-name>
<port-name>FA-8G:1</port-name>
<port-name>FA-7H:0</port-name>
<port-name>FA-7H:1</port-name>
<port-name>FA-8H:0</port-name>
<port-name>FA-8H:1</port-name>
</port-names>
<wwn>2100001B328F5C54</wwn>
<fast-policy-name>FP_SSD</fast-policy-name>
<device-group-name>LUN_Locke2</device-group-name>
<initiator-group-name>WWN_Locke2</initiator-group-name>
<port-group-name>Port_Locke2</port-group-name>
</storage-group>
</storage-groups>
</output>
</response>
</responses>
</emc-storage-response>
| 
