salvageVolume

Salvages or undeletes a deleted NSS logical volume. salvageVolume can also optionally re-add the eDirectory volume object for the undeleted volume.

Request

<salvageVolume state=" ">
   <deletedVolumeName/>
   <volumeName/>
   <ndsName/>
   <context/>
   <poolName/>
   <ndsPoolName/>
   <noNDSObject/>
   <updateVLDB/>
</salvageVolume>

Reply

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

Elements

salvageVolume: Specifies the volume to be salvaged.
deletedVolumeName: (Required) Specifies the internal name of the deleted volume to salvage.
volumeName: (Required) Specifies the new name to assign to the salvaged volume.
ndsName: (Required unless noNDSObject is used) Specifies the name of the eDirectory volume object that represents the volume in eDirectory. If NULL is specified, the name of the eDirectory volume object is generated by pre-pending the server name and an underscore to the name specified in the volumeName element.
context: (Required unless noNDSOjbect is used) Specifies where the eDirectory volume object is created. If no context is specified, defaults to be the same as the server object.
poolName: Specifies the value to use as the nssfsPool attribute of the eDirectory volume object. If NULL is specified, the pool's actual eDirectory name is retrieved from eDirectory and used.
ndsPoolName: (Required unless noNDSObject is used) Specifies the value to use as the nssfsPool attribute of the eDirectory volume object. If NULL is specified, the pool's actual eDirectory name is retrieved from eDirectory and used.
noNDSObject: (Optional) Specifies that no eDirectory objects should be created for the salvaged volume. If used, the ndsName, context, and ndsPoolName elements are ignored.
updateVLDB: Specifies that the DFS Volume Location Database (VLDB) is updated by the XML processing code. This element is used for backward compatibility with ConsoleOne, which does not know about this element but does its own VLDB updating. New code should include this element.
result: Specifies an error value or 0 (for no error).
description: Specifies a text description of the result.

Attributes

state

(Optional) Specifies what state the salvaged volume is set to:

deactive
active
mounted

Defaults to whatever state the current file system policies dictate (see NSS Volume States).

Example

The following example salvages a deleted volume, which is currently named "M8C6CTP2IHL3_DV" on MYPOOL, and renames it MYPOOL. It also creates an eDirectory volume object for NSS2 using the default names.

<nssRequest>
   <deletedVolume>
      <salvageVolume state="mounted">
         <deletedVolumeName>M8C6CTP2IHL3_DV
         </deletedVolumeName>
         <volumeName>NSS2</volumeName>
         <poolName>MYPOOL</poolName>
         <ndsName>
         <context>
         <ndsPoolName>
      </salvageVolume>
   </deletedVolume>
</nssRequest>

A nssReply packet to the salvage volume command follows:

<nssReply>
   <deletedVolume>
      <salvageVolume>
         <result value="0">
            <description/>success</description>
         </result>
      </salvageVolume>
   </deletedVolume>

   <result value="0">
      <description/>zOK</description>
   </result>
</nssReply>