Installing Operating System Updates Using a Metadata.tar File on HyperScale 1.5 Appliance

You can install Operating system (OS) updates on HyperScale nodes when the CommServe does not have internet connectivity, using the Commvault installation package and 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 packages, thus reducing the download time.

Before You Begin

We recommend that you install Commvault Platform Release 2022E (with maintenance release 11.28.14) or higher on the CommServe and the HyperScale MediaAgents.

Procedure

Log on to the computer that has internet connectivity, and download the metadata.tar file and the Commvault Platform Release 2022E or higher installation package from the Commvault Store.
Copy the metadata.tar file to any folder on the Hyperscale node.
Log on to the Hyperscale 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 in which the remote cache is configured 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 file is located in the /root directory.
  
  The command creates an upgrpms.xml file in the remote cache path on the node. For example, /ws/ddb/upgos/upgrpms.xml.
Copy the upgrpms.xml file to the computer where you downloaded the Commvault installation package and has internet connectivity.
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.
Copy the custom package to the remote cache path in the Hyperscale node. For example, /ws/ddb/CVAppliance_Unix.tar.
Set the MediaAgents associated with the nodes in the Maintenance mode. For more information, see Setting the MediaAgent on Maintenance Mode.

Important

Make sure that all the MediaAgents in the storage pool are set in the maintenance mode before proceeding to the next step.
Using the system console (for example, using KVM, not SSH), log on to the node in which the remote cache is configured and navigate to the following folder:

/opt/commvault/MediaAgent
Update the operating system binaries using the following command:
```
# /opt/commvault/MediaAgent/cv_offline_upgrade.py upgrade /ws/ddb/CVAppliance_Unix.tar
```
Note

cv_offline_upgrade.py must be run using the console. Do not run cv_offline_upgrade.py using SSH.

The upgrade process can take up to 1-2 hours.

The progress of the installation is displayed. (The sequence is also logged in /var/log/cvupgradeos.log.)

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

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:

=====================================================
                   Upgrade Summary
=====================================================
    hyperscale-hs2                    Successful
    hyperscale-hs3                    Successful
    hyperscale-hs1                    Successful
[root@hyperscale-hs1 ~]# cat /etc/redhat-release
Red Hat Enterprise Linux Server release 7.7 (Maipo)
[root@hyperscale-hs1 ~]# grep Red /boot/grub2/grub.cfg
menuentry 'Red Hat Enterprise Linux Server (3.10.0-1062.el7.x86_64) 7.7 (Maipo)'
[root@hyperscale-hs2 ~]# cat /etc/redhat-release
Red Hat Enterprise Linux Server release 7.7 (Maipo)
[root@hyperscale-hs2 ~]# grep Red /boot/grub2/grub.cfg
menuentry 'Red Hat Enterprise Linux Server (3.10.0-1062.el7.x86_64) 7.7 (Maipo)'
[root@hyperscale-hs3 ~]# cat /etc/redhat-release
Red Hat Enterprise Linux Server release 7.7 (Maipo)
[root@hyperscale-hs3 ~]# grep Red /boot/grub2/grub.cfg
menuentry 'Red Hat Enterprise Linux Server (3.10.0-1062.el7.x86_64) 7.7 (Maipo)'

Installing Operating System Updates On Nodes Without Internet Access (2)

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

Using the Command Center, remove the MediaAgents associated with the nodes from Maintenance mode. For more information about removing the MediaAgents from Maintenance mode, see Setting the MediaAgent on Maintenance Mode.