Deploying to WildFly 19.0.0.0
This topic introduces how to deploy Logi Report Server to WildFly. The example directory paths listed below are based on Unix. The instructions are applicable to both Unix and Windows installations; however, the format of the paths for Windows would use the Windows format, that is, C:\LogiReport\Server
instead of /opt/LogiReport/Server
.
It is assumed that:
- WildFly 19.0.0.0 is installed in the
/opt/wildfly
directory. - The Logi Report Server WAR file jreport.war is located in the
/opt/LogiReport/Server/bin/distribute
directory. To create the WAR file refer to the instructions in Building a WAR/EAR File to Include a Self-contained Logi Report Server.Note: Before creating the WAR, you need to change JRPatternLayout to PatternLayout all over the LogConfig.properties file in
/opt/LogiReport/Server/bin
. After jreport.war is generated, create a file named jboss-deployment-structure.xml as follows in the jreport.war/META-INFO folder:<?xml version="1.0" encoding="UTF-8"?>
<jboss-deployment-structure>
<deployment>
<dependencies>
<system>
<paths>
<path name="org/w3c/dom/css"/>
</paths>
</system>
</dependencies>
</deployment>
</jboss-deployment-structure>
To deploy Logi Report Server to WildFly 19.0.0.0:
- Start WildFly 19.0.0.0 by running the standalone.sh script in
/opt/wildfly/bin
. - By default WildFly 19.0.0.0 is now distributed with security enabled for the management interfaces, this means that before you connect using the administration console you need to add a new user, this can be achieved using the
add-user.sh
script in the bin folder. You will then be prompted to set the user name and password for the new user. - Log onto the WildFly 19.0.0.0 Administration Console with the specified user name and password using the URL
http://localhost:9990/console
. - In the Deployments tab, select Add. In the Create Deployment dialog box, browse to select the file jreport.war. Then select Next.
- In the step 2 of the Create Deployment dialog box, select the Enable option and then select Save.
- Upon the successful deployment of the Logi Report Server WAR file jreport.war, access Logi Report Server using the following URLs:
http://localhost:8080/jreport/jrserver
http://localhost:8080/jreport/jinfonet/index.jsp
Troubleshooting
If you run into problems when using Logi Report Server in WildFly, send the log files of Logi Report Server to support@logianalytics.com. The following procedure illustrates how to generate the log files:
- Modify the file standalone.sh in
/opt/wildfly/bin
.In the file standalone.sh, add -Dlogall=true after the reporthome definition:
"$JAVA" $JAVA_OPTS \ -classpath "$WILDFLY_CLASSPATH" -Dreporthome=/opt/LogiReport/Server \ -Dlogall=true \ org.wildfly.Main "$@"
- After editing standalone.sh, start WildFly using the modified file.
- After reproducing the problem, send support@logianalytics.com the log files in
reporthome/logs
.The WildFly log files may also help to identify the problem. The most useful one is /opt/wildfly/server/default/log/server.log.
Note: If you encounter the issue that WildFly 19.0.0.0 cannot locate jrenv.jar when building a WAR/EAR to deploy to WildFly 19.0.0.0, add -Djbossas7=true in makewar.bat/sh.