...
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.
| Warning |
|---|
| IMPORTANT: Please note that there is minimal configuration required in Joget Workflow LEE itself, and almost all the work is done on the separate layers so it is vital to ensure that you have sufficient expertise in your chosen products. |
...
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.
Joget Workflow Clustering Configuration
...
| Code Block |
|---|
workflowDriver=com.mysql.jdbc.DriverworkflowUrlDriver workflowUrl=jdbc\:mysql\://host\:port/database_name?characterEncoding\=UTF-8 workflowUser=username profileName= workflowPassword=password |
...
- Deploy the WAR files jw.war and jwdesigner.war from the LEE bundle to each of the application servers, e.g. for Apache Tomcat, copy the files into the tomcat webapps directory
- Add a Java -wflow.home=shared_directory_path option in the application server startup e.g. for Apache Tomcat, modify the JAVA_OPTS line
...
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.
Sample Installation and Configuration
...
This sample describes an installation using the following products:
Joget Workflow | Joget Workflow v5 LEE |
Load Balancer | Apache HTTP Web Server 2.4 with mod_proxy and mod_balancer (proxy and load balancing modules) running on Ubuntu 14.04 |
Application Servers | Apache Tomcat 8.0 running on Ubuntu 14.04 |
Shared File Directory | NFS on Ubuntu 14.04 |
Shared Database | MySQL 5.5 on Ubuntu 14.04 |
| Warning |
|---|
| IMPORTANT: Please note that this is not a comprehensive guide and does not cover production-level requirements e.g. user permissions, network and database security, etc. Please ensure that these are covered by your system, network and database administrators. |
...
| Code Block |
|---|
sudo exportfs -ra sudo service nfs-kernel-server restart |
...
Mount the Shared Directory in the Application Servers
...
Open a web browser and access each server to confirm that http://server:8080/jw
Configure Application Server Session Replication
...
More information on Tomcat clustering is at http://tomcat.apache.org/tomcat-8.0-doc/cluster-howto.html
Configure Load Balancer
In the load balancer server, install Apache HTTP Server
...
| Code Block |
|---|
sudo a2enmod headers proxy proxy_balancer proxy_http |
If you are running Apache 2.4, you will need to also enable the following module.
| Code Block |
|---|
sudo a2enmod lbmethod_byrequests |
Configure a new site with the proxy and balancer modules. Create a new file in /etc/apache2/sites-available, named jwsite
...
| Code Block |
|---|
NameVirtualHost * <VirtualHost *> DocumentRoot "/var/www/jwsite" ServerName localhost ServerAdmin support@mycompany.com ErrorLog /var/log/apache2/jwsite-error.log CustomLog /var/log/apache2/jwsite-access.log combined DirectoryIndex index.html index.htm <Proxy balancer://cluster> BalancerMember http://server1:8080 route=node01 BalancerMember http://server2:8080 route=node02 Order deny,allow Allow from all </Proxy> ProxyPreserveHost On ProxyPass /jw balancer://cluster/jw stickysession=JSESSIONID ProxyPassReverse /jw balancer://cluster/jw </VirtualHost> |
...
Deploy and configure Joget Workflow LEE as described earlier in 2.2 Joget Clustering Configuration