CommServe Hardware Refresh: Preparing the Old CommServe Computer for Shutdown

To migrate the CommServe database to a new hardware, you must first prepare the old CommServe computer for shutdown.


  1. From the CommCell Browser, right-click the CommServe node and then click Properties.
  2. On the Activity Control tab, clear all the check boxes, except the Enable All Job Activity check box, and then click OK.

    This ensures that no new jobs are performed, except for disaster recovery operations, VM provisioning jobs, and workflow jobs. These jobs do not affect the hardware refresh.

  3. From the Job Controller, kill all jobs that are in progress, or wait for the jobs to complete.
  4. Install the latest Commvault Service Pack. For instructions, see Installing the Service Pack Locally on Windows Computers.
  5. If a MediaAgent is installed on the CommServe computer and you have a disk library with a local mount path, copy the mount path to a location accessible to the new CommServe computer.

    For example, if you have a disk library configured with a local mount path in C:\disklib01, copy the entire folder including its contents and subfolders.

    For information on moving mount paths, see Moving Mount Paths.

  6. If you have a deduplication database (DDB), do the following:
    • If the MediaAgent hosting the DDB is installed in the CommServe, copy the DDB content (CV_SIDB folder and icl_label.txt file) to an accessible location. This location should be accessible to the new CommServe computer.
    • If the DDB resides on a separate MediaAgent, no action is required.
  7. Run a CommServe Disaster Recovery Backup.
    1. From the CommCell Browser, right-click the CommServe node and then click All Tasks > Disaster Recovery Backup.
    2. On the Disaster Recovery Options dialog box, click OK to run the backup.

      Tip: The Disaster Recovery backup job may enter the Waiting state after the Backup to Disk phase is complete. This can happen if the DR storage policy is associated to the same MediaAgent where you stopped the services. As a result, the DR backup job is not able to transfer the data to the offline MediaAgent.

      In this situation, you can stop the DR backup job after the Backup to Disk phase is complete. However, before you stop the job, verify that the Backup to Disk phase is complete:

      1. From the Job Controller window, double-click the job.
      2. To view the status of the different phases in the job, click the Attempts tab on the Job Details dialog box.
  8. Copy the CommServe Disaster Recovery backup files (set_XXX folder) to an accessible location.

    Tip: Disaster Recovery backup files are saved to the location specified in the DR Backup Settings dialog box that is available from the Control Panel. Make sure to obtain the latest DR set from this location.

  9. Verify and, if necessary, note the port number used for reports:
    1. From the CommCell Console, click the Configuration tab, and then click Email and Web Server.
    2. Click the Web Server tab.
    3. The port number is displayed in the Report Default URL box. For example:


      If the default port number is changed, make a note of the port number.

  10. Using the Microsoft Internet Information Services (IIS), make a note of the port numbers used by the Consoles.

  11. Make a list of all the Commvault packages installed on the CommServe computer.
    1. From the CommCell Browser, right-click the CommServe and click Properties.
    2. In the CommCell Properties dialog box, click the Version tab. The packages are listed in the Update status area.

      We recommend that you also make a list of hotfixes that you installed, which are displayed in the Version information area.

  12. If you plan to use different network details, do not shut down the CommServe computer yet. You will perform this operation after the CommServe database is restored and upgraded on the new hardware.
  13. If you plan to use the same network details, make a note of the IP settings (IP address and DNS) and the computer name, and then shut down the CommServe computer using the following sequence:
    1. Stop all Commvault services.
    2. Shut down the computer.
    3. Unplug the network cables.
    4. If you have a tape library attached to the CommServe, unplug the library from the CommServe computer and plug it in to the new hardware.

      Note: If you plan to reuse this computer, complete the following tasks before you activate the computer in the network:

      • Uninstall Commvault software.
      • Change the computer name and IP settings to different values.

What to Do Next

Setting Up the CommServe Database in the New Hardware

Last modified: 4/15/2019 5:56:20 PM