Changing the TIBCO HOME Directory

To change the current TIBCO HOME directory, perform the following steps:

Procedure

1. Stop TIBCO® Managed File Transfer Platform Server for Windows.

2. Save your configuration files and log files (optional) in a folder outside of your current TIBCO HOME to reuse them in a new environment.

   Configuration files are typically located in the TIBCO HOME\MFT Platform Server folder. Any file with the .cfg extension and ftmssvr.pqf is a configuration file.

   The following is the list of configuration files:

   AccessControl.cfg	cfprofile.cfg	openssl.cnf
   Cfalias.cfg	cfrprofile.cfg	openssl.fips.cnf
   cfcos.cfg	Comtblg.classic	Sslauth.cfg
   CfgPostProc.cfg	Comtblg.cp037	TRECV
   cflist.cfg	Comtblg.cp1047	TSEND
   cfnode.cfg	Comtblg.dat
   Uninstall.silent	ftmssvr.pqf

   Transaction's Log.txt file and admin changes Admin.txt file are typically located in the TIBCO HOME\MFT Platform Server\Trace folder.

   The following is the list of log files:

   • Log.txt.yyyymmdd

   • Admin.txt.yyyymmdd

3. Uninstall TIBCO® Managed File Transfer Platform Server for Windows with PreserverCurrentSetup = false to remove all registry entries and configuration files.

   Note: When PreserveCurrentSetup=false, then all files from the current TIBCO HOME\MFT Platform Server and TIBCO HOME\MFT Platform Server\Trace folders are removed during uninstallation.

4. Install TIBCO® Managed File Transfer Platform Server for Windows, this creates new registry entries and configuration files. During the installation, select or create the new TIBCO_HOME directory that you want to use.

   The new default configuration files are installed in the new TIBCO HOME.

   Note: PreserverCurrentSetup can be true or false.

5. Stop TIBCO® Managed File Transfer Platform Server for Windows and copy the configuration and log files that you have saved in Step 2.

6. Start TIBCO® Managed File Transfer Platform Server for Windows.

   TIBCO® Managed File Transfer Platform Server for Windows is now ready to function in the new TIBCO HOME.

Troubleshooting

Case 1: Installation fails with error: "ANT Task: Create Service has failed"

Follow the procedure below if you receive this error while installing TIBCO® Managed File Transfer Platform Server for Windows using a domain user account.

Verify if the entered domain user account is valid for the machine. If it is not a valid domain user account, then exit the installation and reinstall TIBCO® Managed File Transfer Platform Server for Windows with the correct domain user account to troubleshoot the issue.

If the domain user account is valid and the installation fails, perform the following four tasks:

1. Reinstall TIBCO® Managed File Transfer Platform Server for Windows.

   1. Restart the installation using a local system account. While installing, ignore the Upgrade/Reinstall Notice.

      

2. Change the TIBCO® Managed File Transfer Platform Server for Windows account from local system account to domain user account.

   1. Run Service Control Manager as administrator.

   2. Select the TIBCO MFT Platform Server service.

   3. On the TIBCO MFT Platform Server Properties dialog, select the Log On tab.

   4. On the Log On tab, select This account and enter a valid domain account.

      Tip: Restart the TIBCO MFT Platform Server service to verify the domain account’s validity.

      

3. Assign necessary rights and access privileges to the domain account.

   1. On your machine, go to Local Security Policy > Local Policies > User Rights Assignment.

   2. Find and assign Log on as a service and Replace a process token level rights to the domain account.

      

   3. To assign registry access, open Regedit as administrator and go to Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Proginet.

   4. Select Properties > Permissions and assign Full Control.

      

4. Restart TIBCO® Managed File Transfer Platform Server for Windows.

   1. Start TIBCO® Managed File Transfer Platform Server for Windows with the domain account using either the PSW GUI Manager application or from Services.

Case 2: Installation fails with error: "Another version of TIBCO(R) Managed File Transfer Platform Server for Windows has been detected in a different TIBCO HOME. The product is only allowed to be installed in one TIBCO HOME."

Follow the procedure below if you receive this error while installing TIBCO® Managed File Transfer Platform Server for Windows in a TIBCO HOME.

• For versions 8.1.0 or higher

  1. Open the registry entry HKEY_LOCAL_MACHINE\SOFTWARE\Proginet\CyberFusion Server\FusionRoot and set the value to ${tibco_home}\MFT Platform Server

     ${tibco_home} should be replaced with the actual TIBCO_HOME directory name.

  2. Install the product again.

• For versions 8.0.1 or lower

  1. Open the registry entry HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MFTPS\ImagePath and set the value to ${tibco_home}\MFT Platform Server\ftmssvr.exe

     ${tibco_home} should be replaced with the actual TIBCO_HOME directory name.

     Note: If the value already is "${tibco_home}\MFT Platform Server\ftmssvr.exe" then remove the leading and trailing quotation mark (").

  2. Install the product again.