Product Documentation

Database Administrator's Guide

Previous Topic

Next Topic

Alternative Configuration Methods

FairCom Server offers several methods of setting configuration options. This section explains those options.

Settings File

Your vendor may supply an encrypted settings file, ctsrvr.set, that is not user configurable. Configuration options in this file are critical to the vendor’s application, and should not be deleted. It is possible for the vendor to configure FairCom DB to require this file for startup. Review your vendor’s documentation for guidance on this settings file.

Environment Variables

The FairCom Server supports environment variables specifying the location and file name of the Server Configuration, Settings, and License files, FCSRVR_CFG, FCSRVR_SET, and FCSRVR_LIC respectively. By default, FairCom DB looks for configuration, settings, and license files (named ctsrvr.cfg, ctsrvr.set settings file, and ctsrvr*.lic) in the configured working directory. This feature allows an administrator to specify alternate configuration for specialized purposes.

The environment variables, FCSRVR_CFG, FCSRVR_SET, and FCSRVR_LIC override the default names and locations when FairCom DB is launched. The environment variable should contain a complete file name for the configuration file.

For example, to direct FairCom DB to use .\work\my_config.001 as its configuration file on a Windows platform, define FCSRVR_CFG as:

set FCSRVR_CFG=.\work\my_config.001

Likewise, FCSRVR_SET overrides the name and location of the Server Settings file:

(Unix example)

set FCSRVR_SET=/usr/production/


FCSRVR_LIC overrides the default name and location of the FairCom Server license file. For example, to use .\myFolder\ctsrvr12345678.lic as the license file:

set FCSRVR_LIC=.\myFolder\ctsrvr12345678.lic

Command-Line Parameters

FairCom DB accepts configuration information from the command-line in addition to the settings and configuration files. Configuration keywords and values listed as command-line arguments take affect after an encrypted settings file, ctsrvr.set, if any, and before the standard configuration file, ctsrvr.cfg. A command-line entry cannot override a settings file entry, and a configuration file entry cannot override a command-line entry (or a settings entry). For more information on the encrypted settings file (ctsrvr.set), see additional documentation included in the Security section of the Knowledgebase in the Customer Portal.

All valid configuration file keywords are supported and may be listed on the command line followed by an appropriate value. No special switch symbols or syntax is required. Simply enter each keyword followed by a value as follows:




To specify the name and location of your server configuration file, ctsrvr.cfg, when launching the FairCom Server from the command-line, use the command-line keyword CTSRVR_CFG followed by a fully qualified configuration file name as follows:

faircom CTSRVR_CFG C:\myServer\ctsrvr.cfg

faircom CTSRVR_CFG /usr/myserver/myinfo.cfg


ctsrvr CTSRVR_CFG C:\myServer\ctsrvr.cfg

ctsrvr CTSRVR_CFG /usr/myserver/myinfo.cfg

The CTSRVR_CFG command line keyword is typically used when running two servers on the same machine, described elsewhere.

Note: The FCSRVR_CFG environment variable supersedes the CTSRVR_CFG keyword, so the file specified in the environment variable will always be the file used.