Versions Compared

Old Version 4

changes.mady.by.user Andrew

Saved on

compared with

New Version 5

changes.mady.by.user Andrew

Saved on

Key

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

...

  • Joget DX uses Glowroot for Java APM; thus a new "-javaagent" argument in needed 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
  • Joget DX has new runtime Glowroot files in ".\wflow\glowroot\". You can retrieve these files from a fresh install of Joget DX in a temporary folder.
  • Joget DX has a 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.
  • Joget DX installation is running on "apache-tomcat-8.5.41".
  • Joget DX installation is running on Java "jre11.0.2". However Joget DX can still run on Java 8.

Run Joget DX In My Existing v5/v6 Folder 

  1. Backup your Joget v6 installation files and v6 database.
  2. Install Joget DX into a temporary separate folder in your server as we will copy some files from here to your Joget v5/v6 folders.
  3. Make the above changes in startup script (add new "-javaagent" argument and "-Xmx" value) and copy in the Glowroot files to ".\wflow\glowroot\".
  4. Delete all the files in "\work" folder in ".\apache-tomcat-8.5.41" folder. These are cache files and can be safely deleted.
  5. Delete the "\jw" and "\jwdesigner" folders in ".\apache-tomcat-8.5.41\webapps" folder. Joget will re-create the "/jw" folder on startup.
  6. Delete the "jw.war" and "jwdesigner.war" files.
  7. Copy Joget DX's "jw.war" file into ".\apache-tomcat-8.5.41\webapps\". The source "jw.war" file is located in the same path as in v5/v6.
  8. If necessary, edit the database configuration file ".\wflow\app_datasource-default.properties" to point to your existing v6 database.
  9. Start Joget Apache Tomcat and monitor the joget.log.

Run Joget DX In A New Folder And Use My Existing Database

...

Run Joget DX In A New Folder And Use The Default New Database




Final Note

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 be too many files) and "./wflow/app_plugins" folder (to first test Joget DX with zero custom plugin) until after everything is running smoothly.


General Upgrade Flow

Warning

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.

...