Versions Compared

Old Version 16

changes.mady.by.user Hugo

Saved on

compared with

New Version Current

changes.mady.by.user Andrew

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Warning

Compatibility: It is strongly recommended that you test the upgrade on a development or test environment first. Please read the Upgrade Guide  If you are upgrading from v3, please note that there have been security hardening changes since v4 so please refer to v4 Compatibility.

Licensing: For the Enterprise Edition, upgrades between major versions (e.g. v5 to v6) requires re-activation with a new license, so users with an active Enterprise Software Subscription are required to request for a new license.

IMPORTANT: Starting from v6.0.15, JAVA 8 is required due to fixes for vulnerability issues of a dependent library.

  1. Prepare a test server that mimics the production server as close as possible in all possible aspects (e.g. user setup, networking environment, cpu/memory capabilities, database) without cloning the production's database server. Start with a fresh new database.
  2. Once you are ready with the test server, you may try to start with a fresh database without the data but just the Apps loaded in. Run through all the functionalities of your Apps to see if everything works as expected.
  3. If Step 2 goes well, you may then try to clone the existing production database to see how your Apps fare with the existing production data. Run through all the functionalities of your Apps again to see if everything works as expected.
  4. If you have integrated Joget Workflow with other solutions, you will also need to test them accordingly.
  5. When you are ready, please continue to the next step.

...

Warning

Do not upgrade directly in a production server without prior testing.

Info
titleNote on Upgrading on Joget Workflow v5 to v6

Although in default bundle of Joget Workflow v6, it is shipped together with Apache Tomcat 8.5 and Java 8, it is possible for one to run Joget Workflow v6 in Joget Workflow v5's bundle of Apache Tomcat 8 and Java 7. It is recommended to use the newer version as it offers better performance and bug fixes.


  1. Locate the new jw.war and jwdesigner.war files from either the:
    1. Downloadable Installers (in the /apache-tomcat-x.x.x/webapps directory); or 
    2. The Enterprise Support Site for Enterprise Software Subscribers.
  2. Stop Apache Tomcat / Joget.
  3. Backup the existing installation data (Please refer to Joget Workflow Deployment Best Practices)
  4. Delete the existing jw.war, jwdesigner.war, jw and jwdesigner directories in "[Joget Installation Directory]/apache-tomcat-x.x.x/webapps". 
  5. Delete the Apache Tomcat working directories i.e. the "jw" and "jwdesigner" directories in "[Joget Installation Directory]/apache-tomcat-x.x.x/work/Catalina/localhost".
  6. Copy the new jw.war and jwdesigner.war files into the Apache Tomcat webapps directory "[Joget Installation Directory]/apache-tomcat-x.x.x/webapps".
  7. Start Apache Tomcat / Joget Workflow.

...



Info

 

 

...

titleNote on Upgrading Joget

If in your earlier Joget version you changed the security key and salt hash, remember to edit the customApplicationContext.xml file and add in your original key and salt hash after upgrading your Joget else you will not be able to log in to Joget with your admin account.