HP StorageWorks Storage Mirroring for Linux Getting Started

HP StorageWorks Storage
Mirroring for Linux
Getting Started
First Edition (February 2008)
Part Number: T2558-96077
© Copyright 2008 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.
This document contains proprietary information, which is protected by copyright. No part of this document may be
photocopied, reproduced, or translated into another language without the prior written consent of Hewlett-Packard. The
information contained in this document is subject to change without notice.
Microsoft®, Windows®, and Windows NT® are U.S. registered trademarks of Microsoft Corporation.
Hewlett-Packard Company shall not be liable for technical or editorial errors or omissions contained herein. The information
is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Hewlett-Packard
Company products are set forth in the express limited warranty statements for such products. Nothing herein should be
construed as constituting an additional warranty.
HP StorageWorks Storage Mirroring for Linux Getting Started
First Edition (February 2008)
Part Number: T2558-96077
Double-Take, GeoCluster, and NSI are registered trademarks of Double-Take Software, Inc. Balance, Double-Take for Virtual
Systems, Double-Take for Virtual Servers, and Double-Take ShadowCaster are trademarks of Double-Take Software, Inc.
Microsoft, Windows, and the Windows logo are trademarks or registered trademarks of Microsoft Corporation in the United
States and/or other countries. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or
other jurisdictions. All other trademarks are the property of their respective companies.
© 2008 Double-Take Software, Inc. All rights reserved.
Table of Contents
Server Requirements .................................................................................................................. 1
Installing Storage Mirroring ....................................................................................................... 1
Configuring Your Storage Mirroring Installation ..................................................................... 2
Upgrading Storage Mirroring ..................................................................................................... 3
Removing (Erasing) Storage Mirroring ..................................................................................... 3
Installing the Storage Mirroring Client for Windows .............................................................. 4
Removing the Storage Mirroring Client for Windows ............................................................ 4
Storage Mirroring Clients ........................................................................................................... 5
The Management Console ......................................................................................................................................................................... 5
Starting the Management Console .................................................................................................................................................. 5
Understanding the display ................................................................................................................................................................. 6
Logging on and off of Storage Mirroring ........................................................................................................................................ 8
Getting help for the Management Console ................................................................................................................................... 9
Exiting the Management Console .................................................................................................................................................... 9
Storage Mirroring text clients ................................................................................................................................................................10
The Text Client .................................................................................................................................................................................10
The Command Line Client ..............................................................................................................................................................11
Logging on and off of Storage Mirroring ......................................................................................................................................12
Getting help in the text clients .......................................................................................................................................................13
Exiting the text clients ......................................................................................................................................................................13
Establishing a Connection ........................................................................................................ 14
Connection Wizard connection .............................................................................................................................................................14
Connection Manager connection ...........................................................................................................................................................17
Text client connection .............................................................................................................................................................................18
Server Requirements
Verify that each machine that will be used as a Storage Mirroring source or target meets the following system requirements.
!
Operating System—Each server must be running a 32-bit or 64-bit version of Red Hat® Enterprise Linux® 4.2 through
!
System memory—At a minimum, you should have 512 MB of memory on each server. Ideally, you should have 1 GB.
!
Disk Usage—The amount of disk space required for the Storage Mirroring program files is approximately 45 MB. About
5 MB will be located on your /(root) partition, and the remainder will be on your /usr partition. You will need to
verify that you have additional disk space for Storage Mirroring queuing, logging, and so on. Additionally, on a target
server, you need sufficient disk space to store the replicated data from all connected sources, allowing additional space
for growth.
!
Protocols—TCP/IP
!
File System—Storage Mirroring supports the ext2 and ext3 file systems. Storage Mirroring is compatible with NFS and
4.5.
Samba as long as they are mounted on top of Storage Mirroring. Storage Mirroring should be mounted just above the
storage file system.
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.
Go to a shell prompt by launching a terminal application from your graphical user interface (GUI) or logging in via the
Linux virtual console.
2.
If you are not already, become the superuser ("root") by typing su -.
3.
Determine the installation package that is appropriate for your operating system.
Operating System
Installation File
32-Bit Operating System
StorageMirroring-versionnumbers.i386.rpm
64-Bit Operating System
StorageMirroring-versionnumbers.x86_64.rpm
The versionnumbers in the installation file name will vary and will correspond to the version of Storage Mirroring you
are installing. For example, if you are installing version 4.3.10.0.1815, the installation files would be
StorageMirroring-4.3.10.0-1815.i386.rpm or StorageMirroring-4.3.10.0-1815.x86_64.rpm. If you
are uncertain about the architecture of your machine, you can use the uname -m command to determine it.
4.
If you are installing from a CD, mount the file ISO 9660 or UDF file system and run the installation file appropriate for
your operating system. If you are installing from a web download, verify you have the installation file appropriate for your
operating system and then run the installation program.
To run the installation use rpm -i with the installation file name. For example, if you were installing on a 32-bit
operating system, you would use the command rpm -i StorageMirroring-4.3.10.0-1815.i386.rpm.
A successful installation returns you to the shell prompt. If you receive an error message during the installation, you will need
to reinstall the software. If you are unable to resolve the error, contact technical support.
1
Configuring Your Storage Mirroring Installation
After you have installed Storage Mirroring, you need to configure your installation prior to using the software. Storage
Mirroring contains a DTSetup menu-driven application to provide easy access to the installation configuration.
1.
Run the DTSetup command from the shell prompt.
NOTE:
Do not run DTSetup using the sudo command. Use a real root shell to launch DTSetup instead, either
by logging in as root on the console or by using the login session of a non-privileged user to run su - to
start a root shell.
2.
The first time you run DTSetup after an installation or upgrade, you will be prompted to review the HP license
agreement. Review the agreement and accept the terms of agreement by typing yes. You cannot use Storage Mirroring
without agreeing to the licensing terms.
3.
When the DTSetup menu appears, select the option that you want to configure.
!
Setup tasks—Use these tasks to modify your Storage Mirroring configuration.
!
Activation code—For each server, you must specify an activation code, which is a16-character, alpha-numeric
code that applies the appropriate Storage Mirroring license to your installation.
!
Security groups—Storage Mirroring uses the native operating system to provide security. 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.
The dtadmin group provides full privileges and the dtmon group provides a subset of privileges.
!
Replication mount points—In order to use Storage Mirroring replication, data that will be replicated must
reside on a Storage Mirroring partition, which is specially mounted with the Storage Mirroring file system
(DTFS) driver. DTFS is a virtual file system that monitors the storage file system so that data changes can be
captured. DTFS is a transparent file system. Existing mount points may be available for replication, but the data
on those mount point can only be replicated if they are DTFS mount points. The DTSetup utility allows you to
specify which mount points should be DTFS mount points.
NOTE:
Storage Mirroring supports the ext2 and ext3 file systems. Storage Mirroring is compatible with
NFS and Samba as long as they are mounted on top of Storage Mirroring. Storage Mirroring
should be mounted just above the storage file system.
Do not select the root as a replication mount point.
If you have a single drive system, mount DTFS to any of the subdirectories directly under root
that you want to replicate.
If you are using Konquerer, you can only unmount a replication mount point by rebooting the
server.
!
!
IP addresses—If you are using Storage Mirroring across a router, you will need to configure the router ports
to accommodate Storage Mirroring traffic. Use this option to assist in IP address configuration.
!
Configuration file—Storage Mirroring program settings are the user-definable options that control Storage
Mirroring application settings and Storage Mirroring processing settings. This includes options like the name of
the verification log file and the size of the Storage Mirroring memory pool. You can set these options using
DTSetup or the Storage Mirroring clients.
!
Performance settings—
Storage Mirroring daemon—The Storage Mirroring daemon will start automatically after Storage Mirroring is
installed and the server is rebooted. You must also restart the daemon after you mount DTFS on a mount point.
You can start and stop the Storage Mirroring daemon using this built-in DTSetup script.
!
DTText—You can launch the Storage Mirroring Text Client from DTSetup. The Text Client is a full-screen,
text-based client that manages and monitors Storage Mirroring components. The interface uses DTCL commands
entered one line at a time. The Text Client offers command line editing capabilities, such as backspace cursor
movement and forward/backward command history scrolling. All connection information is displayed in columnar
text format on the screen.
2
!
Troubleshooting and documentation—Use this menu option to access troubleshooting tasks and the Storage
Mirroring documentation.
!
Log file—LogViewer is a utility that gathers Storage Mirroring alerts. These alerts, which are proccessing
notifications, warnings, and error messages, are written to disk and can be displayed using DTSetup or the
LogViewer.
!
Diagnostics—You may need to collect configuration data when reporting problems to technical support.
DTSetup can gather Storage Mirroring log files, Storage Mirroring settings, network configuration information
such as IP addresses, and other data which may be necessary for technical support to troubleshoot issues.
!
Documentation—You can view Storage Mirroring documentation including the Getting Started guide,
Evaluation Guide, User’s Guide, readme, and various legal documents.
Upgrading Storage Mirroring
If you already have Storage Mirroring installed, you can upgrade your installation.
1.
Go to a shell prompt by launching a terminal application from your graphical user interface (GUI) or logging in via the
Linux virtual console.
2.
If you are not already, become the superuser ("root") by typing su -.
3.
Determine the installation package that is appropriate for your operating system.
Operating System
Installation File
32-Bit Operating System
StorageMirroring-versionnumbers.i386.rpm
64-Bit Operating System
StorageMirroring-versionnumbers.x86_64.rpm
The versionnumbers in the installation file name will vary and will correspond to the version of Storage Mirroring you
are installing. For example, if you are installing version 4.3.10.0.1815, the installation files would be
StorageMirroring-4.3.10.0-1815.i386.rpm or StorageMirroring-4.3.10.0-1815.x86_64.rpm. If you
are uncertain about the architecture of your machine, you can use the uname -m command to determine it.
4.
If you are upgrading from a CD, mount the file ISO 9660 or UDF file system and run the installation file appropriate for
your operating system. If you are installing from a web download, verify you have the installation file appropriate for your
operating system and then run the installation program.
To upgrade, use rpm -U with the installation file name. For example, if you are upgrading on a 32-bit operating system,
you would use the command rpm -U StorageMirroring-4.3.10.0-1815.i386.rpm.
A successful upgrade returns you to the shell prompt. After an upgrade, the installation is verified each time the daemon is
started. This allows any settings that may have become corrupt to be restored.
Removing (Erasing) Storage Mirroring
Use these instructions if you want to remove (erase) an existing Storage Mirroring installation.
1.
Go to a shell prompt by launching a terminal application from your graphical user interface (GUI) or logging in via the
Linux virtual console.
2.
If you are not already, become the superuser ("root") by typing su -.
3.
Erase Storage Mirroring by using the command rpm - e StorageMirroring.
A successful removal returns you to the shell prompt. If you receive an error message during the removal, you will need to
erase the software again. If you are unable to resolve the error, contact technical support.
NOTE:
After removing Storage Mirroring, some files may not be removed until after the server has been rebooted
3
Installing the Storage Mirroring Client for Windows
Use the instructions to install the Storage Mirroring clients on a Microsoft® Windows® machine.
1.
Close any open applications.
2.
Start the installation program using the appropriate instructions, depending on your media source.
!
CD—Load the Storage Mirroring CD into the local CD-ROM drive. If auto-run is enabled, the installation program
will start automatically. To manually start the program, select Start, Run and specify <cd_drive>:\autorun.exe.
Select to install Storage Mirroring for Windows.
!
Web download—Launch the .exe file that you downloaded from the web. When prompted, unzip the files and
launch the installation.
3.
When the Storage Mirroring installation program begins, the Welcome screen is displayed. Click Next to continue.
4.
Review and accept the Storage Mirroring license agreement to continue with the installation program. Click Next to
continue.
5.
Select the folder where you would like to install the Storage Mirroring clients and click Next to continue.
6.
When you are ready to begin copying the files, click Install.
7.
After the files have completed copying, click Finish to exit the installation program.
Removing the Storage Mirroring Client for Windows
Use these instructions if you want to remove the Storage Mirroring clients on a Microsoft Windows machine.
NOTE:
If desired, you can use the Add/Remove Programs function of the Windows Control Panel to remove the
Storage Mirroring clients.
1.
Close any open applications.
2.
Start the installation program using the appropriate instructions, depending on your media source.
!
CD—Load the Storage Mirroring CD into the local CD-ROM drive. If auto-run is enabled, the installation program
will start automatically. To manually start the program, select Start, Run and specify <cd_drive>:\autorun.exe.
Select to install Storage Mirroring for Windows.
!
Web download—Launch the .exe file that you downloaded from the web. When prompted, unzip the files and
launch the installation.
3.
When the Storage Mirroring installation program begins, the Welcome screen is displayed. Click Next to continue.
4.
On the Maintenance dialog box, select Remove and click Next to continue.
5.
The installation program is immediately ready to begin removing the Storage Mirroring files. Click Remove to continue.
6.
When the message prompt informs you that the uninstall program has completed successfully., click OK.
4
Storage Mirroring Clients
There are several clients available for Storage Mirroring.
!
Management Console—This client is a 32-bit Microsoft Windows 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 below.
!
Text Client and Command Line Client—This client uses the DTCL (Double-Take Command Language) scripting
language with commands for all Storage Mirroring operations. This client can initiate failover and failback but cannot
monitor failover activity. For basic details on the text clients, begin with Storage Mirroring text clients on page 10.
!
Failover Control Center—This client is a 32-bit Microsoft Windows client that can configure all aspects of failover and
can monitor failover activity, For details on the Failover Control Center, see the Storage Mirroring User’s Guide.
The Management Console
The Management Console is a 32-bit Microsoft Windows client that can manage and monitor Storage Mirroring components
on any platform. Storage Mirroring machines are displayed along with active connection information. The Management
Console can also configure failover settings.
Starting the Management Console
From the Windows machine that you installed the Storage Mirroring client, select Start, Programs, Storage Mirroring, Linux
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. If you double-click on the root, those same servers expand or
collapse in the branches of the tree. More detailed information can be found in the Storage Mirroring User’s Guide.
5
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.)
!
The icons in the left pane indicate what modules are loaded on each machine.
Left Pane Icons
Icon
Description
The world icon is selected. The Storage Mirroring machines are displayed in the right pane of the
Management Console. The Storage Mirroring machines are also displayed in a collapsable and expandable
tree view under the world icon.
The globe icon is selected. The Storage Mirroring globe icon indicates that an object in the expanded tree is
selected.
A blue machine indicates a Storage Mirroring source.
A yellow machine indicates a Storage Mirroring target.
Yellow and blue machines indicate a Storage Mirroring source and target.
A single machine with a hammer indicates that neither the source nor target modules are loaded.
A machine with two red vertical lines over it indicates that the target module is paused.
A machine with red horizontal lines over it indicates that a restore may be required because the target
machine is or has been standing in for the source machine due to failover.
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.
!
The icon to the left of the machine name indicates the security access that is granted for that machine. For detailed
information on security and access rights, see the Storage Mirroring User’s Guide.
Security Icons
Icon
!
Description
Access Granted
This icon is a computer with a gear and it indicates the Storage Mirroring
security is set to administrator access.
Administrator rights
This icon is a computer with a magnifying glass and it indicates the Storage
Mirroring security is set to monitor only access.
Monitor rights
This icon is a lock and it indicates the Storage Mirroring security is set to no
access.
No rights
After you have logged into a machine, a collapsable and expandable tree view of the volumes and directories it contains
is displayed. To expand the tree, click on the plus sign icon. To collapse the tree, click on the minus sign icon.
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.
6
Left Pane
Right Pane
Description
Source Machine
Target Tab
The display is blank.
Target Machine
Source Tab
The display is blank.
Target Machine
Target Tab
The active connections, if any, to that target machine are displayed.
Replication Set
No Tabs
The available target machines are displayed so that you can drag and drop a
replication set onto a target to establish a connection.
Volume or Directory
No Tabs
The directories and files contained in that volume or directory are displayed.
a
a. If transmission is stopped (manually stopped, outside of a scheduled transmission window, network error
between the source and target, and so on) the replication set will not be displayed on the Target tab. When
transmission (re)starts, the replication set will (re)appear.
7
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. Once a valid user
name and password has been provided and the Storage Mirroring source or target has verified membership in one of the
Storage Mirroring security groups, the user is granted appropriate access to the source or target and the corresponding
features are enabled in the client. Access to Storage Mirroring is granted on one of the following three levels:
!
Administrator Access—All Storage Mirroring features are available for that machine. For example, this access level
!
Monitor Access—Statistics can be viewed on that machine, but Storage Mirroring features are not available. For example,
includes creating replication sets and establishing Storage Mirroring connections.
this access level does not allow the user to create or modify replication sets or create or modify Storage Mirroring
connections, but does allow you to view the connection statistics for any established Storage Mirroring connections on
that machine.
!
No Access—The machine appears in the Storage Mirroring Management Console and can be pinged from the Storage
Mirroring Text Client, but no other access is available.
1.
Highlight a machine on the left pane of the Management Console. By double-clicking the machine name, Storage
Mirroring automatically attempts to log you on to the selected machine. Verify your access by the resulting icon.
2.
If you have no access, the Logon dialog box will automatically appear. If you have monitor access or want to log on with
a different username, right-click the machine name and select Logon.
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 or select No to
continue without adding an activation code.
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.
NOTE:
If the login does not complete within 30 seconds, it is automatically canceled. If this timeout is not long enough
for your environment, you can increase it by adjusting the Communication Timeout on the Configuration tab
of the Management Console properties. Select File, Options, from the Management Console to access this
screen.
If your Storage Mirroring server is across a router or firewall, you may need to disable ICMP pings so that the
login process does not attempt to verify the availability of the server prior to logging in. Select File, Options,
from the Management Console to access this option.
8
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.
9
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.
Because the Text Client and Command Line Client use the same DTCL commands, all examples use the Text Client. For a
complete listing of the DTCL commands and the conventions used to document them, see the Storage Mirroring User’s Guide.
The Text Client
The Text Client is a full-screen, text-based client that can be run from a command prompt. It can manage and monitor Storage
Mirroring components on any platform regardless of the Text Client platform. The interface uses DTCL commands entered
one line at a time. The Text Client offers command line editing capabilities, such as backspace cursor movement and
forward/backward command history scrolling. All connection information is displayed in columnar text format on the screen.
Starting the Text Client
From a Windows client, select Start, Programs, Storage Mirroring, Linux Text Client or from a command prompt of any
client, type the command DTText.
NOTE:
The DTText command name is case-sensitive.
Using the Text Client
The Text Client is divided into three sections:
!
The top section displays source, connection, and statistical data. If specifying a command that requires output, like the
status command, the output is also displayed in this section.
!
The middle section is where the DTCL commands are entered.
!
The lower section displays the DTCL command that was entered with any resulting messages. In this section, the security
access granted is also displayed.
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
10
The Command Line Client
The Command Line Client can be run from a command prompt. It can manage and monitor Storage Mirroring components
on any platform regardless of the Command Line Client platform. The Command Line Client is run from the operating system
command line and the DTCL commands are run from the Storage Mirroring command line.
Starting and using the 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 is installed, type the command DTCL –i. A DTCL
Command prompt will appear and the commands can be entered from that prompt. Any resulting errors are immediately
displayed.
Interactive Entry
/usr/bin> dtcl -i
Command: login indy administrator ******* domain_name
User access level set to DT_FULL_ACCESS
Command:
!
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.
File Entry
/usr/bin> dtcl -f dtcl.txt
User access level set to DT_FULL_ACCESS
- List of rep sets CustomerData
enabled
/usr/bin>
DTCL.TXT Used in File Entry
login indy administrator password domain_name;
source indy;
repset list;
!
Single Line Entry—Determine all of the DTCL commands you want to run and enter them in a single line at the command
prompt where Storage Mirroring is installed. For example, you might use the following command to log on to a machine
and display its replication sets.
Single Line Entry
/usr/bin>dtcl login indy administrator password; source indy; repset list
User access level set to DT_FULL_ACCESS
- List of rep sets CustomerData
enabled
/usr/bin>
11
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.
!
DT_Full_Access—You have administrator rights to the selected Storage Mirroring machine.
!
DT_Monitor_Only_Access—You have monitor rights to the selected Storage Mirroring machine.
!
DT_No_Access—You do not have any rights to the selected Storage Mirroring machine.
You can also verify your access at the top of the Text Client screen depending on the commands you have entered and the
information displayed in the upper half of the screen.
Storage Mirroring version 4.3
Source Machine: indy
Access Level: FULL)
================================================================================
Command: login indy administrator ******** domain_name
================================================================================
User access level set to DT_FULL_ACCESS
>source indy
If you have monitor access or no access and want to log on as the administrator, use the login command. Log off of a machine
by using the logout command. Both commands are outlined on the following page.
Command
LOGIN
Description
Log on to a Storage Mirroring machine
Syntax
LOGIN <machine> <username> <password> [domain]
Options
!
machine—Name of the machine
!
username—Name of the user
!
password—Password associated with username.
!
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.
Examples
login indy administrator ******
Notes
!
The login command is not available when scrolling through the Text Client command history.
!
Options that contain non-alphanumeric characters must be enclosed in quotation marks.
!
The password cannot be a Storage Mirroring keyword. These are any DTCL command (source,
target, and so on.) or any DTCL shortcut command (env, mon, rep, and so on).
Command
LOGOUT
Description
Logs off of a Storage Mirroring machine
Syntax
LOGOUT <machine>
Options
machine—Name of the machine
Examples
logout indy
Notes
Machine names that contain non-alphanumeric characters must be enclosed in quotation marks.
12
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.
!
You can also type DTCL help to display the DTCL commands and their syntax.
Exiting the text clients
To exit the Storage Mirroring Text Client and Command Line Client, type the exit or quit command.
Command
EXIT
Description
Exits the Text Client and the Command Line Interactive client
Syntax
EXIT
Command
QUIT
Description
Quits the Text Client and the Command Line Interactive client
Syntax
QUIT
13
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. In the Connection Wizard, you specify:
!
Source—The machine containing the data to protect. This is your production server.
!
Target—The machine to receive the data from the source. This is your backup server.
!
Replication Set—The data to be protected.
!
Target Location—The location on the target machine to store the data.
!
Advanced Options—The Connection Wizard allows you to open the Connection Manager to set advanced options.
1.
In the Storage Mirroring Management Console, select Tools, Connection Wizard.
NOTE:
In order for the Connection Wizard menu option to be available, you must have a source or target
highlighted in the left pane of the Management Console. You do not need to be logged on to the machine.
If the Storage Mirroring Servers root is highlighted, the Connection Wizard option will not be available.
At any time while using the Connection Wizard, select Back to return to previous screens and review
your selections.
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. If the logon is not successful, the Logon dialog box will appear
prompting for your security identification.
If you highlighted a target in the Management Console, the target will already be selected. If it is not, select the Storage
Mirroring target. This is your backup machine that will receive the data from the source. Click Next to continue.
NOTE:
Storage Mirroring will automatically attempt to log on to the selected target using the identification of the
user logged on to the local machine. If the logon is not successful, the Logon dialog box will appear
prompting for your security identification.
14
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. Mark the check box of the volumes and/or directories you wish to protect. Click Next to
continue.
7.
Select the location on the target machine where the data will be stored.
!
Send all data to a single path on the target—This option sends all selected volumes and directories to the default
location:
/source_name/replication_set_name/
!
Send all data to the same path on the target—This option sends all selected volumes and directories to the same
directories on the target machine. For example, c:\data and d:\files on the source will go to c:\data and
d:\files, respectively, on the target.
!
Custom—To select a custom path, click once in the Target Path field and modify the drive and directory to the
desired location.
8.
Click Next to continue.
9.
Review your selections on the summary screen.
15
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. Click Back
if you need to return to the replication set selection.
The Connection Wizard will close, the connection will be established, and mirroring and replication will begin. To
view your connection, highlight the source machine in the left pane of the Management Console. The active
connection is displayed in the right pane of the Management Console. For detailed information on the Management
Console statistics that are available for an established connection, see the Storage Mirroring User’s Guide.
!
If you want to set advanced options, click Advanced Options. The Connection Wizard will close and the Storage
Mirroring Connection Manager will open. The Servers tab will be completed. To set advanced settings, select a tab
in the Connection Manager and reference the chapter in the Storage Mirroring User’s Guide that corresponds to the
tab name.
16
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.
!
Highlight a replication set and then drag and drop the replication set to a target machine on the right pane of the
Management Console.
The Connection Manager opens to the Servers tab.
2.
Some entries on the Servers tab will be completed depending on which method you used to access it. For example, if
you entered the Connection Manager by right-clicking on a replication set, the name of the replication set will be
displayed in the replication set field.
3.
Verify the correct source machine and replication set were selected from the Management Console. If they are not, use
the Source Server and Replication Set fields to identify the source machine and replication set for which you want to
establish the connection.
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. The Route field
will automatically populate with Throughput Diagnostics Utility (TDU). For detailed information on
statistics logging, see the Storage Mirroring User’s Guide.
5.
Select the target path, which corresponds to the desired location on the target where the replicated data will reside, by
selecting One-to-One or All-to-One. If you want to specify a custom location, select either of the radio buttons and
then click on the directory entry under the Target Path column. You will be in edit mode and can specify the desired
location on the target for the replicated data.
6.
If you want mirroring and/or replication to start immediately when the connection is established, mark either or both of
the two check boxes at the bottom of the Servers tab.
NOTE:
7.
Other tabs are available in the Connection Manager to set advanced connection settings. To establish a
connection, you do not need to make modifications to these tabs; a connection can be established with
the default settings. For more information, see the Storage Mirroring User’s Guide.
Click Connect to establish the connection.
17
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 <machine> <username> <password> [domain]
Options
!
machine—Name of the machine
!
username—Name of the user
!
password—Password associated with username.
!
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.
Examples
login indy administrator ******
Notes
!
The login command is not available when scrolling through the Text Client command history.
!
Options that contain non-alphanumeric characters must be enclosed in quotation marks.
!
The password cannot be a Storage Mirroring keyword. These are any DTCL command (source,
target, and so on.) or any DTCL shortcut command (env, mon, rep, and so on).
2.
Log on to the Storage Mirroring target machine. This is the machine that will receive the data and possibly stand in for
the source machine. Log on by using the login command.
3.
Specify your Storage Mirroring source machine by using the source command.
4.
Command
SOURCE
Description
Identifies a machine as the active source machine
Syntax
SOURCE <source_machine>
Options
source_machine—Name of the machine
Examples
source indy
Notes
Machine names that contain non-alphanumeric characters must be enclosed in quotation marks.
Create a new replication set using the repset create command.
Command
REPSET CREATE
Description
Creates a replication set
Syntax
REPSET CREATE <name>
Options
name—Name of the replication set
Examples
!
!
Notes
repset create “Customer Data”
repset create marketing
!
Replication set names that contain non-alphanumeric characters must be enclosed in quotation
marks.
!
If the name of the replication set is the same as a word used in a DTCL command (for example,
repset create repset), you will receive an error. If you want to use a word like this, you
must enclose it in quotation marks (repset create “repset”).
18
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.
Syntax
REPSET RULE ADD <path> [INCLUDE|EXCLUDE][, RECURSIVE|NONRECURSIVE][TO
<repset>]
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
!
RECURSIVE—All subdirectories and files are recursively included or excluded
!
NONRECURSIVE—All subdirectories and files are non-recursively included or excluded
!
repset—Name of the replication set
Examples
repset rule add /var/spool/customerDB to “Customer Data”
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.
!
Options that contain non-alphanumeric characters must be enclosed in quotation marks.
!
Verify what files can be included by reviewing Replication Capabilities in the Storage Mirroring User’s
Guide.
6.
Repeat the repset rule add command to define all of the data to be protected.
7.
If you make an error when creating a replication set, use the repset rule remove command.
8.
Command
REPSET RULE REMOVE
Description
Removes a rule from a replication set
Syntax
REPSET RULE REMOVE <path> [FROM <repset>]
Options
!
path—Volume, directory, wild card, and/or file name
!
repset—Name of the replication set
Examples
repset rule remove /var/spool/customerDB from “Customer Data”
Notes
!
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.
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
!
repset display
repset display “Customer Data”
!
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.
19
9.
After you have added all of the rules, save the replication set by using the repset save command.
Command
REPSET SAVE
Description
Saves all replication set rules for the currently selected source
Syntax
REPSET SAVE
10. Connect the repset to the target by using the connect command.
Command
CONNECT
Description
Establishes a connection between a replication set and a target machine
Syntax
CONNECT <repset> TO <target_machine> MAP EXACT | BASE <target_path> |<source_path> TO
<target_path> [,...] [MIRROR | NOMIRROR] [, REPLICATE | NOREPLICATE]
[, MONITOR | NOMONITOR][, ORPHANS | NOORPHANS]
Options
!
!
repset—Name of the replication set
target_machine—Name of the target machine, an IP address on the target machine, or a virtual IP
address
!
MAP EXACT—Specifies that the replication set data will be sent to the same logical volume on the
target
!
MAP BASE—The replication set data will be sent to the locations specified below:
!
connect repset to target—If mappings are not specified with the command, map base
will be used by default. The data will be replicated to /SrcName/RepsetName/SrcVolName
on the target machine
!
connect repset to target 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
!
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
!
...—Indicates that the source_path TO target_path option can be used more than once for each
source directory in the replication set
Examples
Notes
!
MIRROR—Automatically initiates a mirror when the connection is established
!
NOMIRROR—Does not initiate a mirror when the connection is established
!
REPLICATE—Automatically initiates replication when the connection is established
!
NOREPLICATE—Does not initiate replication when the connection is established
!
MONITOR—Specifies that the target is going to monitor the specified source machine for failover.
The source machine must have already been defined as a monitor machine.
!
NOMONITOR—Specifies that the target is not going to monitor the source machine for failover
!
ORPHANS—Removes orphan files on the target
!
NOORPHANS—Does not remove orphan files on the target
!
!
connect “Customer Data” to jersey map exact
connect marketing to jersey map base /home/username
!
The default settings for this command are mirror, replicate, nomonitor, and noorphans.
!
Options that contain non-alphanumeric characters must be enclosed in quotation marks.
Your Storage Mirroring connection is now established. To configure advanced options for a connection, see the Storage
Mirroring User’s Guide.
20
Download PDF
Similar pages