> Software > Manage > Storage > Commvault Storage Solutions > Commvault Flex > Commvault Flex Open > Post Deployment Operations and Administration > Installing VaultOS Updates

Installing VaultOS Updates Using a Metadata File on Commvault Flex Open

Use a metadata.tar file to identify and download the operating system (OS) update packages required for your Commvault Flex Open nodes. The metadata-based method identifies the differences between the packages installed on the node and the packages required for the update, so you don't need to download a complete OS package bundle for all supported hardware configurations.

The process generates an upgrpms.xml file on the node. Use that file on an internet-connected Windows or Linux staging computer to download the required RPMs and prepare an offline update package (CVAppliance_Unix.tar). The resulting package is typically 200–300 MB, although the size depends on the packages required by your environment.

Requirements

  • Enable root access on the node. For instructions, see Enable or disable root access.

  • Use an internet-connected staging computer running either 64-bit Windows or Linux. The package download tool depends on the operating system:

    Staging computer Download tool Installation media
    Windows (x64) Setup.exe Commvault Windows installation package
    Linux cvpkgadd Commvault Linux installation media

  • Download the latest metadata.tar file and the applicable Commvault Long-Term Support Release 11.36 or later installation package from Commvault Store. The metadata file is released during the first week of each month. Always use the latest available file.

  • Use the system console, such as KVM, rather than SSH, for the node login used to generate the RPM list.

Generate the required RPM list

  1. Copy metadata.tar to a directory on one of the Commvault Flex Open nodes.

  2. From the system console (for example, KVM), log on to the node containing metadata.tar.

  3. Go to /opt/commvault/MediaAgent.

  4. Run the following command, specifying the location of metadata.tar:

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

    This example uses metadata.tar in the /root directory. The command creates /ws/ddb/upgos/upgrpms.xml on the node.

  5. Copy upgrpms.xml to the internet-connected staging computer.

Download the OS update packages

Choose the procedure for the operating system of your staging computer. Complete only one of the following tabs.

Use the Windows x64 installation package. Setup.exe is available in the Windows installation media, not in the Linux installation media.

  1. Log on to the internet-connected Windows computer as an administrator or a member of the Administrators group.

  2. Go to the downloaded Windows installation package and start the download manager application.

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

  4. Run Setup.exe from the extracted installation files.

    The installation wizard opens.

  5. On the welcome page, select I Agree, and then continue.

  6. On the Choose the Installation Type page, select Download packages to install on a different computer, and then continue.

  7. Clear Windows, select Download UNIX OS appliance updates, and then continue.

  8. In Select the RPM configuration XML file, select upgrpms.xml (or download_platform.xml if that is the file generated for your configuration), and then continue.

  9. In Select a folder to download the packages, specify the destination directory, and then continue.

  10. On the Install Status page, click Finish.

    The downloader creates the custom CVAppliance_Unix.tar package in the specified directory.

Use cvpkgadd from the Commvault Linux installation media. Linux installation media doesn't contain Setup.exe.

  1. Log on to the internet-connected Linux staging computer.

  2. Run cvpkgadd from the Commvault Linux installation media.

  3. Select Download packages to install on a different computer.

  4. Select Download UNIX OS appliance updates.

  5. Specify the generated RPM configuration XML file (upgrpms.xml or download_platform.xml) and the directory where you want to download the packages.

  6. Download the required OS update RPMs and prepare the offline update package.

    The offline upgrade procedure uses CVAppliance_Unix.tar.

Install the OS updates

  1. Copy the custom CVAppliance_Unix.tar package to the Commvault Flex Open node. For example, use /ws/ddb/CVAppliance_Unix.tar.

  2. Log on to the node containing the package and go to /opt/commvault/MediaAgent.

  3. Run the following command to update the operating system binaries:

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

    The following confirmation appears:

    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):

  4. Enter y and press Enter to continue.

    The installation progress appears on screen and is also logged in /var/log/commvault/Log_Files/cvupgradeos.log.

    The update has the following behavior:

    - The software installs updates sequentially on the nodes in the cluster.

    - After the update is installed on a node, the node restarts. The upgrade resumes automatically after the restart, although post-upgrade operations can take some time.

    - The node from which you initiate the OS updates is the last node to restart.

Verify the update

  1. After the node restarts, log on again and go to /opt/commvault/MediaAgent.

  2. Check the installation status:

    ./cvupgradeos.py -status

If an update doesn't complete, review /var/log/commvault/Log_Files/cvupgradeos.log to identify the cause. Correct the issue, and then rerun cvupgradeos.py to install the updates on the affected node.

×

Loading...