Upgrading Data Protection for VMware

This procedure documents how to upgrade to Data Protection for VMware 8.2.2.

Before you begin

Important: This upgrade procedure applies to a system that does not have IBM Storage Protect Snapshot for VMware installed.

You must have administrator privileges to upgrade Data Protection for VMware.

Updates to the existing Data Protection for VMware vSphere GUI are processed in the following manner:

Parameter files are backed up before the Data Protection for VMware vSphere GUI upgrade process begins.
The same Derby Database Port and WebSphere® Application Server Default Base Port numbers are used.
The values in the profile (vmcliprofile) are used for the Data Protection for VMware command-line interface.

Restriction:

When IBM Storage Protect for Virtual Environments was installed to a non-default location, the upgrade process installs IBM Storage Protect for Virtual Environments 8.2.2 features to the default installation directory. You cannot upgrade to a non-default location. See the subtopics in Installable components for the default installation directories for each feature.
The upgrade process does not install new components.
For example, if your previous version has only the recovery agent GUI installed, the upgrade procedure does not install the recovery agent command-line interface. In such a scenario, you must run the installation program again and then select the missing component to install.
The v Center needs access to the domain name of the GUI host.
The domain name of the GUI host used in upgrade must be reachable by the vCenter in order to upgrade the Data Protection vSphere plug-in. If the domain name is not reachable, then re-registering the plug-in will be necessary post-upgrade.
The recovery agent on Linux® version must be the same version as the recovery agent on the Windows proxy. Therefore, if you upgrade recovery agent on Linux, you must also upgrade the recovery agent version on the Windows proxy.

Procedure

To upgrade Data Protection for VMware, complete the following steps:

Note: If the data mover V6.x is installed, you must uninstall it before the upgrade. Follow the instructions in the Uninstalling Data Protection for VMware on a Linux system topic.

Download the Data Protection for VMware package.
Stop any Data Protection for VMware components and services that are running.
Unmount any mounted virtual volumes.
You can use the recovery agent GUI or command-line interface (mount del command) to unmount volumes.

Create a backup copy of the key store file (key.jks):

copy C:\IBM\SpectrumProtect\webserver\usr\servers\veProfile\resources\security\key.jks C:\IBM\SpectrumProtect\webserver\

From the folder where you saved the Data Protection for VMware package start the upgrade process:
1. Run the spinstall.exe file and follow the instructions in dialogue box to upgrade it.
2. Run the install-Linux.bin file and follow the instructions in the prompts to upgrade it.
  
  Note: You can install only one Data Protection for VMware vSphere GUI on a machine.
Move the backup copy of key.jks file to its original path:
```
move C:\IBM\SpectrumProtect\webserver\key.jks C:\IBM\SpectrumProtect\webserver\usr\servers\veProfile\resources\security\key.jks
```
Note: This step intentionally overwrites the new key.jks file that was created during the upgrade process.
Restart the webserver.

What to do next

After you upgrade Data Protection for VMware, the following error screen can be seen in Data Protection for VMware vSphere GUI when you check the Status of the plug-in.

Figure 1. Error after upgrade on the vSphere plug-in

To resolve the error, re-register plug-in on vSphere by using the following steps:

Open the web-browser and enter the following URL:
```
https://hostname:port/TsmVMwareUI
```
where:
- hostname: The name of the system where the Data Protection for VMwareCloud GUI is installed.
- port: The port number which you can use to access GUI. The default port number is 9081.
Log in by using your vCenter user ID and password.
Re-register the plug-in by selecting appropriate values.
Check for the status for IBM Storage Protect 8.1.25 plug-in on the Data Protection for VMware vSphere GUI.