Creating Storage Policies Using XML Files

Overview

Storage policies act as channel for backup and restore operations. Its chief function is to map data from its original location to a physical media. After creating a storage policy you can configure it. The following sections describe using xml files for creating a storage policy and configuring various properties of a storage policy.

Log On to the CommServe

To run command line operations, you must first login to the CommServe.

From the Command prompt, navigate to <Software_Installation_Directory>/Base and run the following command:

 
qlogin -cs <commserve name> -u <user name>

For example, to log on to CommServe 'server1' with username 'user1':

qlogin -cs server1 -u user1

Run Command Line Operations

To run the command line operations, you can download the .xml file, update the relevant XML parameters and then execute the following command from the software_installation_directory/Base folder.

 
qoperation execute −af <downloaded location>\template.xml

For example, to execute an xml file, template.xml located at 'c:\program files\software\base:

qoperation execute −af c:\program files\software\base\template.xml

Log Off from the CommServe

Once you have completed the command line operations, you can logout from the CommServe using the following command:

 
qlogout -cs commserve

For example, to log out from the CommServe 'Server1'.

qlogout -cs Server1

Available Parameters for Storage Policy Configuration

The following table displays all the parameters you can use with the commands. To add a parameter to your command, use the following syntax: (An example is provided at the end of the table.)

qoperation execute -af <template XML File> -<parameter name> <value>

See Also: Available Elements for Modifying Data Encryption Properties

Creating a Storage Policy

Storage Policy creation using xml is defined under the root tag App_CreateStoragePolicyReq. Information about the retention settings, library name and MediaAgent name is specified under the storagePolicyCopyInfo tag. Nested under the storagePolicyCopyInfo tag is the retentionRules tag which defines the basic retention rules.

1. Download the SP_creation.xml file and save it on the computer from where the command will be executed.

2. Before running the command, review the Available Parameters for Storage Policy Configuration.

3. Execute the following command from the software_installation_directory/Base folder after substituting the parameter values.

   qoperation execute -af <download location>\SP_creation.xml -storagePolicyName xxxxx -libraryName xxxxx -mediaAgentName xxxxx -retainArchiverDataForDays xx -retainBackupDataForCycles xx -retainBackupDataForDays xx -numberOfStreams xx

   Example

   To create a storage policy with name “SP1”, Library name “Lib1”, MediaAgent Name “MA1”, and infinite retention period.

   qoperation execute -af <download location>\SP_creation.xml -storagePolicyName SP1 -libraryName Lib1 -mediaAgentName MA1

   To create a storage policy with name “SP2”, Library name “Lib2”, MediaAgent Name “MA2” and retain archiver data in the primary copy for 5 days, retain backup data in the primary copy 5 days and 10 cycles.

   qoperation execute -af <downloaded location>\SP_creation.xml -storagePolicyName SP2 -libraryName Lib2 -mediaAgentName MA2 -retainArchiverDataForDays 5 -retainBackupDataForCycles 10 -retainBackupDataForDays 5

   To create a storage policy with name “SP2”, Library name “Lib2”, MediaAgent Name “MA2” and specify the data retention time for a specific job.

   qoperation execute -af <downloaded location>\SP_creation.xml -storagePolicyName SP2 -libraryName Lib2 -mediaAgentName MA2 -retainArchiverDataForDays 5 -retainBackupDataForCycles 10 -retainBackupDataForDays 5

   To create a storage policy with two data paths:

   • To create a storage policy with name “SP2”, MediaAgent with name “MA1” and “MA2”, disk library with name “DiskLib2”.

     qoperation execute -af <downloaded location>\SP_creation.xml -storagePolicyName SP2 -libraryName DiskLib2 -mediaAgentName MA1 -retainArchiverDataForDays 5 -retainBackupDataForCycles 10 -retainBackupDataForDays 10 -numberOfStreams 15 -dataPathProperties/operationFlags/addDataPath true -dataPathProperties/library/libraryName DiskLib2 -dataPathProperties/mediaAgent/mediaAgentName MA2

   • To create a storage policy with name “SP2”, MediaAgent with name “MA1” and “MA2”, tape library with name “TapeLib2”, drive pool with name “Drivepool1” and “Drivepool2”, spare media group with name “Sparemedia1”, scratch pool with name “Scratchpool1”.

     qoperation execute -af <downloaded location>\SP_creation.xml -storagePolicyName SP2 -libraryName TapeLib2 -mediaAgentName MA1 -drivePoolName Drivepool1 -spareMediaGroupName Sparemedia1 -retainArchiverDataForDays 5 -retainBackupDataForCycles 10 -retainBackupDataForDays 10 -numberOfStreams 15 -dataPathProperties/operationFlags/addDataPath true -dataPathProperties/library/libraryName TapeLib2 -dataPathProperties/mediaAgent/mediaAgentName MA2 -dataPathProperties/drivePool/drivePoolName Drivepool2 -dataPathProperties/scratchPool/scratchPoolName Scratchpool1

