Page 1
T ivo l i Storage Manager for SAN ® for AIX Version 5.4 Storage Agent User’s Guide SC32-0129-00...
Page 3
T ivo l i Storage Manager for SAN ® for AIX Version 5.4 Storage Agent User’s Guide SC32-0129-00...
Page 4
“Notices,” on page 53. Fifth Edition (January 2007) This edition applies to Version 5.4 of IBM Tivoli Storage Manager for SAN for AIX (program numbers 5608-HSM, 5608-ISM, 5608-ISX, 5608-SAN, and 5608-ARM) and to any subsequent releases until otherwise indicated in new editions or technical newsletters.
Changes for IBM Tivoli Storage Manager Version 5 ..xiii Changes for IBM Tivoli Storage Manager Version 5 Release 4 — January 2007 . Changes for IBM Tivoli Storage Manager Version 5 Release 3 —...
Page 6
IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide...
It provides: v An overview of LAN-free data transfer v Detailed explanations for installing, configuring, and using the IBM Tivoli Storage Manager (Tivoli Storage Manager) client and storage agent, and the Tivoli Storage Manager server...
Storage Manager and tells you where to look for more information about Tivoli Storage Manager products. IBM Tivoli Storage Manager Publications This section lists publications in the IBM Tivoli Storage Manager library and related documents. It also describes how to access Tivoli publications online and how to order Tivoli publications.
Page 9
IBM Tivoli Storage Manager for Databases: Data Protection for Microsoft SQL Server Installation and User’s Guide IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for Windows Installation and User’s Guide...
Web browser, open the infocenter.html file. The file is in the appropriate publications directory on the product CD. IBM posts publications for this and all other Tivoli products, as they become available and whenever they are updated, to the Tivoli software information center Web site.
Page 11
Searching knowledge bases If you have a problem with your IBM software, begin by searching the available knowledge bases to determine whether the resolution to your problem is already documented. Search the information center on your local system or network: IBM Tivoli Storage Manager provides an information center on a CD.
Page 12
– Online: Go to the Passport Advantage Web page (www.lotus.com/services/ passport.nsf/WebDocs/ Passport_Advantage_Home) and click How to Enroll – By phone: For the phone number to call in your country, go to the IBM Software Support Web site (http://techsupport.services.ibm.com/guides/ contacts.html) and click the name of your geographic region.
Submit your problem to IBM Software Support: You can submit your problem in one of two ways: v Online: Go to the ″Submit and track problems″ page on the IBM Software Support site (http://www.ibm.com/software/support/probsub.html). Enter your information into the appropriate problem submission tool.
Page 14
IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide...
Manager server to quickly and easily format LAN-free-capable volumes dynamically when they are requested by the storage agent. For full details, refer to the IBM Tivoli Storage Manager for z/OS Administrator’s Guide and IBM Tivoli Storage Manager for z/OS Administrator’s Reference.
The following changes have been made to the product for this edition: LAN-free for z/OS IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide In Tivoli Storage Manager Version 5.3, the minimum I/O to a volume associated with a FILE device class is 256 KB, regardless how much data is being written to the volume.
Page 17
For full details, refer to the IBM Tivoli Storage Manager for z/OS Administrator’s Guide and IBM Tivoli Storage Manager for z/OS Administrator’s Reference. Product Packaging and Name Changes Product packaging and names for Tivoli Storage Manager have been updated.
Page 18
IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide...
Chapter 1. Storage Agent Overview IBM Tivoli Storage Manager for Storage Area Networks is a feature of Tivoli Storage Manager that enables LAN-free client data movement. This feature allows the client system to directly write data to, or read data from, storage devices attached to a storage area network (SAN), instead of passing or receiving the information over the network.
Page 20
Broken lines indicate movement of control information and metadata. The LANFREECOMMMETHOD option allows the storage agent to support several clients while installed on only one of the clients. IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide Client Library Control...
349X Tape Library Sharing” on page 6 for details regarding libraries. v Shared disk storage using a FILE library and the integration of Tivoli SANergy, IBM TotalStorage SAN File System or other supported file-sharing software. For current information about supported file-sharing software, see www.ibm.com/software/sysmgmt/products/...
LAN-free enabled and some sessions to the server for those volumes that are not LAN-free enabled. 5. The process repeats until all files in the list are restored. IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide...
You can install this library-manager server on any of the platforms listed. Full details on using the storage agent with z/OS and OS/390 are given in the IBM Tivoli Storage Manager for z/OS Administrator’s Guide and the IBM Tivoli Storage Manager for z/OS Administrator’s Reference.
Cluster environment. See the Redbook IBM Tivoli Storage Manager in a Clustered Environment for details on configuring the storage agent in an HACMP environment. ACSLS, SCSI and 349X Tape Library Sharing When Tivoli Storage Manager servers share an ACSLS, SCSI tape, or 349X storage device using a library manager and library clients, one server, the library manager, owns and controls the tape library device.
Page 25
Tivoli Storage Manager Clients with Storage Agents Tivoli Storage Manager Server Library Client Tape Library Figure 3. Library Manager and Client LAN-free Configuration Notes: 1. An environment can have a library manager without a library client. 2. In an environment where ACSLS library support is required, the library client can reside on a Tivoli Storage Manager server on AIX, Linux, HP-UX, Solaris, Windows, or z/OS.
Page 26
Tivoli Storage Manager server residing on an AIX, Solaris, or Windows operating system. v If your environment consists of an IBM 3494 tape library, the library manager server can be a Tivoli Storage Manager server residing on an AIX, HP-UX, Linux, Solaris, or Windows operating system.
File Device Sharing Using Tivoli SANergy Note: SANergy is just one option for file-sharing software. IBM TotalStorage SAN File System is another. For current information about supported file-sharing software, see www.ibm.com/software/sysmgmt/products/ support/IBMTivoliStorageManager.html. When Tivoli Storage Manager servers share access to disk storage, the environment contains a shared file device class (Tivoli Storage Manager server FILE device class) and utilizes the SANergy product.
Page 28
LAN-free data movement. The continued connection to the LAN provides a metadata (control information) path. If the storage agent is not available, the LAN provides a failover path for data backup and recovery. IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide...
Page 29
Data Owner Tivoli Storage Manager Client Storage Agent Library Client LAN-free Data Movement TCP/IP Communication Fibre Channel 3270 Communications-Library Control Commands Tape Drives 1 2 3 4 Figure 6. ACSLS Library Environment For detailed installation, configuration, and system administration of ACSLS, refer to the appropriate StorageTek documentation.
Manager Version 5.4.3 server example is an example only and is neither a promise nor guarantee that such a version will be released. This compatibility is subject to change at IBM’s discretion. Review the readme for a given server level for the latest information related to compatibility. Tivoli Storage Manager Version 5.4.0 servers will also support Version 5.3.4 and Version 5.3.5 storage...
LAN-free communications method (lanfreecommmethod client option): Circle the communications method you choose for the LAN-free data movement function. For more information, see the lanfreecommethod option in the IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User’s Guide.
Page 32
Drive 3 Drive 4 Shared disk Local path name: Enter the name of the local path to the network-mounted file system. For example, enter /shareddisk. Client node names IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide...
On the system where the storage agent is installed, use SMIT and issue the following commands to obtain information about tape devices. v For IBM devices: Select Devices -> Tape Drive -> List All Defined Tape Drives v For other devices: Devices ->...
Page 34
Specify the TCP/IP address for the machine where the storage agent is installed. - LANFREETCPPORT Specify the same TCP/IP port address as specified by the TCPPORT option in the storage agent options file, dsmsta.opt. IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide...
A shared ACSLS, SCSI, or 349X tape library. The storage agent can connect to either the library manager or a library client. v File device sharing using Tivoli SANergy or IBM TotalStorage SAN File System. For current information about supported file-sharing software, see www.ibm.com/software/sysmgmt/products/...
LAN-free backup and restore to disk in conjunction with your licensed use of the IBM Tivoli Storage Manager for Storage Area Networks product. See Figure 5 on page 9 for possible Tivoli SANergy configurations. See the IBM Tivoli SANergy Administrator’s Guide for details.
Tivoli Storage Manager Figure 7 shows the results of completing “Step 2.1 Client System: Installing Software” and “Step 2.2 IBM Tivoli Storage Manager Server: Defining the Storage Agent and Configuring Devices” on page 24. Use this figure as a reference point as you work through the steps in this section.
Page 38
API if not already installed on the system, or upgrade the software to the latest level as necessary. The latest levels can be downloaded from the IBM Tivoli Storage Manager Web site at www.ibm.com/software/sysmgmt/products/ support/IBMTivoliStorageManager.html. If you are using the storage agent to support multiple clients, you must install or upgrade the client and API software on each client that will be supported.
Page 39
1500 TCPPort 1502 TCPServeraddress tsmsrver.tucson.ibm.com Note: A TCPPORT of 1502 is used in the examples; however, the default TCPPORT is 1500. If a dsm.sys file does not exist in the directory specified by DSMI_DIR, create a symbolic link to the dsm.sys file in the Tivoli Storage Manager client installation directory.
Page 40
The Tivoli Storage Manager device driver is only required when you are using a SCSI device that is not covered by an IBM SCSI device driver. To decide whether to install the device driver package, refer to the support Web site (noted in “Where to Look for Information”...
Page 41
The command generates the following lines in the device configuration file for the storage agent: set staname storagnt SET STAPASSWORD xxxxxxx SET STAHLADDRESS agent.tucson.ibm.com DEFINE SERVER tsmsrver serverpassword=xxxxxxxxxxx HLADDRESS=tsmsrver.tucson.ibm.com LLADDRESS=1502 The passwords (shown as xxxxxxxxxxx) are encrypted in the file.
When you are connecting the storage agent to the library manager, follow these steps: IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide equal to YES. You set the server password by issuing the SET SERVERPASSWORD command from a Tivoli Storage Manager administrative command line.
Page 43
a. Define a shared ACSLS, SCSI, or 3494 library using the SHARED=YES option. b. Define paths to the library using the DEFINE PATH command on the server. c. Define drives that are associated with the library. d. Define paths to the drives using the DEFINE PATH command on the server. e.
Tivoli Storage Manager Client Workstation Storage Agent device name: /dev/mt1 Tape Library Drive Tivoli Storage Manager Server - TSMSRVER define drive sanlib1 drive1 define path tsmsrver drive1 srctype=server destype=drive library=sanlib1 device=/dev/mt6 define path storagnt drive1 srctype=server destype=drive library=sanlib1 device=/dev/mt1 Figure 8. Device information Tape Devices Define paths on the server using the device names as seen by the storage agent on each client system.
As a result, a delay may occur during startup processing. The storage agent also determines if the Tivoli Storage IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide...
Manager server is a library client or library manager. If the server is a library client, the storage agent attempts to define itself to the library manager if it is not known to the library manager. Step 5.2 Verify the LAN-free Configuration To verify that you have configured your system correctly for LAN-free data movement, perform the following procedure: 1.
Page 48
If the query finds entries in the activity log that relates to the storage agent, the client is using LAN-free data transfer. IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide...
Figure 9 on page 33 shows the results of completing “Step 2.1 Client System: Installing Software” on page 33 and “Step 2.2 IBM Tivoli Storage Manager Server: Defining the Storage Agent and Configuring Devices” on page 37. Use this figure as a reference point as you work through the steps in this section.
Install the client software and API if it is not already installed on the system, or upgrade the software to the latest level as necessary. The latest levels can be downloaded from the IBM Tivoli Storage Manager Web site at www.ibm.com/software/sysmgmt/products/ tsmsrver .tucson.ibm.com...
Page 52
DSMI_LOG points to the path for the dsierror.log file The following are examples on how to set up these environment variables. IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide TCPPORT is 1500.
Page 53
1500 TCPPort 1502 TCPServeraddress tsmsrver.tucson.ibm.com Note: A TCPPORT of 1502 is used in the examples; however, the default TCPPORT is 1500. If a dsm.sys file does not exist in the directory specified by DSMI_DIR, create a symbolic link to the dsm.sys file in the Tivoli Storage Manager client installation directory.
Page 54
SET STANAME storagnt SET STAPASSWORD xxxxxxx SET STAHLADDRESS agent.tucson.ibm.com DEFINE SERVER tsmsrver serverpassword=not4u HLADDRESS=tsmsrver.tucson.ibm.com LLADDRESS=1502 IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide Fileset Names tivoli.tsm.StorageAgent.rte tivoli.tsm.devices.aix5.rte64 tivoli.tsm.msg.xx_XX.devices tivoli.tsm.msg.xx_XX.server be running when the DSMSTA SETSTORAGESERVER command is issued.
Configuration File for the Storage Agent” on page 49 for details about these files. Step 2.2 IBM Tivoli Storage Manager Server: Defining the Storage Agent and Configuring Devices The following provides the instructions that you need to perform on the Tivoli Storage Manager server.
Page 56
Note: When you are using StorageTek 9840B tape devices with the z/OS d. Define the storage pool. For example: IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide data manager server, the FORMAT attribute of the device class must...
Page 57
define stgpool apoolname adeviceclassname pooltype=primary 5. If you are using a shared ACSLS library manager, define a path from the storage agent to the library manager. For example: define path storagnt libmgr1 srctype=server desttype=library If you are using an ACSLS-managed external library, define a path from the storage agent to the external manager.
LAN-free sessions will fail if the storage pool does not contain any formatted volumes and does not allow automatic formatting. For details, refer to the IBM Tivoli Storage Manager for z/OS Administrator’s Guide and IBM Tivoli Storage Manager for z/OS Administrator’s Reference.
Page 59
Determining Whether the Data Movement was LAN-free Use the following guidelines to help determine whether the data is moving on the LAN-free path: v Monitor the QUERY SESSION output against the node that is running the LAN-free backup. Review the bytes sent and bytes received. You can perform this action by using a Tivoli Storage Manager administrative command-line client to login to the Tivoli Storage Manager server and storage agent to verify that the proper sessions have been established.
Page 60
IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide...
SET STAHLAddress command that is inserted into the device configuration file. IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide server to the Tivoli Storage Manager server. a server to the Tivoli Storage Manager server.
LLADDRESS field of the DEFINE SERVER command. Examples Issue the DSMSTA SETSTORAGESERVER command with the following information: v Storage agent Name: storagnt Password: fun4me TCP/IP address: agent.tucson.ibm.com v Tivoli Storage Manager server Name: tsmsrver Password: not4u TCP/IP address: tsmsrver.tucson.ibm.com TCP/IP port: 1502 The command is: dsmsta setstorageserver myname=storagnt mypassword=fun4me myhladdress=agent.tucson.ibm.com...
The following options are also available, but not required: ADMINONClientport yes|no IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide The name of the device configuration file for the storage agent. A typical name for the file is devconfig.
Page 65
If the option is set to YES, or if the TCPPORT and TCPADMINPORT are the same value (the default), then the administrative sessions can use the TCPPORT. v NO If the option is set to NO, and if the TCPADMINPORT value is different than the TCPPORT value, then administrative sessions cannot use TCPPORT.
Page 66
STAMaxpooledsessions number TCPADMINPORT number THROUGHPUTDatathreshold kilobytes_per_second IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide Specifies whether the Tivoli Storage Manager SAN discovery function is enabled. When set to ON, the storage agent will perform SAN discovery in...
Typical contents of the device configuration file are as follows: SET STANAME storagnt SET STAPASSWORD fun4me SET STAHLADDRESS agent.tucson.ibm.com DEFINE SERVER tsmsrver serverpassword=not4u HLADDRESS=tsmsrver.tucson.ibm.com LLADDRESS=1502 In this example, storagnt is the name of the storage agent and tsmserver is the name of the Tivoli Storage Manager server.
Page 68
DEFINE SERVER Define the Tivoli Storage Manager server with which the storage agent communicates. IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide...
Page 70
Figure 10. Legacy ACSLS Data Migration Two methods to migrate data are: v Use the IBM Tivoli Storage Manager server MOVE DATA command. This method allows the legacy ACSLS data to move to a new storage pool without moving any expired files in the aggregates. For more information, see the Managing Storage Pools and Volumes section of the Administrator’s Guide.
The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us.
Page 73
Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Other company, product or service names may be trademarks or service marks of others. Appendix C. Notices...
Page 74
IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide...
Glossary The terms in this glossary are defined as they pertain to the IBM Tivoli Storage Manager library. If you do not find the term you need, refer to the IBM Software Glossary at www.ibm.com/ibm/terminology/. For a complete IBM Tivoli Storage Manager glossary, see the Administrator’s Guide.
Page 76
An IBM Tivoli Storage Manager server that controls device operations when multiple IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide IBM Tivoli Storage Manager servers share a storage device. The device operations include mount, dismount, volume ownership, and library inventory.
Page 77
The ordering is usually based on the speed and capacity of the devices that the storage pools use. In IBM Tivoli Storage Manager, the storage hierarchy is defined by identifying the next storage pool in a storage pool definition.
Page 78
IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide...
Page 80
29, 40 summary of changes to this product and publication xiii system requirements 12 IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide tape device information, obtaining 15 Tivoli Storage Manager API install 21, 34...
Page 82
Program Number: 5608-HSM 5608-ISM 5608-ISX 5608-SAN 5608-ARM Printed in USA SC32-0129-00...