Installation on Other Jakarta EE Application Servers

This document provides instructions for installing Joget on various Jakarta EE application servers, including WebSphere Liberty and JBoss EAP. Each installation process involves specific steps tailored to the respective application server environments. Additionally, it includes guidance on configuring the logging file path for different application server types.

Installation on WebSphere Liberty V24.0.0.1 with Jakarta EE 8 web profile

1. Open the terminal. 
2. Execute the following command to set the JVM_ARGS environment variable:
   

   export JVM_ARGS="-javaagent:path_to/wflow/wflow-cluster.jar -javaagent:path_to/aspectjweaver-1.9.22.jar -javaagent:path_to/wflow/glowroot/glowroot.jar"
   

3. Deploy the jw.war file by copying it to the usr/servers/defaultServer/dropins directory.

Installation on JBoss EAP 8 (8.0.0)

1. Set the JAVA_OPTS environment variable: 

   export JAVA_OPTS="$JAVA_OPTS -javaagent:path_to/wflow/wflow-cluster.jar -javaagent:path_to/aspectjweaver-1.9.22.jar -javaagent:path_to/wflow/glowroot/glowroot.jar -Dorg.aspectj.tracing.enabled=false -Dorg.aspectj.tracing.factory=default -Dwflow.ignite=true"

   Note
   For a list of additional JAVA_OPTS environment variables available for Joget DX 9, Apache Kafka, and Apache Ignite, refer to Joget JAVA_OPTS properties.

   Jav

    

    

    

2. Deploy the jw.war file in the standalone/deployments directory.

Logging file path configuration

The logging file path is specified in the file WEB-INF/classes/log4j.properties. Specifically, these two tags control the location of the log files:

log4j.appender.R.File=${catalina.home}/logs/joget.log
log4j.appender.R2.File=${catalina.home}/logs/email.log

In other types of application servers besides Tomcat, the value for ${catalina.home} is empty, causing the path to become /logs/email.log.

To configure your preferred log file paths, Ensure to adjust the path in these tags according to your needs. You can also set the system property in the Java Virtual Machine (VM) startup script.

 For example:

• -Dcatalina.home=(preferred_path).