V11 SP8

Changing the Deduplication Database MediaAgent

You can change the MediaAgent hosting the active or sealed deduplication database (DDB). This is useful in the following scenarios:

  • MediaAgent is offline
  • The DDB disks hosted on the MediaAgent has low disk space

Before You Begin

Before changing the MediaAgent of the active deduplication database (DDB) make sure that:

  • The DDB partition contains data. You cannot move an empty DDB partition.
    To move empty DDB partitions, see Recovering Permanently Offline Deduplication Database Partitions.
  • No DDB backup or DDB reconstruction jobs are running to the storage policy copy that is associated with the DDB move.
  • The destination MediaAgent is of same operating system type as of source MediaAgent. For example, 64-bit to 64-bit or Windows to Windows MediaAgent.

    You cannot copy the DDB from Windows to Linux or from Linux to Windows and Linux different bit versions (for example, 64-bit to 32-bit version).

  • Ensure that the destination MediaAgent has at least 5% more free space to host the DDB.
  • The involved source and destination MediaAgent are online.


  1. From the CommCell Browser, expand Storage Resources > Deduplication Engines > storage_policy_copy.
  2. Right-click the deduplication_database and then click Move Partitions.

  3. In the Target MediaAgent And Partition Path column, click Choose Path to change the location of the appropriate partition.
  4. From the MediaAgent list, select the MediaAgent.
  5. In the Partition Path, enter the file path where you want to locate the DDB, and then click OK.


    • If you have a DDB partition path that contains an active store and sealed stores, moving an active store will not move the sealed stores. You must move each sealed store separately using DDB Move operation.
    • Do not move the DDB under the software installation directory.
  6. Click OK.

    A confirmation popup appears for suspending the active jobs on the DDB.

    • Click Yes to automatically suspend any active jobs and proceed with the move operation. The suspended jobs resume after the move operation completes.
    • Click No to not suspend any active jobs. The move operation proceeds only if there are no active jobs. Otherwise, the move operation is cancelled automatically. You can proceed with move operation only after the active jobs are suspended or completed.


A Move Partition job appears in the Job Controller window. The job copies the DDB files from the old MediaAgent to the new MediaAgent.


  • If you changed the MediaAgent of both the partitions, for each partition a separate job is displayed.
  • After successful completion of the job, the space is freed up for every 24 hours on the source MediaAgent.

    If required, you can modify the number of days to keep the files on the source MediaAgent by using the Days to keep DDB on source location after successful move partition job parameter in the Deduplication tab of the Media Management Configuration dialog box.

  • If a DDB file or source path is open or being used by other program, then the deletion of the DDB files on the source location is prevented.