After downloading the FairCom product package, it is important to locate the FairCom root folder (<faircom>).
The <faircom> folder for each FairCom product contains all the files it uses. Our documentation regularly refers to this folder, and you must know where to find it to run and configure the server and its command-line utilities.
By default, the <faircom> folder has a long name that includes the product name, operating system, 64-bit or 32-bit platform, and a four-part version number, such as FairCom-Edge.windows.64bit.v4.2.0.173.
We advise creating a dedicated FairCom installation directory for its products since all FairCom products operate using the permissions associated with this directory. Examples include C:\FairCom (Windows), /user/FairCom (Linux), or /documents/FairCom (MacOS).
You can have multiple FairCom products and versions installed in the same FairCom directory, such as C:\FairCom\FairCom-Edge.windows.64bit.v4.2.0.173\ and C:\FairCom\FairCom-DB.windows.64bit.v13.0.1.42\.

Inside the <faircom> folder
Inside the <faircom> folder are all files used by the FairCom server.
- Start the server by running
faircom.exein theserversubfolder. - Configure the server using
ctsrvr.cfgandservices.jsonin theconfigsubfolder. - Run tutorials located in the
driversfolder. - Run command-line utilities in the
toolsfolder. - Back up the data files stored in the data folder and the transaction logs in the
tranlogsfolder.
FairCom folders
When you install the FairCom server, its root folder is placed in the folder of your choice. This <faircom> folder name includes the product name followed by the operating system and the exact version. The version corresponds to the underlying core engine that powers the FairCom server. It follows the pattern, Major, Minor, Patch, and Build.
The following folders are in the <faircom> folder.

| Folder | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
/build_sdk |
A software development kit for C programmers. It is only available in FairCom's professional package. | ||||||||||||||||
/config |
Server startup configuration files. The following list shows which files configure which settings.
|
||||||||||||||||
/data |
Data, and index files. | ||||||||||||||||
/drivers |
Tutorials and drivers for many programming languages. |
||||||||||||||||
/server |
FairCom software executables. | ||||||||||||||||
/tools |
Command-line utilities for managing the server. | ||||||||||||||||
/tranlogs |
Transaction log files. |
Config folder
The config folder contains configuration files that you modify to change the behavior of the FairCom server. These configuration files are referenced throughout this document.

Data folder
The data folder contains log files and one folder for each database that you create. Your data and index files are in these database folders.
ctreeSQL.dbstestdata
By default, FairCom products ship with a single database named ctreeSQL. Use that name in any of the APIs that ask you to enter the name of your database.
![]()
The sql_server.log file contains JSON log entries for each SQL operation you perform. This is useful for troubleshooting SQL. You can turn on logging to this file by placing the SQL_DEBUG LOG_STMT_TIMES_FETCH command in the ctsrvr.cfg file.
FairCom system files (*.fcs) are also kept here. Most are transaction log files used to record that all data sent to the FairCom database engine is durably captured on disk.
The following FCS files contain useful troubleshooting information:
-
ctstatus.fcscontains a history of critical events, such as starts and stops of the FairCom server. -
snapshot.fcscontains a snapshot of the FairCom server when it shuts down.
Drivers folder
The directory structure for the drivers folder may differ depending on your platform.
This drivers folder contains a sub-folder for each programming language, API, and connector that FairCom supports, plus one special folder named c-tree.drivers . The sub-folders are organized by language and API. Inside each sub-folder are tutorials, drivers, connectors and a ReadMe file that walks you through running the tutorials, to get you started in only a few minutes.
The c-tree.drivers sub-folder is a general-purpose folder that contains the components needed by each programming language to run, link, and compile the code in the other drivers sub-folders.
Server folder
The server executable file (faircom.exe ) is in the server directory.
The other files and folders in this directory are to facilitate specific features and operations.
Tools folder
The tools folder contains command‑line utilities you can use to manage your database.
![]()