Installing the Event Replicator on a Linux/UNIX Environment

In order for the Event Replicator to run on a Linux/UNIX system:

  • install the Event Replicator Administrator on a Windows machine.

  • install the CONNX SQL Engine client component on the Linux/UNIX machine.

  • install the Event Replicator components on both the Windows Event Replicator Administrator system and the Linux/UNIX system.

We strongly recommend using the same account to install both Adabas and the Event Replicator.

  1. On the Windows Event Replicator Administrator system, run the Unix Installer from the CONNX Open Source Event Replicator Start menu.

  2. Open a session in the Linux/UNIX installation directory on the Linux/UNIX Event Replication machine.

  3. Run the install script ./installreplication.

  4. Enter an install option:

    • If this is the Adabas source database server, install the Event Producer.  

    • If this is the Event Consumer and the Controller server, install the Event Replication Server.

  • Option 1 will install both the Event Replication Server and the Event Producer,

  • Option 2 will only install the Event Replication Server, and

  • Option 3 will only install the Event Producer.

 

Note: The Event Replication Server contains the Event Consumer and the Controller.

 

UNIX_prompt_screen.bmp

 

  1. Press Enter. You will be prompted for an installation directory.

 

UNIX_new_directory.bmp

 

  1. Select the same install directory as the one containing the ConnecX SQL Engine installation. Press Enter. The install script will install the selected components and start the servers.  

 

Unix_final_screen.bmp

 

  1. After the installation completes:

  • Define CONNX_EP_DATA_PATH in your UNIX environment.

CONNX_EP_DATA_PATH is the location of the Event Producer log file.

  • CONNX_EP_DATA_PATH can be in the same directory as ConnecX SQL Engine.  

  • The account used to run Adabas must have read/write access to CONNX_EP_DATA_PATH

  • Define CONNXREGISTRY in your UNIX environment.

  • Define ADAREX in your UNIX environment.

  • Using the account running the ADABAS Nucleus, source (export) cnxep.env into the environment (for example,  /export/home/cnxuser/connx/replicator/cnxep.env).

  • If necessary, start the message queue and start the replication controller.

  1. If you are replicating to a SQL Server, Sybase, Oracle, DB2 or Informix target database, follow the special configuration instructions found in Connecting to SQL Server, Sybase, Oracle, DB2 and Informix from UNIX in CONNX Configuration Settings - non-Windows in the CONNX User Guide.

Warning: If your UNIX target database is not correctly configured on both the ConnecX SQL Engine administrative machine and the Open Systems Event Replicator Administrator machine, you will not be able to use the Open Systems Event Replicator to replicate to those target tables.

 

Note: Note: If there is a firewall between the machines involved in replication, make sure the message queue port (default is 9200) is open.  This includes the Windows machine where the Replication Administrator is located..

 

You are now ready to enable the Event Replicator.

 

Note: If Adabas is upgraded after the Open Systems Event Replicator has been installed, both the Adabas SQL Gateway and the Open Systems Event Replicator MUST be re-installed.