Skip to main content

Steps to upgrade FairCom server

While FairCom always attempts to maintain backward compatibility, transaction logs from earlier versions are generally incompatible with newer FairCom server formats.

Note

Unless otherwise mentioned in the version-specific Update Guides, existing data and index files are usually not affected by transaction log changes.

Remove transaction logs and upgrade the FairCom database engine

FairCom makes it easy to upgrade the FairCom server and continue to use your existing files as long as you safely remove prior transaction logs. The following steps are appropriate any time you are upgrading.

Note

As part of this process you will shut down your server twice to allow all files to be brought to a consistent state.

  1. Have all clients cleanly exit from your existing FairCom server.

  2. Perform a normal controlled shutdown of the server using one of the methods described here:

    • Server Console Window - If the FairCom Server was launched manually, double-click the server icon in the tooltray to open the server console. Click the Control tab then select shutdown the server.

    • Windows Toolbar - Right-click the FairCom server icon in the Windows Tooltray and choose ShutDown the Server.

    • Windows Service - If the FairCom server is running as a service, open Windows Services and locate the FairCom Server in the list of services running on your machine. Right-click the service and choose Stop.

    • Use the client command line utility, <faircom>/tools/ctadmn, and follow the prompts.

    • Use the client command line utility, <faircom>/tools/ctstop.

    Remember that the Administrator user ID is "admin" (case insensitive), and the default password is "ADMIN" (case sensitive). The default DB server name is "FAIRCOMS".

  3. Block the ability of any clients to attach to the FairCom server.

  4. Restart the existing FairCom server with no clients attached and allow a successful automatic recovery to take place. This ensures all files are brought to a consistent state in the event that any data is remaining in the transaction logs.

  5. Perform another normal controlled shutdown of the FairCom server as described earlier.

  6. Remove all existing transaction logs and associated files (L*.FCS, S*.FCS, D*.FCS, I*.FCS, and *.FCT).

    Note

    We do not recommend removing FAIRCOM.FCS unless specifically instructed to do so in the notes accompanying the new FairCom version.

    The following types of log dependencies should be considered before deleting transaction logs:

    1. Replicas

    2. Deferred indexes

    3. Record update callbacks

    If these options are in use, ensure they have processed all the log data before the logs are deleted. Otherwise, the dependent data could be out of sync. Deferred indexes and record update callbacks do not always use transaction logs.

  7. Copy your new FairCom server directory in its entirety into the existing Server directory. Note you might want to protect your existing ctsrvr.cfg and ctsrvr.set files so you don't lose any custom settings. Also, review the new ctsrvr.cfg file accompanying any FairCom server upgrade to leverage new best practice settings.

    Note

    Client compatibility can prevent connections to the new FairCom Database Engine. It is always advised to use the most recent matching client version with your FairCom server version.

  8. Unblock the ability of any clients to attach.

  9. Start the FairCom server as usual and begin using your existing data.

FairCom has added logic to notify you when transaction logs may be incompatible. Please review the section "Detection of Transaction Log Incompatibilities" in the FairCom Server Administrator's Guide for details.

Steps to upgrade the FairCom server

upgrade serverupgrade databaseupgrade FairComupgrade guide