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 |
ISSERVER_JAVA_EXE | Alternative JVM for the command |
ISSERVER_JAVA_OPTS | Java options for the command (i.e. -Xmx) |
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 |