Getting Started Fourth Edition (May 2004) Part Number: 359447-001
© Copyright 2004 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 particular 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 Storage Mirroring Server Requirements ..........1 Storage Mirroring Installation ............................3 Installation notes ............................................................................... 3 Installing Storage Mirroring ............................................................ 5 Installing Storage Mirroring automatically ................................... 8 Upgrading, modifying, or repairing Storage Mirroring ...........14 Additional upgrading guidelines ..........
Storage Mirroring Server Requirements Verify that each machine that will be used as an HP OpenView Storage Mirroring source or target meets the following system requirements. ! Operating System and Licensing—There are different Storage Mirroring licenses depending on the operating system you are using. Be sure you have the correct license for your operating system.
! Server Name—Storage Mirroring includes Unicode file system support, but your server name must still be in ASCII format. ! System Memory—64 MB minimum ! Disk Space Program Files 48 MB Microsoft Windows Installer Files 20 MB Total 68 MB NOTE: The program file can be installed to any volume while the Microsoft Windows Installer files are automatically installed to the operating system boot volume.
Storage Mirroring Installation Review the Storage Mirroring Installation notes below and on the following page and then use the appropriate installation instructions depending on your current configuration. ! Installing Storage Mirroring on page 5—Use these instructions if you are installing Storage Mirroring for the first time or have completely uninstalled a previous version of Storage Mirroring.
! Because Storage Mirroring has operating system dependent files, if you are upgrading your operating system (to a new major version, not a service pack) and have Storage Mirroring installed, you must remove Storage Mirroring prior to the operating system upgrade. Use the steps below as a guideline. a. Uninstall Storage Mirroring. b. Perform the operating system upgrade. c. Install Storage Mirroring.
Installing Storage Mirroring Use these instructions if you are installing Storage Mirroring for the first time or if you have completely uninstalled any previous version of Storage Mirroring. 1. Close any open applications. 2. Start the installation program by loading the Storage Mirroring CD into the local CD-ROM drive. If auto-run is enabled, the program will start automatically. To manually start the program, select Start, Run and specify: :\autorun.exe 3.
8. If you selected the Custom installation, select the components that you wish to install and the path where you want the files located. Click Next to continue. NOTE: 9. If you have selected the Custom, Client Components Only installation, continue with step 14. You will be prompted to enter your User Name, Organization, and Activation Code. The code is a 16-character, alpha-numeric activation code which applies the appropriate Storage Mirroring license to your installation. Click Next to continue.
12. If you are using Windows NT 4.0, in order for Storage Mirroring’s failover capabilities to assume the IP address(es) of your source(s) during failover, you must create placeholders equal to the greatest number of IP addresses the target may need to assume at any given time. By default, five placeholders are created on each NIC. To change the number of placeholders for each available NIC, enter the number of placeholders you want created in the Placeholders field. Click Next to continue. 13.
Installing Storage Mirroring automatically The Storage Mirroring installation program can accept command-line parameters which allow you to automate the installation process by running an unattended, or silent, installation. The silent installation allows you to pass parameters through to the installation program instead of entering information manually during the installation. NOTE: If you are using Windows NT 4.
Entry Valid Parameters DT Activation Code ! AutoReboot ! ! ! If you are installing a single or site license, enter the activation code. If you are installing to multiple machines, create additional sections at the bottom of the setup file corresponding to each machine name. See the note accompanying step 7 for additional details.
Entry Cluster Client Valid Parameters ! ! SNMP ! ! Y—Install Storage Mirroring client resource files. The files installed with this setting allow you to manage the Storage Mirroring cluster resource from a machine that may not necessarily be a part of the cluster. N—Do not install Storage Mirroring client resource files.
Entry Valid Parameters DTService Startup If you are using the DTNT option, specify: ! Y or 1—Start the Storage Mirroring service automatically ! N or 0—Do not start the Storage Mirroring service automatically DTFailover Startup If you are using Windows NT 4.0 and have specified the DTNT option, the specify: ! Y or 1—Configure the machine for failover ! N or 0—Do not configure the machine for failover Placeholder Count If you are using Windows NT 4.
Example DTSetup.ini for Client Only Installation [Double-Take] DTSETUPTYPE=DTNT DTACTIVATIONCODE=01a2b000304c056d AUTOREBOOT=Y [Client] DOUBLETAKEFOLDER="C:\Program Mirroring" Files\OpenViewStorage MANAGEMENTCONSOLE=Y TEXTTOOLS=Y CLUSTERCLIENT=Y SNMP=N Use the appropriate instructions depending on if you are performing a local or remote Storage Mirroring installation automatically. The local installation is below and the remote installation is on the following page.
! Remote, automatic Storage Mirroring installation 1. Create a temporary directory on the primary site server. For example, create z:\dtinstall. 2. Share the temporary folder. 3. Copy the files from the DblTake\NT2000 directory on the Storage Mirroring CD-ROM to the temporary folder. 4. From a command prompt, remove the read-only attributes from the files in the temporary directory by using the command attrib *.* -r. 5. Make a backup copy of the default DTSetup.ini file in the shared folder. 6.
Upgrading, modifying, or repairing Storage Mirroring If you already have Storage Mirroring installed, you can upgrade, modify, upgrade and modify, or repair your installation. The choices will depend on the version of the installation you are using. ! Upgrade—Select Upgrade if you already have Storage Mirroring installed and are upgrading to a newer version. If you are upgrading, be sure and review the Additional upgrading guidelines on page 17.
3. The Storage Mirroring installation program starts with an initial screen allowing you to install the software or read associated files. Select Install Storage Mirroring for Windows. 4. When the Storage Mirroring installation program begins, the Welcome screen is displayed. Click Next to continue. 5. Review and accept the Storage Mirroring license agreement to continue with the installation program. Click Next to continue. 6.
NOTE: If you do not see upgrade options, the Storage Mirroring version that you are attempting to upgrade to is not newer than the version that is currently installed. 8. Select the appropriate option and click Next to continue. 9. The remaining screens are dependent on your selection on the Maintenance dialog: ! Modify Client and Server Components—In order to modify any of your existing settings, all of the installation screens are presented in order.
Additional upgrading guidelines When you are upgrading Storage Mirroring, keep in mind the following limitations between versions. NOTE: A Storage Mirroring major version is identified by the first numeral and the minor version is identified by the second numeral. For example, in the release 4.3, 4 is the major version number and 3 is the minor version number. Additional numbers beyond the major and minor version indicate service packs, hotfixes, and build numbers.
Removing Storage Mirroring Use these instructions if you want to remove an existing Storage Mirroring installation. These instructions use the remove feature built into the Storage Mirroring installation program. NOTE: If desired, you can use the Add/Remove Programs function of the Windows Control Panel to remove Storage Mirroring. After you confirm that you want to uninstall the program, continue with step 9.
Select either option and click Next to continue. NOTE: The Program Maintenance dialog box will appear. If you do not see this dialog box, you have not previously installed Storage Mirroring. 7. On the Maintenance dialog box, select Remove and click Next to continue. 8. The installation program is immediately ready to begin removing the Storage Mirroring files. Click Remove to continue. 9. You will be prompted to indicate whether or not you want to remove the Storage Mirroring security groups.
Storage Mirroring Service After Storage Mirroring is installed and the machine is rebooted, the service is automatically started. The Storage Mirroring service controls the core functionality of Storage Mirroring including mirroring, replication, and failover. Manually starting the service 1. Open the Services applet. Windows 200x—Select Start, Programs, Administrative Tools, Services. Windows NT—Select Start, Settings, Control Panel and double-click the Services icon. 2.
Manually stopping the service 1. Open the Services applet. Windows 200x—Select Start, Programs, Administrative Tools, Services. Windows NT—Select Start, Settings, Control Panel and double-click the Services icon. 2. Select the Storage Mirroring service. Windows 2000—Expand the Services and Applications tree on the left pane of the Computer Management window, select Services, and then double-click Storage Mirroring on the right pane of the Computer Management window.
Storage Mirroring Clients There are several clients available for Storage Mirroring. ! Management Console—32-bit GUI client that can manage and monitor all Storage Mirroring components including failover configuration. This client cannot initiate failover or failback or monitor failover activity. For basic details on the Management Console, begin with The Management Console on page 22. ! Text Client and Command Line Client—Uses the DTCL (Double-Take Command Language) scripting language.
Starting the Management Console From the machine that you installed the Storage Mirroring client, select Start, Programs, Storage Mirroring, Management Console. The Management Console is divided into a left and right pane. The views in the panes change depending on what is highlighted. For example, in the left pane when the root of the tree, labeled Storage Mirroring Servers, is highlighted, all of the machines running Storage Mirroring are displayed in the right pane.
Understanding the display The left pane is a tree view displaying each machine running Storage Mirroring. As each machine name is highlighted, note the following items: ! The status bar at the top of the pane displays the modules loaded on each machine: Source, Target, Source and Target, or None. (None indicates that the core functionality of Storage Mirroring is running, but neither the source nor target modules have been loaded.
Icon Description Any of the machine icons can appear with a red X. The red X indicates: ! The Management Console cannot communicate with that Storage Mirroring machine. ! There is a problem with an established Storage Mirroring connection. Look in the right pane of the Management Console or log on to the machine in the left pane to determine the exact problem. A machine icon can appear with a black X. The black X indicates that the machine is not running Storage Mirroring.
! The right pane displays the following information depending on the item selected in the left pane of the Management Console and the tab selected on the right pane. Right Pane Icons Left Pane Right Pane Description World View No Tabs All connected machines and their current connection state are displayed. Source Machine Source Tab The active connections, if any, from that source machine are displayed. Source Machine Target Tab The display is blank.
Logging on and off of Storage Mirroring To ensure protection of your data, Storage Mirroring offers multi-level security using native operating system security features. Privileges are granted through membership in user groups defined on each machine running Storage Mirroring. To gain access to a particular Storage Mirroring source or target, the user must provide a valid operating system user name and password and the specified user name must be a member of one of the Storage Mirroring security groups.
3. Specify your Username, Password, Domain, and whether you want your password saved. Click OK. NOTE: If your activation code is missing or invalid, you will be prompted to open the Server Properties general tab to add or correct the code. Select Yes to open the Server Properties dialog box. 4. Verify your access by the resulting icon and log on again if necessary. 5. To log off of a Storage Mirroring machine, right-click the machine name on the left pane of the Management Console and select Logout.
Getting help for the Management Console Context-sensitive help is available in the Management Console by: ! Clicking Help when it appears on various dialog boxes ! Pressing the F1 key ! Selecting Help, Help Topics Exiting the Management Console To exit the Management Console, select File, Exit or select the Exit button on the toolbar.
Storage Mirroring Text Clients The Double-Take Command Language (DTCL) is a scripting language that can be used in either the Text Client or Command Line Client to manage and monitor Storage Mirroring components. It can also be used in script files to execute series and combinations of commands to meet specific needs. The Text Client The Text Client is a full-screen, text-based client that can be run from a command prompt.
To use Storage Mirroring from the Text Client, enter the DTCL commands at the Command prompt in the middle of the Text Client screen. Storage Mirroring version 4.3 Source Machine: ============================================================= Command: login indy administrator ******** domain_name ============================================================= User access level set to DT_FULL_ACCESS The Command Line Client The Command Line Client can be run from a command prompt.
! File Entry—Create a file with all of the DTCL commands you want to run. At the directory prompt where Storage Mirroring is installed, type DTCL –f filename where filename is the name of the file containing the DTCL commands. For example, you might use the following dtcl.txt file to log on to a machine and display its replication sets. Command Line Client File Entry C:\Program Files\OpenView\Storage Mirroring> dtcl -f dtcl.
Logging on and off of Storage Mirroring To ensure protection of your data, Storage Mirroring uses native operating system security and requires a valid system username and password. If you do not have a valid system username and password for a selected machine, you will not be able to configure Storage Mirroring for that machine. As you enter DTCL commands, Storage Mirroring automatically attempts to log on to the source or target machine. You can verify your access by the resulting message.
Command LOGIN Description Log on to a Storage Mirroring machine Syntax LOGIN [domain] Options ! ! machine—Name of the machine username—Name of the user password—Password associated with ! domain—If logging in using a domain account, ! username. this is the domain name. If logging in using a local account, this is the machine name.
Getting help in the text clients A listing of the DTCL commands and their syntax is available in the Storage Mirroring Text Client and Command Line Client by typing the help command. Command HELP Description Displays the DTCL commands and their syntax Syntax HELP Notes ! Press any key to scroll through the list of commands. ! Press q to exit the help function.
Establishing a Connection You have three options for establishing a connection: ! Using the automated Connection Wizard in the Management Console ! Using the Connection Manager in the Management Console ! Using the Text Client Connection Wizard connection The first time you start the Storage Mirroring Management Console, the Welcome screen leads you to the Storage Mirroring Connection Wizard. The Connection Wizard will guide you through the essential steps necessary to establish a basic connection.
2. The Connection Wizard opens to the Welcome screen. Review this screen and click Next to continue. 3. If you highlighted a source in the Management Console, the source will already be selected. If it is not, select the Storage Mirroring source. This is the machine where the files reside that you wish to protect. Click Next to continue. NOTE: 4. Storage Mirroring will automatically attempt to log on to the selected source using the identification of the user logged on to the local machine.
5. Choose to create a new replication set or use a replication set that already exists. ! If you choose to create a new replication, specify a replication set name. ! If you choose to use an existing replication set, specify the name of that replication set by selecting it from the pull-down menu. Click Next to continue. 6. If you choose to create a new replication set, a tree display appears identifying the volumes and directories available on that source machine.
8. Click Next to continue. 9. Review your selections on the summary screen. 10. If your Connection Wizard settings are correct, establish your connection by completing one of the two options below: ! If you do not want to set advanced options, click Finish. NOTE: If you created a new replication set in step 5, you will be prompted at this time to save the replication set. Click Yes to save the replication set or click No to go back to the Finished dialog box.
Connection Manager connection 1. There are four methods available for opening the Connection Manager and establishing a connection manually: ! Highlight a replication set and select Tools, Connection Manager. ! Right-click on a replication set and select Connection Manager. ! Drag and drop a replication set to a target machine on the left pane of the Management Console.
4. Depending on the method you used to open the Connection Manager, the Target Server and Route fields may or may not be completed. If they are not, select a target machine and the primary IP address of that machine will automatically appear. If you have multiple IP addresses on your target, verify the Route field is set to the correct network path. NOTE: To initiate a connection using the Resource Planning Tool, select the Diagnostics target.
Text client connection 1. Log on to the Storage Mirroring source machine. This is the machine where the files reside that you wish to protect. Log on by using the login command. Command LOGIN Description Log on to a Storage Mirroring machine Syntax LOGIN [domain] Options ! ! machine—Name of the machine username—Name of the user password—Password associated with ! domain—If logging in using a domain ! username. account, this is the domain name.
3. 4. Specify your Storage Mirroring source machine by using the source command. Command SOURCE Description Identifies a machine as the active source machine Syntax SOURCE Options source_machine—Name of the machine Examples source indy Create a new replication set using the repset create command.
5. Specify the data to be protected by creating replication set rules. Define a rule by using the repset rule add command. 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.
Notes The default settings for this command are include and recursive. ! If you do not specify a replication set name, the current replication set will be used. ! If the path begins with a non-alphabetic character or if the replication set name includes non-alphanumeric characters, the path or name must be enclosed in quotation marks. ! Verify what files can be included by reviewing Replication Capabilities in the Storage Mirroring User’s Guide. ! 6.
8. Verify the replication set rules defined by using the repset display command. Command REPSET DISPLAY Description Displays the rule of a replication set Syntax REPSET DISPLAY [repset] Options repset—Name of the replication set Examples ! ! Notes 9. repset display repset display Exchange If you do not specify a replication set name, the current replication set will be used. ! If the replication set name includes non-alphanumeric characters, the name must be enclosed in quotation marks.
Syntax CONNECT TO MAP EXACT | BASE | TO [,...
Options ! connect repset to target map base source_path TO target_path— Custom location that specifies each directory on the source and where that data will be copied to on the target machine ! ...
Examples ! ! Notes connect “Exchange Repset” to jersey map exact connect Exchange to jersey map c:\exchsrvr to e:\exchsrvr, monitor The default settings for this command are mirror, replicate, nomonitor, and noorphans. ! If a path begins with a non-alphabetic character or if the replication set name includes non-alphanumeric characters, the path or name must be enclosed in quotation marks. ! Your Storage Mirroring connection is now established.
