Silent uninstallation and hotfix rollback for TIBCO MFT Platform Server for Windows

Silent uninstallation and hotfix rollback for TIBCO MFT Platform Server for Windows

book

Article ID: KB0072537

calendar_today

Updated On:

Products Versions
TIBCO Managed File Transfer Platform Server for Windows 8.0

Description

For silent uninstallation, we need to create an Uninstall.silent  XML file with parameters to uninstall Platform Server for Windows, or rollback hotfixes. The following parameters are supported:

 

Parameter Name

Parameter Description

uninstallTIBCOHome

Defines the path to the TIBCO_HOME where Platform Server is installed. This value is required and is validated before the uninstallation can proceed in the silent mode.

uninstallProductID

Defines the ID of the product that you want to uninstall as defined in the feature config or _installInfo xml file.  For MFT Platform Server, this should be set to "mftps-win". 

Note: You should always set this parameter.  If you do not set this parameter, all TIBCO products installed in the TIBCO home directory will be uninstalled!

uninstallProductVersion 

Defines the Platform Server version that you want to uninstall.  If not specified, all versions matching the uninstallProductID are removed.

tibco.mftpswin.preservecurrentsetup

Allows the user to preserve current platform Server  configuration and settings.  This parameter supports the following values:

True: Save all configuration files and settings

False: Remove all configuration files and settings

 

In order to perform a silent uninstall, you must create the SilentUninstall.xml file.  You can use a text editor like Notepad to create this file.  You can create the uninstall.silent xml file in any directory and you can use any file name.  The uninstall "responseFile" command parameter must point to the uninstall xml file.  Use the sample xml shown in the uninstall scenarios when creating the silent install xml file.  

 

Special Considerations:

: You MUST specify the uninstallProductID XML parameter.  Otherwise all products installed in TIBCO home will be uninstalled.

: Only install products in the TIBCO Home directory that use the TIBCO Universal Installer.  For example, do not install MFT Internet Server or Command Center in the TIBCO Home directory.  If you do, the install directory for these products will be deleted when the last TIBCO Product that uses the Universal Installer is uninstalled.  

: If you want to backout multiple hotfixes, each hotfix must be backed out one at a time.  You cannot backout multiple hotfixes in the same uninstall execution.
: Only the most recent Hotfix can be uninstalled.  Assume you installed hotfixes in this order:

8.0.0_HF-001

8.0.0_HF-002

8.0.0_HF-003

You must uninstall the hotfixes in this order, one at a time:

8.0.0_HF-003

8.0.0_HF-002

8.0.0_HF-001

: In order to roll back from 8.0.1 to 8.0 successfully, tibco.mftpswin.preservecurrentsetup must be set to true

: You cannot roll back to Platform Server for Windows version prior than 8.0 



 

Sample command to perform an uninstall

"C:\tibco\tools\universal_installer\TIBCOUniversalInstaller-x86-64.exe" -silent -V responseFile="C:\tibco\tools\universal_installer\Uninstall.silent" logFile="C:\tibco\tools\universal_installer\uninstall_log.txt"

 

Here is an explanation of the uninstall parameters:

 

Parameter

Description

-silent

Defines that this is a silent uninstall and no user input will be requested

-V

Specifies verbose mode

responseFile

Defines fully qualified path location of the uninstall xml file

logFile

Defines the qualified path location of the uninstall log file that will be created


 

Environment

Microsoft Windows

Resolution

1) To COMPLETELY uninstall Platform Server for Windows and delete all configuration files

NOTE: Any files/products in tibco_home not installed using the TIBCO Universal Installer will be deleted if Platform Server for Windows is uninstalled and is the only product installed using TIBCO Universal Installer.

 
<?xml  version="1.0"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<entry key="uninstallProductID">mftps-win</entry>
<entry key="uninstallTIBCOHome">c:/tibco</entry>
<entry key="tibco.mftpswin.preservecurrentsetup">false</entry>
</properties>
 

