You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

Introduction

If you are upgrading your current Joget v5 or v6 to Joget DX, here are your options and step by step guides. 


Upgrade An Earlier Version of Joget to Joget DX And Maintain My Database & Joget Folders


Upgrade An Earlier Version of Joget to Joget DX And Start A New Database


Transfer My Earlier Version of Joget Files to A New Joget DX Installation



General Upgrade Flow

Compatibility: It is strongly recommended that you test the upgrade on a development or test environment first.  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.

Performing a Backup

Please backup your files and perform the necessary tests after the upgrade. If you are upgrading from v3, please note that there have been security hardening changes since v4 so please refer to v4 Compatibility .

Updating Joget Workflow

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


  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.



Note 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.





  • No labels