Skip to main content
How to upgrade VMware backup proxy

Upgrade VMware backup proxy to use new features available with the latest version of proxy

Updated over 2 months ago

Enterprise Workloads Editions: βœ… Business | βœ… Enterprise | βœ… Elite

Each Druva release comes with new features and enhancements, and to use these features, you must have the latest version of Hybrid Workloads agent or backup proxy. Druva regularly provides updates to Druva backup proxy to enable it with new features and enhancements. Updates also include bug fixes and performance improvements.

This section also provides options on how to upgrade Druva backup proxy in your environment. As an administrator, you can upgrade Druva backup proxy using the following methods. You can also upgrade multiple agents and proxies for different workloads at the same time from the Management Console.

Upgrade VMware backup proxy through Management Console

With the automatic agent upgrade feature, you can upgrade backup proxy to the latest versions from the Management Console with a single click.

Considerations

Consider the following aspects before you upgrade the backup proxies:

  • Automatic rollback for RPM upgrade is supported from version 4.7.1 and later.

  • To upgrade the backup proxy from an older version to version 4.7.1 or later, you must deploy the backup proxy. Automatic upgrade is supported from backup proxy version 4.7.1 onwards.

  • If an upgrade is triggered and schedule backup and restore jobs are in queue, the jobs resume after the upgrade is complete.

Procedure

  1. Log in to the Management Console.

  2. From the top menu bar, select your organization if organizations are enabled.

  3. Click Protect > VMware.
    The All Virtual Machines page appears that lists all the registered vCenter/hypervisors.

  4. You can either select the registered vCenter/ESXi host from the card view or list view or select it from the vCenter/ESXi host list in the left navigation pane.

  5. In the left pane, click Backup Proxies.

  6. Under the Version column, you can see the current status for each proxy.

    • Latest Latest version:

      The current version is the latest available version for backup proxies.

    • Non Upgradable ❌:

      The current version is not upgradable to the latest version through the Druva portal.


      πŸ“ Note


      ​ If the VMware backup proxy cannot be upgraded to the latest version, you must deploy a new ova for the latest backup proxy version.


    • Scheduled upgrade Sceduled upgrade:

      There is an ongoing upgrade.


      πŸ“ Note


      ​ Jobs that are in progress at the time of upgrade will restart after the upgrade is complete. Ongoing backup now jobs will fail after triggering the upgrade.


    • Upgradable Upgrade available:

      The current version is upgradable to the latest available version.
      ​

  7. To upgrade individual backup proxies across different pools:

    • Select the backup proxy(s) and click Upgrade.

      Upgrade backup proxy_1.png

  8. To upgrade backup proxies within a pool, click on the Back Proxy Pools tab.

  9. Click on the backup proxy pool.

    • Select the backup proxy(s) and click Upgrade.

      Upgrade_1.png

Upgrade VMware backup proxy through RPM

Use the RPM package to upgrade the backup proxy (with CentOS OS).

Before you begin

Ensure that your existing backup proxy can be upgraded using RPM. If you are upgrading from an older backup proxy version to the latest backup proxy version, RPM upgrade can fail. For example, if you try to upgrade backup proxy using RPM, and in the logs you see a message like:

Vddk 6.0.3 not found on backup proxy. To install rpm please deploy latest backup proxy OVA

If you see a message similar to the one above, you cannot upgrade the backup proxy using RPM. To upgrade backup proxy, deploy the latest backup proxy appliance and reconfigure the virtual machines to use the newly deployed backup proxy.

If you can upgrade the backup proxy using RPM, download the latest backup proxy and perform the following steps.

Procedure

