Initializing help system before first use

Editing the Insight 5 Environment Variables

The environment variables tell the system which JAVA and Xpress settings to use.

You can specify different rules for each server and worker by editing the insight-*.conf.bat file, which is stored in the <SERVER_CONFIG_DIR> or <WORKER_CONFIG_DIR> for your OS. For more on <SERVER_CONFIG_DIR> and <WORKER_CONFIG_DIR>, see Important Note about this Guide.

Windows Server and Worker System Environment Variables

Java: The system will consult the variables XPRESS_INSIGHT_JAVA_HOME and JAVA_HOME; the first of those with a value will be used as the Java home directory and Java will be run as bin\java.exe from within that directory. If neither are present, the system will default to java.exe which should be on the system environment PATH.

Java memory: If the variable XPRESS_INSIGHT_JAVA_XMX is set, then it will be used as the -Xmx option to run Java, which specifies the maximum memory. Default is 2G, which can also be specified as 2048M.

Windows Worker System Environment Variables

XPRESSDIR: If set, then %XPRESSDIR%\bin\mosel.exe should exist; %XPRESSDIR%\bin will be added to the front of the PATH so that using the instruction "mosel.exe" will work. This is useful if you have one main Xpress installation, but you want to try the Worker with a different version.

MOSEL_DSO: If set, a semicolon-separated list of urls to look for DSOs outside the Xpress ecosystem.

Linux Environment Variables

On Linux, environment variables are set in the environment file, found next to application.properties in the <SERVER_CONFIG_DIR> or <WORKER_CONFIG_DIR>. By default, the file contains the following:
# To override the Java home directory, uncomment and supply a value on the next line
# XPRESS_INSIGHT_JAVA_HOME=

# To override the maximum memory Java can use, uncomment and supply a value on the next line
# XPRESS_INSIGHT_JAVA_XMX=

# To override the temporary directory, uncomment and supply a value on the next line
# XPRESS_INSIGHT_TMP=

# To set a configuration encryption key, uncomment and supply a value on the next line
# INSIGHT_CONFIGURATION_KEY=