> Documentation > Data Management > Define Storage and Retention for Backups Using Storage Policies > User-Defined XML Files > Updating Properties of a Storage Policy Copy Using XML Files > Updating Alternate Data Paths for a Copy

Specify Conditions for Using an Alternate Data Path

The following table displays all the parameters you can use with the commands.

Element

Description

Parent Element

switchIfOffline

To use an alternate data path when resources are offline.

copyFlags

switchIfBusy

To use an alternate data path when resources are busy.

copyFlags

roundRobbinDataPath

Enable to automatically load balance between all the available data paths.

If the client and MediaAgent are on the same computer, you can perform LAN free operations. In such scenario, you must set all the following parameters to 0:

  • switchIfBusy

  • switchIfOffline

  • roundRobbinDataPath

copyFlags

hours/minutes

You can use alternate data path when resources in default data path are busy.

Specify the time period (hours and minutes) for which you want to wait before using the alternate data path.

resourcesOfflineWaitTimeInHoursMinutes

hours/minutes

You can use alternate data path when resources in default data path are offline.

Specify the time period (hours and minutes) for which you want to wait before using the alternate data path.

resourcesBusyWaitTimeInHoursMinutes

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

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

    Example

    • To use an alternate data path for a copy Copy1, immediately when the resources are busy.

      qoperation execute -af <download location>\Update_DataPathConfig.xml -copyName Copy1 -storagePolicyName SP01 -switchIfBusy 1 -resourcesBusyWaitTimeInHoursMinutes/hours 0 resourcesBusyWaitTimeInHoursMinutes/minutes 0

      If you want to wait for two hours when the resources are busy and then use an alternate data path for a copy Copy1.

      qoperation execute -af <download location>\Update_DataPathConfig.xml -copyName Copy1 -storagePolicyName SP01 -switchIfBusy 1 -resourcesBusyWaitTimeInHoursMinutes/hours 2 resourcesBusyWaitTimeInHoursMinutes/minutes 0

    • To use an alternate data path for a copy Copy1, immediately when the resources are offline.

      qoperation execute -af <download location>\Update_DataPathConfig.xml -copyName Copy1 -storagePolicyName SP01 -switchIfOffline 1 -resourcesOfflineWaitTimeInHoursMinutes/hours 0 resourcesOfflineWaitTimeInHoursMinutes/minutes 0

      If you want to wait for two hours when the resources are busy and then use an alternate data path for a copy Copy1.

      qoperation execute -af <download location>\Update_DataPathConfig.xml -copyName Copy1 -storagePolicyName SP01 -switchIfOffline 1 -resourcesOfflineWaitTimeInHoursMinutes/hours 2 resourcesOfflineWaitTimeInHoursMinutes/minutes 0

    • To automatically load balance between all the available data paths for a copy Copy1.

      qoperation execute -af <download location>\Update_DataPathConfig.xml -copyName Copy1 -storagePolicyName SP01 -roundRobbinDataPath 1

      To perform auxiliary copy operation using the LAN free data path, execute the following command:

      qoperation execute -af <download location>\Update_DataPathConfig.xml -copyName Copy1 -storagePolicyName SP01 -roundRobbinDataPath 0 -switchIfOffline 0 -switchIfBusy 0

Loading...