isCOBOL Application Server : Windows service and Unix daemon : Unix daemon : Daemon configuration
Daemon configuration
The isserver command on Linux look for two files located in the bin directory:
• default_java.conf includes the paths to the isCOBOL and Java installations:
Variable
Description
ISCOBOL
isCOBOL installation directory
ISCOBOL_JDK_ROOT
JDK installation directory
ISCOBOL_JRE_ROOT
JRE installation directory
• isserver.options includes environment variables that can alter the command behavior:
Variable
Description
ISSERVER_HOME
Home directory of the command
ISSERVER_OPTS
Command line options for the command.
Use a space to separate multiple options.
When the options string includes spaces, delimit it with quotes, for example:
ISSERVER_OPTS="-port 1234 -c my.properties"
ISSERVER_JAVA_EXE
Alternative JVM for the command
ISSERVER_JAVA_OPTS
Java options for the command.
Use a space to separate multiple options.
When the options string includes spaces, delimit it with quotes, for example:
ISSERVER_JAVA_OPTS="-XX:+HeapDumpOnOutOfMemoryError -Xmx8G"
ISSERVER_LOG_FILE
File where the command output is redirected
ISSERVER_PID_FILE
Semaphore file to inform if the command is running or not.
This file contains the process ID.
These files are generated by the setup process.
In these files, comments are prefixed by a hash and each entry is on a separate line.
Environment variables in isserver.options can alternatively be set also in the external environment through the export command. The external environment has priority over the content of isserver.options.
Starting multiple daemons on the same machine (Unix)
In this example we show how to start two isCOBOL Server daemons listening on different ports on the same machine.
1. Create two configuration files, e.g.
server1.properties:
iscobol.port=10999
iscobol.as.fileserver.port=10997
iscobol.as.httpserver.port=10996
server2.properties:
iscobol.port=10899
iscobol.as.fileserver.port=10897
iscobol.as.httpserver.port=10896
Note - the two snippets above show the basic configuration, they should be completed with the rest of settings that usually appear in a isCOBOL Server configuration. Notice that different ports for each isCOBOL Server feature are referenced in the two configuration files.
2. Create the two daemons as follows:
export ISSERVER_JAVA_OPTS=-Discobol.conf=/path/to/server1.properties
export ISSERVER_PID_FILE=isserver1.pid
export ISSERVER_LOG_FILE=isserver1.log
isserver start
 
export ISSERVER_JAVA_OPTS=-Discobol.conf=/path/to/server2.properties
export ISSERVER_PID_FILE=isserver2.pid
export ISSERVER_LOG_FILE=isserver2.log
isserver start
3. To stop the two daemons, do the following:
export ISSERVER_PID_FILE=isserver1.pid
isserver stop
 
export ISSERVER_PID_FILE=isserver2.pid
isserver stop