hit counter script
IBM TIVOLI SC32-0129-00 User Manual
IBM TIVOLI SC32-0129-00 User Manual

IBM TIVOLI SC32-0129-00 User Manual

For aix
Table of Contents

Advertisement

Quick Links

T ivo l i
Storage Manager for SAN
®
for AIX
Version 5.4
Storage Agent User's Guide
SC32-0129-00

Advertisement

Table of Contents
loading

Summary of Contents for IBM TIVOLI SC32-0129-00

  • 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.
  • Page 5: Table Of Contents

    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...
  • Page 7: About This Book

    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...
  • Page 8: Where To Look For Information

    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...
  • Page 10: Tivoli Technical Training

    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.
  • Page 13: Conventions Used In This Guide

    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...
  • Page 15: Changes For Ibm Tivoli Storage Manager Version 5

    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.
  • Page 16: Changes For Ibm Tivoli Storage Manager Version 5 Release 2-January 2004

    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...
  • Page 19: Chapter 1. Storage Agent Overview

    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...
  • Page 21: Lan-Free Client Data Backup Scenario

    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/...
  • Page 22: Multi-Session No-Query Restore For Lan-Free Path

    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...
  • Page 23: Changes For Ibm Tivoli Storage Manager Version

    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.
  • Page 24: Acsls, Scsi And 349X Tape Library Sharing

    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.
  • Page 27: File Device Sharing Using Tivoli Sanergy

    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.
  • Page 30: System Requirements

    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...
  • Page 31: Configuration Information Worksheets

    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...
  • Page 33: Obtain Device Information

    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...
  • Page 35: Chapter 3. Installing And Configuring Tape-Library And File-Device Sharing Environments

    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/...
  • Page 36: Step 1. Verifying The Network Connection

    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.
  • Page 37: Step 2. Establishing Communications Among Client, Storage Agent, And Tivoli Storage Manager

    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.
  • Page 42: Step 2.2 Ibm Tivoli Storage Manager Server: Defining The Storage Agent And Configuring Devices

    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.
  • Page 44: Step 3. Configuring Devices For The Storage Agent To Access

    Figure 8 on page 27 shows the results of completing this step. IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide...
  • Page 45: Tape Devices

    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.
  • Page 46: Disk Devices

    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...
  • Page 47: Step 5.2 Verify The Lan-Free Configuration

    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...
  • Page 49: Chapter 4. Installing And Configuring External Library Environments

    If you will be using a storage agent with external library support, you must have an external library manager capable of exploiting the external library interface as defined in the Administrator’s Guide in the appendix, ″External Media Management © Copyright IBM Corp. 2000, 2007...
  • Page 50: Step 1. Verifying The Network Connection

    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.
  • Page 51: Step 2.1 Client System: Installing Software

    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.
  • Page 55: Step 2.2 Ibm Tivoli Storage Manager Server: Defining The Storage Agent And Configuring Devices

    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.
  • Page 58: Step 3. Starting The Storage Agent And Verifying The Lan-Free Configuration

    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...
  • Page 61: Appendix A. Administration And Configuration Reference

    Certain storage pool attributes can result in failed requests rather than the desired LAN failover by the storage agent. If the storage agent accurately identifies a LAN-free destination, the LAN-free operation will most likely be successful. © Copyright IBM Corp. 2000, 2007...
  • Page 62: Adding Communication Information For The Storage Agent

    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.
  • Page 63: Examples

    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...
  • Page 64: The Storage Agent Options File

    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...
  • Page 67: The Device Configuration File For The Storage Agent

    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 69: Appendix B. Legacy Acsls Data Migration And Coexistence

    Figure 10 on page 52 displays the normal migration path from an old storage pool containing the data associated with the ACSLS library type to a new storage pool associated with an EXTERNAL library type and an ECARTRIDGE device class. © Copyright IBM Corp. 2000, 2007...
  • 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.
  • Page 71: Appendix C. Notices

    Web sites. The materials at those Web sites are not part of the materials for this IBM product, and use of those Web sites is at your own risk.
  • Page 72: Trademarks

    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...
  • Page 75: Glossary

    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 79: Index

    FILE library configuration considerations 9 disk devices 25 fixes, obtaining ix glossary 57 © Copyright IBM Corp. 2000, 2007 how to information: determine LAN-free data movement 29, 41 obtain device information 15 set up environment variables 21, 34 use this book v...
  • 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...

This manual is also suitable for:

Tivoli storage manager for san

Table of Contents