Connect

Command

CONNECT

Description

Establishes a connection between a replication set and a target machine

Syntax

CONnect <repset> TO <target> MAP EXACT | MAP BASE <target_path> | MAP <source_path> TO <target_path> [,...] [MIRror | NOMIRror] [, REPlicate | NOREPlicate] [, MONitor | NOMONitor] [, ORPHANS | NOORPHANS] [, COMPRESSion <level>] [CLEARRESTOREREQUIRED] [ROUTE=<target_IP>]

Options

• repset—Name of the replication set
• target—Name of the target or an IP address on the target
• MAP EXACT—Specifies that the replication set data will be sent to the same logical volume on the target (/data and /files is copied to /data and /files, respectively)
• MAP BASE target_path—Substitute a complete path, including the volume, for target_path and the data will be replicated to target_path\SrcVolName on the target machine
• MAP source_path TO target_path—Custom location that specifies each directory on the source and where that data will be copied to on the target machine
• ...—Indicates that the source_path TO target_path option can be used more than once for each source directory in the replication set
• MIRror—Automatically initiates a mirror when the connection is established
• NOMIRror—Does not initiate a mirror when the connection is established
• REPlicate—Automatically initiates replication when the connection is established
• NOREPlicate—Does not initiate replication when the connection is established
• MONitor—Specifies that the target is going to monitor the specified source machine for failover. The source machine must have already been defined as a monitor machine.
• NOMONitor—Specifies that the target is not going to monitor the source machine for failover
• ORPHANS—Moves or deletes orphan files on the target. Orphan files will not be immediately processed when you create the connection. This setting is for processes that are run after a connection is already established (remirror, auto-remirror, verification, and so on).
• NOORPHANS—Does not move or delete orphan files on the target
• COMPRESSion level—Enables compression of data being sent to the target at the level specified. Valid levels are 1 (minimum), 2 (moderate), or 3 (maximum).
• CLEARRESTOREREQUIRED—Clears the restore required flag and initiates the connection
• ROUTE=target_ip—Specifies the IP address on the target that will receive the incoming Double-Take Availability data

Examples

• connect DataFiles to beta map exact
• connect UserData to beta map base d:\UserData\
• connect UserFiles to beta map exact orphans, compression 2
• con DataFiles to beta map exact mir, compress 1

Notes

• The default settings for this command are mirror, replicate, nomonitor, and noorphans.
• The options (no)mirror, (no)replicate, (no)monitor, (no)orphans, and compression can be used in any combination and in any order. The first option does not require a comma, but the second and remaining options do require a comma before the option.
• Options, except for IP addresses, that contain non-alphanumeric characters must be enclosed in quotation marks.
• If you are establishing a connection within a NAT or firewall environment, you will need to specify the target using the IP address and port number (separated by a colon) of the router. For example, connect DataFiles to 10.10.1.57:1105 map exact.
• When scripting with this command, if a successful connection is established, the command will return a positive number, which is the connection ID assigned to that connection.