Installing Operating System Updates on Existing Nodes

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 and HyperScale nodes must be in the following Service Pack and Hot Fix level:
- Service Pack 15 with hotfix pack 34 (or higher)
- Service Pack 16 with hotfix pack 7 (or higher)
- Service Pack 17 or higher
Verify the version in the clients associated with the CommServe server and HyperScale nodes before upgrading the OS. 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 installs the 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 there is anything other than the redhat repository.

Procedure

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, if it doesn't exist.
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 (/opt/commvault/SoftwareCache).
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.
If the HyperScale nodes are setup using a 1Gig management network, make NFS share on the remote cache accessible to all the nodes in the network. For more information about enabling access, see Enabling Access to NFS Shares to the Nodes.
Download the latest updates and populate the remote cache as follows:
1. From the navigation pane, go to Manage > System > Maintenance.
  
  The Maintenance page appears.
2. Click Download/copy software.
  
  The Download/copy software section appears, showing the current feature release, the latest available feature release, and the last job that was run.
3. Click Run job .
  
  The Download/copy software dialog box appears.
4. Select Download software using Internet or Local Copy, depending on your environment.
5. In Download installation media, select the available feature release or maintenance release installation files that you want to download.
6. In Operating system options, select the platform and operating system for the software you want to download.
  
  Note
  
  The latest OS updates will be downloaded, irrespective of the selected option.
7. In Remote caches to sync, select the HyperScale node in which the remote cache is configured.
8. Click Download.
9. Click OK twice to close the dialog boxes.
Monitor the progress of the download job to ensure that the software is successfully downloaded and synchronized. For more information, see Viewing Jobs.
Set the MediaAgents associated with the nodes in the Maintenance mode. For more information about setting the MediaAgents in the Maintenance mode, 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.
Login to the HyperScale node in which the remote cache is configured and navigate to the following folder:
```
/opt/commvault/MediaAgent
```
Use the system console to login to the node. For example, using KVM, not SSH.
Start the update installation using one of the following commands:
- Use the following command to install OS updates without any manual intervention:
```
./cvupgradeos.py
```
  Note
  
  cvupgradeos.py must be run using the console. Do not run cvupgradeos.py using SSH.
- Alternatively, shut down the VMs hosting the CommServe and the Hosted Engine (oVirt or the virtualization management application that manages multiple virtual machines on multiple hosts) and install OS updates on all the cluster nodes without managing these VMs. This option can be used to avoid failures associated with managing the VMs during the OS update installation process.
  1. To shut down the VM associated with the CommServe, access the Virtualization Manager, and shut down the VM associated with the CommServe from the virtual machines pane.
  2. Use the following commands to shutdown the Hosted Engine:
```
hosted-engine --set-maintenance --mode=global
hosted-engine --vm-shutdown
hosted-engine --vm-poweroff
```
  3. Use the following command to install OS updates on all the cluster nodes:
```
./cvupgradeos.py -no_vm_management
```
The following prompt will be displayed:

Important

Make sure that all the nodes in the cluster are listed.
Type y and press Enter to continue.

The following prompt will be displayed:

Note

The oVirt hostname prompt will be displayed only when the hostname cannot be automatically obtained from one of the configuration files.
Enter the Fully Qualified Domain name (FQDN) of the oVirt host.

The following prompt will be displayed:
Enter the password associated with the oVirt host.

CommServe and Hosted Engine VMs will now be shutdown and powered off and will be restarted once the upgrade is complete.

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.
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.
Restart the VMs hosting the CommServe and the Hosted Engine, if it was shut down, as follows:
1. Use the following commands to restart the Hosted Engine:
```
hosted-engine –-vm-start
hosted-engine --set-maintenance --mode=none
```
2. Verify that the maintenance mode has been reset using the following command:
```
hosted-engine --vm-status
```
3. To restart the VM associated with the CommServe, access the Virtualization Manager, and restart the VM associated with the CommServe from the virtual machines pane.
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.

Result

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.