From the directory that contains the downloaded RPM, run the following commands:

  1. Open the command prompt.

  2. Run the following command to find the old package name of the Druva installer:
    ​rpm -qa | grep druva

  3. Run the following command to uninstall the old package:
    ​rpm -e <old_package_name>
    When you are prompted Do you want to cleanup all Phoenix config and data files: [yes/no]? [default: no], enter no.
    ​


    πŸ’‘ Tip

    If you enter yes, all the Hybrid Workloads agent configuration files will be deleted. When you reinstall the agent you will have to reactivate it.


  4. Run the following command to install the new package, and start the Phoenix service.
    ​rpm –ivh <new_package_name>
    where <new_package name> represents the file name (along with the extension) of the new installer.

  5. Set the vCenter credentials on proxy using the following command:
    ​vCenterDetail set <hostfqdn> <username> <password>

  6. Restart the Phoenix service.

Upgrade VMware backup proxy through Debian

Use the Debian package to upgrade the backup proxy (with Ubuntu OS). To upgrade backup proxy, deploy the latest backup proxy appliance and reconfigure the virtual machines to use the newly deployed backup proxy. If you can upgrade the backup proxy using Debian, download the latest backup proxy Debian package and perform the following steps.

  1. Login to the backup proxy virtual machine.

  2. Run the following command to check currently installed deb package:
    ​dpkg -l | grep -i druva

  3. Run the following command to uninstall current deb package:
    ​
    ​For VMware proxy version prior to 7.0.0
    ​dpkg -r druva-phoenix-vmware-client
    ​
    When you are prompted Do you want to cleanup all Phoenix config and data files: [yes/no]? [default: no], enter no.
    ​


    πŸ’‘ Tip

    If you enter yes, all the Hybrid Workloads agent configuration files will be deleted. When you reinstall the agent you will have to reactivate it.



    ​For VMware proxy version 7.0.0 and later
    ​dpkg -r enterpriseworkloads
    ​
    When you are prompted Do you want to cleanup all EnterpriseWorkloads config and data files: [yes/no]? [default: no], enter no.
    ​


    πŸ’‘ Tip

    If you enter yes, all the EnterpriseWorkloads agent configuration files will be deleted. When you reinstall the agent you will have to reactivate it.


  4. Run the following command to install a deb package:
    ​dpkg -i <package name>

Downgrade VMware backup proxy through Debian


❗ Important

Perform the following steps only if you have upgraded the VMware backup proxy from version 6.3.5 to 7.0.0.


The following are the steps to downgrade the VMware backup proxy from version 7.0.0 to 6.3.5.


πŸ“ Note


​In the following steps, backupConfig.zip will only be created after your initial migration from version 6.3.5 to 7.0.0.


  1. Login to the backup proxy virtual machine.

  2. Run the following command.

    mkdir /etc/Phoenix

  3. Run the following commands:

    1. unzip /var/backups/Druva/EnterpriseWorkloads/ConfigBackup/vmware/backupConfig.zip -d "/etc/Phoenix/"

    2. echo "2.0.0" >> /etc/Phoenix/.version

    3. Note down the current version.

      dpkg -l | grep -i druva

    4. Remove the current package.

      dpkg -r enterpriseworkloads

    5. Run the following command:

      dpkg -i <old_package_to_be_installed>

    6. Verify successful package downgrade.

      ddpkg -l | grep -i druva

      For example, root@BackupProxy:~# dpkg -l | grep -i druva

      ii druva-phoenix-vmware-client 6.3.5-444332

    7. service Phoenix restart

      Ensure that the service is up and running.

      service Phoenix status
      ​


      πŸ“ Note

      ​Remove the /etc/Druva directory after the VMware backup proxy downgrade completes.


Upgrade packages in Ubuntu proxy

To check and install the latest updates, you must run the following commands. These commands fix the security vulnerabilities of application packages and kernel by updating them.

Check pending updates

Run the following command:

apt update && apt list --upgradable

Here, apt-update refreshes the list of available package updates.

Install updates

Run the following command:

apt-get upgrade -y

Here, apt-get upgrade installs the available package updates without upgrading the kernel. If a vulnerability is not patched by Ubuntu in the kernel version present in the proxy, then you must deploy a new OVA.

List Ubuntu repository

Run the following command to list Ubuntu repositories. This must be allowed if internet access is restricted on proxy infra.

grep -rhE ^deb /etc/apt/sources.list*

Did this answer your question?