Product Documentation

Database Administrator's Guide

Previous Topic

Next Topic

Starting FairCom DB

The following is a general discussion of the process used to start a FairCom Server. In most environments, faircom is the name of the FairCom DB SQL Server executable (ctsrvr is the name of the ISAM-only FairCom DB Server).

  1. Ensure faircom (or ctsrvr) is in the base directory for database operations. See FairCom Server Installation.
  2. If reconfiguring the FairCom Server, use a text editor to create a configuration file, ctsrvr.cfg. See Configuring the FairCom Server.
  3. If adding (or changing) a configuration file, make sure it is in the same directory as the FairCom Server, is optionally set with the FCSRVR_CFG environment variable, or is listed on the command line (CTSRVR_CFG <file>).

Note: If the configuration file is not found by the FairCom Server, the server will not use the customized configuration file but will begin operation using default configuration settings. Check the installation instructions for your platform in FairCom Server Installation for any exceptions.

Start the FairCom Server by entering or selecting the name of the FairCom Server executable file, faircom or ctsrvr, just as any ordinary program in the environment.

Note: The FairCom Server name may have a file extension - see the platform-specific information in FairCom Server Installation for details.

Note: By default, no password is required to start the FairCom Server, therefore an automated process, such as a batch, script, or cron process, may start the FairCom Server.

Every time the FairCom Server starts, it checks log files made when it last stopped and, if necessary, uses these files to automatically recover from problems. See Automatic Recovery for details.

In most Unix environments, FairCom recommends Administrators run the FairCom Server in background to decrease the chance of unwittingly terminating it. For example:

# faircom &

or

# ctsrvr &

The Unix “no hang up” option may also be used to keep the FairCom Server from being terminated if the user starting the FairCom Server logs off the system. For example:

# nohup faircom &

or

# nohup ctsrvr &

TOCIndex