...

Introduction

Joget Workflow v6 boasts new features and capabilities that appeal to both new and existing users. Check out What is New in Joget Workflow v6 to find out more before performing the upgrade. 

General Upgrade Flow

Updating to Joget DX 7.0.26

If you are running on Java 11 prior to version 11.0.4, you will need to upgrade to the latest Java 11 version (11.0.13) due to a Java bug that causes a JVM crash https://bugs.openjdk.java.net/browse/JDK-8210457. Click here to read the change log.

What's New In Joget DX Installation Files

The following are new in Joget DX:

• Joget DX uses Glowroot for Application Performance Management; thus a new "-javaagent" argument in needed in the startup "joget-start.bat or .sh" 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.

  Thai
  Joget DX มีไฟล์ Glowroot รันไทม์ใหม่ใน ". \ wflow \ glowroot \" คุณสามารถดึงไฟล์เหล่านี้ได้จากการติดตั้ง Joget DX ใหม่

• Joget DX has a higher default maximum memory allocation pool for the JVM in "-Xmx768M". Joget DX requires more Java heap space and if your server has  additional RAM, do allocate more @-Xmx@ memory for better performance.

  Thai
  Joget DX มีพูลการจัดสรรหน่วยความจำสูงสุดเริ่มต้นที่สูงกว่าสำหรับ JVM ใน "-Xmx768M" Joget DX ต้องการพื้นที่ Java heap มากขึ้นและหากเซิร์ฟเวอร์ของคุณมี RAM เพิ่มเติมให้จัดสรรหน่วยความจำ @ -Xmx @ มากขึ้นเพื่อประสิทธิภาพที่ดีขึ้น

• Joget DX installation is running on "apache-tomcat-8.5.41".

  Thai
  การติดตั้ง Joget DX กำลังทำงานบน "apache-tomcat-8.5.41"

• Joget DX installation is running on Java "jre11.0.2". However Joget DX can still run on Java 8.

  Thai
  การติดตั้ง Joget DX กำลังทำงานบน Java "jre11.0.2" อย่างไรก็ตาม Joget DX ยังคงสามารถทำงานบน Java 8 ได้

Run Joget DX In My Existing v5/v6 Folder 

1. Backup your Joget v6 installation files and v6 database.

   Thai
   สำรองไฟล์การติดตั้ง Joget v6 และฐานข้อมูล v6

2. Install Joget DX in a new folder using the Windows or Linux Installer from https://www.joget.org/product/joget-dx/ . We will copy some files from here to your Joget v5/v6 folders.

   Thai
   ติดตั้ง Joget DX ในโฟลเดอร์ใหม่โดยใช้ Windows หรือ Linux Installer จาก https://www.joget.org/product/joget-dx/ เราจะคัดลอกไฟล์บางไฟล์จากที่นี่ไปยังโฟลเดอร์ Joget v5 / v6 ของคุณ

3. Make the above changes in startup script (add new "-javaagent" argument and "-Xmx" value) and copy in the Glowroot files to ".\wflow\glowroot\".

   Thai
   ทำการเปลี่ยนแปลงข้างต้นในสคริปต์เริ่มต้น (เพิ่มอาร์กิวเมนต์ "-javaagent" ใหม่และค่า "-Xmx") และคัดลอกในไฟล์ Glowroot ไปที่ ". \ 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.

   Thai
   ลบไฟล์ทั้งหมดในโฟลเดอร์ "\ work" ในโฟลเดอร์ ". \ apache-tomcat-8.5.41" นี่คือไฟล์แคชและสามารถลบได้อย่างปลอดภัย

5. Delete the "\jw" and "\jwdesigner" folders in ".\apache-tomcat-8.5.41\webapps" folder. Joget will re-create the "/jw" folder on startup.

   Thai
   ลบโฟลเดอร์ "\ jw" และ "\ jwdesigner" ใน ". \ apache-tomcat-8.5.41 \ webapps" โฟลเดอร์ Joget จะสร้างโฟลเดอร์ "/ jw" ใหม่เมื่อเริ่มต้น

6. Delete the "jw.war" and "jwdesigner.war" files.

   Thai
   ลบไฟล์ "jw.war" และ "jwdesigner.war"

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.

   Thai
   คัดลอกไฟล์ "jw.war" ของ Joget DX ไปที่ ". \ apache-tomcat-8.5.41 \ webapps \" ไฟล์ "jw.war" ต้นทางอยู่ในพา ธ เดียวกับใน v5 / v6

8. If necessary, edit the database configuration file ".\wflow\app_datasource-default.properties" to point to your existing v6 database.

   Thai
   หากจำเป็นให้แก้ไขไฟล์การกำหนดค่าฐานข้อมูล ". \ wflow \ app_datasource-default.properties" เพื่อชี้ไปที่ฐานข้อมูล v6 ที่มีอยู่ของคุณ

