Cascade DataHub™ for Linux and QNX : Version 7.2
	Cogent DataHub Command Set

`mirror_master_2`

mirror_master_2 — sets up a secure mirroring master.

Syntax

(mirror_master_2 host port flagslocaldomain remotedomain heartbeat timeout [username password])

Arguments

host

The master host's name or IP address.

port

The port number or service name of the mirroring master.

flags

Any combination of:

Hex	Flag	Notes
`0x00100000`	`READABLE`	Data is readable from the master. Always set this.
`0x00200000`	`WRITABLE`	Data is writable to the master.
`0x01000000`	`SYNC_SEND`	On initial connection, send all data to the master
`0x02000000`	`SYNC_RECV`	On initial connection, receive all data from the master
`0x04000000`	`SYNC_TIME`	On initial connection, synchronize by comparing time stamps.
`0x10000000`	`AUTHORITATIVE`	Master is authoritative. Data here is marked Not Connected when the connection drops.
`0x20000000`	`NON_AUTHORITATIVE`	I am authoritative. Data in the master is marked Not Connected when the connection drops.
`0x40000000`	`OVERRIDE_TIME`	Override the time stamp on incoming data with the system clock time.

Some combinations of flags will generate strange results:

Combining WRITABLE with OVERRIDE_TIME will result in pollution of the master's time stamps.
Only one of SYNC_SEND, SYNC_RECV and SYNC_TIME should be specified.
Only one of AUTHORITATIVE and NON_AUTHORITATIVE should be specified.
If WRITABLE is not set, then SYNC_SEND, SYNC_TIME and NON_AUTHORITATIVE make no sense.

localdomain

The domain of the slave (i.e. local) computer

remotedomain

The domain of the mirroring master.

heartbeat

The number of milliseconds for the heartbeat on this connection. 0 means disabled.

timeout

The number of milliseconds for the timeout on this connection. 0 means disabled. The timeout should be significantly longer than the heartbeat.

username

(optional) The user name to use if authenticating this connection.

password

(optional) The password to use if authenticating this connection. This password is stored in obfuscated text to stop somebody from casually copying it. However, since this obfuscation must be reversible to give access to the original password, it does not represent strong security. Do not allow untrusted people access to your configuration file.

Returns

A message indicating success or error. Please refer to Return Syntax for details.

Description

This command is the same as mirror_master, but includes the necessary parameters for security. This command is sent to the slave DataHub in a mirroring relationship. It tells the slave all the information it needs about its connection to the master DataHub. This command corresponds to all the entries in the Mirror Master dialog that opens when you click the Add button in the Tunnel/Mirror option of the Properties window.


mirror_master		mult