addVolume

Creates an eDirectory pool object for an already existing NSS storage pool.

Request

<addVolume type=" ">
   <name/>
   <context/>
   <volumeName/>
   <poolName/>
   <ndsPoolName/>
   <dfsGUID/>
</addVolume>

Reply

<addVolume>
   <result value=" ">
      <description/>
   </result>
</addVolume>

Elements

name: (Required) Specifies the name of the eDirectory volume object to create. If NULL is specified, the name of the eDirectory volume object is generated by prepending the server name and an underscore to the volume name.
context: (Required) Specifies the eDirectory context in which the eDirectory volume object is created. If NULL is specified, the eDirectory volume object is created in the same context where the server object resides.
volumeName: Specifies the name of the volume on the server.
poolName: (Required for NSS) Specifies the name of the pool on the server. This element is ignored for traditional volumes.
ndsPoolName: (Required for NSS) Specifies the value to be use as the nssfsPool attribute name of the eDirectory volume object. If NULL is specified, the pool's actual eDirectory name is retrieved and used for the nssfsPool attribute. This element is ignored for traditional volumes.
dfsGUID: Specifies the value used as the dfs-volume-guid attribute for the eDirectory volume object.
result: Specifies an error value or 0 (for no error).
description: Specifies a text description of the result.

Example

A nssRequest packet to add a volume is as follows:

<ndsRequest>
   <ndsVolume>
      <addVolume>
         <volumeName>NSS1</volumeName>
         <poolName>MYPOOL</poolName>
         <dfsGUID>
            D428AB28-3216-01D6-80-01-BD09318C30CA
         </dfsGUID>
         <name>
         <context>
         <ndsPoolName>
      </addVolume>
   </ndsVolume>
</ndsRequest>

A nssReply packet to the add volume command follows:

<nssReply>
   <ndsVolume>
      <addVolume>
         <result value="0">
            <description/>success</description>
         </result>
      </addVolume>
   </ndsVolume>
   <result value="0">
      <description/>zOK</description>
   </result>
</nssReply>