Recover Scripting Guide First Edition (November 2009) Part Number: T5437-96009
© Copyright 2009 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particul ar purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Table of Contents Table of Contents 1 Client and scripts 8 Command Line client 9 Scripts 11 Command syntax conventions 13 Getting help for scripting commands 14 Replication sets 15 Creating a replication set 16 Modifying a replication set 19 Deleting a replication set 22 Calculating replication set size 23 Establishing a connection 25 Simulating a connection 29 Connections 30 Monitoring connections 31 Queuing Storage Mirroring Recover data 33 Reconnecting automatically 35 P
Verifying your target data 59 Data transmission 63 Stopping, starting, pausing, and resuming transmission 64 Scheduling data transmission 66 Transmission schedule examples 69 Limiting transmission bandwidth 71 Compressing data for transmission 76 Snapshots 78 Scheduling snapshots 79 Initiating a manual snapshot 82 Applying a snapshot on the target 83 Deleting a snapshot 84 Archiving 86 Archiving files manually 87 Recalling archived files from the target 89 Restoring data 90 F
Using variables to create and connect a replication set and run verification 172 Controlling a mirror using flow control 173 Using variables to pause a target 174 Using variables to resume a target 175 Creating a backup or snapshot of the target by inserting a task command during 176 replication Creating a backup of the target by rotating connections Scripting commands 178 180 Archive Pause 185 Archive Resume 186 Archive Start 187 Archive Stop 188 Block All 189 Compression Disable 190
Email Subject 209 Email Test 210 Environment 211 Exit 212 Failback 213 Failover 214 Get 215 GetEnvStr 216 Get Local 217 Help 218 Limit Bandwidth 219 Limit Bandwidth Disable 220 Limit Bandwidth Schedule Add 221 Limit Bandwidth Schedule Clear 222 Limit Bandwidth Schedule Enable 223 Limit Bandwidth Schedule List 224 Limit Bandwidth Schedule Remove 225 Load Source 226 Load System State 227 Load Target 228 Login 229 Logout 230 Mirror Pause 231 Mirror Resume 232 Mir
Monitor Create 238 Monitor Delete 239 Monitor Display 240 Monitor Get 241 Monitor List 242 Monitor Move 243 Monitor Option 245 Monitor Remove 249 Monitor Script Add 250 Monitor Script Remove 251 Monitor Start 252 Monitor Stop 253 Monitor Use 254 NIC List 255 Orphans Disable 256 Orphans Enable 257 Orphans Start 258 Orphans Stop 259 Pause Target 260 Ping 261 Queue Task 262 Quit 265 Recall Pause 266 Recall Resume 267 Recall Start 268 Recall Stop 269 Replicati
Repset Create 273 Repset Delete 274 Repset Display 275 Repset List 276 Repset Resync 277 Repset Rule Add 278 Repset Rule Remove 279 Repset Save 280 Repset Use 281 Restore 282 Resume Target 284 Schedule Clear 285 Schedule Disable 286 Schedule Enable 287 Schedule End 288 Schedule Start 289 Schedule Window 290 Script Account 291 Script Add 292 Script List 295 Script Remove 296 Script Test 297 Set 298 Set Local 299 Shutdown 300 Snapshot Create 301 Snapshot Del
Snapshot Schedule Disable 305 Snapshot Schedule Display 306 Snapshot Schedule Enable 307 Snapshot Schedule Every 308 Source 309 StatsLog Start 310 StatsLog Status 311 StatsLog Stop 312 Status 313 Target 314 Test Connections 315 Time Now 316 Transmission Pause 317 Transmission Resume 318 Transmission Start 319 Transmission Stop 320 Unblock All 321 Unload Source 322 Unload System State 323 Unload Target 324 Verify 325 Version 327 Wait 328 Wait on Mirror 329 Wait
Client and scripts Storage Mirroring Recover has its own scripting language to control some, but not all Storage Mirroring Recover features. This Scripting Guide does not explain Storage Mirroring Recover features and functions, only the scripting aspects of Storage Mirroring Recover. For details on the features and functions, see the Storage Mirroring Recover User's Guide. The scripting language can be used in the Storage Mirroring Recover Command Line client or in script files.
Command Line client There are three different methods of executing commands from the Command Line client. ● Interactive Entry—At the directory prompt where Storage Mirroring Recover is installed, type the command DTCL –i. A Command prompt will appear and the scripting commands can be entered from that prompt. Any resulting errors are immediately displayed.
Because the Windows command process (cmd.exe) strips two layers of quotation marks during processing, any scripting command that you use that requires quotation marks must have three quotation marks around it. For example, if your machine name had a space in it, login "machine Note: name" username password would be sufficient for the Command Line client interactive entry or file entry. But for the Command Line client single line entry, you would have to use login """machine name""" username password.
Scripts You can create script files to execute series and combinations of scripting commands to meet specific needs. When working with scripts, keep in mind the following. ● ● ● ● ● When creating scripts, each commented line must start and end with the pound (or number) sign (#). Scripts must use ANSI coding. Do not use Unicode or other formats. Variables can be used in commands to replace items that vary such as machine or domain names.
variable. If the new value of the variable does not exceed the end value then the statements will be executed again. This continues until the variable exceeds the end value. If a step value is not provided, the default adds one to the variable. Use the following syntax for the FOR loop. FOR = TO [STEP ] DO END ● WHILE Loop—The WHILE loop evaluates a relational expression and, if it is true, then the statement block is executed.
Command syntax conventions The following conventions are used for the scripting commands. ● ● ● ● ● ● UPPERCASE letters indicate syntax that must be typed exactly as shown. lowercase italic blue letters are variables such as file names, user names, or machine names. Angle brackets, < and >, surround required items that must be supplied with the command. Square brackets, [ and ], surround optional items that can be supplied with the command but are not required.
Getting help for scripting commands A listing of the DTCL commands and their syntax is available by typing the help command. Command HELP Description Displays the DTCL commands and their syntax Syntax Notes HELP ● Press any key to scroll through the list of commands. ● Press q to exit the help function. ● You can also type dtcl help from the directory where the Storage Mirroring Recover program files are installed to display the DTCL commands and their syntax.
Replication sets Using the scripting commands, you can perform the following functions to manage your replication sets.
Creating a replication set Before you can establish a connection, you must create a replication set. 1. Use the repset create command to create a new replication set. Command REPSET CREATE Description Creates a replication set Syntax REPSET CREATE Options name—Name of the replication set Examples repset create DataFiles ● Notes ● The name of the replication set should not be a Storage Mirroring Recover keyword. These are any DTCL command (source, target, and so on.
Options ● path—Volume, directory, wild card, and/or file name ● INClude—Include the specified path in the replication set ● EXClude—Exclude the specified path in the replication set ● ● Examples RECursive—All subdirectories and files of the specified path are recursively included or excluded NONRECursive—No subdirectories and files of the specified path are included or excluded ● repset—Name of the replication set ● repset rule add "c:\data" to DataFiles ● repset rule add "c:\temp" exc rec t
6. After you have added all of the rules, save the replication set by using the repset save command.
Modifying a replication set Make modifications to a replication set when you want to change the data you wish to protect. 1. View the replication sets associated with the active source machine by using the repset list command. Command REPSET LIST Description Lists all replication set names for the currently selected source Syntax REPSET LIST 2. Identify a replication set as active by using the repset use command.
4. Remove the existing rule that you need to change using the repset rule remove command. Command REPSET RULE REMOVE Description Removes a rule from a replication set Syntax Options Examples REPSET RULE REMove [FROM ] ● path—Volume, directory, wild card, and/or file name ● repset—Name of the replication set ● repset rule remove "c:\data" from DataFiles ● repset rule rem "c:\temp" ● Notes ● If you do not specify a replication set name, the current replication set will be used.
● ● Notes ● ● The default settings for this command are include and recursive. The options include/exclude and recursive/nonrecursive can be used in any combination and in any order. The first option does not require a comma, but the second option does require a comma before the option. If you do not specify a replication set name, the current replication set will be used. Options that contain non-alphanumeric characters must be enclosed in quotation marks. 6.
Deleting a replication set 1. View the replication sets associated with the active source machine by using the repset list command. Command REPSET LIST Description Lists all replication set names for the currently selected source Syntax REPSET LIST 2. Delete the replication set by using the repset delete command.
Calculating replication set size 1. Use the repset calculate command to manually calculate the size of a replication set. Command REPSET CALCULATE Description Calculates the size of a replication set Syntax REPSET CALCulate [repset] Options repset—Name of the replication set Examples ● repset calculate DataFiles ● repset calc DataFiles ● Notes ● ● If a replication set name is not specified, the active replication set will be used.
Command SET Description Modifies the value of a Storage Mirroring Recover program setting for the specified server Syntax SET = [machine] ● Options Examples ● value—See Server settings for a complete list of the values for each Storage Mirroring Recover program setting ● machine—Name of the machine ● set netport=1100 ● set DefaultAddress="129.12.34.
Establishing a connection After you have created a replication set, you can establish a connection by connecting the replication set to a target. 1. If you do not know which replication set you will be connecting to the target machine, the repset list command will display the available replication sets for that source. Command REPSET LIST Description Lists all replication set names for the currently selected source Syntax REPSET LIST 2.
● ● ● ● ● ● ● ● 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 MA
● ● 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 Recover data 27 of 332
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.
Simulating a connection After you have created a replication set, you can simulate a connection by connecting the replication set to the TDU. 1. If you do not know which replication set you will be connecting to the target machine, the repset list command will display the available replication sets for that source. Command REPSET LIST Description Lists all replication set names for the currently selected source Syntax REPSET LIST 2. To initiate a connection to the TDU, use the connect TDU command.
Connections Using the scripting commands, you can perform the following functions to manage your connections.
Monitoring connections 1. Identify the connection ID that you want to monitor by using the conID command.
● ● ● ● Options ● ● ● ● Examples Notes BLOCK—Displays whether replication set path on the specified target is being blocked target—Name of the target, an IP address on the target, or a virtual IP address CONnect—Displays connection information for the connection ID specified con_id—Connection ID assigned to the source/target connection MIRror—Displays mirroring information for the connection ID specified REPlicate—Displays replication information for the connection ID specified TRANsmit—Displays t
Queuing Storage Mirroring Recover data Use the get and set commands with the following options to configure how Storage Mirroring Recover queues data.
for each Storage Mirroring Recover program setting Examples ● machine—Name of the machine ● set netport=1100 ● set DefaultAddress="129.12.34.3" ● Notes ● ● Some settings, although immediately applied to Storage Mirroring Recover, will not take effect until the service is restarted. If you do not specify a machine name, the value from the current source will be updated. If you have not identified an active source, no changes will be made.
Reconnecting automatically Use the AutoReconnect option with the get and set commands to configure Storage Mirroring Recover to reconnect connections automatically.
● Notes ● ● Some settings, although immediately applied to Storage Mirroring Recover, will not take effect until the service is restarted. If you do not specify a machine name, the value from the current source will be updated. If you have not identified an active source, no changes will be made. Options that contain non-alphanumeric characters must be enclosed in quotation marks.
Pausing and resuming target processing 1. Pause the execution of operations on the target by using the pausetarget command on a target that you are logged in to.
Disconnecting a connection Use the disconnect command to disconnect the source/target connection.
Mirroring Using the scripting commands, you can perform the following functions to manage mirroring.
Stopping, starting, pausing, or resuming mirroring You can stop, start, pause, or resume a mirror.
● Examples Notes Command CLEARRESTOREREQUIRED—Clears the restore required flag and initiates the mirror ● mirror start 1 different, newer ● mir start 2 different, checksum orphans calc The default settings for this command are noorphans and calculate.
Mirroring automatically Use the AutoRemirror option with the get and set commands to configure if a mirror is initiated automatically when a connection is automatically reconnected.
● Notes ● ● Some settings, although immediately applied to Storage Mirroring Recover, will not take effect until the service is restarted. If you do not specify a machine name, the value from the current source will be updated. If you have not identified an active source, no changes will be made. Options that contain non-alphanumeric characters must be enclosed in quotation marks.
Using mirror scripts 1. To determine any current mirroring scripts, use the script list command.
● ● ● ● con_id—Connection ID assigned to the source/target connection source—Name of the source target—Name of the target, an IP address on the target, or a virtual IP address type—Any of the following script types ● ● Options ● ● ● MIRRORSTART—This script starts when the target receives the first mirror operation. In the case of a difference mirror, this may be a long time after the mirror is started because the script does not start until the first different data is received on the target.
you must enclose it in quotation marks. Arguments cannot contain nested quotation marks. Therefore, if you are passing more than one argument to your script, none of the arguments can require quotation marks. To work around this limitation, you can use 8.3 file naming.
Examples script add 1 alpha on beta mirrorstart="C:\Program Files\StorageWorks\Storage Mirroring\Scripts\MirrorStartScript.bat" args="arg1 arg2" delay interact ● Notes ● The default settings for this command are nodelay and nointeract. Machine names that contain non-alphanumeric characters must be enclosed in quotation marks. 3. To specify the account to use when running the mirror scripts, use the script account command.
[INTERACT|NOINTERACT] ● ● Options ● ● ● Examples machine—Name of the machine where you want to execute the script as a test path—Specify the full path and file name (including the file extension) to the mirroring script. Do not include arguments with the path, only the path and file name. Enclose the path in quotation marks. arguments—Specify any arguments, valid for your script, that are required to execute your script.
● ● ● Options ● con_id—Connection ID assigned to the source/target connection source—Name of the source machine target—Name of the target, an IP address on the target, or a virtual IP address type—Any of the following script types ● ● ● Examples Notes MIRRORSTART—Script that was being processed before the mirroring process starts MIRRORSTOP—Script that was being processed when the mirroring process stops MIRRORCOMPLETE—Script that was being processed when the mirroring process is complete ● script
Removing orphan files 1. To configure orphan removal or deletion during mirror, verification, and restoration processes, use the orphans enable command. Command ORPHANS ENABLE Description Enables orphan file removal during subsequent mirror or verification processes. Syntax ORPHANS ENABLE con_id Options con_id—Connection ID assigned to the source/target connection Examples orphans enable 1 2.
Syntax SET = [machine] ● Options Examples ● value—See Server settings for a complete list of the values for each Storage Mirroring Recover program setting ● machine—Name of the machine ● set netport=1100 ● set DefaultAddress="129.12.34.3" ● Notes setting—See Server settings for a complete list of the Storage Mirroring Recover program settings ● ● Some settings, although immediately applied to Storage Mirroring Recover, will not take effect until the service is restarted.
Examples orphans start 1 5. If you want to stop removing orphan files after it has been started, use the orphans stop command.
Replication Using the scripting commands, you can perform the following functions to manage replication.
Starting replication Start replication by using the replication start command.
Inserting tasks during replication Task command processing is a Storage Mirroring Recover feature that allows you to insert and run tasks at various points during the replication of data. Because the tasks are user-defined, you can achieve a wide variety of goals with this feature. For example, you might insert a task to create a snapshot or run a backup on the target after a certain segment of data from the source has been applied on the target.
6. The target processes the Storage Mirroring Recover task command and completes whatever task is defined, perhaps a snapshot or backup. Since the Storage Mirroring Recover task command is user-defined, you can insert any valid executable or batch file. Storage Mirroring Recover task command processing must be enabled, and there must be an active Storage Mirroring Recover connection for task command processing to function properly. To insert a task command, you would use the queuetask command.
executed ● ● ● ● args—Arguments or options which need to be supplied with the task. Multiple arguments can be supplied in a spaceseparated list enclosed in quotation marks. TIMEOUT timeout—Valid number followed by an optional time indicator indicating the length of time ot pause while waiting for the task to complete. The valid time indicators include seconds, minutes, hours, and days. If you do not specify a time indicator, it will default to seconds.
● Examples ● ● ● ● ● ● Notes ● ● ● ● ● queuetask backup to beta onreceive=PauseAndBackup.bat onexecute=Resume.bat qtask backup to beta onrec=PauseAndBackup.bat onexec=resume.bat The default setting for this command is nointeract. Any combination of one or more execution points can be used with the same queuetask command. All script processing messages, including errors, can be viewed in the Storage Mirroring Recover logs and the Windows Event Viewer.
Verifying your target data With scripting commands, verification can only be initiated after a connection is established. 1. Log on to the source using the login command. Command LOGIN Description Log on to a Storage Mirroring Recover machine Syntax LOGIN [domain] ● ● Options ● ● Examples machine—Name of the machine username—Name of the user. The username is limited to 100 characters. password—Password associated with the user name.
Examples Notes ● source alpha ● sou alpha Source names that contain non-alphanumeric characters must be enclosed in quotation marks. 3. Initiate the verification process by using the verify command.
● ● Examples Notes NOORPHANS—Does not move or delete orphan files on the target CLEARRESTOREREQUIRED—Clears the restore required flag and initiates the verification ● verify 1 ● verify 2 sync, newer ● verify 2 every 2 hr The default verification settings are sync, checksum, and noorphans. 4. Use the VerifyLogName, VerifyLogAppend, and VerifyLogLimit options with the get and set commands to configure the verification log.
● Options Examples ● value—See Server settings for a complete list of the values for each Storage Mirroring Recover program setting ● machine—Name of the machine ● set netport=1100 ● set DefaultAddress="129.12.34.3" ● Notes setting—See Server settings for a complete list of the Storage Mirroring Recover program settings ● ● Some settings, although immediately applied to Storage Mirroring Recover, will not take effect until the service is restarted.
Data transmission Using the scripting commands, you can perform the following functions to manage your Storage Mirroring Recover transmissions.
Stopping, starting, pausing, and resuming transmission You can stop, start, pause, or resume transmission. 1. To start the transmission process, use the transmission start command. Command TRANSMISSION START Description Initiates the transmission pause Syntax TRANSmission START Options target—Name of the target, an IP address on the target, or a virtual IP address.
Description Pauses the transmission pause Syntax TRANSmission PAUSE Options target—Name of the target, an IP address on the target, or a virtual IP address. Depending on the network route Storage Mirroring Recover uses to access the target, you may need to specify the fully qualified domain name. Examples Notes ● transmission pause beta ● trans pause beta Target names that contain non-alphanumeric characters must be enclosed in quotation marks. 4.
Scheduling data transmission You can clear an existing schedule, disable or enable the use of a schedule, and set start, stop, and window criteria. 1. To clear all existing transmission options, use the schedule clear command. All transmission options are stored on the source machine until they are Note: either cleared or the option is updated. At this time, there is not a command to display the existing transmission options.
Notes Target names that contain non-alphanumeric characters must be enclosed in quotation marks. Command SCHEDULE DISABLE Description Disables the transmission schedule without clearing the schedule data Syntax SCHEDule DISABLE Options target—Name of the target, an IP address on the target, or a virtual IP address Depending on the network route Storage Mirroring Recover uses to access the target, you may need to specify the fully qualified domain name.
● ● ● ● Examples ● ● ● Notes ● bytes—Number of bytes that must be in the source disk queue to initiate the transmission process number—Any number indicating how often the transmission process will be repeated time_units—Minutes (min), hours (hr), or days (day) schedule beta start starttime=03/11/07 03:30, queuesize=10000, every 6 hr sched beta start queuesize=100000000 The start option EVERY cannot be used by itself and cannot be the first option in a string of options.
● Notes ● If you use both of the end options, duration and bytes, the transmission will be stopped when the first end option value is met. Target names that contain non-alphanumeric characters must be enclosed in quotation marks. 5. You can specify a transmission window using the schedule window command.
If all the data is not transmitted within the 6-hour duration, the remaining data will remain in the queue and will be transmitted during the next scheduled transmission.
Limiting transmission bandwidth You can set a fixed bandwidth limit or a bandwidth schedule. 1. With a fixed bandwidth limit, data will be transmitted at all times according to the user-specified bandwidth configuration. If you want to set a fixed bandwidth limit, use the limit bandwidth command.
Syntax LIMIT BANDWIDTH SCHEDULE ADD
Monday through Friday, would start at 8:00 p.m., and would not limit the bandwidth. (To create an unlimited event, set the limit option to the keyword UNLIMITED.) In this schedule, on Monday at 6:00 a.m., the schedule limit would be applied, limiting the transfer of data. At 8:00 p.m. that night, the schedule limit would be applied again, unlimiting the transfer of data. At 6:00 a.m. Tuesday morning, the schedule would be applied again. This would continue until the Friday 8:00 p.m. schedule is applied.
6. To clear the schedule use the limit bandwidth schedule clear command. Command LIMIT BANDWIDTH SCHEDULE CLEAR Description Clears a bandwidth schedule Syntax LIMIT BANDWIDTH SCHEDULE CLEAR Options target—Name of the target, an IP address on the target, or a virtual IP address. Depending on the network route Storage Mirroring Recover uses to access the target, you may need to specify the fully qualified domain name.
fully qualified domain name. Examples limit bandwidth disable on beta Notes Target names that contain non-alphanumeric characters must be enclosed in quotation marks.
Compressing data for transmission 1. To determine the current compression setting, use the compression list command. By default, compression is disabled. Command COMPRESSION LIST Description Identifies the compression level set and if compression is enabled Syntax COMPRESSion LIST 2. To set the level of compression, use the compression set command.
Options con_id—Connection ID assigned to the source/target connection Examples compression disable 1 77 of 332
Snapshots Using the scripting commands, you can perform the following functions to manage your Storage Mirroring Recover snapshots.
Scheduling snapshots Use the snapshot schedule commands to establish scheduled snapshots. 1. To establish and initiate a snapshot schedule, use the snapshot schedule every command.
● Options ● Examples Notes con_id—Connection ID assigned to the source/target connection target—Name of the target, an IP address on the target, or a virtual IP address ● snapshot schedule 1 display ● snap sched 1 disp Target names that contain non-alphnumeric characters must be enclosed in quotation marks. 3. You can disable a snapshot schedule, without losing the schedule configuration, by using the snapshot schedule disable command.
● Examples Notes target—Name of the target, an IP address on the target, or a virtual IP address ● snapshot schedule 1 enable ● snap sched 1 enable Target names that contain non-alphnumeric characters must be enclosed in quotation marks.
Initiating a manual snapshot Use the snapshot create command to take a manual snapshot.
Applying a snapshot on the target Apply a snapshot to the target by using the snapshot revert command.
Deleting a snapshot Because Storage Mirroring Recover uses the Microsoft Volume Shadow Copy service to create snapshots, the snapshots can be managed through the Volume Shadow Copy command line administrator. You can also view, copy, or restore files from the Previous Version tab by accessing the file properties through a share using Windows Explorer. See your Volume Shadow Copy documentation for details. Additionally, you can use the scripting commands to delete snapshots on the target. 1.
OLDEST, only the oldest good snapshot will be deleted. ● ● Examples BAD—If specified, deletes only bad snapshots. If used with ALL, all bad snapshots will be deleted. If used with OLDEST, only the oldest bad snapshot will be deleted.
Archiving Using the scripting commands, you can manually archive your files and recall archived files.
Archiving files manually 1. To start archiving, use the archive start command. Command ARCHIVE START Description Starts the archive process Syntax ARCHIVE START FILEAGE FILESIZE ● ● Options ● Examples con_id—Connection ID assigned to the source/target connection number_days—Any number indicating the age, in days, of the files that you want archived. Any file older than the days specified will be archived.
Command ARCHIVE STOP Description Stops the archive process Syntax ARCHIVE STOP Options con_id—Connection ID assigned to the source/target connection Examples archive stop 1 88 of 332
Recalling archived files from the target 1. To start the process to recall all files from the target, use the recall start command. Command RECALL START Description Starts the process to recall all archived files from the target Syntax RECALL START Options con_id—Connection ID assigned to the source/target connection Examples recall start 1 2. To pause the process to recall all files from the target, use the recall pause command.
Restoring data 1. Log on to your target using the login command. Command LOGIN Description Log on to a Storage Mirroring Recover machine Syntax LOGIN [domain] ● ● Options ● ● Examples machine—Name of the machine username—Name of the user. The username is limited to 100 characters. password—Password associated with the user name. The password is limited to 100 characters. domain—If logging in using a domain account, this is the domain name.
Notes Source names that contain non-alphanumeric characters must be enclosed in quotation marks. 3. Restore Storage Mirroring Recover data from the target to the source by using the restore command.
● Examples NOORPHANS—Does not move or delete orphan files on the source restore DataFiles from beta ,overwritenewer ,usetargetdb ● ● Notes ● ● ● The default settings for this command are overwrite, overwritenewer, usetargetdb, restoredbtoo, and noorphans. The options 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. The source command is required before each use of the restore command.
4. After the restoration is complete, the connection will remain connected and continue replicating data changes from the target to the source until the restoration connection is manually disconnected on the target using the disconnect command.
Failover Using the scripting commands, you can perform the following functions to manage failover.
Configuring failover monitoring 1. Specify a target machine by using the target command. Command TARGET Description Identifies a machine as the active target machine Syntax TARget Options target—Name of the target, an IP address on the target, or a virtual IP address Examples ● target beta ● tar beta ● Notes ● You must be logged into a machine using the login command before using the target command.
3. Establish a monitor to use with the remaining monitor commands by using the monitor create command. Command MONITOR CREATE Description Establishes a source as a failover monitor. This is the machine that will be monitored by a target in case it should experience a failure. Syntax MONitor CREATE Options source—Name of the source Examples Notes ● monitor create alpha ● mon create alpha Machine names that contain non-alphanumeric characters must be enclosed in quotation marks. 4.
SERVICE INTERVAL TIMEOUT | [monitor] ● ● ● ● ● Options ● ● ● ● ● Examples IP_address—The IP address which should be moved during failover target_NIC—The integer value of the target NIC obtained from the niclist command NONE—Does not actively monitor the source machine. You will be responsible for identifying when a failure has occurred and initiating failover manually.
settings can be different. ● Monitor names that contain non-alphanumeric characters must be enclosed in quotation marks. 6. To remove an IP address from an established monitor, use the monitor remove command.
● ● ● ● ● ● ● ● ● ● ● Options ● ● ● ● ● ● ● ● MOVENAME—Moves the server name during failover NOMOVENAME—Does not move the server name during failover MOVEADDRESSES—Moves the IP address(es) during failover NOMOVEADDRESSES—Does not move the IP address(es) during failover MOVESHARES—Moves the shares during failover NOMOVESHARES—Does not move the shares during failover ADD—Specifies the source machine’s identity is added to the target machine’s identity when failover occurs REPLACE—Specifies th
last known good Storage Mirroring Recover state ● ● ● ● ● ● ● INTERVENTION—Specifies that network administrator intervention is required before failover begins NOINTERVENTION—Specifies that network administrator intervention is not required before failover begins FOHOSTNAME—Removes the host SPN from Active Directory on the source and adds it to Active Directory on the target during failover NOFOHOSTNAME—Does not modify Active Directory on the source or target during failover FBHOSTNAME—Returns the ho
Examples ● monitor option alpha ● mon option alpha ● ● ● Notes ● monitor option nomoveshares, nousesharefile, failone, nointervention The default settings are movename, moveaddress, moveshares, add, usesharefile, failall, fodelay, fbdelay, apply, intervention, nofohostname, and nofbhostname. The options 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. 9. Specify any scripts by using the monitor script add command.
Command MONITOR SCRIPT REMOVE Description Specifies the scripts that should not be run during the failover and failback processes Syntax MONitor SCRIPT REMove [monitor] ● type—Any of the following script types ● ● ● Options ● ● ● Examples PREFAILOVER—The file is a pre-failover script to be run on the target before failover POSTFAILOVER—The file is a post-failover script to be run on the target after failover PREFAILBACK—The file is a pre-failback script to be run on the target before fai
● Notes ● ● If you do not specify a monitor, the current source designated as the monitor will be used. If you have not identified a monitor, you will receive an error message stating that a monitor has not been selected. Depending on your sequence of commands, you may need to use the monitor get command to specify an active monitor before using monitor display. Monitor names that contain non-alphanumeric characters must be enclosed in quotation marks. 12.
Editing failover monitoring configuration 1. Specify your active monitor by using the monitor get command. Command MONITOR GET Description Identifies a machine as the active monitor machine Syntax MONitor GET Options target—Name of the target, an IP address on the target, or a virtual IP address Examples Notes ● monitor get beta ● mon get beta Monitor names that contain non-alphanumeric characters must be enclosed in quotation marks. 2.
Failing over Verify that the source machine is offline and not connected to the network to avoid IP address conflicts. Trigger failover using the failover command.
Stopping failover monitoring 1. Specify your active monitor by using the monitor get command. Command MONITOR GET Description Identifies a machine as the active monitor machine Syntax MONitor GET Options target—Name of the target, an IP address on the target, or a virtual IP address Examples Notes ● monitor get beta ● mon get beta Monitor names that contain non-alphanumeric characters must be enclosed in quotation marks. 2. To stop failover monitoring, use the monitor stop command.
Deleting failover monitoring configuration 1. Specify your active monitor by using the monitor get command. Command MONITOR GET Description Identifies a machine as the active monitor machine Syntax MONitor GET Options target—Name of the target, an IP address on the target, or a virtual IP address Examples Notes ● monitor get beta ● mon get beta Monitor names that contain non-alphanumeric characters must be enclosed in quotation marks. 2.
Failing back 1. If you are performing failback before restoring, verify that your source machine is not connected to the network and that the issue(s) that caused the failure is resolved. If you have already performed a restoration, your source should already be connected to the network using a unique identity. 2. Login to the target machine that is currently standing in for the failed source by using the login command.
Syntax TARget Options target—Name of the target, an IP address on the target, or a virtual IP address Examples ● target beta ● tar beta ● Notes ● You must be logged into a machine using the login command before using the target command. Target names that contain non-alphanumeric characters must be enclosed in quotation marks. 4. Specify your active monitor by using the monitor get command.
● ● Options ● ● monitor—Name of the source machine designated as the monitor target—Name of the target, an IP address on the target, or a virtual IP address REMONITOR—Automatically continues monitoring the source machine after failback NOREMONITOR—Automatically discontinues monitoring the source machine after failback. Examples failback alpha on beta remonitor Notes Options that contain non-alphanumeric characters must be enclosed in quotation marks.
Configuring server settings While only a subset of the server settings are available through the Management Console, all of the Storage Mirroring Recover server settings are accessible through the get and set commands. See Server settings for a complete list of the server settings. ● Retrieving setting values—To retrieve the current value of a setting, use the get command. This command will return the value of the specified setting from the specified server.
● Examples ● machine—Name of the machine ● set netport=1100 ● set DefaultAddress="129.12.34.3" ● Notes value—See Server settings for a complete list of the values for each Storage Mirroring Recover program setting ● ● Some settings, although immediately applied to Storage Mirroring Recover, will not take effect until the service is restarted. If you do not specify a machine name, the value from the current source will be updated.
Server settings The following table lists all of the server settings, in decimal value. Server Setting Description 24-character Storage Mirroring Recover activation code Values: Unique value for each customer ActivationCode Default: N/A GUI Setting: Server Properties, Licensing tab, Activation Code Specifies the adapter to use when establishing a connection. This option should not be changed.
Server Setting Description Specifies which IP addresses to failover AllFailover Values: 0 Failover only monitored IP addresses, 1 Failover all IP addresses Default: 1 GUI Setting: Failover Control Center, Monitor Settings, Items to Failover, IP Address(es) Specifies whether or not all IP addresses must fail for failover to take place AllMustFail Values: 0 any IP address can fail, 1 All IP addresses must fail Default: 1 GUI Setting: Failover Control Center, Monitor Settings, Failover Trigger, All Monito
Server Setting Description The length of time, in milliseconds, to delay between attempts to archive a file ArchiveLoopDelay Values: any integer Default: 1000 GUI Setting: None Specifies the base file name used for the archive preview report. The replication set will be prepended to the file name. ArchivePreviewFileName Values: any valid file name Default: archivepreview.txt GUI Setting: Server Properties.
Server Setting Description Specifies if the archive file name uses a name or IP address ArchiveUseDNSName Values: 0 Archived files are stored with the server source IP address, 1 Archived files are stored with the source server name Default: 0 GUI Setting: None AutoCalcEulaAccepted Used internally by the Management Console. Do not modify this entry.
Server Setting Description Determines whether or not a source that has lost its connection with a target will attempt to reconnect to the target AutoRetransmit Values: 0 Do not attempt to reconnect, 1 Attempt to reconnect Default: 1 GUI Setting: None Location on the target of the backup of the replication sets Values: any valid path BackupDir Default: the location where the Storage Mirroring Recover files were installed GUI Setting: None Calculates the approximate size of a replication set by using the
Server Setting Description Specifies whether or not the replication set size should be calculated on connection CalculateOnConnect Values: 0 Do not calculate on connection, 1 Calculate on connection Default: 1 GUI Setting: Connection Manager, Mirroring tab, Calculate Replication Set size on connection CaseSensitiveRepSetQueries This entry is no longer used.
Server Setting Description Enables additional logging for out of order acknowledgement errors CreateDumpOnAckErrors Values: 0 Do not create a logging file, 1 Create a logging file Default: 0 GUI Setting: None The location of the Storage Mirroring Recover file attribute, replication set, connection, and schedule database files Values: any valid path DataPath Default: the location where the Storage Mirroring Recover files were installed GUI Setting: Server Properties, Database tab, Database Files, Folder
Server Setting DelayGCArbitration Description Number of seconds to delay the arbitration process. This option allows time for the network to become stable before trying to execute arbitration logic, for example, when a cluster failover has occurred, but the network has a lag before it returns to a stable state. Arbitration should not start until the network is back in that stable state.
Server Setting Description Determines if an additional attempt is made to access a file by a Microsoft API call if the Storage Mirroring Recover call fails.
Server Setting Description Specifies if e-mail notification is enabled Values: 0 E-mail notification is disabled, 1 E-mail notification is enabled Default: 0 EmailEnabled GUI Setting: Server Properties, E-mail Notification tab, Enable notification This is a read-only setting. If you change this setting using the DTCL SET command or via the registry editor, e-mail notification will not automatically start. You must use the GUI or the DTCL EMAIL ENABLE command to start e-mail notification.
Server Setting Description Specifies which Event Viewer messages are sent via email Values: 1 Error messages will be sent via e-mail, 2 Warning messages will be sent via e-mail, 3 Information messages will be sent via e-mail EmailIncludeCategories Default: 1,2 GUI Setting: Server Properties, E-mail Notification tab, Include You must disable and re-enable e-mail notification for a change to take effect. Specifies the e-mail address(es) that will receive Storage Mirroring Recover generated e-mail messages.
Server Setting Description Specifies the port that the SMTP e-mail server is using EmailServerPort Values: any valid port number Default: 25 GUI Setting: None Specifies if SMTP server authentication for e-mail notification is enabled or disabled Values: 0 SMTP authentation is disabled, 1 SMTP authenticaion is enabled Default: 0 EmailSmtpLogin GUI Setting: Server Properties, E-mail Notification tab, Log on to SMTP Server Your SMTP server must support the LOGIN authentication method to use this feature.
Server Setting EmailSubjectPrefix Description Specifies unique text which will be inserted at the front of the subject line for each Storage Mirroring Recover generated e-mail message. This will help distinguish the Storage Mirroring Recover messages from other messages.
Server Setting Description Indicates if Storage Mirroring Recover will correct any short file names created by the operating system on the target during a mirror or for create and rename operations during replication EnableShortFileNameProcessing Values: 0 Do not correct any short file names on the target, 1 Correct short file names on the target Default: 0 GUI Setting: None Specifies whether Storage Mirroring Recover snapshot functionality is enabled Values: 0 Storage Mirroring Recover snapshot function
Server Setting Description Returns the host SPN (Service Principle Name) to its original setting on failback Values: 0 Disabled, 1 Enabled FailbackHostname Default: 0 GUI Setting: Failover Control Center, Monitor Settings, Active Directory, Failback Hostname If you are using Active Directory, this option should be enabled or you may experience problems with failback.
Server Setting Description The number of times a failed driver call will be retried by the service. FileAccessRetry Values: 1 - 65535 Default: 10 GUI Setting: None FileQueueSize When a mirror is started, one thread reads from the disk and builds the file queue. Another set of threads reads files off of the queue and sends them to the target. This setting is the maximum size of the queue in entries.
Server Setting Description Specifies if verification will be performed with every difference mirror ForceVerifyOnMirror Values: 0 Verification is not performed with every difference mirror, 1 Verification is performed with every difference mirror Default: 0 GUI Setting: None Specifies the length of time, in seconds, to generate a hard link report HardLinkInterval Values: any valid integer Default: 3600 GUI Setting: None Specifies the location where hard links will be logged.
Server Setting Description Indicates the IP address(es) to be ignored by the Management Console. An ignored IP address will not be displayed in the Management Console servers tree. HeartbeatIgnoreIPs Values: a semi-colon separate list of IP addresses in the format x.x.x.
Server Setting Description Specifies if file and directory delete operations will be replicated to the target IgnoreDeleteOps Values: 0 Delete operations are replicated to the target, 1 Delete operations are not replicated to the target Default: 0 GUI Setting: Server Properties, Source tab, Replication, Ignore Delete Operations Identifies if Storage Mirroring Recover will use PPP (Pointto-Point Protocol) or SLIP (Serial Line Internet Protocol) adapters IgnorePPPAddresses Values: 0 Storage Mirroring Rec
Server Setting Description Specifies whether failures to write a file on the target are logged IgnoreWriteFailureOnTarget Values: 0 Log all write failures on the target, 1 or any larger integer indicates that number of write failures which will be ignored before starting to log the write failures Default: 0 GUI Setting: None Specifies whether the system volume information folder is mirrored and replicated IncludeSysVolInfo Values:0 Do not include the system volume information folder, 1 Include the syst
Server Setting Description Specifies whether or not to failover the IP addresses during failover IPFailover Values:0 Do not failover IP addresses 1 Failover IP addresses Default: 1 GUI Setting: Failover Control Center, Monitor Settings, Items to Failover, IP Address(es) Specifies the number of times an operation is retried if the driver return an error KFAIOpenRetry Values: any valid integer Default: 10 GUI Setting: None LanguagesAvailable Specifies the Storage Mirroring Recover language support that
Server Setting Description Specifies the functionality of the Storage Mirroring service LoadSourceTarget Values:0 Neither the source nor target modules are loaded, 1 Only the source module is loaded, 2 Only the target module is loaded, 3 Both the source and target modules are loaded Default: 3 GUI Setting: None This setting will not take effect until the Storage Mirroring service has been restarted.
Server Setting Description Indicates whether hard links are logged to replication_set_ name.log when the replication set size is calculated LogHardlinks Values: 0 Hard links are not logged, 1 Hard links are logged Default: 0 GUI Setting: None Specifies the types of messages logged to the.
Server Setting MaxLogPathname Description The maximum length of a file name (the entire volume\directory\filename including slashes, spaces, periods, extensions, and so on) that will be displayed in the Storage Mirroring Recover log file and the Windows Event Viewer. File names longer than the MaxDisplayablePath will be truncated and will be followed by an ellipsis (...). Values:1-32760 Default: 32760 GUI Setting: None Maximum number of .dtl log files that can exist at one time.
Server Setting Description Maximum merged op size (in bytes) used during replication MaxWriteChunkSize Values: 1 - 131072 Default: 65536 GUI Setting: None The path and file name to the Management Console online help file MCHelpPath Default: C:\Program Files\StorageWorks\Storage Mirroring\online help\mc\ wwhelp.htm GUI Setting: None Do not change this value or the online help will not work.
Server Setting Description The minimum file size, in bytes, that will be compressed. Files smaller than this size will not be compressed.
Server Setting Description Maximum number of mirror operations that can be queued on the source machine MirrorQueueLimit Values: 1 - 65535 Default: 1000 GUI Setting: Server Properties, Soruce tab, Mirror Queue, Maximum Pending Mirror Operations Specifies whether or not empty files, zero byte files, are included in a mirror Values: 0 Zero byte files are skipped and not mirrored to the target, 1 All files are mirrored to the target Default: 1 MirrorZeroKFiles GUI Setting: None If MirrorZeroKFiles is enab
Server Setting Description Specifies if orphaned files are deleted or moved to the directory specified by MoveOrphansDir MoveOrphanedFiles Values: 1 Move, 0 Delete Default: 0 GUI Setting: Connection/Restoration Manager, Orphans tab, Move/Delete Orphan Files Indicates the name of the directory where orphaned files will be moved if MoveOrphanedFiles=1 Values: any valid path MoveOrphansDir Default: the location where the Storage Mirroring Recover files were installed GUI Setting: Connection/Restoration Ma
Server Setting Description The maximum length of time, in seconds, to wait on a network connection. If data is not received over a network connection within the specified time limit, the connection is closed. During idle periods, Storage Mirroring Recover sends small amounts of keep-alive data at an interval 1/6 of the NetworkTimeout value to keep the socket from being inadvertently closed.
Server Setting Description Specifies the number of operations that can be stored in the memory queue prior to queuing to disk.
Server Setting Description Arguments to be used with the target post-failback script Values: Any valid argument PostFailbackScriptArgs Default: GUI Setting: Failover Control Center, Monitor Settings, Scripts, Target, Post-Failback, Arguments Location on the target where the target post-failover script is located PostFailoverScript Values: Any valid path Default: GUI Setting: Failover Control Center, Monitor Settings, Scripts, Target, Post-Failover Arguments to be used with the target post
Server Setting Description Specifies whether or not to wait for the target pre-failback script to complete before finishing a failback Values: 0 Do not wait, 1 Wait PreFailbackWait Default: 0 GUI Setting: Failover Control Center, Monitor Settings, Scripts, Target, Pre-Failback, Delay failback until script completes Location on the target where the target pre-failover script is located PreFailoverScript Values: Any valid path Default: GUI Setting: Failover Control Center, Monitor Settings, Script
Server Setting Description The priority level at which the Storage Mirroring service runs. Values: 3 Default: 3 GUI Setting: None PriorityClass The Storage Mirroring service runs at normal priority by default, which is adequate in most cases. However, there are some high-load situations where Storage Mirroring Recover needs a higher priority in order to move data through its queues and transmit the data to the target. One specific example is with bulk inserts to a SQL Server database.
Server Setting Description The location where the queue is stored. Values: any valid path Default: the location specified during the installation QJournalDir GUI Setting: Server Properties, Queue tab, Location, Folder For best results and reliability, you should select a dedicated, non-boot volume. The queue should be stored on a fixed, local NTFS volume. This location also stores the Storage Mirroring Recover driver pagefile. The size, in MB, of each queuing transaction log file.
Server Setting Description The maximum amount of disk space, in MB, in the specified QJournalDir that can be used for Storage Mirroring Recover queuing. When this limit is reached, Storage Mirroring Recover will automatically begin the auto-disconnect process.
Server Setting Description Disk Usage, Maximum system memory for queue Identifies if the Storage Mirroring service will reopen closed files on the quorum drive QueryOnQuorumFile Values: 0 The Storage Mirroring service will not attempt to reopen a closed file on the quroum drive to get security descriptors or last modified times, 1 The Storage Mirroring service will attempt to reopen a closed file on the quroum drive to get security descriptors or last modified times.
Server Setting Description Specifies the amount of time, in minutes, that must be expired before an orphan file is removed Values: 1 - 131072 RemoveOrphansTime Default: 60 GUI Setting: Connection/Restoration Manager, Orphans tab, Remove Orphans not modified within the following time period RemoveSharesOnDisconnect Specifies if shares are removed on the target machine when a Storage Mirroring Recover replication set is disconnected from a target or a source machine is manually shutdown by the administra
Server Setting Description Specifies the script to run if validation of the replication drive fails ReplicationDiskCheckScript Values: Any valid path and script file Default: GUI Setting: None Specifies the interval, in seconds, between validation checks when ReplicationDiskCheckSript is populated ReplicationDiskCheckTimeOut Values: any integer Default: 300 Name of the database that contains replication set information RepSetDBName Values: any valid file name Default: DblTake.
Server Setting RunScriptAtSnaptime Description If a script is specified, the script is launched on the target before Storage Mirroring Recover executes any snapshots. The snapshot will not be executed until the script has completed. If the script returns an error, the snapshot will still execute.
Server Setting Description The number of seconds to wait before checking the transmission schedules to see if transmission should be started or stopped ScheduleInterval Values: 1 - 3600 Default: 1 GUI Setting: None Specifies if the last modified time for directories will be transmitted to the target during a difference mirror SendDirLastModifiedTime Values: 0 last modified time on directories will not be sent to the target, 1 last modified time on directories will be sent to the target Default: 1 GUI S
Server Setting Description Specifies whether a file is accessed twice so that the file’s creation time can be modified to match the source Values: 0 The Storage Mirroring service will not access newly created files that have not been modified. These files on the target will have the date and time of when the file was created on the target, 1 The Storage Mirroring service will access newly created files. These files on the target will have the same date and time as the source.
Server Setting Description Specifies that the last modified time attribute is sent when a file is closed SendLastModifiedTimeOnClose Values: 0 Last modified time is sent when Storage Mirroring Recover has not received any additional operations for the file in the time period specified by LastModifiedReadDelay, 1 Last modified time is sent when a file is closed, which may not be immediately depending on system processing Default: 1 GUI Setting: None If system processing delays (such as the system cache ma
Server Setting Description Specifies how often, in minutes, the registry is scanned for short file names for use in full-server failover ShortFileNameScanIntervalMinutes Values: any valid integer Default: 240 GUI Setting: None Specifies the amount of time, in minutes, to wait for the source to shutdown during failover when protecting a fullserver workload ShutdownRebootTimeoutMinutes Values: any valid integer Default: 5 GUI Setting: None The amount of time, in seconds, for the service to wait prior to co
Server Setting Description Specifies the type of snapshot that Storage Mirroring Recover takes SnapshotType Values: 0 Create a client-accessible snapshot based on the type of connection established, 1 Always create a client-accessible snapshot, 2 Always create a non-clientaccessible snapshot Default: 0 GUI Setting: None The number of files to compare during a source newer difference mirror SourceNewerMaxFileCount Values: 1-1000 Default: 16 GUI Setting: None SourceNewerTimeDiff The number of milliseco
Server Setting Description Arguments to be used with the source post-failback script Values: Any valid argument SourcePostFailbackScriptArgs Default: GUI Setting: Failover Control Center, Monitor Settings, Scripts, Source, Post-Failback, Arguments SSMKeepTargetActivationCode Specifies if the activation code on the target is replaced or maintained after a full-serer failover. Do not modify this entry.
Server Setting Description Specifies if Storage Mirroring Recover logs statistics at startup StatsLoggingOn Values: 0 Stats logging does not start when Storage Mirroring Recover starts, 1 Stats logging starts when Storage Mirroring Recover starts Default: 0 GUI Setting: Server Properties, Setup tab, Setup Options, Log Statistics Automatically Maximum size, in MB, for the statistic.
Server Setting TargetPausedVirtual Description Internal setting that indicates which target machines are paused. Do not modify this setting. Size of the TCP/IP buffer in bytes. Values: 4096-7500000 Default: 375000 GUI Setting: None TCPBufferSize The default setting creates a TCP window that will accommodate most environments. In most environments, this value will not need to be adjusted.
Server Setting Description Blocks the target path for all connections, regardless of the source, so that the data cannot be modified Values: 0 Target paths are not blocked, 1 Target paths are blocked TGBlockOnConnect Default: 0 GUI Setting: None Do not modify this setting without assistance from Technical Support.
Server Setting Description GUI Setting: None TGExecutionRetryLimit The number of times an unfinished operation will be retried on the target before it is discarded. If this value is set to zero (0), an operation will never be discarded and will be retried on the target until it is applied.
Server Setting Description Minimum percentage of system memory that can contain mirror data before the target signals the source to resume the sending of mirror operations. Values: 1-75 TGMirrorCapacityLow Default: 15 GUI Setting: Server Properties, Target tab, Files, Target Mirror Capacity Low Percentage The maximum value forTGMirrorCapacityLow is either 75 or TGMirrorCapacityHigh, which ever is lower.
Server Setting TGThreadCount Description This setting is no longer used Specifies whether or not unfinished operations on the target are logged to the Event Viewer TGUnfinishedOpEvent Values: 0 Unfinished operation messages are not logged, 1 Unfinished operation messages are logged Default: 1 Specifies whether or not Storage Mirroring Recover uses the intermediate cache TGWriteCache Values: 0 Bypass the intermediate cache and write directly to disk, 1 Do not bypass the intermediate cache Default: 1 GUI
Server Setting Description Interval, in seconds, at which the Failover Control Center updates the monitored machines display UpdateInterval Values: 1 - 9999 Default: 1 GUI Setting: Failover Control Center, Settings, Refresh Rate UpgradeCode Used by the Storage Mirroring Recover installation program to maintain the installation settings for an upgrade Specifies if the Windows NTFS change journal is used to track file changes.
Server Setting Description Specifies whether or not user intervention is required to initiate a failover UserIntervention Values: 0 User intervention is not required, 1 User intervention is required Default: 1 GUI Setting: Failover Control Center, Monitor Settings, Manual Intervention UseScheduledPause Used by Storage Mirroring Recover for internal schedule processing. Do not modify this setting.
Server Setting Description Name of the verification log file Values: any valid file name VerifyLogName Default: DTVerify.log GUI Setting: Server Properties, Logging tab, Verification, Filename The time, in minutes, between when one verification fails and a retry is scheduled to begin. VerifyRetryInterval Values: any valid number Default: 3 GUI Setting: None The number of time a verification will be retried.
Scripting examples Below are links to sample Storage Mirroring Recover scripts. Most of the sample scripts must be modified. They cannot be used as-is. Modify them to fit your environment. If you need basic assistance with script modifications, contact Technical Support. Assistance with advanced scripting will be referred to Professional Services.
Creating and connecting a replication set The following script will start a Storage Mirroring Recover connection by creating a replication set called DataFiles on the source alpha and connecting it to the target beta.
Creating and connecting a replication set with failover monitoring The following script will start a Storage Mirroring Recover connection by creating a replication set called DataFiles on the source alpha and connecting it to the target beta. This script will also configure and start failover monitoring.
Restoring a replication set The following script will restore the data in the DataFiles replication set from the target machine beta to the original source machine.
Using variables to create and connect a replication set and run verification The following script uses variables to identify the source, target, and replication set. These variables are then used in the scripting commands. The $connectionID variable will contain the connection ID for the connection established. This variable can then be used to establish a verification schedule.
Controlling a mirror using flow control The following script uses the IF conditional, FOR loop, and WHILE loop commands. In the following examples the FOR loop will start a mirror for all connections between 1 and 10. The IF conditional will return the error command "mirror failed to start" if a value of 0 is not obtained. The WHILE loop will wait for a mirror to end and disconnect as long as the returned value is less than 10.
Using variables to pause a target The following script uses variables to identify the target and credentials to login to that target. These variables are then used in the scripting commands to pause the target. $TheTarget = "beta"; $TheUser = "admin"; $ThePassword = "password"; $TheDomain = "domain.
Using variables to resume a target The following script uses variables to identify the target and credentials to login to that target. These variables are then used in the scripting commands to resume the target. $TheTarget = "beta"; $TheUser = "admin"; $ThePassword = "password"; $TheDomain = "domain.
Creating a backup or snapshot of the target by inserting a task command during replication The following script stops the services on the source, pauses the script to allow the source time to write the remaining application data to disk, inserts a Storage Mirroring Recover task command into the Storage Mirroring Recover replication process, and then restarts the services. REM REM net net net net Stop the services on the source so that data changes are stopped.
REM REM REM REM net net net net with Storage Mirroring Recover replication, the services can be restarted. New changes to the data will fall inline behind the task command just inserted.
Creating a backup of the target by rotating connections The following two scripts create multiple copies of your data on the target, but only one copy is active at a time. This allows you the time and availability to backup the inactive copy of data. This is especially helpful when you have applications with interdependent files. Backups occur sequentially from the first file to the last file.
$TheDomain = "domain.
Scripting commands Each scripting command includes the following. ● Command name ● Description of the command ● Exact syntax for using the command ● Options, if any ● Examples, if necessary ● Notes, if any For details on the conventions used for the command syntax, see Command syntax conventions.
● Email Test ● Environment ● Exit ● Failback ● Failover ● Get ● GetEnvStr ● Get Local ● Help ● Limit Bandwidth ● Limit Bandwidth Disable ● Limit Bandwidth Schedule Add ● Limit Bandwidth Schedule Clear ● Limit Bandwidth Schedule Enable ● Limit Bandwidth Schedule List ● Limit Bandwidth Schedule Remove ● Load Source ● Load System State ● Load Target ● Login ● Logout ● Mirror Pause ● Mirror Resume ● Mirror Start ● Mirror Stop ● Monitor Account Add ● Monitor A
● Monitor Remove ● Monitor Script Add ● Monitor Script Remove ● Monitor Start ● Monitor Stop ● Monitor Use ● NIC List ● Orphans Disable ● Orphans Enable ● Orphans Start ● Orphans Stop ● Pause Target ● Ping ● Queue Task ● Quit ● Recall Pause ● Recall Resume ● Recall Start ● Recall Stop ● Replication Start ● Replication Stop ● Repset Calculate ● Repset Create ● Repset Delete ● Repset Display ● Repset List ● Repset Resync ● Repset Rule Add ● Repset Rule
● Schedule Enable ● Schedule End ● Schedule Start ● Schedule Window ● Script Account ● Script Add ● Script List ● Script Remove ● Script Test ● Set ● Set Local ● Shutdown ● Snapshot Create ● Snapshot Delete ● Snapshot List ● Snapshot Revert ● Snapshot Schedule Disable ● Snapshot Schedule Display ● Snapshot Schedule Enable ● Snapshot Schedule Every ● Source ● StatsLog Start ● StatsLog Status ● StatsLog Stop ● Status ● Target ● Test Connections ● Time Now
● Unload Target ● Verify ● Version ● Wait ● Wait on Mirror ● Wait on Restore ● Wait on Target ● Write 184 of 332
Archive Pause Command ARCHIVE PAUSE Description Pauses the archive process Syntax ARCHIVE PAUSE Options con_id—Connection ID assigned to the source/target connection Examples archive pause 1 185 of 332
Archive Resume Command ARCHIVE RESUME Description Resumes the archive process Syntax ARCHIVE RESUME Options con_id—Connection ID assigned to the source/target connection Examples archive resume 1 186 of 332
Archive Start Command ARCHIVE START Description Starts the archive process Syntax ARCHIVE START FILEAGE FILESIZE ● ● Options ● Examples con_id—Connection ID assigned to the source/target connection number_days—Any number indicating the age, in days, of the files that you want archived. Any file older than the days specified will be archived. size—Any number indicating the size, in KB, of the files that you want archived.
Archive Stop Command ARCHIVE STOP Description Stops the archive process Syntax ARCHIVE STOP Options con_id—Connection ID assigned to the source/target connection Examples archive stop 1 188 of 332
Block All Command BLOCK ALL Allows you to block writing to the data located in the replication set target paths. You can block all of the paths for every connection to Description that target or only those paths associated with a particular connection. This keeps the data from being changed outside of Storage Mirroring Recover processing.
Compression Disable Command COMPRESSION DISABLE Description Disables compression Syntax COMPRESSion DISABLE Options con_id—Connection ID assigned to the source/target connection Examples compression disable 1 190 of 332
Compression Enable Command COMPRESSION ENABLE Description Enables compression Syntax COMPRESSion ENABLE Options con_id—Connection ID assigned to the source/target connection Examples compression enable 1 191 of 332
Compression List Command COMPRESSION LIST Description Identifies the compression level set and if compression is enabled Syntax COMPRESSion LIST 192 of 332
Compression Set Command COMPRESSION SET Description Sets the compression level Syntax COMPRESSion SET ● Options ● con_id—Connection ID assigned to the source/target connection level—Any whole number from 1 to 3 where 1 is minimum compression and 3 is maximum compression Examples compression set 1 2 Notes This command only sets the level of compression. It does not initiate compression.
ConID Command CONID ● Description ● Syntax =CONID TO ● CONID LIST [source] ● Options ● variable—Name of the variable that you want to use to store the connection ID repset—Replication set that was used to establish the connection target—Name of the target, an IP address on the target, or a virtual IP address ● source—Name of the source ● $con_id=conid DataFiles to beta ● $ConnectionNumber=conid UserData to beta ● conid list alpha conid list alpha ● Notes Lists
Connect Command CONNECT Description Establishes a connection between a replication set and a target machine Syntax CONnect TO MAP EXACT | MAP BASE < target_path> | MAP TO [,...
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, autoremirror, 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.
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.
Connect TDU Command CONNECT TDU Establishes a simulation connection between a replication set and the Throughput Diagnostics Utility. This connection imitate a Description normal connection without transmitting any data across the network.
Disconnect Command DISCONNECT Description Disconnects a specified source/target connection for the currently selected source Syntax DISCONnect ● Options Examples con_id—Connection ID assigned to the source/target connection ● *—Specifies all connection IDs ● disconnect 1 ● disconnect * 199 of 332
Email Add Command EMAIL ADD Description Adds an e-mail address to the e-mail notification distribution list Syntax EMAIL ADD Options email_address—A valid e-mail address enclosed in quotation marks Examples email add "administrator@domain.com" ● Notes ● You can repeat this command to add additional addresses to the distribution list. You must have an active source specified for any e-mail command to work properly.
Email Disable Command EMAIL DISABLE Description Disables e-mail notification Syntax EMAIL DISABLE Options You must have an active source specified for any e-mail command to work properly.
Email Enable Command EMAIL ENABLE Description Enables e-mail notification Syntax EMAIL ENABLE Options You must have an active source specified for any email command to work properly.
Email Filter Command EMAIL FILTER Description Displays the filter configuration from the email setfilterinclude command Syntax EMAIL FILTER Options You must have an active source specified for any e-mail command to work properly.
Email From Address Command EMAIL FROMADDRESS Description Specifies the e-mail address that will appear in the From field of Storage Mirroring Recover generated e-mail messages Syntax EMAIL FROMADDRESS Options email_address—A valid e-mail address enclosed in quotation marks Examples email fromaddress "administrator@domain.com" Notes You must have an active source specified for any e-mail command to work properly.
Email Get Email Config Command EMAIL GET EMAILCONFIG Description Displays e-mail notification configuration information Syntax EMAIL GET EMAILCONFIG Notes You must have an active source specified for any e-mail command to work properly.
Email Mail Server Command EMAIL MAILSERVER Description Specifies the name of the SMTP mail server for e-mail notification Syntax Options EMAIL MAILSERVER [username][ password] ● server_name—Name of the SMTP mail server ● ip_address—IP address of the SMTP mail server ● username—User ID required for SMTP server authentication ● Examples password—Password associated with the specified user name email mailserver xchng administrator ******* ● Notes ● ● Your SMTP server
Email Remove Command EMAIL REMOVE Description Removes an e-mail address from the e-mail notification distribution list Syntax EMAIL REMOVE Options email_address—An e-mail address, listed in the current distribution list, enclosed in quotation marks Examples email remove "administrator@domain.com" Notes You must have an active source specified for any e-mail command to work properly.
Email Set Filter Include Command EMAIL SETFILTERINCLUDE Description Specifies which Event Viewer messages are sent via e-mail Syntax Options EMAIL SETFILTERINCLUDE [INFO, WARNING, ERROR] [EXCLUDEIDS ""] ● INFO—Information messages will be sent via e-mail ● WARNING—Warning messages will be sent via e-mail ● ERROR—Error messages will be sent via e-mail ● ● Examples ● ● ● ● Notes ● ● EXCLUDEIDS ID1,ID2-ID4,...—A comma separated list of IDs or ID ranges.
Email Subject Command EMAIL SUBJECT Description Specifies if additional text will be displayed in the subject of the email message Syntax EMAIL SUBJECT [PREFIX | NOPREFIX] [DESCRIPTION | NODESCRIPTION] ● ● Options ● ● ● Examples ● ● Notes ● ● PREFIX prefix—Text which will be inserted at the front of the subject line for each Storage Mirroring Recover generated email message. This will help distinguish the Storage Mirroring Recover messages from other messages.
Email Test Command EMAIL TEST Description Sends a test message to demonstrate e-mail notification Syntax EMAIL TEST [SENDTO ] [TEXT ] ● Options ● ● Examples ● ● Notes ● email_address—Specifies the e-mail address(es) to send the test message to if you do not want to use the e-mail addresses configured with the EMAIL ADD command. This is a comma separated list of addresses. The entire list should be enclosed in quotation marks.
Environment Command ENVIRONMENT Displays a list of all Storage Mirroring Recover machines available to the specified machine. Each machine is identified by machine Description name, IP addresses and whether or not the source and/or target modules are loaded. If no machine is specified, the information is provided for the machine currently specified as the source.
Exit Command EXIT Description Exits the Command Line Interactive client Syntax EXIT 212 of 332
Failback Command FAILBACK Description Initiates the failback process for the specified monitor machine Syntax FAILBACK [ON ] REMONITOR|NOREMONITOR ● ● Options ● ● monitor—Name of the source machine designated as the monitor target—Name of the target, an IP address on the target, or a virtual IP address REMONITOR—Automatically continues monitoring the source machine after failback NOREMONITOR—Automatically discontinues monitoring the source machine after failback.
Failover Command FAILOVER Description Manually initiates the failover process for the specified monitor machine Syntax FAILOVER [ON ] [APPLY | DISCARD | REVERT] ● ● Options ● ● ● monitor—Name of the source machine designated as the monitor target—Name of the target, an IP address on the target, or a virtual IP address APPLY—Apply the data that is in the target queue before beginning failover DISCARD—Discard the data that is in the target queue and begin failover immediately REVE
Get Command GET Description Requests the value of a Storage Mirroring Recover program setting from the specified server Syntax GET [machine] ● Options Examples setting—See Server settings for a complete list of the Storage Mirroring Recover program settings ● machine—Name of the machine ● get netport ● get VerifyLogName ● get DefaultAddress ● Notes ● If you do not specify a machine name, the value from the current source will be returned.
GetEnvStr Command GETENVSTR Description Retrieves an operating system environment variable and stores the value in a Storage Mirroring Recover variable Syntax GETENVSTR $ ● Options ● env_variable—Name of the operating system environment variable that you want to store in the user defined variable variable_name—Name of the variable you want to create. This variable will store the operating system environment variable specified.
Get Local Command GETLOCAL Description Requests the value of a Storage Mirroring Recover program setting from the local machine Syntax GETLOCAL Options setting—See Server settings for a complete list of the Storage Mirroring Recover program settings Examples ● getlocal netport ● getlocal VerifyLogName ● getlocal DefaultAddress 217 of 332
Help Command HELP Description Displays the DTCL commands and their syntax Syntax Notes HELP ● Press any key to scroll through the list of commands. ● Press q to exit the help function. ● You can also type dtcl help from the directory where the Storage Mirroring Recover program files are installed to display the DTCL commands and their syntax.
Limit Bandwidth Command LIMIT BANDWIDTH Description Sets a fixed bandwidth limitation for transmitting data from the source to the target Syntax LIMIT BANDWIDTH , TO ● ● Options Examples ● bytes—Number of bytes to be transmitted seconds—Maximum number of seconds to wait before transmitting again target—Name of the target, an IP address on the target, or a virtual IP address.
Limit Bandwidth Disable Command LIMIT BANDWIDTH DISABLE Description Disables a bandwidth schedule without losing the schedule settings Syntax LIMIT BANDWIDTH DISABLE ON Options target—Name of the target, an IP address on the target, or a virtual IP address. Depending on the network route Storage Mirroring Recover uses to access the target, you may need to specify the fully qualified domain name.
Limit Bandwidth Schedule Add Command LIMIT BANDWIDTH SCHEDULE ADD Description Creates a scheduled bandwidth event for limiting transmission of data from the source to the target Syntax LIMIT BANDWIDTH SCHEDULE ADD
Limit Bandwidth Schedule Clear Command LIMIT BANDWIDTH SCHEDULE CLEAR Description Clears a bandwidth schedule Syntax LIMIT BANDWIDTH SCHEDULE CLEAR Options target—Name of the target, an IP address on the target, or a virtual IP address. Depending on the network route Storage Mirroring Recover uses to access the target, you may need to specify the fully qualified domain name.
Limit Bandwidth Schedule Enable Command LIMIT BANDWIDTH SCHEDULE ENABLE Description Enables a bandwidth schedule Syntax LIMIT BANDWIDTH SCHEDULE ENABLE ON Options target—Name of the target, an IP address on the target, or a virtual IP address. Depending on the network route Storage Mirroring Recover uses to access the target, you may need to specify the fully qualified domain name.
Limit Bandwidth Schedule List Command LIMIT BANDWIDTH SCHEDULE LIST Description Displays the bandwidth schedule for a target Syntax LIMIT BANDWIDTH SCHEDULE LIST Options target—Name of the target, an IP address on the target, or a virtual IP address. Depending on the network route Storage Mirroring Recover uses to access the target, you may need to specify the fully qualified domain name.
Limit Bandwidth Schedule Remove Command LIMIT BANDWIDTH SCHEDULE REMOVE Description Removes a scheduled bandwidth event Syntax LIMIT BANDWIDTH SCHEDULE REMOVE
Load Source Command LOAD SOURCE Description Loads the Storage Mirroring Recover source module Syntax LOAD SOURCE Options machine—Name of the machine Examples load source alpha Notes Machine names that contain non-alphanumeric characters should be enclosed in quotation marks.
Load System State Command LOAD SYSTEMSTATE Description Loads the Storage Mirroring Recover system state module Syntax LOAD SYSTEMSTATE Options machine—Name of the machine Examples load systemstate beta Notes Machine names that contain non-alphanumeric characters should be enclosed in quotation marks.
Load Target Command LOAD TARGET Description Loads the Storage Mirroring Recover target module Syntax LOAD TARGET Options machine—Name of the machine Examples load target beta Notes Machine names that contain non-alphanumeric characters should be enclosed in quotation marks.
Login Command LOGIN Description Log on to a Storage Mirroring Recover machine Syntax LOGIN [domain] ● ● Options ● ● Examples machine—Name of the machine username—Name of the user. The username is limited to 100 characters. password—Password associated with the user name. The password is limited to 100 characters. domain—If logging in using a domain account, this is the domain name. If logging in using a local account, this is the machine name.
Logout Command LOGOUT Description Logs off of a Storage Mirroring Recover machine Syntax LOGOUT Options machine—Name of the machine Examples logout alpha Notes Machine names that contain non-alphanumeric characters must be enclosed in quotation marks.
Mirror Pause Command MIRROR PAUSE Description Pauses a mirror that is in progress Syntax MIRror PAUSE ● Options Examples con_id—Connection ID assigned to the source/target connection ● *—Specifies all connection IDs ● mirror pause 1 ● mir pause * 231 of 332
Mirror Resume Command MIRROR RESUME Description Resumes a paused mirror Syntax MIRror RESUME ● Options Examples con_id—Connection ID assigned to the source/target connection ● *—Specifies all connection IDs ● mirror resume 1 ● mir resume * 232 of 332
Mirror Start Command MIRROR START Description Initiates the mirror process Syntax MIRror START [DIFFERENT [,NEWER] ,CHECKSUM | NOCHECKSUM] [ORPHANS |NOORPHANS] [CALCulate | NOCALCulate] [CLEARRESTOREREQUIRED] ● ● ● ● ● Options ● ● ● ● ● Examples Notes con_id—Connection ID assigned to the source/target connection DIFFERENT—Mirrors only those files that are different based on the file date, time, and/or size NEWER—Mirrors only those files that are newer on the source than on the target C
Mirror Stop Command MIRROR STOP Description Stops a mirror Syntax MIRror STOP ● Options Examples con_id—Connection ID assigned to the source/target connection ● *—Specifies all connection IDs ● mirror stop 1 ● mir stop * 234 of 332
Monitor Account Add Command MONITOR ACCOUNT ADD Description Identifies a user account with update permissions within Active Directory Syntax MONitor ACCOUNT ADD [monitor] ● Options ● ● Examples username—Name of the user in the format domain\user or user@domain. Since the format requires non-alphanumeric characters, enclose the name in quotation marks.
Monitor Account Remove Command MONITOR ACCOUNT REMOVE Description Removes the user account used to failover Active Directory Syntax MONitor ACCOUNT REMove Options monitor—Name of the source machine designated as the monitor Examples ● monitor account remove alpha ● mon account rem alpha ● Notes ● If you do not specify a monitor, the current source designated as the monitor will be used.
Monitor Clear Command MONITOR CLEAR Description Clears all of the failover configuration and monitoring parameters for the specified monitor machine Syntax MONitor CLEAR [monitor] Options monitor—Name of the source machine designated as the monitor Examples ● monitor clear alpha ● mon clear alpha ● Notes ● If you have not identified a monitor, you will receive an error message stating that a monitor has not been selected.
Monitor Create Command MONITOR CREATE Description Establishes a source as a failover monitor. This is the machine that will be monitored by a target in case it should experience a failure. Syntax MONitor CREATE Options source—Name of the source Examples Notes ● monitor create alpha ● mon create alpha Machine names that contain non-alphanumeric characters must be enclosed in quotation marks.
Monitor Delete Command MONITOR DELETE Description Deletes the specified failover monitor and all of its parameters Syntax MONitor DELete Options monitor—Name of the source machine designated as the monitor Examples ● monitor delete alpha ● mon del alpha ● Notes ● In order to successfully delete a monitor, the monitor must not be running on the server. Use the monitor stop command to ensure the monitor is not running.
Monitor Display Command MONITOR DISPLAY Description Displays the monitoring and failover configuration settings for the specified monitor machine Syntax MONitor DISPlay Options monitor—Name of the source machine designated as the monitor Examples ● monitor display alpha ● mon disp alpha ● Notes ● ● If you do not specify a monitor, the current source designated as the monitor will be used.
Monitor Get Command MONITOR GET Description Identifies a machine as the active monitor machine Syntax MONitor GET Options target—Name of the target, an IP address on the target, or a virtual IP address Examples Notes ● monitor get beta ● mon get beta Monitor names that contain non-alphanumeric characters must be enclosed in quotation marks.
Monitor List Command MONITOR LIST Description Displays a list of all failover monitor machines Syntax Examples Notes MONitor LIST ● monitor list ● mon list You must use the monitor get command to specify an active monitor before using monitor list.
Monitor Move Command MONITOR MOVE Description Designates the IP address that will be failed over to the specified target NIC Syntax MONitor MOVE TO NIC USE NONE | NETWORK INTERVAL TIMEOUT | SERVICE INTERVAL TIMEOUT | [monitor] ● ● ● ● ● Options ● ● ● ● ● Examples IP_address—The IP address which should be moved during failover target_NIC—The integer value of the target NIC obtained from the niclist command NONE—Does
● Notes ● ● If you do not specify a monitor, the current source designated as the monitor will be used. If you have not identified a monitor, you will receive an error message stating that a monitor has not been selected. If you choose to use the service option, your source and target must be using the same Storage Mirroring Recover port settings. If you choose to use the network option, the port settings can be different.
Monitor Option Command MONITOR OPTION Description Configures the settings to determine how failover will be performed Syntax MONitor OPTION [MOVENAME | NOMOVENAME] [, MOVEADDRESSES | NOMOVEADDRESSES] [, MOVESHARES | NOMOVESHARES] [, ADD | REPLACE] [, USESHAREFILE | NOUSESHAREFILE][, FAILONE | FAILALL] [, FODELAY | NOFODELAY] [, FBDELAY | NOFBDELAY] [, APPLY | DISCARD | REVERT] [, INTERVENTION | NOINTERVENTION] [, FOHOSTNAME | NOFOHOSTNAME] [, FBHOSTNAME | NOFBHOSTNAME] [monitor] 245 of 332
● ● ● ● ● ● ● ● ● ● ● Options ● ● ● ● ● ● ● ● MOVENAME—Moves the server name during failover NOMOVENAME—Does not move the server name during failover MOVEADDRESSES—Moves the IP address(es) during failover NOMOVEADDRESSES—Does not move the IP address(es) during failover MOVESHARES—Moves the shares during failover NOMOVESHARES—Does not move the shares during failover ADD—Specifies the source machine’s identity is added to the target machine’s identity when failover occurs REPLACE—Specifies th
last known good Storage Mirroring Recover state ● ● ● ● ● ● ● INTERVENTION—Specifies that network administrator intervention is required before failover begins NOINTERVENTION—Specifies that network administrator intervention is not required before failover begins FOHOSTNAME—Removes the host SPN from Active Directory on the source and adds it to Active Directory on the target during failover NOFOHOSTNAME—Does not modify Active Directory on the source or target during failover FBHOSTNAME—Returns the ho
Examples ● monitor option alpha ● mon option alpha ● ● ● Notes ● monitor option nomoveshares, nousesharefile, failone, nointervention The default settings are movename, moveaddress, moveshares, add, usesharefile, failall, fodelay, fbdelay, apply, intervention, nofohostname, and nofbhostname. The options 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.
Monitor Remove Command MONITOR REMOVE Description Removes an IP address that is currently being monitored Syntax MONitor REMove [monitor] ● Options ● Examples IP_address—The currently monitored IP address that should be removed monitor—Name of the source machine designated as the monitor ● monitor remove 205.31.2.57 alpha ● mon rem 205.31.2.68 ● Notes ● If you do not specify a monitor, the current source designated as the monitor will be used.
Monitor Script Add Command MONITOR SCRIPT ADD Description Specifies the scripts that should be run during the failover and failback processes Syntax MONitor SCRIPT ADD [ARGS=< arguments>] [monitor] ● type—Any of the following script types ● ● ● ● Options ● ● ● ● ● Examples ● ● Notes ● PREFAILOVER—The file is a pre-failover script to be run on the target before failover POSTFAILOVER—The file is a post-failover script to be run on the target after failover PREFAILBACK—Th
Monitor Script Remove Command MONITOR SCRIPT REMOVE Description Specifies the scripts that should not be run during the failover and failback processes Syntax MONitor SCRIPT REMove [monitor] ● type—Any of the following script types ● ● ● Options ● ● ● Examples PREFAILOVER—The file is a pre-failover script to be run on the target before failover POSTFAILOVER—The file is a post-failover script to be run on the target after failover PREFAILBACK—The file is a pre-failback script to be run on
Monitor Start Command MONITOR START Description Initiates failover monitoring Syntax MONitor START [ON ] ● Options ● Examples Notes monitor—Name of the source machine designated as the monitor target—Name of the target, an IP address on the target, or a virtual IP address ● monitor start alpha on beta ● mon start alpha Option names that contain non-alphanumeric characters must be enclosed in quotation marks.
Monitor Stop Command MONITOR STOP Description Stops monitoring the source machine for failure Syntax MONitor STOP [ON ] ● Options ● Examples Notes monitor—Name of the source machine designated as the monitor target—Name of the target, an IP address on the target, or a virtual IP address ● monitor stop alpha on beta ● mon stop alpha Option names that contain non-alphanumeric characters must be enclosed in quotation marks.
Monitor Use Command MONITOR USE Description Specifies the source machine designated as the monitor that will be used in subsequent monitor commands Syntax MONitor USE Options Examples Notes monitor—Name of the source machine designated as the monitor . ● monitor use alpha ● mon use alpha Monitor names that contain non-alphanumeric characters must be enclosed in quotation marks.
NIC List Command NICLIST Displays the NICs available on the specified target machine. Each Description NIC is assigned an integer value and this value is used in the monitor move command. Syntax NICLIST [target] Options target—Name of the target, an IP address on the target, or a virtual IP address Examples niclist beta ● Notes ● ● If you do not specify a machine name, the value from the current target will be returned. If you have not identified a target, no data will be returned.
Orphans Disable Command ORPHANS DISABLE Description Disables orphan file removal during subsequent mirror or verification processes.
Orphans Enable Command ORPHANS ENABLE Description Enables orphan file removal during subsequent mirror or verification processes.
Orphans Start Command ORPHANS START Description Manual operation to remove any orphan files on the target Syntax ORPHANS START con_id [CLEARRESTOREREQUIRED] ● Options ● Examples con_id—Connection ID assigned to the source/target connection CLEARRESTOREREQUIRED—Clears the restore required flag and initiates the orphan operation orphans start 1 258 of 332
Orphans Stop Command ORPHANS STOP Description Stops the process to remove orphan files on the target Syntax ORPHANS STOP con_id Options con_id—Connection ID assigned to the source/target connection Examples orphans stop 1 259 of 332
Pause Target Command PAUSE TARGET Description Allows you to pause the execution of Storage Mirroring Recover operations on the target Syntax PAUSETARGET [FROM ] ● Options ● Examples source—Name of the source pausetarget beta ● Notes target—Name of the target, an IP address on the target, or a virtual IP address ● ● You must be logged on to the target machine for this command to work.
Ping Command PING Description Checks a specified machine to see if Storage Mirroring Recover is running Syntax PING Options machine—Name of the machine Examples ping alpha Notes Machine names that contain non-alphanumeric characters must be enclosed in quotation marks.
Queue Task Command QUEUETASK Description Queues tasks inline with replication data Syntax QueueTASK TO ONQueue = [args] | ONTRANSmit = [args] | ONRECeive = [args] | ONEXECute = [args] [TIMEOUT = ] [INTERACT | NOINTERACT] ● ● ● ● Options ● ● ● ● job_name—Unique job name assigned to this task. This will be the identifier you see in the log files. target—Name of the target, an IP address on the target, or a virtual IP address.
● ● ● TIMEOUT timeout—Valid number followed by an optional time indicator indicating the length of time ot pause while waiting for the task to complete. The valid time indicators include seconds, minutes, hours, and days. If you do not specify a time indicator, it will default to seconds. The number zero (0) indicates there is no timeout delay and the next operation is immediately processed. The keyword FOREVER indicates that the next operation is not processed until the task has completed execution.
● Examples ● ● ● ● ● ● Notes ● ● ● ● ● queuetask backup to beta onreceive=PauseAndBackup.bat onexecute=Resume.bat qtask backup to beta onrec=PauseAndBackup.bat onexec=resume.bat The default setting for this command is nointeract. Any combination of one or more execution points can be used with the same queuetask command. All script processing messages, including errors, can be viewed in the Storage Mirroring Recover logs and the Windows Event Viewer.
Quit Command QUIT Description Quits the Command Line Interactive client Syntax QUIT 265 of 332
Recall Pause Command RECALL PAUSE Description Pauses the process to recall all archived files from the target Syntax RECALL PAUSE Options con_id—Connection ID assigned to the source/target connection Examples recall pause 1 266 of 332
Recall Resume Command RECALL RESUME Description Resumes the process to recall all archived files from the target Syntax RECALL RESUME Options con_id—Connection ID assigned to the source/target connection Examples recall resume 1 267 of 332
Recall Start Command RECALL START Description Starts the process to recall all archived files from the target Syntax RECALL START Options con_id—Connection ID assigned to the source/target connection Examples recall start 1 268 of 332
Recall Stop Command RECALL STOP Description Stops the process to recall all archived files from the target Syntax RECALL STOP Options con_id—Connection ID assigned to the source/target connection Examples recall stop 1 269 of 332
Replication Start Command REPLICATION START Description Initiates the replication process Syntax REPlication START [CLEARRESTOREREQUIRED] ● Options ● ● Examples conid—Connection ID assigned to the source/target connection *—Specifies all connection IDs CLEARRESTOREREQUIRED—Clears the restore required flag and initiates replication ● replication start 1 ● rep start * 270 of 332
Replication Stop Command REPLICATION STOP Description Stops the replication process Syntax REPLlication STOP ● Options Examples conid—Connection ID assigned to the source/target connection ● *—Specifies all connection IDs ● replication stop 1 ● rep stop * 271 of 332
Repset Calculate Command REPSET CALCULATE Description Calculates the size of a replication set Syntax REPSET CALCulate [repset] Options repset—Name of the replication set Examples ● repset calculate DataFiles ● repset calc DataFiles ● Notes ● ● If a replication set name is not specified, the active replication set will be used. The results of the calculation are logged to the Storage Mirroring Recover log file.
Repset Create Command REPSET CREATE Description Creates a replication set Syntax REPSET CREATE Options name—Name of the replication set Examples repset create DataFiles ● Notes ● The name of the replication set should not be a Storage Mirroring Recover keyword. These are any DTCL command (source, target, and so on.) or any DTCL shortcut command (env, mon, rep, and so on). Replication set names that contain non-alphanumeric characters must be enclosed in quotation marks.
Repset Delete Command REPSET DELETE Description Deletes the specified replication set Syntax REPSET DELete Options repset—Name of the replication set repset Examples Notes ● repset delete DataFiles ● repset del DataFiles Replication set names that contain non-alphanumeric characters must be enclosed in quotation marks.
Repset Display Command REPSET DISPLAY Description Displays the replication set rules Syntax REPSET DISPlay [repset] Options repset—Name of the replication set Examples ● repset display DataFiles ● repset disp DataFiles ● Notes ● If you do not specify a replication set name, the current replication set will be used. Replication set names that contain non-alphanumeric characters must be enclosed in quotation marks.
Repset List Command REPSET LIST Description Lists all replication set names for the currently selected source Syntax REPSET LIST 276 of 332
Repset Resync Command REPSET RESYNC Description Retrieves the last saved replication set settings, clearing any unsaved changes Syntax REPSET RESYNC 277 of 332
Repset Rule Add Command REPSET RULE ADD Description Adds a rule to a replication set. A rule is the specification of a path including volume, directories, wild cards, and/or file names.
Repset Rule Remove Command REPSET RULE REMOVE Description Removes a rule from a replication set Syntax Options Examples REPSET RULE REMove [FROM ] ● path—Volume, directory, wild card, and/or file name ● repset—Name of the replication set ● repset rule remove "c:\data" from DataFiles ● repset rule rem "c:\temp" ● Notes ● If you do not specify a replication set name, the current replication set will be used.
Repset Save Command REPSET SAVE Description Saves all replication set rules for the currently selected source Syntax REPSET SAVE 280 of 332
Repset Use Command REPSET USE Description Specifies a replication set as the active replication set Syntax REPSET USE Options repset—Name of the replication set Examples repset use DataFiles Notes Replication set names that contain non-alphanumeric characters must be enclosed in quotation marks.
Restore Command RESTORE Description Initiates the restoration process Syntax RESTORE FROM ORIGINAL [, OVERWRITE | NOOVERWRITE] [, OVERWRITENEWER | NOOVERWRITENEWER] [, USETARGETDB | NOUSETARGETDB] [, RESTOREDBTOO | NORESTOREDBTOO] [, CHECKSUM | NOCHECKSUM][, ORPHANS | NOORPHANS] ● ● target—Name of the target, an IP address on the target, or a virtual IP address ● original_source—Name of the original source ● OVERWRITE—Overwrites files on the source ● NOOVERWRI
Examples restore DataFiles from beta ,overwritenewer ,usetargetdb ● ● Notes ● ● ● The default settings for this command are overwrite, overwritenewer, usetargetdb, restoredbtoo, and noorphans. The options 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. The source command is required before each use of the restore command. This command requires the original source option.
Resume Target Command RESUME TARGET Description Allows you to resume the execution of Storage Mirroring Recover operations on the target Syntax RESUMETARGET [FROM ] ● Options ● Examples target—Name of the target, an IP address on the target, or a virtual IP address source—Name of the source resumetarget beta ● Notes ● You must be logged on to the target machine for this command to work. Options that contain non-alphanumeric characters must be enclosed in quotation marks.
Schedule Clear Command SCHEDULE CLEAR Description Clears the existing transmission schedule for the specified target Syntax SCHEDule CLEAR Options target—Name of the target, an IP address on the target, or a virtual IP address Depending on the network route Storage Mirroring Recover uses to access the target, you may need to specify the fully qualified domain name.
Schedule Disable Command SCHEDULE DISABLE Description Disables the transmission schedule without clearing the schedule data Syntax SCHEDule DISABLE Options target—Name of the target, an IP address on the target, or a virtual IP address Depending on the network route Storage Mirroring Recover uses to access the target, you may need to specify the fully qualified domain name.
Schedule Enable Command SCHEDULE ENABLE Description Enables the transmission schedule Syntax SCHEDule ENABLE Options target—Name of the target, an IP address on the target, or a virtual IP address Depending on the network route Storage Mirroring Recover uses to access the target, you may need to specify the fully qualified domain name. Examples Notes ● schedule beta enable ● sched beta enable Target names that contain non-alphanumeric characters must be enclosed in quotation marks.
Schedule End Command SCHEDULE END Description Sets criteria to end the transmission of data from the source to the target Syntax SCHEDule END [ DURATION = ] [ BYTES = ] ● Options ● ● ● Examples target—Name of the target, an IP address on the target, or a virtual IP address Depending on the network route Storage Mirroring Recover uses to access the target, you may need to specify the fully qualified domain name.
Schedule Start Command SCHEDULE START Description Sets criteria to start the transmission of data from the source to the target Syntax SCHEDule START [STARTTIME = ] [MEMLIMIT = ] [QUEUESIZE = ] [EVERY ] ● ● ● Options ● ● ● ● ● Examples ● ● ● Notes ● target—Name of the target, an IP address on the target, or a virtual IP address Depending on the network route Storage Mirroring Recover uses to access the target, you may need to
Schedule Window Command SCHEDULE WINDOW Description Sets criteria to only allow transmissions during a certain period of time Syntax SCHEDule WINDOW TO ● Options ● Examples target—Name of the target, an IP address on the target, or a virtual IP address Depending on the network route Storage Mirroring Recover uses to access the target, you may need to specify the fully qualified domain name. hh:mm—Time in hour:minute format using the 24-hour clock.
Script Account Command SCRIPT ACCOUNT Description Specifies the user account that will be used to run scripts Syntax Options SCRIPT ACCOUNT [ domain] ● machine—Name of the machine ● username—Name of the user ● password—Password associated with the user name ● Examples domain—If logging in using a domain account, this is the domain name. If logging in using a local account, this is the machine name.
Script Add Command SCRIPT ADD Description Specifies the scripts that should be run at a particular point-in-time during a process Syntax SCRIPT ADD [source] = [ARGS=arguments] [DELAY|NODELAY] [INTERACT|NOINTERACT] ● ● ● ● con_id—Connection ID assigned to the source/target connection source—Name of the source target—Name of the target, an IP address on the target, or a virtual IP address type—Any of the following script types ● Options ● ● ● MIRRORSTART—This scri
the path in quotation marks. The file name you specify for your script should be the primary executable of the command being run. If you are using a command shell to execute a script, put the command shell execturable as the script file name and pass another script name in as an argument. ● ● ● ● ● arguments—Specify any arguments, valid for your script, that are required to execute your script. Multiple arguments need to be enclosed in quotation marks and separated by a space.
Examples script add 1 alpha on beta mirrorstart="C:\Program Files\StorageWorks\Storage Mirroring\Scripts\MirrorStartScript.bat" args="arg1 arg2" delay interact ● Notes ● The default settings for this command are nodelay and nointeract. Machine names that contain non-alphanumeric characters must be enclosed in quotation marks.
Script List Command SCRIPT LIST Description Displays a list of mirroring scripts Syntax SCRIPT LIST [source] [ON target] ● Options ● ● con_id—Connection ID assigned to the source/target connection source—Name of the source machine target—Name of the target, an IP address on the target, or a virtual IP address Examples script list 1 alpha on beta Notes Machine names that contain non-alphanumeric characters must be enclosed in qutoation marks.
Script Remove Command SCRIPT REMOVE Description Removes the specified mirroring script Syntax SCRIPT REMove [source] [ON target] ● ● ● Options ● con_id—Connection ID assigned to the source/target connection source—Name of the source machine target—Name of the target, an IP address on the target, or a virtual IP address type—Any of the following script types ● ● ● Examples Notes MIRRORSTART—Script that was being processed before the mirroring process starts MIRRORSTOP—Script that w
Script Test Command SCRIPT TEST Description Tests a mirroring script Syntax SCRIPT TEST [arguments] [INTERACT|NOINTERACT] ● ● Options ● ● ● Examples machine—Name of the machine where you want to execute the script as a test path—Specify the full path and file name (including the file extension) to the mirroring script. Do not include arguments with the path, only the path and file name. Enclose the path in quotation marks.
Set Command SET Description Modifies the value of a Storage Mirroring Recover program setting for the specified server Syntax SET = [machine] ● Options Examples ● value—See Server settings for a complete list of the values for each Storage Mirroring Recover program setting ● machine—Name of the machine ● set netport=1100 ● set DefaultAddress="129.12.34.
Set Local Command SET LOCAL Description Modifies the value of a Storage Mirroring Recover program setting for the local machine Syntax SETLOCAL = ● Options ● Examples setting—See Server settings for a complete list of the Storage Mirroring Recover program settings value—See Server settings for a complete list of the values for each Storage Mirroring Recover program setting ● setlocal netport=1100 ● setlocal DefaultAddress="129.12.34.
Shutdown Command SHUTDOWN Description Stops the Storage Mirroring service . Syntax SHUTDOWN Options machine—Name of the machine Examples shutdown alpha Notes Machine names that contain non-alphanumeric characters must be enclosed in quotation marks.
Snapshot Create Command SNAPSHOT CREATE Description Creates a manual snapshot of the replication set data on the target Syntax SNAPshot CREATE [ON ] ● Options ● Examples Notes con_id—Connection ID assigned to the source/target connection target—Name of the target, an IP address on the target, or a virtual IP address ● snapshot create 1 ● snap create 1 Target names that contain non-alphanumeric characters must be enclosed in quotation marks.
Snapshot Delete Command SNAPSHOT DELETE Description Deletes the specified snapshot(s) from the target Syntax SNAPshot DELete [ON ] ● ● Options snapshot_list_number—The snapshot number retrieved from the SNAPSHOT LIST command ● ALL—Deletes all snapshots ● OLD—Deletes only the oldest snapshot ● ● ● Examples con_id—Connection ID assigned to the source/target connection GOOD—If specified, deletes only good snapshot.
Snapshot List Command SNAPSHOT LIST Description Displays a list of snapshots associated with a connection Syntax SNAPshot LIST [ON ] ● Options ● Examples Notes con_id—Connection ID assigned to the source/target connection target—Name of the target, an IP address on the target, or a virtual IP address ● snapshot list 1 ● snap list 1 Target names that contain non-alphanumeric characters must be enclosed in quotation marks.
Snapshot Revert Command SNAPSHOT REVERT Description Revert the target to the last good automatic snapshot Syntax SNAPshot REVERT [ON ] ● Options ● Examples Notes con_id—Connection ID assigned to the source/target connection target—Name of the target, an IP address on the target, or a virtual IP address ● snapshot revert 1 ● snap revert 1 Target names that contain non-alphanumeric characters must be enclosed in quotation marks.
Snapshot Schedule Disable Command SNAPSHOT SCHEDULE DISABLE Description Disables a snapshot schedule Syntax SNAPshot SCHEDule DISABLE [ON ] ● Options ● Examples con_id—Connection ID assigned to the source/target connection target—Name of the target, an IP address on the target, or a virtual IP address ● snapshot schedule 1 disable ● snap sched 1 disable ● Notes ● This command only disables the snapshot schedule for this connection so that it will not run.
Snapshot Schedule Display Command SNAPSHOT SCHEDULE DISPLAY Description Displays the snapshot schedule Syntax SNAPshot SCHEDule DISPlay [ON ] ● Options ● Examples Notes con_id—Connection ID assigned to the source/target connection target—Name of the target, an IP address on the target, or a virtual IP address ● snapshot schedule 1 display ● snap sched 1 disp Target names that contain non-alphnumeric characters must be enclosed in quotation marks.
Snapshot Schedule Enable Command SNAPSHOT SCHEDULE ENABLE Description Enables a disabled snapshot schedule Syntax SNAPshot SCHEDule ENABLE [ON ] ● Options ● Examples Notes con_id—Connection ID assigned to the source/target connection target—Name of the target, an IP address on the target, or a virtual IP address ● snapshot schedule 1 enable ● snap sched 1 enable Target names that contain non-alphnumeric characters must be enclosed in quotation marks.
Snapshot Schedule Every Command SNAPSHOT SCHEDULE EVERY Description Configures and initiates a snapshot schedule Syntax SNAPshot SCHEDule EVERY [STARTTIME = [hh:mm] ] [ON ] ● ● ● Options ● ● ● Examples con_id—Connection ID assigned to the source/target connection number—Any number indicating the frequency for the scheduled snapshots time_units—Minutes (min), hours (hr), or days (day) mm/dd/yy—Date in month/day/year format indicating when the sched
Source Command SOURCE Description Identifies a machine as the active source machine Syntax SOUrce Options source—Name of the source Examples Notes ● source alpha ● sou alpha Source names that contain non-alphanumeric characters must be enclosed in quotation marks.
StatsLog Start Command STATSLOG START Description Starts the DTStats statistics logging utility Syntax STATSLOG START [TO ] [EVERY < minute>] [MAXSIZE ] ● ● Options Examples machine—Name of the machine filename—Any valid path and filename to which the statistical information will be logged ● minutes—The number of minutes to write to the log file ● kilobytes—The maximum file size in kilobytes statslog start alpha to "dtstat.
StatsLog Status Command STATSLOG STATUS Description Identifies whether the DTStats statistics logging utility is currently running Syntax STATSLOG STATUS Options machine—Name of the machine Examples statslog status alpha Notes Machine names that contain non-alphanumeric characters must be enclosed in quotation marks.
StatsLog Stop Command STATSLOG STOP Description Stops the DTStats statistics logging utility Syntax STATSLOG STOP Options machine—Name of the machine Examples statslog stop alpha Notes Machine names that contain non-alphanumeric characters must be enclosed in quotation marks.
Status Command STATUS Description Requests connection and statistical information Syntax STATUS BLOCK [ON ] | CONnect | MIRror < con_id> | REPlicate | TRANsmit | TARget < target> ● ● ● ● Options ● ● ● ● Examples Notes BLOCK—Displays whether replication set path on the specified target is being blocked target—Name of the target, an IP address on the target, or a virtual IP address CONnect—Displays connection information for the connection ID specified con_id—Co
Target Command TARGET Description Identifies a machine as the active target machine Syntax TARget Options target—Name of the target, an IP address on the target, or a virtual IP address Examples ● target beta ● tar beta ● Notes ● You must be logged into a machine using the login command before using the target command. Target names that contain non-alphanumeric characters must be enclosed in quotation marks.
Test Connections Command TEST CONNECTIONS Sends a test command to determine if Storage Mirroring Recover is running. If there are active connections, the replication set(s), IP Description address(es), and connection ID(s) will be included in the testcon log file. Syntax TESTCONnections [ filename [OVERWRITE]] ● ● Options ● Examples machine—The name of the machine filename—The name of the log file. The file extension .dts is appended to any file name supplied.
Time Now Command TIME NOW Description Prints the current date and time. This command is useful for scripting to determine process start and stop times.
Transmission Pause Command TRANSMISSION PAUSE Description Pauses the transmission pause Syntax TRANSmission PAUSE Options target—Name of the target, an IP address on the target, or a virtual IP address. Depending on the network route Storage Mirroring Recover uses to access the target, you may need to specify the fully qualified domain name.
Transmission Resume Command TRANSMISSION RESUME Description Resumes a paused transmission pause Syntax TRANSmission RESUME Options target—Name of the target, an IP address on the target, or a virtual IP address. Depending on the network route Storage Mirroring Recover uses to access the target, you may need to specify the fully qualified domain name.
Transmission Start Command TRANSMISSION START Description Initiates the transmission pause Syntax TRANSmission START Options target—Name of the target, an IP address on the target, or a virtual IP address. Depending on the network route Storage Mirroring Recover uses to access the target, you may need to specify the fully qualified domain name.
Transmission Stop Command TRANSMISSION STOP Description Stops the transmission pause Syntax TRANSmission STOP Options target—Name of the target, an IP address on the target, or a virtual IP address. Depending on the network route Storage Mirroring Recover uses to access the target, you may need to specify the fully qualified domain name. Examples Notes ● transmission stop beta ● trans stop beta Target names that contain non-alphanumeric characters must be enclosed in quotation marks.
Unblock All Command UNBLOCK ALL Unblocks the replication set target paths that were previously Description blocked. Any process can now update data in the replication set target path.
Unload Source Command UNLOAD SOURCE Description Unloads the Storage Mirroring Recover source module Syntax UNLOAD SOURCE Options machine—Name of the machine Examples unload source alpha Notes Machine names that contain non-alphanumeric characters must be enclosed in quotation marks.
Unload System State Command UNLOAD SYSTEM STATE Description Unloads the Storage Mirroring Recover system state module Syntax UNLOAD SYSTEMSTATE Options machine—Name of the machine Examples unload system state alpha Notes Machine names that contain non-alphanumeric characters must be enclosed in quotation marks.
Unload Target Command UNLOAD TARGET Description Unloads the Storage Mirroring Recover target module Syntax UNLOAD TARGET Options machine—Name of the machine Examples unload target alpha Notes Machine names that contain non-alphanumeric characters must be enclosed in quotation marks.
Verify Command VERIFY Description Verifies the integrity of the data between the source and target machines Syntax VERIFY [ SYNC [,NEWER] | NOSYNC] [,CHECKSUM | NOCHECKSUM] [STARTTIME= [hh:mm]] [EVERY < number> ] [ORPHANS | NOORPHANS] [CLEARRESTOREREQUIRED] ● ● ● ● ● ● ● Options ● ● ● con_id—Connection ID assigned to the source/target connection SYNC—Synchronizes any data that is different NEWER—Synchronizes only those files that are newer on the source than on th
Examples Notes ● verify 1 ● verify 2 sync, newer ● verify 2 every 2 hr The default verification settings are sync, checksum, and noorphans.
Version Command VERSION Description Displays the Storage Mirroring Recover version currently installed Syntax VERSION [MACHINE] Options MACHINE—Name of the machine Examples version alpha ● Notes ● If no machine name is specified, the version of the active source will be displayed. If there is no active source, no version information will be displayed. Machine names that contain non-alpanumeric characters must be enclosed in quotation marks.
Wait Command WAIT Description This command is used in scripts to force the script to stop executing until the specified number of milliseconds has elapsed. Syntax WAIT Options ms—Length of time in milliseconds Examples wait 5000 Notes This sample waits for 5 seconds.
Wait on Mirror Command WAIT ON MIRROR Description This command is used in scripts to force the script to stop executing until the connection has finished mirroring or verifying Syntax WAITONMIRROR Options con_id—Connection ID assigned to the source/target connection Examples waitonmirror 1 329 of 332
Wait on Restore Command WAIT ON RESTORE Description This command is used in scripts to force the script to stop executing until the connection has finished restoring Syntax WAITONRESTORE Options rest_id—Restoration ID assigned to the source/target connection Examples waitonrestore 1 Notes This command requires using the source command immediately before the waitonrestore command.
Wait on Target Command WAIT ON TARGET Description This command is used in scripts to force the script to stop executing until the target queue has been empty for the time specified Syntax WAITONTARGET [FROM ]
Write Command WRITE Description Displays the value of a Storage Mirroring Recover variable Syntax WRITE $ Options variable_name—The name of the variable that you have established and want to display Examples ● write $thetarget ● write $dbrepset 332 of 332
