Installing FairCom Products

Stopping the FairCom Database Engine

If replication is running, it is advisable to stop replication before stopping the server. If replication is running, you may see error 792 (External server shutdown disabled), although replication should be able to handle an unexpected server shutdown. More information on the FairCom replication technology can be found in the Replication Manager User Guide.

In This Section Stopping on Windows Stopping on Unix, Linux, and Mac

Stopping on Windows

By default, the FairCom Server requires an administrator password to initiate a server shutdown on Windows. The default (and permanent) administrator account is ADMIN with an initial default password of ADMIN.

The Windows Service does not require the administrator password as it is assumed the FairCom Server is running under administrative privileges.

The FairCom Server can be stopped using any of these procedures:

• Windows Service - If the FairCom Server is configured to run as a service on your machine, you can stop the service via the Windows Service Administrator or by issuing the net stop... command in a Command Prompt window.

• Windows Taskbar - If the FairCom Server was launched manually, a c-tree icon appears in your taskbar. Right-click on that icon and select the appropriate shutdown option.
  
• c-tree Console - Exit the console application via the menu or the standard Windows "X" in the corner. If the FairCom Server was launched manually, the console window can be displayed by double-clicking on the tool tray icon. Shut down the Database Engine using the console window’s Control menu.
  
• ctadmn - The command-line c-tree Administrator utility provides an option to shut down the server. This works both when the server is running as a service and when it’s been launched manually. Note that this tool requires the c-tree administrator user name and password.
• ctstop - The c-tree stop utility can be used to shut down the server from the command-line or in a batch file. It can be used when the server is running as a service and when it’s been launched manually. Note that this tool requires the c-tree administrator user name and password.

  <faircom>\tools\ctstop.exe

Stopping on Unix, Linux, and Mac

Unix, Linux, and Mac OS X users can use the included stop scripts to initiate a server shutdown. The script will be in the following location:

<faircom>/server/stopserver

This script is provided as a "C" shell script and will work in most Unix shell environments. You are free to modify and tailor it to suit your local requirements.

Warning: These scripts must be run from the folder that contains them.

Other ways of stopping the FairCom Server are as follows:

• ctadmn - The c-tree Administrator utility provides an option to shut down the server. Note that this tool requires the c-tree administrator user name and password.
• ctstop - The c-tree stop utility can be used to shut down the server. Note that this tool requires the c-tree administrator user name and password.

  <faircom>\tools\ctstop

• Unix command-line/shell. The FairCom Database Engine traps the SIGSTOP signal. Use the ps command to find a process with "ctree" in the name and, if the name is "ctreeace", "ctreeedge", or "ctreertg", kill that process:

  ps -e | grep faircom

  If the FairCom Server process is running, you will see it ("faircom" in the example below). Note that older versions of the FairCom products called the process "ctreesql" or "ctreeedge".

7288 pts/0 00:00:06 faircom

#kill <ctree PID>

Use "kill 7288" in this example.