Migrating to the New MediaAgent Using Replace MediaAgent App

Replace MediaAgent app allows you to migrate a MediaAgent and the associated configurations (such as deduplicated database, disk library, and index cache) to a new MediaAgent computer.

Before You Begin

• Import the Replace MediaAgent from CommVault Store. For more information, see Importing an App.

• Verify that the installation package on new MediaAgent computer includes the same set of packages as the old MediaAgent computer.
  To see the list of packages installed on a MediaAgent computer, in the CommCell Browser, right-click the MediaAgent client computer, and then go to View > Installed Software.

• If a local mount path is present in the MediaAgent computer, verify that your environment meets the prerequisites mentioned in Moving a Mount Path because the Replace MediaAgent app performs the move mount path operation to migrate disk libraries.

• If a deduplication database (DDB) in hosted on the MediaAgent computer, verify that your environment meets the prerequisites mentioned in Moving a Deduplication Database to Another MediaAgent because the Replace MediaAgent app performs the move deduplication database operation to migrate a DDB.

Procedure

1. Log on to Web Console.

2. Click Apps.

   The My Apps page appears.

3. Click the Replace MediaAgent App.

   The Replace MediaAgent dialog box appears.

4. From the Old MediaAgent list, select the old MediaAgent that want to migrate.

5. From the New MediaAgent list, select the new MediaAgent that you have installed.

6. Click OK.

7. If the old MediaAgent has any disk mount path configured, then the Move Mount Path dialog box appears.

   1. From the Source Path list, select the path that you want to migrate.

   2. From the Destination Path Type list, select a type.

   3. In the Destination Path box, enter the path to which you want to migrate the selected source path.

   4. If you selected Network Path as the Destination Path Type, then from the Network Path Credential list, select a credential.

   5. Click Next.

   If the old MediaAgent has more than one disk mount path configured, then the Move Mount Path dialog box appears again till you configure destination path for all the source mount paths.

8. If old MediaAgent has any deduplication database configured, then the Move DDB Partition dialog box appears.

   1. Enter DDB Disk Path on New MediaAgent.

   2. If the new MediaAgent has more than one deduplication database (DDB) disk configured, then click Add More, and then enter information of another DDB disk.

   3. Repeat step b to add information of all additional DDB disks.

   4. Click Done.

   A dialog box appears with the details that you provided for your review.

9. Click Continue.

What to Do Next

1. You can use the Job Controller to view the progress of the Replace MediaAgent job.

   For instructions, see Viewing Jobs and Job Details in the Job Controller

2. If you have any tape library configured on the old MediaAgent, then complete the following steps:

   1. Disconnect the tape library from the old MediaAgent, and then connect the tape library to the new MediaAgent. Do not deconfigure the library from the CommCell Console.

   2. On the new MediaAgent, detect the device and re-configure the library.

      For more information, see Migrate Tape Library.