You are here: Scripting commands > Connect

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, an IP address on the target, or a virtual IP address
  • MAP EXACT—Specifies that the replication set data will be sent to the same logical volume on the target (c:\data and d:\files is copied to c:\data and d:\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 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.