Joget DX Preview Release Available for Download
Check out Joget DX, the next generation successor to Joget Workflow for faster, simpler digital transformation.
This document is intended to describe the steps required to deploy Joget Workflow Large Enterprise Edition (LEE) in a clustered environment for scalability and redundancy.
In order for clustering to work, the Large Enterprise Edition is required. The standard Enterprise Edition will not work due to licensing restrictions. Clustering requires several layers to be prepared and configured:
There are many ways to design the clustering architecture, but the core concepts will be similar. In this document, the architecture used is as follows:
This guide describes the steps required to setup Joget Workflow LEE clustering. The exact steps will depend on the actual products used in each layer.
Before the clustering installation can be done, the following prerequisites are needed:
Common directory to be accessed by the application servers with read/write permissions. This directory is used to store shared configuration files, system generated files, and uploaded files. Verify that the shared directory is mounted on the application servers and that files can be accessed with read and write permissions.
Common database to be accessed by the application servers with permission to select, update, delete, create and alter tables. Verify that the application servers can connect and query the shared database.
Java web application server to be installed and running on each server in the cluster. Verify that each application server has been installed correctly and can be accessed with a web browser.
Session replication to be configured on the application servers and network. Verify that session replication has been configured for each application server and the network.
Load balancer (hardware or software) to be installed and configured to direct traffic for requests beginning with /jw to the application servers. Verify that the load balancer has been installed and configured correctly so that web traffic is directed to the individual application servers.
It is important to ensure that the pre-deployment requirements have been verified. Once verified, the Joget Workflow specific steps are as follows:
Configure the datasource properties files in the shared directory
Deploy Joget WAR files to the application servers and configure the startup properties to point to the shared directory.
Activate license for each server. Each server has a unique system key and requires a separate license activation.
Once the pre-deployment and clustering configuration has been done, the testing is a matter of using a web browser to access the load balancer.
This sample describes an installation using the following products:
Joget Workflow v5 LEE
Apache HTTP Web Server 2.4 with mod_proxy and mod_balancer (proxy and load balancing modules) running on Ubuntu 14.04
Apache Tomcat 8.0 running on Ubuntu 14.04
Shared File Directory
NFS on Ubuntu 14.04
MySQL 5.5 on Ubuntu 14.04
Share a file directory to be accessed by the application servers. This directory is used to store configuration files, system generated files, and uploaded files.
In this sample, the shared file directory will be a directory /export/wflow in the file server
In the file server, install the NFS server
Create shared directory and set permission
Configure NFS to export the shared directory, edit /etc/exports to export the directory to the local 192.168.1.0 subnetwork with your favourite editor
The /etc/exports should contain the following:
Export the shares and restart NFS service
In the application servers, install the NFS client
Create new directory /opt/joget/shared/wflow to mount the shared directory and set the directory permissions
Mount the shared directory.
Test read-write permissions to confirm that the directory sharing works.
Install MySQL (https://help.ubuntu.com/14.04/serverguide/mysql.html)
Create a database called jwedb accessible to the application servers.
Run the following MySQL commands to create a blank database
Populate the newly created database with the Joget database schema
Configure database permissions
Run the following MySQL commands to grant permissions to user joget and password joget
Configure MySQL to listen to database connections from remote hosts. Edit the my.cnf file with your favourite editor
Comment away the bind-address directive by adding a # in front of the line
In the application server, test a remote connection to the database server database_host
Install Apache Tomcat on each of the application servers. In each application server, run the following to extract tomcat into /opt/joget:
Start each application server
Open a web browser and access each server to confirm that http://server:8080/jw
Configure Tomcat for clustering by editing apache-tomcat-8.0.20/conf/server.xml. Add jvmRoute="node01" to the Engine tag and uncomment the Cluster tag.
Configure local domain IP. Verify that the local server name resolves to the IP and not 127.0.1.1. Assuming the server name is server1 and the IP is 192.168.1.10, edit /etc/hosts and set:
Verify multicast is enabled between the application servers by running ifconfig and look for MULTICAST. Try http://blogs.agilefaqs.com/2009/11/08/enabling-multicast-on-your-macos-unix/ if there are issues.
Restart the Tomcat servers.
Verify session replication working between the application servers. The catalina.out log file in apache-tomcat-8.0.20/logs should show something similar to:
More information on Tomcat clustering is at http://tomcat.apache.org/tomcat-8.0-doc/cluster-howto.html
In the load balancer server, install Apache HTTP Server
Install proxy and balancer modules
Configure a new site with the proxy and balancer modules. Create a new file in /etc/apache2/sites-available, named jwsite
Add the contents
Enable the new site and restart Apache
Deploy and configure Joget Workflow LEE as described earlier in 2.2 Joget Clustering Configuration