addPoolSnapshot (Linux)

Creates a snapshot (snapName) of a pool and designates another pool (snapPoolName) as a snapshot data repository.

Request

<addPoolSnapshot>
   <poolName/>
   <freeSpaceID/>
   <numSectors/>
   <snapName/>
</addPoolSnapshot>

Reply

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

Elements

poolName: Specifies the name of the pool to take a snapshot of.
freeSpaceID: Specifies the ID of the free space object to use to store the snapshot data.
snapName: Specifies the name of the pool snapshot.
numSectors: Specifies the number of sectors of the free space to use to store the snapshot data.
result: Specifies an error value or 0 (for no error).
description: Specifies a text description of the result.

Example

The following is an example to add a pool snapshot named MYPOOL_S1 to a pool named MYPOOL .

An nss request to add pool snapshot:

<nssRequest>
  <pool>
    <addPoolSnapshot>
      <poolName>/dev/evms/MYPOOL</poolName>
        <freeSpaceID>sdb</freeSpaceID>
        <numSectors>102400</numSectors>
        <snapName>MYPOOL_S1</snapName>
    </addPoolSnapshot>
  </pool>
</nssRequest>

An nss reply packet to add pool snapshot:

<nssReply>
  <pool>
    <addPoolSnapshot>
      <result value="0">
        <description>success</description>
      </result>
    </addPoolSnapshot>
  </pool>
      <result value="0">
        <description>zOK</description>
      </result>
</nssReply>