Versions Compared

Key

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

...

This guide is designed to assist you in ensuring a smooth setup of your production environment and addressing common issues that may arise during the process of installing and using the Joget DX Platform. By following these checklists and instructions, you can enhance the stability, security, and performance of your system. 

Production Environment: Pre-Installation Prerequisite Checklist

For production environments, prepare the following infrastructure prerequisites before the actual Joget DX installation. General instructions are available in the Server Clustering Guide, but actual steps depend on the product used

ItemDescription
Operating SystemPrepare a supported Windows or Linux OS environment.
JavaInstall a supported Java LTS version i.e. Java 11 or Java 17.
Application ServerInstall a supported Java EE application server e.g. Apache Tomcat 9.
Application Server Service Startup ConfigurationConfigure the application server to startup automatically e.g. Installing Apache Tomcat as a Windows Service. Ensure that the service user has full read and write permissions to the file storage.
Database Server

Install a supported RDBMS server and obtain the database connection credentials for Java JDBC:

  • JDBC URL
  • JDBC Username
  • JDBC Password

Ensure that the database user has full permission to create tables in the database.

File Storage

Prepare file storage for the Joget “wflow” directory to store configuration and runtime files.

Ensure there are sufficient read and write permissions for the application server OS user.

For clustering, this directory must be shared between all servers e.g. using NFS or SMB.

Load Balancer / Reverse Proxy Configuration

Configure the load balancer or reverse proxy to forward requests to the application server e.g. NGINX as Reverse Proxy or Apache HTTPD as Reverse Proxy. 

DNS Configuration

Configure the DNS to map domain names to the load balancer or reverse proxy.

HTTPS Configuration

Configure HTTPS for secure traffic. Highly recommended to configure HTTPS at the load balancer or reverse proxy instead of the app server.

Application Server Session Replication

For clustering, configure session replication in the application servers e.g. Configure Apache Tomcat Session Replication. 

LDAP / Active Directory Connectivity

If applicable, ensure that network connectivity is established to the LDAP or Active Directory server.

Production Environment: Joget DX Platform Installation Checklist

...

Troubleshooting: Common Issues Checklist

A list of common issues that may arise during Joget DX Platform deployment or operation

...