|
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 users, domains, and logs directories from main installation directory of backup to current installation directory. |
| 7. | Copy *.dat, *.cfg (except ssl*.cfg), from main installation directory of backup to current installation directory. |
| 8. | Copy license.lic and ssl*.cfg files from main installation directory of backup to etc directory under current installation directory. |
| 9. | Copy "-XmxNNNm" line inside server.vmoptions file to new server.vmoptions file if the value of that parameter is bigger than the one in the new server.vmoptions file. |
| 10. | Copy *.dat from etc directory of backup to etc directory of current installation. |
| 11. | Copy any JDBC driver JAR files you have installed from backup libs/jdbc directory to libs/jdbc directory of current installation. |
| 12. | Copy any custom actions you have installed from backup libs/actions directory to libs/actions directory of current installation. |
| 13. | Copy any custom authentication or 3rd party JAR from backup libs/ext to libs/ext directory of current installation. |
| 15. | Run the ./js-db-migration command from within the installation directory. This will migrate previous installation configuration data to new installation. |
| 16. | Run the ./js-update-web-resources -dir [path-to-your-backup] command from within the installation directory. This command will import and merge changes made to certain labels and logos in the user Web interface in the previous installation. You need to specify the location of the previous installation's backup in the [path-to-your-backup] parameter. |
| 17. | 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 data and users directories from backup into installation directory. |
| 9. | Copy the following files: |
| • | <backup>/jdbc.dat or <backup>/etc/jdbc.dat to <current installation>/etc/jdbc.dat |
| • | <backup>/client.cfg or <backup>/etc/client.cfg to <current installation>/etc/client.cfg |
| • | <backup>/ssl.cfg or <backup>/etc/ssl.cfg to <current installation>/etc/ssl.cfg |
| • | <backup>/ssl_ibm.cfg or <backup>/etc/ssl_ibm.cfg to <current installation>/etc/ssl_ibm.cfg |
| • | <backup>/license.lic or <backup>/etc/license.lic to <current installation>/etc/license.lic |
| • | <backup>/etc/database.properties to <current installation>/etc/database.properties |
| • | <backup>/etc/server-log.properties to <current installation>/etc/server-log.properties |
| 10. | Copy *.vmoptions files from backup directory to current installation directory. |
| 12. | Run the ./js-update-web-resources -dir [path-to-your-backup] command from within the installation directory. This command will import and merge changes made to certain labels and logos in the user Web interface in the previous installation. You need to specify the location of the previous installation's backup in the [path-to-your-backup] parameter. |
| 13. | Restart JSCAPE MFT Server Service and JSCAPE MFT Server Manager. |
Additional Notes
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.
|