Upgrading From An Existing Joget v6 Folder

The following are the changes you need to run Joget DX if you are upgrading from Joget v6 folders:

• Joget DX uses Glowroot for Java APM, so you need to add a new argument in the startup script, example below:

set JAVA_OPTS=-Xmx768M -Dwflow.home=./wflow/ -javaagent:./wflow/aspectjweaver-1.8.5.jar -javaagent:./wflow/glowroot/glowroot.jar

• Install Joget DX in a temporary folder and copy the whole content of folder "\wflow\glowroot\*" to your new Joget "\wflow\" folder.
• Do also note the higher default maximum memory allocation pool for the JVM in @-Xmx768M@. Joget DX requires more heap space and if your server has the additional RAM, do allocate more @-Xmx@ memory for better performance.
• Default Joget DX installation is running on @jre11.0.2@. However Joget DX can still run on Java 8.

The upgrade steps are as follows if you are upgrade to Joget DX in v6 folders:

1. Backup your Joget v6 files and v6 database.
2. Make the above changes in startup script and Glowroot folders.
3. Delete ".\apache-tomcat-8.5.41\work\*" folder.
4. Delete ".\apache-tomcat-8.5.41\webapps\jw" folder and jw.war file.
5. Copy Joget DX @jw.war@ file into ".\apache-tomcat-8.5.41\webapps\".
6. Edit ".\wflow\app_datasource-default.properties" to point to your existing v6 database.
7. Start Joget Apache Tomcat and monitor the joget.log.

New Joget Installation

A second quicker solution where Joget DX is a new install:

1. Backup your Joget v6 database or clone it for Joget DX use (Joget DX will automatically create the new tables and fields it needs).
2. Install Joget DX in a new folder using the Windows or Linux Installer.
3. Copy over all files from v6 ".\wflow\*" to the same folder in Joget DX.
4. Ensure Joget DX can access the v6 database (check the "app_datasource-default.properties" settings).
5. Edit the "./apache-tomcat-8.5.41/conf/server.xml" if you wish to run Joget DX on a different port.
6. Edit to set a higher "-Xmx" memory setting in startup script @joget-start.bat or .sh@.
7. Start Joget Apache Tomcat and monitor the joget.log.

Lastly, you can download and install new plugins specially for Joget DX from https://archives.joget.org/addons/ to try out.

Tip: To save time in the initial DX testing, you can delay the copying of the "./wflow/app_formuploads" folder (may have too many files) and "./wflow/app_plugins" folder (to first test Joget DX with zero custom plugin) until after everything is running smoothly.

Perform Cursory Test

We highly recommend that you spend some time to perform a cursory test on the Joget apps that you have created based on older versions. A quick test can quickly determine if your app is fully compatible with the new Joget v6. Be sure to check the server log also as it would generate error logs on possible missing/incompatible plugins.

Important

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