Operation: provision-server

 Home  Previous  Next

Adapter Request for 'provision-server' Operation

 

Definition

Required

storage-system-name

Specifies the storage system name on which the LUN has to be created.

•Valid value: Please refer to the get-storage-system operation to list the valid values of this field.
•Default value: None.

Yes

size-bytes

Specifies the size (in Bytes) of the LUN to be created.

•Valid value: A positive integer. Example value: 1073741824
•Default value: None.

Yes

raid-group OR Thin Pool

Specifies the correct RAID group name or Thin pool name on which the LUN must be created. The RAID group or Thin Pool must already exist.

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

Yes

wwn or iqn

Specifies the name of the host(s) to which the created LUN(s) must be associated.

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

Yes

port-name

Specifies the port name on which the storage group must be created. When the "port-name" element is not present, the command reports on all available ports.

•Valid value: Please refer to the get-port operation to list the valid values of this field.
•Default value: None

No

storage-group-name

Specifies the name of the storage group that is to be created.

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

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

host-name

Specifies the host name of the wwn/iqn to be added.

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

No

host-ipaddress

Specifies the IP address of the of the wwn/iqn to be added.

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

No

disconnect-host-from-other-group

Specifies whether to disconnect the host from other storage group or not. If the 'disconnect-host-from-other-group' element is set to yes then the host will be disconnected from other host group. This element is applicable only on CLARiiON disk arrays.

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

No

Sample Adapter Request for 'provision-server' Operation

<emc-storage-request>

    <operation-name>create-lun</operation-name>

    <arguments>

      <argument>

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

        <raid-group>0003</raid-group>

        <size-bytes>104857600</size-bytes>

        <number-of-luns>2</number-of-luns>

        <host-name>PC-01</host-name>

        <host-ipaddress>172.16.15.5</host-ipaddress> 

        <wwn>10000000C96EB8DB</wwn>

        <storage-group-name>Storage Group 3</storage-group-name>

        <synchronous>yes</synchronous>

      </argument>

    </arguments>

</emc-storage-request>

Sample Adapter Response for 'provision-server' Operation

Response 1: create-lun

<emc-storage-response>

  <metadata>

    <status>success</status>

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

  </metadata>

  <responses>

    <response>

      <metadata>

        <status>success</status>

        <execution-milliseconds>27281</execution-milliseconds>

        <line-count>10</line-count>

        <target>pythagoras-p27p</target>

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

      </metadata>

      <output>

        <luns>

          <lun>

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

            <raid-group>0003</raid-group>

            <lun-names>

              <lun-name>00020</lun-name>

              <lun-name>00021</lun-name>

            </lun-names>

            <size-bytes>104857600</size-bytes>

            <host-name>PC-01</host-name>

            <host-ipaddress>172.16.15.5</host-ipaddress> 

            <wwn>10000000C96EB8DB</wwn>

            <job-id>260921811</job-id>

            <job-status>Completed</job-status>

            <job-status-description>Completed - Volume Create</job-status-description>

          </lun>

        </luns>

      </output>

    </response>

  </responses>

</emc-storage-response>

Response 2: create-storage-group

<emc-storage-response>

  <metadata>

    <status>success</status>

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

  </metadata>

  <responses>

    <response>

      <metadata>

        <status>success</status>

        <execution-milliseconds>34219</execution-milliseconds>

        <line-count>6</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>

           <storage-group-name>Storage Group 3</storage-group-name>

            <lun-names>

              <lun-name>00020</lun-name>

              <lun-name>00021</lun-name>

            </lun-names>

           <host-name>PC-01</host-name>

           <host-ipaddress>172.16.15.5</host-ipaddress> 

           <wwn>10000000C96EB8DB</wwn>

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

          </storage-group>

        </storage-groups>

      </output>

    </response>

  </responses>

</emc-storage-response>