# Installing Operating System Updates Using a Metadata File on HyperScale Flex

You can install Operating system (OS) updates on the HyperScale Flex node using a metadata.tar file.

The metadata.tar file enables you to download the required OS packages for the upgrade.

This method does not require you to manually download the complete list of OS update packages, thus reducing the download time.

## Before You Begin

Enable root access login on the node. For more information, see Enabling or Disabling Root Access.

## Procedure

1. Log on to the computer that has internet connectivity, and download the latest metadata.tar file, which is released on the first week of every month, and Commvault Long-Term Support Release 11.36 or higher installation package from the Commvault Store.

   Note

   Make sure to always use the latest metadata.tar file for the upgrade.

2. Copy the metadata.tar to any directory on one of the Hyperscale nodes.

3. Log on to the node and generate the list of OS update packages required for the installation using the following steps:

   1. Using the system console (for example, using KVM, not SSH), log on to the node containing the metadata.tar file and navigate to the following folder:

      /opt/commvault/MediaAgent

   2. Run the following command using the metadata.tar file path as input:

          /opt/commvault/MediaAgent/cv_offline_upgrade.py  get_list_of_rpms  ~/metadata.tar

      In this example, the metadata.tar is located in the /root directory

      The command generates the upgrpms.xml file at the following location on the node: /ws/ddb/upgos/upgrpms.xml.

4. Copy the upgrpms.xml file to the computer where you downloaded the Commvault installation package and has internet connectivity.

5. Log on to the computer with internet access as an Administrator or as a member of the Administrator group, run the installation wizard, and generate a custom package that contain the OS updates required for the upgrade, using the following steps:

   1. Log on to the computer as an Administrator or as a member of the Administrator group on that computer.

   2. Navigate to the installation package download location and start the download manager application.

   3. Select where to extract the installation files, and then click Extract.

   4. Run Setup.exe from the installation package.

      The installation wizard opens.

   5. On the welcome page, select the I Agree check box, and then proceed to the next page.

   6. On the Choose the Installation Type page, click Download packages to install on a different computer and proceed to the next page.

   7. Clear the Windows check box, and then select the Download UNIX OS appliance updates check box. Proceed to the next page.

   8. In the Select the RPM configuration XML file box, upload the upgrpms.xml file, and then proceed to the next page.

   9. In the Select a folder to download the packages box, specify the location where you want to download the RPM package, and then proceed to the next page.

   10. On the Install Status page, click Finish.

       The application creates a custom package (CVAppliance_Unix.tar) file in the specified download location.

6. Copy the custom package to the HyperScale Flex node. For example, /ws/ddb/CVAppliance_Unix.tar.

7. Log on to the node containing the /ws/ddb/CVAppliance_Unix.tar file and navigate to the following folder:

   /opt/commvault/MediaAgent

8. To update the operating system binaries, run the following command:

       # /opt/commvault/MediaAgent/cv_offline_upgrade.py upgrade /ws/ddb/CVAppliance_Unix.tar -upgrade_os_only

   The following prompt will be displayed:

       Performing some pre-upgrade checks ... please wait...
       You are attempting to perform OS upgrade of cluster nodes.
       This will bring down cluster services/volume and reboot the nodes one after the other
       Following nodes will be upgraded:
               mynode001.company.com
       Please confirm if you want to upgrade at this time (y/n):

9. Type `y` and press `Enter` to continue.

   The installation process will start. The progress of the installation is displayed. (The sequence is also logged in /var/log/commvault/Log_Files/cvupgradeos.log.)

   Note the following:

   - The updates will be installed sequentially on each node available in the current cluster.

   - At the end of update installation, the node is rebooted. The upgrade will automatically resume after the reboot but may take some time to complete the post upgrade operations on this node.

   - The node from which the OS updates are installed will be the last node to reboot.

10. After the node is rebooted, log back into the node and navigate to the following folder:

    /opt/commvault/MediaAgent

11. After the installation is complete, check the status of the installation using the following command:

        # ./cvupgradeos.py -status

    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.

×

Loading...