Startup on Unix
The Unix version of c-tree does not show any graphical window. All messages are printed on the console.
To start the server in foreground mode, change to the “server” directory and launch the following command:
To start the server in background mode, change to the “server” directory and launch the following command:
The Unix "no hang up" option may also be used to keep the c-tree Server from being terminated if the user starting the c-tree Server logs off the system. For example,
To stop the server, you can use either ctadmn or ctstop utilities, that will be discussed later.
Starting multiple Servers on the same machine
In this example we show how to start two c-tree Server processes listening on different ports on the same machine.
1. Create two configuration files, e.g.
ctsrvr1.cfg:
SERVER_NAME FAIRCOMS1 SERVER_PORT 6661 LOCAL_DIRECTORY ./data1/ |
ctsrvr2.cfg:
SERVER_NAME FAIRCOMS2 SERVER_PORT 6662 LOCAL_DIRECTORY ./data2/ |
Note - the two snippets above shows the basic configuration, they should be completed with the rest of settings that usually appear in a c-tree configuration. We notice that different ports and different data folders are referenced in the two configuration files.
2. Start the two processes as follows:
faircom CTSRVR_CFG /path/to/ctsrvr1.cfg faircom CTSRVR_CFG /path/to/ctsrvr2.cfg |
Note - On Unix platforms, the c-treeRTG server shares a directory with the c-treeRTG clients when they communicate via the shared memory protocol. It is possible to configure the c-treeRTG server to change the default shared memory directory with configuration keyword
SHMEM_DIRECTORY. Using different shared memory directories allows running multiple c-treeRTG servers with the same name on the same machine. To configure the c-treeRTG clients to set the shared memory directory, it is necessary to set
iscobol.file.index.ctshmemdir in the runtime configuration file or
ctshmemdir in the CTREE_CONF file.