Skip to content

StateDMI / Development Environment / launch4j

launch4j software is used to create an executable that wraps the Java Runtime Environment (JRE).


launch4j Installation

To facilitate use, launch4j has been previously installed in the cdss-util-buildtools repository in folder lib/launch4j and does not require any additional installation steps. The cdss-util-buildtools scripts will use launch4j to build the software installer. The following is the download page for launch4j in order to evaluate whether updates should be adopted.

launch4j Configuration

The launch4j software uses a file bin/StateDMI.l4j.ini in the StateDMI installation folder, which is version-controlled in the cdss-app-statedmi-main repository in folder installer/common folder. This is used by launch4j at run-time to configure the Java Runtime Environment. The following command line parameters are used by default, but can be changed after the software is installed:

Parameter                                                   Description
-Xmx2048m Maximum memory for the Java virtual machine. The value should be set based on the computer's available memory.
-Dsun.java2d.noddraw=true Use to fix problems in graphics card drivers (sometimes have visual artifacts strewn about).
-Djava.net.useSystemProxies=true Ensure that StateDMI picks up on system firewall settings that may limit normal HTTP traffic for web services.