In order for the Event Replicator to run on a UNIX system:
install the Event Replicator Administrator on a Windows machine.
install the Event Replicator components on both the Windows Event Replicator Administrator system and the UNIX system.
install the ConnecX SQL Engine component on the UNIX machine.
We strongly recommend using the same account to install both Adabas and the Event Replicator.
Open a session in the UNIX installation directory on the UNIX Event Replication machine.
Run the install script ./installreplication.
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.
Press Enter. You will be prompted for an installation directory.
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.
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.
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.