2.5. Mirroring Data to Windows or other nodes in Linux or QNX

Cascade DataHub™ for Linux and QNX : Version 5.4
	Chapter 2. Using the Cascade DataHub

The Cascade DataHub can mirror data with one or more other DataHubs in running in Windows, as well as Linux or QNX, across a LAN, WAN, or the Internet, using TCP. Mirroring means that the data and any updates to that data on one DataHub are exactly mirrored across the network onto another DataHub, and vice-versa. The only difference between the master DataHub and slave DataHub is that the slave initiates the connection, and a connection license is consumed on the master. Once the connection is established, they function exactly the same.

Each participating DataHub must be configured as mirroring master (server) or mirroring slave (client), or in some cases, both. If your system requires it, a single DataHub can act as a master to one DataHub and as a slave to another.

Each master-slave pair must have matching port numbers and domain names. Specifying port numbers and domain names is explained below.

2.5.1. Exchanging data between Windows and Linux/QNX

There are three possible ways to set this up:

To have the Windows DataHub initiate the connection, you would need to set it up as a slave, and set up the Linux or QNX DataHub as a master.
To have the Linux or QNX DataHub initiate the connection, you would need to set it up as a slave, and set up the Windows DataHub as a master.
As a third alternative, you can use Cascade Connect instead of the DataHub in Windows, however you must keep in mind that Cascade Connect always functions as a slave, and it only connects to DDE-enabled programs. Please refer to the Cascade Connect manual for details on setting it up for mirroring. You would set it up the Linux or QNX DataHub as a master

2.5.2. Exchanging data between Linux/QNX and Linux/QNX

For this scenario, you would set up whichever DataHub you wanted to initiate the connection as a master, and set up the other DataHub as a slave.

2.5.3. Mirroring Master Setup - Linux or QNX

You can set up the Cascade DataHub to act as a mirroring master on Linux or QNX in either of these two ways:

Run the DataHub with the -p option. This tells the Cascade DataHub to listen as a TCP master on the port or service you specify. Normally you would use port 4600, which we have arbitrarily chosen as the "normal" port, but any port number will do so long as the client (slave) uses the same port number.
```
[sh]$  datahub -p port/service
```
For example:
```
[sh]$  datahub -p 4600
```

Create a configuration file or use an existing one. Make sure the following lines are in the file:

(tcp_service 4600)
(enable_tcp_server 1)
(enable_mirror_master 1)

Then run the DataHub with the -f option:

[sh]$  datahub -f /path/to/my/configfile.cfg

For example:

[sh]$  datahub -f /usr/local/misc/dhconfig.cfg

2.5.4. Mirroring Slave Setup - Linux or QNX

You can set up the Cascade DataHub to act as a mirroring slave on Linux or QNX in either of these two ways:

Run the DataHub with the -m, -M and -n options.

[sh]$  datahub -m port -M address -n domain

For example:

[sh]$  datahub -m 4600 -M 192.168.3.15 -n test

Create a configuration file or use an existing one. Make sure the following lines are in the file:
```
(create_domain domain_M)
(mirror_master address port domain_S domain_M)
(enable_mirror_slave 1)
```
The create_domain command is optional. It is used in this example to show how to make a domain on the slave DataHub that matches a domain on the master DataHub. The mirror_master command then sets up mirroring from domain_M on the master to a different domain, domain_S, on the slave. You can also mirror domains with the same name, say default, by simply specifying the same domain name for master and slave:
```
(mirror_master 192.168.3.15 4600 default default)
```
Once the file is ready, run the DataHub with the -f option:
```
[sh]$  datahub -f /path/to/my/configfile.cfg
```
For example:
```
[sh]$  datahub -f /usr/local/misc/dhconfig.cfg
```

2.5.5. Mirroring Master Setup - Windows

The Act as a master for mirroring box is checked by default, with the service/port set at 4600. Normally you won't have to change these settings.

If you enter a name for the service/port instead of a number, that name must be listed in the Windows services file. Please refer to The Windows Services file Appendix for details.

2.5.6. Mirroring Slave Setup - Windows

Check the Act as a mirroring slave to these masters box to have the Cascade DataHub act as a slave.

To specify one or more masters for this mode, click the Add Master... button. This will open the Mirror Master Dialog:

This is what must be entered:

Host name: The name or IP address of the host computer.
Service/Port: The port number or service name as entered in the Master service/port entry box of the master on the remote computer. The system default is the number that appears in the Master service/port entry box above. It is common, but not necessary, to have these two numbers (or names) the same.
Local domain: The local Cascade DataHub domain for this slave.
Remote domain: The remote Cascade DataHub domain, which is on the master computer. Point names will be mapped from the remote domain (on the master) into the local domain (on this slave), and vice versa.

To edit a master, double-click it or select it and press the Edit button, and edit the fields described above. To remove a master, highlight it and click the Remove button.


2.4. Working with Data		2.6. Viewing Data