Documentation

Replication Manager

Previous Topic

Next Topic

Quick Start

This chapter provides a quick guide to installing and configuring the Replication Manager for experimenting with its many features. When you install in a real-world environment, such as when you roll it out throughout your enterprise, rest assured that Replication Manager provides many installation and configuration options so you can tailor it to your needs. For more information, see Installation Details.

Downloading Replication Manager

The FairCom Replication Manager is distributed in a .zip or .tar package with a name similar to the following:

  • FairCom DB.<platform>.ReplicationManager.<build>

Installation involves simply extracting the package onto your server file system.

The package contains the centralized Memphis components (the Replication Manager controller, database, and browser‑based graphical tools).

Note: It is possible to install and run Replication Manager on the same system where a FairCom DB, FairCom EDGE, or c-treeRTG server is running, but you will need to change the https port in config/cthttpd.json.

You will need to edit the config/ctagent.json configuration files on the FairCom DB, FairCom EDGE, and/or c-treeRTG server nodes to point to the Replication Manager.

You may need to update the licenses on the server nodes to ensure replication is enabled for each database server node.

Note: Your FairCom DB, FairCom EDGE, and/or c-treeRTG servers will need to be updated to the latest build:
V11.7.0 or later.

After downloading and unzipping the Replication Manager package, you will see a directory structure similar to the following:

  • ReplicationManager – This is the folder containing Replication Manager. The application to launch (memphis, or Memphis.exe on Windows) is contained in this directory.
  • ReplicationManager\web – Browser-based versions of the graphical tools, including Replication Manager as well as FairCom DB SQL Explorer, FairCom DB ISAM Explorer, and Ace Monitor.

Installation

  1. In the ReplicationManager folder, execute memphis (Linux) or Memphis.exe (Windows) to launch Replication Manager.
  2. Bring up your other c-tree Servers (ctreesql.exe, ctreeEdge.exe, or ctsrvr.exe).

    Note: It is important that the c-tree Server engines are started after the Memphis application is running, so the automatic registration is completed. You will know this step did not complete correctly if your c-tree Server is not showing in the Memphis Replication Manager Management Interface.

  3. Open a web browser and enter this URL:

    https://hostname-of-your-server:8443/ReplicationManager/

    for example: https://localhost:8443/ReplicationManager/

    If you get a security or certificate error, you will have to click Details and click the link that allows you to continue on to the web page.

  4. You should see the login page for the Replication Manager. The user name and password should be filled in automatically.

    User: "admin"

    Password: "ADMIN"

    After you have logged into Replication Manager, you will see the interface described in this document.

Configuration

To enable replication, the following lines should be seen in ctsrvr.cfg:

; Plugins

PLUGIN cthttpd;./web/cthttpd.dll

PLUGIN ctagent;./agent/ctAgent.dll

The lines shown above enable the plug-in that handles web communication (cthttpd) and the agent that performs the replication (ctagent).

Configuration is performed using two files: config/ctagent.json and config/cthttpd.json.

ctagent.json:

{

"embedded": true,

"log_file": "agentLog.txt",

"memphis_server_name": "MEMPHIS",

"memphis_sql_port": 7000,

"memphis_host": "localhost",

"memphis_database": "MEMPHIS",

"ctree_check_mask": "*.dat;*.idx;*.fdd;*.fsd",

"inactive_timeout": 600

}

cthttpd.json:

{

"listening_https_port": 8443,

"ssl_certificate": "./web/fccert.pem",

"document_root": "./web/apps",

"application": [

"ctree;ctREST.dll",

"AceMonitor;ctMonitor.dll",

"SQLExplorer;ctSQLExplorer.dll",

"ISAMExplorer;ctISAMExplorer.dll",

"ReplicationManager;ctReplicationManager.dll"

]

}

Setting Up Replication:

  1. Hover over the edge of the source server: A chain-link appears. Drag from source server and drop on target server.
  2. Use Replication Plan window to create a Publication (the files on the source server to be replicated) and Subscription (the destination of the replicated files on the target server).
  3. Under Existing Plans: Click the arrow next to a plan to Deploy it then click Start to begin replication (see Menus below).

The Replication Manager provides many features for fine-tuning your replication plan, importing existing replication, and monitoring your replication environment. The rest of this document explains these features in detail.

TOCIndex