Moving a Mount Path to a New Location

You can move a mount path from one device location to a new device location on the same MediaAgent or another MediaAgent. The destination path can be a local path or a network path.

When you move a mount path, deduplicated and non-deduplicated data that resides on the source mount path is moved to the destination device.

You can move a mount path to a new device in the following cases:

  • You want to move to another location that has more storage capacity.

  • You want to move to a faster disk media.

A move mount path operation involves the following steps:

  • Disables the pruning of data present on the source mount path.

  • Validates the source mount path folder and the destination device.

  • During phase 1, the software copies the full volumes from the source mount path folder to the destination device. The software allows the operations like backup, restore, auxiliary copy, data verification, synthetic full and deduplication database (DDB) reconstruction.

    Note

    After phase 1, the job selects the Disable mount path for new data option that is available in the Mount Path Properties -Allocation Policy dialog box. Do not change the option when the move mount path operation is in progress. The job automatically clears the option after completion of the operation.

  • During phase 2, the software suspends backup and other operations for the source mount path and copies the active volumes from the source mount path folder to the destination device.

  • Clears the Disable mount path for new data option.

  • Enables the pruning of data.

  • Resumes backup and other operations that are pending.

Notes

  • If the source mount path is a consolidated mount path, the software initiates multiple move mount path operations to move each mount path in the consolidated mount path.

  • Move mount path operation performs checksum verification of the data to ensure data integrity. As a result, the operation may be slower than the Windows file copy operation.

  • When you move a mount path between two Linux MediaAgents, the move mount path operation does not support drill hole capability. If you move a mount path with drill hole capability, the mount path will consume more space after the move.

  • Any mount paths that failed to move will remain on the source device.

  • If you are using storage pools, do NOT add any mount path shares while the Move Mount Path job is in progress. Otherwise, you will end up with duplicate mount path shares.

Before You Begin

  • Review the Move Mount Path - Support page.

  • Ensure that the destination mount path folder is not a sub folder under the source mount path folder.

  • Do not move the mount path to the software installation directory.

  • The move mount path operation overwrites the destination mount path. Therefore, ensure that the destination mount path is an empty folder.

  • Ensure that the destination mount path folder has at least 5% more free space than the space consumed by the source mount path.

  • Ensure that the source mount path has backup data.

  • Ensure that the source MediaAgent and the destination MediaAgent are online and accessible.

  • To move a mount path in an automated disk library, you must disable the automated mount path detection. For instructions, see Disabling Automated Mount Path Detection.

  • The user must have the Library Management permission or Library Administration permission on the library that hosts the mount path.

  • The Commvault services must be up and running on the source MediaAgent until the move mount path operation is complete.

  • Verify that the mount path is not shared with the destination MediaAgent.

Procedure

  1. From the CommCell Browser, expand to Storage Resources > Libraries > library.

  2. Right-click the mount path that you want to move, and then click Move Mount Path.

    The Move Mount Path dialog box appears.

  3. From Select Source MediaAgent list, select the source MediaAgent.

    For a mount path shared between MediaAgents, the shared MediaAgents appear in the list.

  4. Under Destination Path, select Move to new location option.

  5. From the MediaAgent list, select the MediaAgent that hosts the device.

  6. Select Local Path or Network Path.

    Note

    If you provide an existing mount path device location as destination path, then system would perform move to existing device and merge mount path to device location.

  7. If you select Local Path, enter the new mount path location in the Disk Device box.

  8. If you select Network Path, enter the following information:

    • Credential: From the list, select an appropriate credential to access the mount path. To create a new credential, click the Create New button.

      For instructions about creating a credential, see Adding a Credential to Credential Manager.

    • Folder: The new mount path location.

      Note

      If you provide an existing mount path device location as destination path, then the software moves to an existing device and merges to device location.

  9. Click OK.

    You can track the progress of the job from the Job Controller.

Result

  • If the source device has more than one mount path, then the software launches multiple move mount path jobs to move all mount paths to the destination device.

  • After the completion of a move mount path job, the space on the source mount path is freed up after 24 hours (one day). To modify the time to keep the files on the source mount path, configure the Minutes to keep mount path files on source location after successful move mount path job parameter in the Media Management Configuration dialog box.

  • If the mount path move job fails or is killed, you must manually clean the data that was copied to the destination mount path.

What to Do Next

  • Verify that the new mount path is online and accessible after the move.

    Note

    The new mount path may appear offline if the source mount path has run out of disk space prior to move mount path operation. To see the new mount path online, you must wait until the next disk space update.

  • Perform a disaster recovery backup. For instructions, see Performing a Disaster Recovery Backup.

  • If the source mount path or the destination mount path is a network path, the software automatically updates the credentials for the shared MediaAgents with the credentials from the new location. For other MediaAgents (with local or UNIX paths) that share the source mount path, you must modify the path to the new location. For instructions, see Modifying the Access Path for the MediaAgents.

Loading...