HP StorageWorks Storage Mirroring scripting guide (T2558-96074, February 2008)

13 - 4
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> [,...]
[MIR
ROR | NOMIRROR] [, REPLICATE | NOREPLICATE] [, MONITOR | NOMONITOR]
[, ORPHANS | NOORPHANS] [, COMPRESS
ION <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
 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 Storage
Mirroring 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
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.