Upgrading

Existing users of commercial editions of JSCAPE MFT Server are entitled to 1 year of free upgrades and technical support.  To obtain access to the latest version please contact JSCAPE via the Help Desk.

Upgrade Process - Graphical User Interface

This process is available only to versions 6.2 and above when using GUI installer.  Upgrades may only be performed against versions 5.0 or above.  If you are currently using a version prior to 5.0 then you must uninstall/delete current version and reinstall/reconfigure new version.

1.  Run the GUI installer for JSCAPE MFT Server.

2.  When prompted where to install JSCAPE MFT Server select the same installation directory as your current installation.

3.  The installer for JSCAPE MFT Server will detect that a previous version of JSCAPE MFT Server is installed and will prompt you for a directory in which the current version may be backed up.

4.  Continue with the installation process as normal.  Once installation is complete your server configuration settings from previous version will be automatically migrated from previous version to current version.

Additional Notes

1. If you are managing your server remotely it is IMPORTANT that both the version of JSCAPE MFT Server Manager used matches the version of JSCAPE MFT Server you are managing.

2. Any logos or text label settings that you have made to web interface WILL NOT be migrated during upgrade process.

3. Note, for Windows environments the JSCAPE MFT Server service will revert to using the Local System account after an upgrade.  If JSCAPE MFT Server is accessing shared network resources (e.g. UNC paths) then you may need to update JSCAPE MFT Server service to use an account with access.

Upgrade Process - Manual

Upgrades may only be performed against versions 5.0 or above.  If you are currently using a version prior to 5.0 then you must uninstall/delete current version and reinstall/reconfigure new version.

Pre-9.3

1.Shutdown JSCAPE MFT Server Service and JSCAPE MFT Server Manager.

2.Backup current JSCAPE MFT Server installation directory.

3.Uninstall current version of JSCAPE MFT Server.

4.Install updated version of JSCAPE MFT Server making sure to use same installation directory as previous install.

5.Shutdown JSCAPE MFT Server Service and JSCAPE MFT Server Manager.

6.Copy directories.properties, server-log.properties, jdbc.dat, ssl.cfg, ssl_ibm.cfg and license.lic from backup directory to current installation etc directory.

7.Copy *.vmoptions files from backup directory to current installation directory.users and logs directories from backup directory to current installation directory.

8.Copy any JDBC driver JAR files you have installed from backup libs/jdbc directory to libs/jdbc directory of current installation.

9.Copy any custom actions you have installed from backup libs/actions directory to libs/actions directory of current installation.

10. Copy any custom authentication or 3rd party JAR from backup libs/ext to libs/ext directory of current installation.

11. Run the ./js-db-migration command from within the installation directory.  This will migrate previous installation configuration data to  new installation.

12. Restart JSCAPE MFT Server Service and JSCAPE MFT Server Manager.

Post 9.3

1.Shutdown JSCAPE MFT Server Service and JSCAPE MFT Server Manager.

2.Backup current JSCAPE MFT Server installation directory.

3.Uninstall current version of JSCAPE MFT Server.

4.Install updated version of JSCAPE MFT Server making sure to use same installation directory as previous install.

5.Copy any JDBC driver JAR files you have installed from backup libs/jdbc directory to libs/jdbc directory of current installation.

6.Copy any custom actions you have installed from backup libs/actions directory to libs/actions directory of current installation.

7.Copy any custom authentication or 3rd party JAR from backup libs/ext to libs/ext directory of current installation.

8.Copy contents of etc directory from backup to etc directory of current installation.

9.Copy *.vmoptions files from backup directory to current installation directory.

10.Restart JSCAPE MFT Server Service and JSCAPE MFT Server Manager.

Additional Notes

1. If you are managing your server remotely it is IMPORTANT that both the version of JSCAPE MFT Server Manager used matches the version of JSCAPE MFT Server you are managing.

2. Any logos or text label settings that you have made to web interface WILL NOT be migrated during upgrade process.