Installing Operating System Updates

Operating system (OS) updates can be installed on HyperScale nodes to ensure that the OS has the most recent updates from Red Hat.

Before You Begin

  • CommServe server and HyperScale nodes must be in SP15 (or higher) to perform this task. Verify the version in the clients associated with the CommServe server and HyperScale nodes. For more information on verifying the version information in a client, see Viewing the Service Pack Details for One or More Clients.
  • The update process updates provided by Red Hat for the OS. The process does not update other RPMs that may have been manually installed on the nodes.
  • Navigate to /etc/yum.repos.d and cleanup everything, except redhat.repo. Download software will fail if it there is anything other than the redhat repository.


  1. Setup a remote cache on one of the nodes in the storage pool that has the DDB configured on it. The OS updates will be installed, (or orchestrated) from this node.
    1. From the CommCell Console ribbon, on the Tools tab, click Add/Remove Software > Software Cache Configuration.
    2. In the Software Cache Configuration dialog box, click the Remote Software Cache tab and then click Add.
    3. From the Computer list, select the client associated with the HyperScale node where you want to configure the remote cache directory.

      In the Please Specify Cache Directory box, the default location for the remote cache is provided.

      Important: Use the default location.

    4. Click Configure Packages to Sync.
    5. In the Configure Packages to Sync dialog box, choose the Customize Packages option. (The Sync Packages option will be enabled by default. Do not select any other options.)
    6. Click OK to save your configuration changes.
    7. Click OK to close the Modify Remote Software Cache Information dialog box.

      Note: If there are multiple HyperScale clusters on a CommServe, one remote cache is required for each cluster.

  2. Download the latest updates and populate the remote cache as follows:
    1. From the CommCell Console ribbon, on the Tools tab, click Add/Remove Software > Download Software.

      The Download and Sync Cache Options dialog box will be displayed.

    2. In the General tab, select an appropriate option to download the necessary updates.

      Note: The latest OS updates will be downloaded, irrespective of the selected option.

    3. In the Options tab, select the Download and Sync option to ensure that the remote cache configured in the HyperScale node is automatically synchronized.
    4. Click Advanced.

      The Advanced Options for Download and Sync Cache dialog box will be displayed.

    5. In the Operating Systems tab, clear the Windows check box and then select the Unix check box.
    6. Click OK twice to close the dialog boxes.

    Monitor the progress of the download job in the Job Controller to ensure that the software is successfully downloaded and synchronized.

  3. Set the MediaAgents associated with the nodes in the Maintenance mode. For more information about setting the MediaAgents in the Maintenance mode, see Marking a MediaAgent Offline for Maintenance.
  4. Login to the HyperScale node in which the remote cache is configured and navigate to the following folder:


  5. Start the OS update installation using the following command:


    Note: cvupgradeos.py must be run using the console. Do not run cvupgradeos.py using SSH.

    The following prompt will be displayed:

    Important: Make sure that all the nodes in the cluster are listed.

  6. Type y and press Enter to continue.

    This will start the installation process. The updates will be installed sequentially on each HyperScale node available in the current cluster. At the end of update installation, each node will be rebooted before moving on to the next node.

    The progress of the installation is displayed. The following logs can also be used to view the progress of the installation:

    1. /var/log/commvault/Log_Files/cvupgradeos.log.
    2. Detailed progress of yum update can be monitored in yum.out.log and yum.err.log available in /var/log/commvault/Log_Files/hsupgradedbg folder.

    A message will be displayed when the installation process is finished.

  7. Once the installation is completed, check the status of the installation using the following command:

    ./cvupgradeos.py -status

    This will display a message similar to the following:

    If there is a failure, investigate the reason for the failure in /var/log/commvault/Log_Files/cvupgradeos.log. Correct the issue causing the failure and then rerun cvupgradeos.py to install the updates in the failed node.

  8. Once the updates are successfully installed, remove the MediaAgents associated with the nodes from Maintenance mode. For more information about removing the MediaAgents from Maintenance mode, see Marking a MediaAgent Offline for Maintenance.


  • The updates will be installed in all the HyperScale nodes.
  • If the OS version is upgraded, you can verify the OS version as follows:
    • Open the CommCell Console and click Client Computers.
    • The Client Name, OS Version and other details will be displayed on the right pane.

Last modified: 11/1/2019 9:35:31 PM