Database Administrator's Guide

Configuring FairCom DB

Unless otherwise instructed, a FairCom Server starts using default settings for all configurable parameters. The FairCom Server takes configuration instructions from a raw text configuration file, ctsrvr.cfg, placed in the <faircom>/config directory. When the FairCom Server finds this file, it uses all the specified configuration values.

Note: Your vendor may also provide a settings file that is not user-configurable, ctsrvr.set.

Note: Keep in mind that the ctsrvr.cfg file needs to be saved in a Unix text file format. Failure to do so may cause an error to occur.

The FairCom Server allows keywords to be entered from the command-line when it is being started. For example, the following shows setting the Index and Data cache sizes to 1 million bytes each:

./ctsrvr IDX_MEMORY 1000000 DAT_MEMORY 1000000

The command-line entries take precedence over any settings in ctsrvr.set, which takes precedence over ctsrvr.cfg.

Examples of reasons the FairCom Server may need to be reconfigured are:

• Communications protocols (for transmitting information to and from the FairCom Server): The default communications support for the FairCom Server is TCP/IP. Implementing other communication techniques requires a FairCom Server configuration file, and the appropriate COMM_PROTOCOL keyword.
• Memory allocations: To change the maximum amount of memory all users, or any given user, will be allocated—and to specify whether this maximum is an absolute rule or only a guideline.
• Backup files: To specify the FairCom Server should look for a dynamic dump script and follow instructions in that script to back up specified files.

In This Chapter FairCom DB Configuration File Configuration Flexibility with Environment Variables FairCom DB Standard Wildcards Scaling Factors for Configuration Keyword Values Alternative Configuration Methods