ISAM server setup

This chapter explains how to install the FairCom ISAM Server on your operating system. Certain configuration issues pertaining to the runtime and shared memory communication are explained here. The next chapter, FairCom ISAM Configuration, dives into more detail about the many configuration options provided by FairCom ISAM.

Installing & Configuring the FairCom DB Server

FairCom ISAM includes a specific version of the well-known FairCom DB database engine, called FairCom ISAM, which integrates server-side logic to implement many of the product requirements.

The server must be installed as described in this section, FairCom ISAM Server Setup.

The server must be configured as described in FairCom ISAM Configuration.


Once the FairCom ISAM driver and the FairCom ISAM Server have been installed and configured, FairCom ISAM should be transparent to your application. Your application should operate the same as it has prior to installing FairCom ISAM.

FairCom ISAM for Windows

The FairCom ISAM installer for Windows creates a Microsoft Windows service that automatically starts the database engine at Windows startup. This allows for seamless and unattended operation. Use the standard Windows service control panels to start/stop and configure various service options.

VSS Backup - FairCom ISAM for Windows supports the Windows Volume Shadow Copy Service (VSS) Writer for backups. This support is supplied as a dynamic link library (c-treeACEVSSWriter.dll) that allows Windows VSS Backup to be used. See VSS Integration in the Technical White Papers on the FairCom website.

FairCom ISAM for Unix/Linux

The FairCom ISAM tar archive for Unix/Linux contains a ready-to-run FairCom DB database engine:

cd /FairCom/Vx.x.x.RTG/<platform>/server/

./faircom

Feel free to include it along with your /etc/init.d startup scripts for fully unattended operation. Consult your local system administrator for details about specific machine configurations.

Configure the FairCom ISAM Server

Note: The FairCom ISAM server (a specialized version of FairCom DB) is configured separately from the FairCom ISAM client. Client configuration is discussed in the next section, FairCom ISAM Configuration.
 

For information about configuring the FairCom ISAM Client, see the FairCom ISAM Configuration chapter in this manual.

For information about configuring the FairCom ISAM Server, refer to the Configuring the FairCom DB Server chapter of the FairCom DB Server Administrator's Guide.

 
The FairCom ISAM Server has a multitude of options for configuring many of the various database subsystems including:

  • Data and index cache control
  • Transaction logging features
  • Memory files
  • Backup scripts
  • Diagnostic options
  • Operational statistics logging

Unless otherwise instructed, the FairCom ISAM Server starts with default settings for all configurable parameters. The FairCom ISAM Server takes configuration instructions from a configuration file, ctsrvr.cfg, placed in the FairCom ISAM Server directory. When the FairCom ISAM Server finds a ctsrvr.cfg file, it uses all the specified configuration values.

FairCom ISAM is delivered with appropriate settings for the server. If you want to change these settings, the ctsrvr.cfg file can be edited using the FairCom DB Config Manager, located in: FairCom\vX.X.X.RTG\<win*>\Tools\gui\c-treeConfigManager.exe (where FairCom\vX.X.X.RTG\<win*>\ is the installation directory) for Windows installations, or simply edit this file using any text editor on Unix/Linux systems.

For more information, refer to Configuring the FairCom DB Server in the FairCom DB Server Administrator's Guide.