Uninstalling Data Protection for VMware on a Linux system

Uninstall Data Protection for VMware and remove files and directories on a supported Linux operating system.

Before you begin

To ensure a successful uninstall, use the following guidance:

Remove nodes from IBM Spectrum Protect Server. You must do this prior to the uninstall of the Data Protection for VMware product:
1. Run the dsmadmc from /opt/tivoli/tsm/client/ba/bin/dsmadmc.
2. You may need to use the del command to delete file space for nodes: del file nodename *
3. Use the q command to query for nodes: q filespace nodename *
4. Use the rem command to remove nodes: rem node nodename
Stop dsmcad services created for Data Movers. Use the instructions in the technical note http://www-01.ibm.com/support/docview.wss?uid=swg21358414
1. Use the ps command to check if the dsmcad service is running: ps -ef|grep dsmcad
2. Use the kill command to halt the dsmcad service: kill -9 dsmcad-processID
You must clean up files related to the creation of a Data Mover services. Go to the installation directory and issue the following command:
```
/opt/tivoli/tsm/client/ba/bin/dsmutillnx cleanupDmFiles 1 
```
Press Enter to select the node name and press Press Enter to delete.

You can find the node names in dsm.sys
When you uninstall the IBM Spectrum Protect vSphere Client plug-in from a VMware vSphere 5.5 environment, only its associated privilege labels and descriptions are removed. The actual privileges remain installed. This issue is a known VMware limitation. For more information, see the following VMware Knowledge Base article: http://kb.vmware.com/kb/2004601.
The Data Protection for VMware Enablement File is not removed after the product is uninstalled.

About this task

When you uninstall Data Protection for VMware on a Linux system, by default, the type of uninstallation is the same process as the type of original installation. To use a different uninstallation process, specify the correct parameter. For example, if you used a silent installation process, you can use the installation wizard to uninstall by specifying the –i swing parameter. Run the uninstallation process as the root user. The root user profile must be sourced. If you use the su command to switch to root, use the su - command to source the root profile.

When the uninstall process begins removing program files, canceling the uninstall process does not return the system to a clean state. This situation might cause the reinstallation attempt to fail. As a result, clean the system by completing the tasks that are described in Manually removing Data Protection for VMware from a Linux system.

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

Procedure

Change to the directory for the uninstallation program. The following path is the default location to the uninstallation program: /opt/tivoli/tsm/tdpvmware/_uninst/TDPVMware/
Depending on the type of installation, use one of the following methods to uninstall Data Protection for VMware:
- To use the installation wizard to uninstall Data Protection for VMware, enter this command:
```
./Uninstall_Tivoli_Data_Protection_for_VMware –I swing
```
- To use the console to uninstall Data Protection for VMware, enter this command:
```
./Uninstall_Tivoli_Data_Protection_for_VMware -i console
```
- To silently uninstall Data Protection for VMware, enter this command:
```
./Uninstall_Tivoli_Data_Protection_for_VMware -i silent -f uninstall.properties
```
  The uninstall.properties file contains the vCenter connection information. This information is needed to uninstall the Data Protection for VMware vSphere GUI.

Manually removing Data Protection for VMware from a Linux system

About this task

When Data Protection for VMware cannot be uninstalled by using the standard uninstallation procedure, you must manually remove Data Protection for VMware from the system as described in these steps. Complete this process as the root user.

Procedure

If you installed the Data Protection for VMware vSphere GUI, remove its package from the Package Manager database with this command:
```
rpm -e TIVsm-TDPVMwarePlugin
```

Remove the IBM Spectrum Protect API with this command:

rpm -e TIVsm-API64
gskssl64.linux.x86_64.rpm
skcrypt64.linux.x86_64
TIVsm-TDPVMwarePlugin.x86_64.rpm
TIVsm-DPAPI.x86_64.rpm

Remove the product entries from the Deployment Engine:
1. Issue this command to view a list of all entries:
```
/usr/ibm/common/acsi/bin/de_lsrootiu.sh
```
2. Issue this command to remove the installed unit entries that are related to Data Protection for VMware:
```
/usr/ibm/common/acsi/bin/deleteRootIU.sh <UUID> <discriminant>
```
  Ensure that these unit entries are removed:
```
FBJRE   
TDPVMwareGUI
JavaHelp  
TDPVMwareDM
```
  After the uninstaller completes, remove the following directories, if present:
  - /opt/tivoli/tsm/client
  - /opt/tivoli/tsm/tdpvmware
  Remove the user tdpvmware and associated directories:
  - userdel tdpvmware
  - /home/tdpvmware
  - /etc/adsm
Back up the global registry file (/var/.com.zerog.registry.xml).
After the file is backed up, remove all tags that are related to Data Protection for VMware.
Remove all files in the installation directory (/opt/tivoli/tsm/tdpvmware). Also, remove any shortcuts that are on the desktop.
Back up the log files that are in the /root directory that contain TDPVMware in the file name.
For example, IA-TDPVMware-00.log or IA-TDPVMware_Uninstall-00.log.

Remove these log files after they are backed up. By removing them, you can view any error that is issued if the installation process fails again.
You can now install the product again as described in Installing Data Protection for VMware on Linux systems.