9. Start Joget Apache Tomcat and monitor the joget.log and catalina.log for errors.

   Thai
   เริ่ม Joget Apache Tomcat และตรวจสอบข้อผิดพลาด joget.log และ catalina.log

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

A second quicker option where Joget DX is a new installation (recommended due to the updated Apache Tomcat and JRE files that comes with the latest Joget DX 7 installer):

1. Backup your Joget v6 database or clone it for Joget DX's use (Joget DX will automatically create the new tables and fields it needs).

   Thai
   สำรองฐานข้อมูล Joget v6 ของคุณหรือโคลนเพื่อการใช้งานของ Joget DX (Joget DX จะสร้างตารางและฟิลด์ใหม่ตามที่ต้องการโดยอัตโนมัติ)

2. Install Joget DX in a new folder using the Windows or Linux Installer from https://www.joget.org/product/joget-dx/.

   Thai
   ติดตั้ง Joget DX ในโฟลเดอร์ใหม่โดยใช้ Windows หรือ Linux Installer จาก https://www.joget.org/product/joget-dx/

3. Copy over all files from v6 ".\wflow\*" folder to the same folder in Joget DX.

   Thai
   คัดลอกไฟล์ทั้งหมดจากโฟลเดอร์ v6 ". \ wflow \ *" ไปยังโฟลเดอร์เดียวกันใน Joget DX

4. Ensure Joget DX can access the v6 database (check the database settings in "app_datasource-default.properties" file using a text editor).

   Thai
   ตรวจสอบให้แน่ใจว่า Joget DX สามารถเข้าถึงฐานข้อมูล v6 (ตรวจสอบการตั้งค่าฐานข้อมูลในไฟล์ "app_datasource-default.properties" โดยใช้โปรแกรมแก้ไขข้อความ)

5. Optional: Edit the "./apache-tomcat-8.5.41/conf/server.xml" if you wish to run Joget DX on a different port instead of "8080".

   Thai
   ทางเลือก: แก้ไข "./apache-tomcat-8.5.41/conf/server.xml" หากคุณต้องการรัน Joget DX บนพอร์ตอื่นแทน "8080"

6. Edit the "joget-start.bat or .sh" file using a text editor to set a higher "-Xmx" memory for better performance.

   Thai
   แก้ไขไฟล์ "joget-start.bat หรือ. sh" โดยใช้เท็กซ์เอดิเตอร์เพื่อตั้งค่าหน่วยความจำ "-Xmx" ที่สูงขึ้นเพื่อประสิทธิภาพที่ดีขึ้น

7. Start Joget Apache Tomcat and monitor the joget.log and catalina.log for errors.

   Thai
   เริ่ม Joget Apache Tomcat และตรวจสอบข้อผิดพลาด joget.log และ catalina.log

8. Finally, copy your Joget plugins from the "old" Joget to your new Joget folder, if any. The Joget plugins are located in ".\wflow\app_plugins\".

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

Fastest option, especially as a development server:

1. Download the Joget DX Windows or Linux Installer from https://www.joget.org/product/joget-dx/.

   Thai
   ดาวน์โหลด Joget DX Windows หรือ Linux Installer จาก https://www.joget.org/product/joget-dx/

2. Run the "joget-enterprise-setup-7.0.exe" installer if you are on Windows or unzip the "joget-enterprise-setup-7.0.tar.gz" if you are on Linux.

   Thai
   เรียกใช้โปรแกรมติดตั้ง "joget-enterprise-setup-7.0.exe" หากคุณใช้ Windows หรือเปิดเครื่องรูด "joget-enterprise-setup-7.0.tar.gz" หากคุณใช้ Linux

3. Follow the on screen installer prompt if you are on Windows.

   Thai
   ทำตามข้อความแจ้งการติดตั้งบนหน้าจอหากคุณใช้ Windows

4. Joget DX comes with MariaDB database but you can change the default database to MSSQL, Oracle or PostgreSQL .

   Thai
   Joget DX มาพร้อมกับฐานข้อมูล MariaDB แต่คุณสามารถเปลี่ยนฐานข้อมูลเริ่มต้นเป็น MSSQL, Oracle or PostgreSQL

5. Click on "joget-start.bat" or "joget-start.sh" to start Joget DX.

   Thai
   คลิกที่ "joget-start.bat" หรือ "joget-start.sh" เพื่อเริ่ม Joget DX

6. In your browser, type in the url address "http://localhost:8080/jw" to run Joget DX.

   Thai
   ในเบราว์เซอร์ของคุณพิมพ์ที่อยู่ URL "http://localhost:8080/jw" เพื่อเรียกใช้ Joget DX

7. Export all the apps from v5/v6 and import them into Joget DX.

   Thai
   ส่งออกแอพทั้งหมดจาก v5 / v6 และนำเข้าสู่ Joget DX

8. Finally, copy your Joget plugins from the "old" Joget to your new Joget folder, if any. The Joget plugins are located in ".\wflow\app_plugins\".

