Installing InstantdbSync in a Linux/UNIX Environment
In order for InstantdbSync to run on a Linux/UNIX system:
Install the InstantdbSync Administrator on a Windows machine.
Install the CONNX SQL Engine client component on the Linux/UNIX machine.
Install the InstantdbSync components on both the Windows InstantdbSync Administrator system and the Linux/UNIX system.
We strongly recommend using the same account to install both Adabas and InstantdbSync.
To install InstantdbSync on a Linux/UNIX machine:
1. On the Windows InstantdbSync Administrator system, run the Unix Installer from the CONNX InstantdbSync Start menu.
2. Open a terminal session in the Linux/UNIX installation directory on the Linux/UNIX InstantdbSync machine.
3. Run the install script ./installreplication.
4. Enter an install option:
1 - Install both the InstantdbSync Server and the Event Producer
2 - Install only the InstantdbSync Server
3 - Install only the Event Producer
If this is the Adabas source database server, install the Event Producer. If this is the Event Consumer and the Controller server, install the InstantdbSync Server.
Note:
The InstantdbSync Server contains the Event Consumer and the Controller.
5. Follow the instructions in the terminal to select the same directory that contains the CONNX SQL Engine installation.
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 CONNX 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/instantdbsync/cnxep.env).
If necessary, start the message queue and start the replication controller.
If you are replicating to an SQL Server, Sybase, Oracle, DB2, or Informix target database, see the relevant topic under Operations Guide > Working with Database Objects in CONNX for information about establishing connections to these databases.
Warning:
If your UNIX target database is not correctly configured on both the CONNX SQL Engine administrative machine and the InstantdbSync Administrator machine, you will not be able to use the InstantdbSync to replicate to those target tables.
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 InstantdbSync Administrator is located.
Note:
If Adabas is upgraded after InstantdbSync is installed, both the Adabas SQL Gateway and InstantdbSync MUST be re-installed.
You are now ready to enable InstantdbSync.