Operation: create-storage-group

 Home  Previous  Next

The create-storage-group operation creates the association link between a LUN, a host and a controller port which allows the host to access the LUN through the specified port. It is an important step of the process of allocating storage to a server.

Storage Groups also control through which port of the disk array a host can access a LUN. In most classic cases, hosts will need to be able to access a given LUN through all ports of the disk array. So, the create-storage-group operation creates a storage group by exposing the LUN through the specified ports. If no ports are specified then the LUN will be exposed through all the ports of the disk array.

Adapter Request Elements for 'create-storage-group' Operation

 

Definition

Required

operation-name

Specifies the name of the operation you want to perform.

•Valid value: create-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.

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.
•Default value: None.

Yes

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.
•Default value: None.

Yes

wwn

Specify the WWNs to which the LUN must be assigned. Several WWNs can be specified by using the <wwn> element several times.

•Valid value: Any valid string of 16 hexadecimal digits.
•Default value: None.

Yes

iqn

Specifies the name of the iSCSI host(s) to which the LUN(s) must be associated. Several iSCSI hosts can be specified by using the <iqn> element.

•Valid value: Any valid string.
•Default value: None.

No

host-name

Specifies the name of the host that owns the specified WWNs.

•Valid value: Any value.
•Default value: None.

No

host-ipaddress

Specifies the IP address of the host that owns the specified WWNs.

•Valid value: any valid IP address
•Default value: None.

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.
•Default value: None.

No

disconnect-host-from-other-group

If the specified host is associated with any other storage group, this key value is set to ‘yes’ to disconnect the host from other storage group. This element is applicable only on CLARiiON disk arrays.

•Valid value: yes or no
•Default value: no

No

device-group-name

Specifies the name of the device group that is to be created with the specified LUN(s) masked in it. This element is applicable only on Symmetrix arrays running Enginuity 5874 or above.

•Valid value: Any valid string.
•Default value: None.

No

initiator-group-name

Specifies the name of the initiator group that is to be created with the specified Host(s)[wwn/iqn] masked in it. This element is applicable only on Symmetrix arrays running Enginuity 5874 or above.

•Valid value: Any valid string.
•Default value: None.

No

port-group-name

Specifies the name of the port group that is to be created with the specified Port name(s) masked in it. This element is applicable only on Symmetrix arrays running Enginuity 5874 or above.

•Valid value: Any valid string.
•Default value: None.

No

port-name

Specifies the name of the FC/Ethernet port(s) through which the LUN(s) must be exposed to the Host(s). This element is applicable only on Symmetrix arrays running Enginuity 5874 or higher.

•Valid value: Any valid string.
•Default value: None.

No

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.

•Valid value: yes | no.
•Default value: yes.

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

initiator-group-to-cascade

Specifies the name of the existing initiator group(s) that has to be cascaded with the specified initiator-group-name. This element is applicable only on Symmetrix arrays running Enginuity 5874 or above.

•Valid value: Any valid string.
•Default value: None.

No

fast-policy-name

Specifies the name of the FAST Policy that must be associated with the specified device-group-name. This element is applicable only on Symmetrix arrays running Enginuity 5874 or above.

•Valid value: Any valid string.
•Default value: None.

No

Sample Adapter Request for 'create-storage-group' Operation

Sample 1: Creating a Storage Group (Clariion Arrays)

<emc-storage-request>

    <operation-name>create-storage-group</operation-name>

    <arguments>

      <argument>

        <storage-system-name>CLARiiON+CKM00083900053</storage-system-name>

        <lun-name>00012</lun-name>

        <lun-name>00011</lun-name>

        <storage-group-name>PC02 Group 4</storage-group-name>

        <wwn>10000000C96EB8DA</wwn>

        <wwn>10000000C96EB8DB</wwn>

  <host-name>pascal</host-name>

  <host-ipaddress>172.10.16.14</host-ipaddress>

        <disconnect-host-from-other-group>yes</disconnect-host-from-other-group>

      </argument>

    </arguments>

  </emc-storage-request>

Sample 2: Creating a Storage Group (Symmetrix Arrays)

<emc-storage-request>

    <operation-name>create-storage-group</operation-name>

    <arguments>

      <argument>

        <storage-system-name>SYMMETRIX+000294901120</storage-system-name>

        <storage-group-name>SG_Test</storage-group-name>

        <fast-policy-name>SATA_FC_SSD</fast-policy-name>

        <lun-name>0030A</lun-name>

        <wwn>21000024FF04B66C</wwn>

        <device-group-name>DG_Test</device-group-name>

        <initiator-group-name>IG_Test</initiator-group-name>

        <port-group-name>PG_Test</port-group-name>

        <initiator-group-to-cascade>Pascal</initiator-group-to-cascade>

      </argument>

    </arguments>

  </emc-storage-request>

Adapter Response Elements for 'create-storage-group' Operation

 

Description

storage-system-name

Name of the storage system.

lun-name

Name of the LUN.

wwn

WWN that belongs to the storage group.

create-storage-group-status

Status of the operation.

Sample Adapter Response for 'create-storage-group' Operation

Sample 1: Creating a Storage Group (Clariion Arrays)

<emc-storage-response>

  <metadata>

    <status>success</status>

    <response-count>1</response-count>

  </metadata>

  <responses>

    <response>

      <metadata>

        <status>success</status>

        <execution-milliseconds>46187</execution-milliseconds>

        <line-count>8</line-count>

        <target>pythagoras-p27p</target>

        <config-name>pythagoras-p27p</config-name>

      </metadata>

      <output>

        <storage-groups>

          <storage-group>

            <storage-system-name>CLARiiON+CKM00083900053</storage-system-name>

            <lun-names>

              <lun-name>00012</lun-name>

              <lun-name>00011</lun-name>

            </lun-names>

            <wwns>

              <wwn>10000000C96EB8DA</wwn>

              <wwn>10000000C96EB8DB</wwn>

            </wwns>

            <create-storage-group-status>0 (Success)</create-storage-group-status>

          </storage-group>

        </storage-groups>

      </output>

    </response>

  </responses>

</emc-storage-response>

Sample 2: Creating a Storage Group (Symmetrix Arrays)

<emc-storage-response>

  <metadata>

    <status>success</status>

    <response-count>1</response-count>

  </metadata>

  <responses>

    <response>

      <metadata>

        <status>success</status>

        <execution-milliseconds>11357</execution-milliseconds>

        <line-count>12</line-count>

        <target>pc-emc</target>

        <config-name>default</config-name>

      </metadata>

      <output>

        <storage-groups>

          <storage-group>

            <storage-system-name>SYMMETRIX+000294901120</storage-system-name>

            <storage-group-name>SG_Test</storage-group-name>

            <lun-name>0030A</lun-name>

            <wwn>21000024FF04B66C</wwn>

            <fast-policy-name>SATA_FC_SSD</fast-policy-name>

            <device-group-name>DG_Test</device-group-name>

            <initiator-group-name>IG_Test</initiator-group-name>

            <initiator-group-to-cascade>Pascal</initiator-group-to-cascade>

            <port-group-name>PG_Test</port-group-name>

            <create-storage-group-status>Completed</create-storage-group-status>

            <job-id>4134665155</job-id>

            <job-status-description>Completed - Create Masking View</job-status-description>

          </storage-group>

        </storage-groups>

      </output>

    </response>

  </responses>

</emc-storage-response>