Post Installation Notes

Use this guide Troubleshooting - Common Errors to learn how to solve start up errors in your Joget DX.

Download and install new plugins specially for Joget DX from https://archives.joget.org/addons/ to try out:

• Process Enhancement Plugin
• Report Builder
• API Builder

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.

Additional Documentation

General Upgrade Flow

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.

   Thai
   เตรียมเซิร์ฟเวอร์ทดสอบที่เลียนแบบเซิร์ฟเวอร์ที่ใช้งานจริงให้ใกล้เคียงที่สุดในทุกด้านที่เป็นไปได้ (เช่นการตั้งค่าผู้ใช้, สภาพแวดล้อมเครือข่าย, ความสามารถของซีพียู / หน่วยความจำ, ฐานข้อมูล) โดยไม่ต้องโคลนเซิร์ฟเวอร์ฐานข้อมูลการผลิต เริ่มต้นด้วยฐานข้อมูลใหม่

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.

   Thai
   เมื่อคุณพร้อมกับเซิร์ฟเวอร์ทดสอบคุณอาจลองเริ่มต้นด้วยฐานข้อมูลใหม่โดยไม่มีข้อมูล แต่มีเพียงแอพที่โหลดเข้ามาเท่านั้นเรียกใช้ฟังก์ชันการทำงานทั้งหมดของแอพเพื่อดูว่าทุกอย่างทำงานได้ตามที่คาดหวังหรือไม่

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.

   Thai
   หากขั้นตอนที่ 2 เป็นไปด้วยดีคุณอาจลองโคลนฐานข้อมูลการผลิตที่มีอยู่เพื่อดูว่าแอพของคุณเป็นอย่างไรกับข้อมูลการผลิตที่มีอยู่ ทำงานผ่านฟังก์ชั่นทั้งหมดของแอพของคุณอีกครั้งเพื่อดูว่าทุกอย่างทำงานได้ตามที่คาดไว้หรือไม่

4. If you have integrated Joget Workflow with other solutions, you will also need to test them accordingly.

   Thai
   หากคุณรวม Joget Workflow เข้ากับโซลูชันอื่นคุณจะต้องทำการทดสอบตามลำดับ

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 .

1. Thai
   เมื่อคุณพร้อมโปรดทำตามขั้นตอนต่อไป

Updating Joget Workflow Using jw.war

...

1. Locate the new jw.war

    and jwdesigner.war files

    file from either the:

   Thai
   ค้นหาไฟล์ jw.war ใหม่จาก:

   
   

   1. Downloadable Installers (in the /apache-tomcat-x.x.x/webapps directory); or 

      Thai
      ตัวติดตั้ง Downloadable Installers ดาวน์โหลดได้ (ในไดเรกทอรี /apache-tomcat-x.x.x/webapps); หรือ

   2. The Enterprise Support Site for Enterprise Software Subscribers.

      Thai
      ไซต์ Enterprise Support Site สำหรับผู้สมัครสมาชิกซอฟต์แวร์องค์กร

2. Stop Apache Tomcat / Joget.

   Thai
   หยุด Apache Tomcat / Joget

3. Backup the existing installation data (Please refer to Joget Workflow Deployment Best Practices)

   Thai
   สำรองข้อมูลการติดตั้งที่มีอยู่ (โปรดอ้างอิงJoget Workflow Deployment Best Practices)

4. Delete the existing jw.war

   , jwdesigner.war, jw and jwdesigner

   and jw directories in "[Joget Installation Directory]/apache-tomcat-x.x.x/webapps". 

   Thai
   ลบไดเร็กทอรี jw.war และ jw ที่มีอยู่ใน "[ไดเร็กทอรีการติดตั้ง Joget] /apache-tomcat-x.x.x/webapps"

5. Delete the Apache Tomcat working directories i.e. the "jw"

   and "jwdesigner" directories

   directort in "[Joget Installation Directory]/apache-tomcat-x.x.x/work/Catalina/localhost".

   Thai
   ลบไดเรกทอรีทำงานของ Apache Tomcat เช่น "jw" directort ใน "[ไดเร็กทอรีการติดตั้ง Joget] /apache-tomcat-x.x.x/work/Catalina/localhost"

6. Copy the new jw.war

    and jwdesigner.war files

    file into the Apache Tomcat webapps directory "[Joget Installation Directory]/apache-tomcat-x.x.x/webapps".

   Thai
   คัดลอกไฟล์ jw.war ใหม่ไปยังไดเรกทอรี webapps Apache Tomcat "[ไดเร็กทอรีการติดตั้ง Joget] /apache-tomcat-x.x.x/webapps"

7. Start Apache Tomcat / Joget Workflow.

   Thai
   เริ่ม Apache Tomcat / Joget Workflow

Note: The old jwdesigner.war process builder has been deprecated and need not be copied to your new Joget  installation.

...

...