NOTE: If the ‘<tibco_home>\MFT Platform Server\System’ is present after an uninstall, please perform the following steps:

  1. Reinstall the same version of Platform Server for Windows using TIBCO Universal Installer.
  2. Check if there are ‘mftps-win_8.x.x_restore.zip’ files in ‘<tibco_home>\_installinfo\.SPBackup’ folder and delete these files.
  3. Run the silent uninstaller with the same Uninstall.silent response file.
 

2) To uninstall Platform Server for Windows while PRESERVING the current configuration

<?xml  version="1.0"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<entry key="uninstallProductID">mftps-win</entry>
<entry key="uninstallTIBCOHome">c:/tibco</entry>
<entry key="tibco.mftpswin.preservecurrentsetup">true</entry>
</properties>
 

3) To COMPLETELY uninstall base version of Platform Server for Windows when no hotfixes have been applied

<?xml  version="1.0"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<entry key="uninstallProductID">mftps-win</entry>
<entry key="uninstallTIBCOHome">c:/tibco</entry>
<entry key="uninstallProductVersion">8.0.0</entry>
<entry key="tibco.mftpswin.preservecurrentsetup">false</entry>
</properties>
 

4) To uninstall one version of Platform Server for Windows while PRESERVING the configuration with no hotfixes applied

<?xml  version="1.0"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<entry key="uninstallProductID">mftps-win</entry>
<entry key="uninstallTIBCOHome">c:/tibco</entry>
<entry key="uninstallProductVersion">8.0.0</entry>
<entry key="tibco.mftpswin.preservecurrentsetup">true</entry>
</properties>
 

5) Uninstall the last Platform Server for Windows hotfix applied:

<?xml  version="1.0"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<entry key="uninstallProductID">mftps-win</entry>
<entry key="uninstallProductVersion">8.0.0.00x</entry>
<entry key="uninstallTIBCOHome">c:/tibco</entry>
</properties>

NOTE: Replace x in ‘uninstallProductVersion’ with the hotfix number

 

6) Rollback from 8.0.1 to the previous version of Platform Server for Windows

<?xml  version="1.0"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<entry key="uninstallProductID">mftps-win</entry>
<entry key="uninstallTIBCOHome">c:/tibco</entry>
<entry key="uninstallProductVersion">8.0.1</entry>
<entry key="tibco.mftpswin.preservecurrentsetup">true</entry>
</properties>
 

7) Uninstall multiple hotfixes

---------------------------------------------------------------------

For example, if you have Platform Server for Windows 8.0, with HF-001, HF-002, HF-003 installed, and would like to rollback to HF-001, this procedure must be followed:

 

1. Create Uninstall.silent.HF3 with the following parameters:

<?xml  version="1.0"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<entry key="uninstallProductID">mftps-win</entry>
<entry key="uninstallProductVersion">8.0.0.003</entry>
<entry key="uninstallTIBCOHome">c:/tibco</entry>
</properties>
 

2. Create Uninstall.silent.HF2 with the following parameters:

<?xml  version="1.0"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<entry key="uninstallProductID">mftps-win</entry>
<entry key="uninstallProductVersion">8.0.0.002</entry>
<entry key="uninstallTIBCOHome">c:/tibco</entry>
</properties>
 

3. Run the following commands:

"C:\tibco\tools\universal_installer\TIBCOUniversalInstaller-x86-64.exe" -silent -V responseFile="C:\tibco\tools\universal_installer\Uninstall.silent.HF3" logFile="C:\tibco\tools\universal_installer\uninstall_log_HF3.txt"

"C:\tibco\tools\universal_installer\TIBCOUniversalInstaller-x86-64.exe" -silent -V responseFile="C:\tibco\tools\universal_installer\Uninstall.silent.HF2" logFile="C:\tibco\tools\universal_installer\uninstall_log_HF2.txt"

 

Issue/Introduction

Steps for executing a silent uninstall and hotfix rollback on TIBCO MFT Platform Server for Windows