APAR status
Closed as documentation error.
Error description
Problem Description: The manual page "Uninstalling Data Protection for VMware on Windows" describes the procedure to completely uninstall the product and everything. But its order is incorrect, as below: - Step 4 requires removing only directories of RecoveryAgent and TDPVMware. It does not require removing directory of backup-archive client (data mover). Actually, however, user can remove baclient directory, in case that the remaining files (logs, dsm.opt, etc.) are no longer needed in the future. - Step 7 requires dsmcutil command. But dsmcutil command is already deleted at step 3. User cannot delete data mover services. - Step 7b contains an "Important" statement. But the statement refers non-exist step numbers (3b and 3c), and its content is not applicable for current versions. Tivoli Storage Manager Versions affected: IBM Spectrum Protect for Virtual Environments Data Protection for VMware 8.1.0 or higher on Windows platform Initial Impact: Low Additional Keywords: TSM TS000847904
Local fix
Until the document is corrected, do the following order to completely uninstall everything: 1) Stop any Data Protection for VMware components and any data mover components that are running. 2) Unmount any mounted virtual volumes. 3) Delete any existing virtual machine backups by issuing the data mover delete backup command. 4) Remove any installed data mover services by using dsmcutil remove command. dsmcutil remove /name:"TSM Remote Client Agent" dsmcutil remove /name:"TSM Client Acceptor" 5) Click Start > Control Panel > Programs and Features > Uninstall a program. And uninstall the following programs. Data Protection for VMware suite IBM Spectrum Protect JVM 6) Remove the following Data Protection for VMware files and directories (if they are on your system): - Directory "C:\Program Files\Tivoli\TSM\RecoveryAgent" - Directory "C:\Program Files\Tivoli\TSM\TDPVMware" - Directory "C:\Program Files (x86)\Common Files\Tivoli\TDPVMware" - File C:\ProgramData\installed.txt - File C:\ProgramData\TDPVMwareInstallation.log - File C:\ProgramData\Tivoli\TSM\vmFileLevelRestoreDataSet.xml - File C:\ProgramData\Tivoli\TSM\vmFileLevelRestoreDataSet.xml.bak - File C:\ProgramData\Tivoli\TSM\vmFileLevelRestoreDataSet.xml.lock - Directory C:\ProgramData\Tivoli\TSM\RecoveryAgent - Directory "C:\Program Files\Tivoli\TSM\baclient" (if the remaining log files, dsm.opt files, etc. are no longer needed )
Problem summary
**************************************************************** * USERS AFFECTED: * * IBM Spectrum Protect - Data Protection for Virtual * * Environments 8.1.0, 8.1.2 and 8.1.4 on Windows platform * **************************************************************** * PROBLEM DESCRIPTION: * * The topic "Uninstalling Data Protection for VMware on * * Windows" in the Installation Guide describes the procedure * * to completely uninstall the product. The order of steps is * * incorrect, and some information is no longer relevant. * **************************************************************** * RECOMMENDATION: * * Update the IBM Spectrum Protect for Virtual Environments * * 8.1.6 Installation Guide and Knowledge Center topic * * "Uninstalling Data Protection for VMware on Windows". Until * * this information is published, the associated information * * updates are documented in the IBM Spectrum Protect for * * Virtual Environments 8.1x techdoc 7048968 * * http://www.ibm.com/support/docview.wss?uid=swg27048968. * * Note that this is subject to change at the discretion of * * IBM. * ****************************************************************
Problem conclusion
Documentation updated.
Temporary fix
Comments
APAR Information
APAR number
IT24993
Reported component name
TSM FOR VE DP V
Reported component ID
5725TVEVM
Reported release
71W
Status
CLOSED DOC
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2018-05-20
Closed date
2018-06-15
Last modified date
2018-06-15
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Fix information
Applicable component levels
[{"Line of Business":{"code":"LOB26","label":"Storage"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SS8TDQ","label":"Tivoli Storage Manager for Virtual Environments"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"71W"}]
Document Information
Modified date:
14 February 2021