> Expert > Storage > Command Line > MediaAgent QCommands Using XML Files > Disk Libraries

Editing Disk Library Properties

Updated

You can modify the properties of a disk library using XML.

  1. Download the edit_disk_library_properties.xml file save it on the computer where the command is run.

  2. Open the XML file.

  3. Change the XML parameters.

    Attribute

    Description

    libraryName

    The name of the disk library whose property needs to be updated.

    mountPathUsage

    When the value is set to 1, Spill and fill mount paths usage is selected.
    When the value is set to 2, Fill and Spill mount paths usage is selected.

    numOfWritersForLibrary

    When the value is set to -1, the number of writers allocated in the disk library is maximum.

    usePnpWhenBlank

    Specify that blank disks with no other data is used for data protection operations and allows you to use disks exclusively for data protection purposes.

    Valid values are:

    • 0 (disable)

    • 1 (enable)

    • 2 (do not change)

    lowWaterMark

    Value in (%) for low watermark warning

    Note: This value should be less than or equal to the warning watermark value (%).

    warningWaterMark

    Value in (%) for warning watermark

    Note: This value should be greater than or equal to the low watermark value (%).

    startDataAgingWhenDataOccupiedOnDiskIs

    Specify the disk capacity in percentage. The data ageing will start when the disk consumption reached the defined percentage.

    preventDataDelFromMntPth

    When the value is set to 0, disables prevention of accidental deletion of the mount path contents.
    When the value is set to 1, enables prevention of accidental deletion of the mount path contents.
    When the value is set to 2, the existing settings are not altered.

    stopDataAgingWhenDataOccupiedOnDiskIs

    Specify the disk capacity in percentage, when reached, data is not aged

    preferMountPathWithFreeSpace

    When the value is set to 1, the system uses the mount path with the most free space available while using the round-robin method to write the data.

    preferMountPathAccordingToMA

    When the value is set to 1, the mount path set as the 'preferred' mount path for the MediaAgent (selected in the Data Path tab of Copy Properties dialog box) is picked for write operations.

    hideLibrary

    When the value is set to 1, the library is hidden and is prevented from being displayed in the CommCell Console.

    markLibForMaintenance

    You can mark a library offline for maintenance to perform administrative or maintenance tasks on the library.

    Valid values are:

    • 0 (disable)

    • 1 (enable)

    • 2 (do not change)

    Example:

    • Use this example XML file to set the mount path usage as "Spill and fill mount paths" for a library with name "Library1".

    • Use this example XML file to set the number of writers as "5" for a library with name "Library1".

    • Use this example XML file to set the low watermark as "20" and warning watermark as "40" for a library with name "Library1".

  4. Run the following command from the <software installation directory>\Base folder. 

     
    qoperation execute -af <downloaded location>\edit_disk_library_properties.xml

    Click here to see sample output.

Was this page helpful?