Creating Deduplication Enabled Storage Policy

To create a storage policy by enabling deduplication using single deduplication database (DDB) the xml tags nested within the storagePolicyCopyInfo tag are retentionRules, commonPdconfig, maInfoList and subStoreList.

1. Download the SP_creation.xml file and save it on the computer from where the command will be executed.

2. Before running the command, review the Available Parameters for Storage Policy Configuration.

3. Execute the following command from the <software_installation_directory>/Base folder after substituting the parameter values.

   qoperation execute -af <downloaded location>\SP_creation.xml -storagePolicyName xxxxx -libraryName xxxxx -mediaAgentName xxxxx -retainArchiverDataForDays xx -retainBackupDataForCycles xx -retainBackupDataForDays xx -maInfoList/mediaAgent/mediaAgentName xxxxx -path xxxxx -sidbBlockSizeKB xxx -enableDASHFull 1 -enableDeduplication 1

   Example

   To create a storage policy SP2 with Library Lib1, MediaAgent MA1, the SIDB store located on MA2, SIDB path “c:\SIDB”, and SIDB block size 512KB.

   qoperation execute -af <downloaded location>\SP_creation.xml -storagePolicyName SP2 -libraryName Lib1 -mediaAgentName MA1 -retainArchiverDataForDays 5 -retainBackupDataForCycles 10 -retainBackupDataForDays 5 -maInfoList/mediaAgent/mediaAgentName MA2 -path c:\SIDB -sidbBlockSizeKB 512 -enableDASHFull 1 -enableDeduplication 1

Enabling an Incremental Storage Policy

You can create a standard storage policy for all the Full backups and an incremental storage policy for incremental and differential backups.

1. Download the SP_creation.xml file and save it on the computer from where the command will be executed.

2. Before running the command, review the Available Parameters for Storage Policy Configuration.

3. Execute the following command from the software_installation_directory/Base folder after substituting the parameter values.

   qoperation execute -af <downloaded location>\SP_creation.xml -storagePolicyName xxxx -incrementalStoragePolicy/storagePolicyName xxxx -mediaAgentName xxxx -libraryName xxxx -retainArchiverDataForDays xx -retainBackupDataForCycles xx -retainBackupDataForDays xx

   Example

   To create storage policy with name "SP_Incremental" and use "SP1" storage policy as an incremental storage policy.

   qoperation execute -af <downloaded location>\SP_creation.xml -storagePolicyName SP_Incremental -incrementalStoragePolicy/storagePolicyName SP1 -mediaAgentName MA1 -libraryName Lib1 -retainArchiverDataForDays 5 -retainBackupDataForCycles 10 -retainBackupDataForDays 5

   All the incremental backups are directed through the SP1 storage policy.

Creating a Global Deduplication Policy

You can create a global deduplication policy to deduplicate data from multiple storage policies against each other. When a global deduplication policy is created, a storage policy associated with it is also created with the Policy as name suffix.

1. Download the SP_creation.xml file and save it on the computer from where the command will be executed.

2. Before running the command, review the Available Parameters for Storage Policy Configuration.

3. Execute the following command from the software_installation_directory/Base folder after substituting the parameter values.

   qoperation execute -af <downloaded location>\SP_creation.xml -storagePolicyName xxxxx -libraryName xxxxx -mediaAgentName xxxxx -maInfoList/mediaAgent/mediaAgentName xxxxx -path xxxxx -enableGlobalDeduplication 1 -hostGlobalDedupStore 1 -enableDASHFull 1 -enableDeduplication 1

   For example, to create a global deduplication storage policy with name SP_GDSP, Library Lib1, MediaAgent MA1, the SIDB store located on MA2, and SIDB path “c:\SIDB”, execute following command:

   qoperation execute -af <downloaded location>\SP_creation.xml -storagePolicyName SP_GDSP -libraryName Lib1 -mediaAgentName MA1 -maInfoList/mediaAgent/mediaAgentName MA2 -path c:\SIDB -enableGlobalDeduplication 1 -hostGlobalDedupStore 1 -enableDASHFull 1 -enableDeduplication 1

   You can use the SP_GDSP to enable global deduplication for any storage policy created in the CommCell.

Creating a Global Deduplication Enabled Storage Policy

