V11 SP8
Loading...

CommServe Upgrade with Hardware Refresh: Post Migration Operations

The following operations are recommended on the new CommServe® computer after the hardware refresh.

Access the CommCell Console Remotely

You can access the CommCell Console remotely from any computer using a Java-enabled web browser. The default URL to access the console is the following:

http://<cshostname>:81/console

Where:

  • cshostname is the hostname of the CommServe computer (where the CommCell Console component was installed).
  • 81 is the default port number used to connect with the CommCell Console. The port number may be different if you modified the IIS port in the IIS Server Manager.

Configure Cluster Environment

If you moved the CommServe database from a cluster to another cluster, you need to perform the following steps in the new environment.

Step 1: Convert the CommServeDatabase from Cluster to Non-Cluster mode

  1. Login to the active node's physical machine in the new cluster and modify the following registry key:
    • HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Instance001\Machines\<Cluster_Machine_Name>
    • Set value of DWORD registry key bVIRTUALMACHINE to 0.
  2. On the CommServe computer, go to the <software installation path>\Base folder and double-click CSRecoveryAssistant.exe.
  3. In the CommServe Recovery Assistant dialog box, click Recovery, and then click Next.
  4. In the Enter the path to the database dump folder box, enter or browse the name of the Disaster Recovery folder where the dump files are located, and then click Next.

    Make sure that the dump files are available on the local disk of the CommServe host.

  5. In the Enter the path to extract the database files box, type the destination path where you want to restore the CommServe database files and then click Next.

    Alternatively, click Browse and select the restore path.

    By default, all the database files are restored to the CommServe database path located on the destination CommServe host.

  6. In the Summary screen, review the selections, and then click Start Recovery.

    The tool now performs the following operations on the CommServe system:

    • Stop services on your CommServe computer
    • Restore the database to the specified restore path
    • Verifies and upgrades the database if required

      The tool can upgrade the database from a previous version or service pack.

    • Synchronize the CommServe system and the restored database
    • Run post operations on the CommServe computer
  7. When all the operations are complete, click Next.

    The host name and client name of the destination CommServe host and the restored database are displayed. If the names are different, the tool updates the CommServe host with the client name of the restored database and host name of the destination CommServe host.

  8. If the IP address of the destination CommServe host is different from the original production CommServe host, select the Provide a license file check box and enter the path to a new IP address changelicense file in the text box provided and click Next.

    Note: If you do not have a new license, contact your Commvault Account Manager or Support for a new license.

    It is optional to provide a license file if the tool detects no change in the CommServe IP address in the existing license file.

  9. Select the Convert to non-Cluster check box.

    This will remove the cluster related information from the database.

  10. A completion message is displayed. Click Finish.

    The database will be restored and will be converted to a non-cluster mode.

Step 2: Convert the CommServe Database back to Cluster mode

  1. Login to the active node's physical machine in the new cluster and modify the following registry key:
    • HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Instance001\Machines\<Cluster_Machine_Name>
    • Set value of DWORD registry key bVIRTUALMACHINE to 1.
  2. On the CommServe computer, go to the <software installation path>\Base folder and double-click CSRecoveryAssistant.exe.
  3. In the CommServe Recovery Assistant dialog box, click Recovery, and then click Next.
  4. Select the Database already restored on this computer check box and click Next.
  5. In the Summary screen, review the selections, and then click Start Recovery.
  6. Select the Convert to cluster check box.
  7. In the Physical Node text boxes type the names of the physical CommServe nodes as they appear in the Microsoft Failover Cluster Manager.

    Do not copy and paste the physical node name from the registry, or add the characters "_node" to the node name. The characters "_node" are automatically added to the physical node name during the database restore operation.

  8. A completion message is displayed. Click Finish.

    The database will be converted to the cluster mode.

Step 3: Configure an Additional Setting to Send Update Status to the CommServe

  1. Log on to the CommCell Console.
  2. In the CommCell Browser, right click the <CommServe> computer, and then click Properties.
  3. Click the Additional Settings tab, and then click Add.
  4. In the Add Additional Settings on Windows Client dialog box, do the following:
    1. In the Name box, type bSendUpdateStatusToCS.
    2. In the Category box, type registry.
    3. From the Type list, select INTEGER.
    4. In the Value box, type 1.
    5. Click OK.
  5. Click OK to close the CommCell Properties dialog box.
  6. Restart the CommCell services using the Process Manager. For instructions, see Restarting a Service.

Configure the File Archiver Agent

  • If you had the File Archiver Agent for BlueArc, Celerra, or NetApp installed on your old hardware, then make sure to install and configure OnePass on your new hardware. See File Archive Agents for more information.
  • If you had the File Archiver Agent for Windows installed on your old hardware, then make sure to install and configure OnePass on your new hardware. See OnePass for Windows File System for more information.

    After configuring OnePass, create the following registry key to recall the File Archiver stubs.

    1. From the CommCell Browser, right click the CommServe computer and then click Properties.

      The CommCell Properties dialog box appears.

    2. On the Additional Settings tab, click Add.

      The Add Additional Settings on Windows Client dialog box appears.

    3. In the Name box, type GXHSM_USE_FSAppType_ForFSDMRecalls.
    4. In the Value box, type 1.
    5. Click OK.

Tune the SQL Server Memory Usage

If you pre-installed the SQL Server on the new hardware before the CommServe software was installed, we recommend you to verify the SQL memory usage for the Commvault components. The maximum memory used by the SQL Server should be 50% of the physical memory available in the new computer.

  1. On the CommServe computer, open the Microsoft SQL Server Management Studio.
  2. Right-click the Server_Instance, and then click Properties.
  3. From the Server Properties dialog box, on the left pane, select the Memory page.
  4. In the Maximum server memory (in MB) box, specify 50% of the physical memory available in the computer.
  5. Click OK.

Verify Commvault Network Components (If CommServe Name Changed)

If the new CommServe computer has a different name and IP address than the old computer, reconfigure each data interface pair (DIP) that exists between the CommServe computer and other clients. See Data Interface Pairs - Advanced for information on adding, editing or deleting DIPs.