Installing Operating System Updates on New Nodes

You can upgrade the operating system (OS) on new nodes that have an older image and are not part of an existing storage pool. This will ensure that the OS in the new nodes are in sync with the OS in the existing nodes, when it is attached to an existing storage pool.

Before You Begin

Identify the OS versions in the old and new nodes to make sure that the new nodes have an older image:

  • Use the following command to get the kernel version:

    uname -r

  • Use the following command to get the gluster version:

    gluster --version


  1. Login to the node that has the remote cache configured.

    Note: Use the system console to login to the node. For example, using KVM, not SSH.

    Perform the following steps to identify the node in which the remote cache is configured:

    1. From the CommCell Console ribbon, on the Tools tab, click Add/Remove Software > Software Cache configuration.

      The Software Cache configuration dialog box will be displayed.

    2. Click the Remote Software Cache tab.

      Use the Configuring Software Cache list to identify the node in which the remote cache is configured.

  2. Run the following command from the system console to add the new nodes:

    ./cvupgradeos.py -set_additional_nodes <new nodes list>


    <new nodes list> is a comma separated list of new nodes.

    For example:

    ./cvupgradeos.py -set_additional_nodes mynode004.company.com,mynode005.company.com,mynode006.company.com

    Tip: Use ./cvupgradeos.py -l to view the help for the command.

  3. 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.

    Tip: The download operation will automatically download the necessary RPMs once it identifies that the new nodes have an older image.

  4. Upgrade the new nodes using the following command:

    ./cvupgradeos.py -upgrade_additional_nodes

    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 new nodes are listed.

  5. Type y and press Enter to continue.

    The installation process will start. 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 sequence is also logged in /var/log/commvault/Log_Files/cvupgradeos.log.)

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

What to Do Next

Add the nodes to the existing HyperScale Storage Pool as follows:

  1. Using a web browser, launch the Command Center using the following URL:

    https://<Commserver hostname>/adminconsole

  2. Type the user name and password provided during the setup.
  3. Click Login.
  4. From the navigation, click Storage > Storage Pools.

    The Storage Pool page appears.

  5. From the Storage Pools page, click the name of the Storage Pool to which you want to the additional nodes.
  6. Click Add nodes.

    The Add nodes page appears.

  7. From the Nodes list, select the number of nodes which you want to add.

    Note: The number of nodes that you can add to a Storage Pool depends on the Resiliency of the Storage Pool.

  8. Click Add.

This will add the new nodes to the storage pool.

Last modified: 12/18/2019 5:07:23 PM