Once you create a global deduplication policy, you can use it to enable global deduplication for any storage policy.

1. Download the SP_creation.xml file and save it on the computer from where the command will be executed.

2. Before running the command, review the Available Parameters for Storage Policy Configuration.

3. Execute the following command from the software_installation_directory/Base folder after substituting the parameter values.

   qoperation execute -af <downloaded location>\SP_creation.xml -storagePolicyName xxxx -useglobalpolicy/storagePolicyName xxxx -enableDeduplication 1 -useGlobalDedupStore 1 -enableDASHFull 1

   For example, to create a global deduplication enabled storage policy, with name SP1, that is using SP_GDSP as a global deduplication policy, execute following command:

   qoperation execute -af <downloaded location>\SP_creation.xml -storagePolicyName SP1 -useglobalpolicy/storagePolicyName SP_GDSP -enableDeduplication 1 -useGlobalDedupStore 1 -enableDASHFull 1

Creating a Global Non-Deduplication Enabled Storage Policy

Once you create a global non-deduplication policy, you can use it to enable global non-deduplication for any storage policy.

1. Download the SP_creation.xml file and save it on the computer from where the command will be executed.

2. Before running the command, review the Available Parameters for Storage Policy Configuration.

3. Execute the following command from the software_installation_directory**/Base folder after substituting the parameter values.

   qoperation execute -af <downloaded location>\sp_copycreation.xml -storagePolicyName 'xxxxx' useGlobalStoragePolicy 1 -useGlobalPolicy/storagePolicyName "xxxxx" -retainArchiverDataForDays xx -retainBackupDataForCycles xx -retainBackupDataForDays xx -copyName 'xxxxx'

   For example, to create a global non-deduplication enabled storage policy, with name SP1, that is using SP_GDSP as a global non-deduplication policy, execute following command:

   qoperation execute -af <downloaded location>\sp_copycreation.xml -storagePolicyName 'SP1' -useGlobalStoragePolicy 1 -useGlobalPolicy/storagePolicyName "SP_GNDSP"

Creating Storage Policy Associated with a OnCommand Unified Manager

If you want to perform the snap vault or snap mirror operations using NetApp filers, you must create a storage policy associated with a OnCommand Unified Manager.

1. Download the SP_creation.xml file and save it on the computer from where the command will be executed.

2. Before running the command, review the Available Parameters for Storage Policy Configuration.

3. Execute the following command from the software_installation_directory/Base folder after substituting the parameter values.

   qoperation execute -af <downloaded location>\SP_creation.xml -storagePolicyName xxxx -libraryName xxxxx -mediaAgentName xxxxx -enableSnapshot 1 -dfmServer/name xxx

   For example, to create a storage policy with name SP1 that is associated with a OnCommand Unified Manager server1, execute following command:

   qoperation execute -af <downloaded location>\SP_creation.xml -storagePolicyName SP_GDSP -libraryName Lib1 -mediaAgentName MA1 -enableSnapshot 1 -dfmServer/name server1

Creating Storage Policy with Partitioned DDB

A Partitioned Deduplication Database (DDB) can improve the scalability of the database by splitting the database on different disks and/or MediaAgents.

1. Download the SP_MultipleDDb_Creation.xml file and save it on the computer from where the command will be executed.

2. Edit the template and specify the deduplication database locations on different disks or MediaAgents.

   For example, to create a SIDB on MA1 and MA2, edit following elements in the XML template:

    
   <DDBPartitionInfo>
        <maInfoList>
            <MediaAgent> 
                <mediaAgentName>MA1</mediaAgentName>
            </mediaAgent>
        <subStoreList>
            <accessPath> 
                <path>PATH1</path>
            </accessPath>
        </subStoreList>
        </maInfoList>
        <maInfoList>
            <MediaAgent> 
                <mediaAgentName>MA2</mediaAgentName>
            </mediaAgent>
        <subStoreList>
            <accessPath> 
                <path>PATH2</path>
            </accessPath>
        </subStoreList>
        </maInfoList>
    </DDBPartitionInfo>

3. Execute the following command from the software_installation_directory/Base folder:

   qoperation execute -af <downloaded location>\SP_MultipleDDb_Creation.xml -storagePolicyName xxx -libraryName xxx -mediaAgentName xxx -retainArchiverDataForDays xx -retainBackupDataForCycles xx -retainBackupDataForDays xx  -enableDeduplication 1

Examples

The following example shows how to add a parameter for a command and creation of storage policy that uses:

Related Topics

• Creating the Global Secondary Copy Policy Using the Command Line Interface

• Creating a Storage Policy Copy Using a Global Secondary Copy Policy Through the Command Line Interface