HP StorageWorks Enterprise File Services Remote Copy Utility 2.1.
Legal and notice information © Copyright 2006 Hewlett-Packard Development Company, L.P. © Copyright 2003–2006 Riverbed Technology, Inc. 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.
Introduction CONTENTS Contents ........................................................................................................... 3 About This Guide.................................................................................. Types of Users ................................................................................ Organization of This Guide ............................................................ Document Conventions ................................................................
Transparently Prepopulating CIFS Data ............................................. 19 Monitoring Data.................................................................................. 20 Restricting Clients............................................................................... 21 Creating Log Files............................................................................... 21 Additional RCU Features.................................................................... 21 Specifying Time Limits ...
INTRODUCTION Introduction In This Introduction Welcome to the HP StorageWorks Enterprise File Services Remote Copy Utility Reference Manual. Read this introduction for an overview of the information provided in this guide and for an understanding of the documentation conventions used throughout.
A comprehensive index directs you to areas of particular interest. Document Conventions 4 This manual uses the following standard set of typographical conventions to introduce new terms, illustrate screen displays, describe command syntax, and so forth. Convention Meaning italics Within text, new terms and emphasized words appear in italics.
Hardware and Software Dependencies The following table summarizes the hardware, software, and operating system requirements for the HP EFS RCU. Hardware Requirements Software Requirements Operating System Requirements HP EFS Remote Copy Utility • Windows machines, UNIX servers running a Common Internet Filing System (CIFS) server, and Network Attached Storage (NAS) filers to be data sources and targets, when you specify a Universal Naming Convention (UNC) or mapped drive path.
HP StorageWorks Enterprise File Services WAN Accelerator Manager User Guide describes how to install, configure, and administer a network made up of multiple HP EFS WAN Accelerators using the HP StorageWorks Enterprise File Services WAN Accelerator Manager.
Contacting HP This section describes how to contact HP. Telephone numbers for worldwide technical support are listed on the following HP web site: http://www.hp.com/support. From this web site, select the country of origin. For example, the North American technical support number is 800-633-3600. NOTE: For continuous quality improvement, calls may be recorded or monitored.
8 INTRODUCTION
In This Chapter The HP EFS Remote Copy Utility This chapter provides an overview of the HP EFS Remote Copy Utility (HP EFS RCU). It contains the following sections: “Overview,” next “Features” on page 10 Overview The HP EFS RCU is a command-line utility that runs on Windows 2000 or later operating systems. You install the HP EFS RCU on a Windows client and server that communicate over a Wide Area Network (WAN).
As shown in Figure 1-1 the HP EFS RCU can be used to transparently prepopulate data from the server at the data center, to the HP EFS WAN Accelerator at the remote site. Thus, when clients at the remote site access data, they can observe LAN-like performance. Figure 1-1. HP EFS RCU Deployment Features With the HP EFS RCU running on the client and server, you can perform the following actions: 10 Data Transfer.
Figure 1-2. Transparent Prepopulation Static Backup. With the HP EFS RCU, when a scheduled static backup window occurs, because the data is already prepopulated in the HP EFS WAN Accelerators (using the transparent prepopulation feature), only new and modified data is transported to the backup site. Static backup allows enterprise customers to reduce their backup windows. Proxy File Service (PFS). The HP EFS RCU can be run in concert with PFS, an optional feature on the HP EFS WAN Accelerator.
12 1 - THE HP EFS REMOTE COPY UTILITY
In This Chapter Installing and Using the RCU This chapter describes how to install the HP EFS Remote Copy Utility (RCU). It also describes how to copy, mirror, monitor and perform transparent prepopulation of data across the Wide Area Network (WAN). It contains the following sections: “Installing the RCU,” next “Upgrading from RCU 2.1 to 2.1.
The installer places the binary in the C:\Program Files\RCU directory and creates a standard Windows service on your machine. The installer adds this directory to your path environment variable. Within this directory the installer places two sample configuration files, r_client.cfg and r_server.cfg. You can use these files to set the program parameters for the RCU (for example, read timeout). For the CLI command to use these configuration files, please see “/configfile” on page 32.
The following section describes how to run the RCU from the Command-Line Interface (CLI). To run the RCU from the command-line interface 1. On the server, start a command window. 2. Move to the working directory on the server where you want to copy data. For example: cd e:\working 3. Start the RCU on the server. For example: rcu /server This command starts the server RCU process in the e:\working directory. 4. Alternately, on the client, start a command window. 5.
To schedule tasks for the RCU on a client 1. Select Start -> All Programs -> Accessories -> System Tools -> Scheduled Tasks to display the Scheduled Tasks dialog box. 2. Double-Click Add Scheduled Task to display the Scheduled Task Wizard. TIP: To modify an already scheduled task, double-click the task in the Scheduled Tasks dialog box. 3. In the Scheduled Task Wizard, select Browse. 4. Select Local Disk (C:) -> Program Files -> RCU -> RCU.exe. 5. Perform the steps in the Scheduled Task Wizard.
To start the RCU in server mode as a Windows service 1. Click Start ->Control Panel ->Administrative Tools ->Services to display the Services dialog box. 3. Click the Log On tab to enter the user name and password you want the service to use when you log in. IMPORTANT: The user must have write access to the PFS shares it specifies in order for the RCU to write to them. 4.
rcu /copy c:\data server1 client1_data In this example the RCU copies the c:\data directory on the client to the client1_data directory on the server (which is located in the RCU working directory on the server). IMPORTANT: Windows restricts many file names (including the path) to 255 characters. When you copy, mirror, or prepopulate data using the RCU, make sure your path and file names do not exceed 255 characters. For example: c:\temp\rcu\rcu.
rcu /server 4. On the client, start a command window. cd c:\build 6. Mirror the build directory to the server. For example: rcu /mirror c:\build server1 build1 In this example, after the operation, the contents of the build1 directory on the server (which is located in the RCU working directory) is synchronized with and reflects the c:\build directory on the client.
IMPORTANT: To specify the HP EFS WAN Accelerator for data warming you must use the HP EFS WAN Accelerator’s Primary IP address. If you do not use the Primary IP address, the HP EFS WAN Accelerator cannot effectively warm the data. In this example, the RCU client sends the files or directory in c:/data to the target HP EFS WAN Accelerator. Because data flows through both HP EFS WAN Accelerators, the data store on them is warm with the file data transmitted.
Restricting Clients To restrict clients 1. Move to the working directory on the server. For example: cd e:\working 2. At the command prompt, restrict clients. For example: rcu /server /allowclientip 10.0.0.100 /allowclientip Portola where /allowclientip specifies the IP address (in this example, 10.0.0.100) and / allowclientip specifies the client machine (Portola), that you want to allow access to. Creating Log Files The RCU can log actions to a file or set of files.
Specifying Time Limits The RCU client can be given a time limit for mirroring, copying, or transparently prepopulating data. A time limit can be useful when you want to limit data transfer usage to a certain time frame (for example, 2 hours after midnight) to control bandwidth usage. The following example illustrates the transparent prepopulation of the c:\data directory until the entire directory has been transferred, or 1 hour (that is, 3600 seconds) has passed, whichever comes first.
In This Chapter The HP EFS RCU Commands This chapter describes the HP EFS Remote Copy Utility (HP EFS RCU) CommandLine Interface (CLI) and its options. It contains the following sections: “Client Actions,” next “Client Options” on page 25 “Server Options” on page 26 “Monitoring Actions” on page 29 “Logging Options” on page 30 “Global Options” on page 31 Client Actions The following section describes the CLI commands that govern the client machine.
Parameters Specifies the local directory where the files are located. Specifies the server where you want to copy files. Specifies the server directory where you want to copy files. NOTE: This can be a complete path or UNC path if the /allowabspath is enabled on the server. To enable the /allowabspath command see, “/ allowabspath” on page 27. Example rcu /copy c:\data server1 client1_data /mirror Description Mirrors client and server directories.
Parameters Specifies the local directory where the files are located. Specifies the IP address of the HP EFS WAN Accelerator where you want to prepopulate the data store. You must specify the HP EFS WAN Accelerator Primary IP address, not the in-path IP address. rcu /prepop c:\data wa1 Client Options The following CLI options are available for the client commands.
Parameters Specifies the maximum number of connection attempts. /maxretrywait Description Specifies the maximum amount of time (in seconds) between connection attempts. The default value is 30 seconds. Syntax /maxretrywait Parameters Specifies the maximum number seconds to wait before the next connection attempt. /timeout Description Halt an operation after the time period specified. By default /timeout is not enabled.
/allowabspath Allows the client to specify a destination drive as a complete path with drive letters or using the UNC path. Syntax /allowabspath Parameters None Example On the server: rcu /server /allowsabspath On the client: rcu /copy data server C:\private\data or rcu /copy data server \\server2\data /allowclientip Description Allows connections from a given client. Syntax /allowclientip [ /allowclientip ] Parameters Specifies the client machine name or IP address.
/server Description Run the HP EFS RCU in server mode. Syntax /server Parameters None Example rcu /server /serverdebug 28 Description If running in server mode, stops the HP EFS RCU after the first client is processed.
Monitoring Actions “/monitor,” next “/monitoridlewait” on page 29 “/monitormaxwait” on page 29 /monitor Description Waits for changes in the local directory, then performs the specified client actions. Syntax /monitor Parameters Example Specifies the monitoring actions you want to perform on the client machine.
Parameters Example Specifies the maximum time period to wait before performing the specified client action. The default value is 300 seconds. rcu /monitor /monitoridlewait 10 /monitormaxwait 300 /mirror c:\build server1 build1 Logging Options The following section describes the logging CLI commands.
/logfilename Specifies a name of a log file. The default file name is rcu.log. Syntax /logfilename Parameters Example Specifies the name of the log file. rcu /server /logfilename mylog.txt /logfilenum Description Specifies the maximum number of log files to keep. The default value is 10. Syntax /logfilenum Parameters Example Specifies the number of log files to keep.
“/compareacls,” next “/configfile” on page 32 “/port” on page 33 “/readtimeout” on page 33 “/recvbuf” on page 33 “/sendbuf” on page 33 /compareacls Description For two files that are the same except for their security descriptors, the HP EFS RCU recognizes them as different and mirrors them from the client to the server. If the / compareacls option is not specified, the HP EFS RCU recognizes the files as the same and does not mirror them.
/port Specifies the TCP port that the server is listening on. Syntax /port 3 - THE HP EFS RCU COMMANDS Description Parameters Specifies the port number. /readtimeout Description TCP read timeout value in seconds. The default value is 10800 seconds. Syntax /readtimeout Parameters None. /recvbuf Description Specifies the receive buffer size in bytes. The default value is 65536 bytes. Syntax /recvbuf Parameters Specifies the receive buffer size.
34 3 - THE HP EFS RCU COMMANDS
Symbols /allowabspath 27 /allowclientip 27 /compareacls 32 /configfile 32 /copy 23 /denyclientip 27 /excludepath 25 /logfile 30 /logfilemax 30 /logfilename 31 /logfilenum 31 /maxretries 25 /maxretrywait 26 /mirror 24 /monitor 29 /monitoridlewait 29 /monitormaxwait 29 /port 33 /prepop 24 /quiet 31 /readtimeout 33 /recvbuf 33 /sendbuf 33 /server 28 /serverdebug 28 /timeout 26 /verbose 31 C Client actions 23 Client options 25 Configuration files 14 contacting HP 7 Copying data 17 D Data transfer, overview 10 D
Reference books, related 5 Related reading 6 Restricting clients 21 S Scheduling tasks 15 Server actions 26 Software dependencies 5 Static backup, overview 11 T Tasks, running scheduled 15 Time limits, specifying 22 Transparent prepopulation, overview 11 Transparently prepopulating data 19 U Users, types of 3 W Wild cards, specifying 22 Windows file names 18 Windows service, starting and stopping 17 36 INDEX
