IBM SC32-0129-00 User Manual
T
ivoli
®
Version 5.4
Storage Manager for SAN
for AIX
Storage
Agent User’s Guide
SC32-0129-00
T
ivoli
®
Version 5.4
Storage Manager for SAN
for AIX
Storage
Agent User’s Guide
SC32-0129-00
Note!
Before using this information and the product it supports, be sure to read the general information under Appendix C,
“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 since the December 2004 edition are marked with a vertical bar (|) in the left margin. Ensure that you are
|
using the correct edition for the level of the product.
|
Order publications through your sales representative or the branch office that serves your locality.
|
Your feedback is important in helping to provide the most accurate and high-quality information. If you have any
|
comments about this book or any other IBM Tivoli Storage Manager documentation, please see “Support
|
Information” on page viii.
|
© Copyright International Business Machines Corporation 2000, 2007. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
|
About This Book . . . . . . . . . . .v
| |
How to Use This Book . . . . . . . . . . .v
Where to Look for Information . . . . . . . .vi
IBM Tivoli Storage Manager Publications . . .vi
Tivoli Technical Training . . . . . . . . . viii
Support Information . . . . . . . . . . viii
Conventions Used in This Guide . . . . . .xi
Changes for IBM Tivoli Storage
Manager Version 5 . . . . . . . . . xiii
Changes for IBM Tivoli Storage Manager Version 5
|
Release 4 — January 2007 . . . . . . . . . xiii
||
Changes for IBM Tivoli Storage Manager Version 5
|
Release 3 — October 2005 . . . . . . . . . xiii
||
Changes for IBM Tivoli Storage Manager Version 5
Release 3 — December 2004 . . . . . . . . xiii
Changes for IBM Tivoli Storage Manager Version 5
Release 2—January 2004 . . . . . . . . . . xiv
Changes for IBM Tivoli Storage Manager Version 5
Release 2—June 2003 . . . . . . . . . . . xiv
Chapter 1. Storage Agent Overview . . .1
LAN-free Client Data Backup Scenario . . . . . .3
Multi-session No-Query Restore for LAN-free Path .4
Chapter 2. Planning . . . . . . . . . .5
Supported Operating Systems . . . . . . . .5
Types of Environments . . . . . . . . . . .5
ACSLS, SCSI and 349X Tape Library Sharing . .6
File Device Sharing Using Tivoli SANergy . . .9
External Libraries . . . . . . . . . . . .9
System Requirements . . . . . . . . . . .12
Configuration Information Worksheets . . . . .13
Obtain Device Information . . . . . . . .15
Client Node Information . . . . . . . . .15
Chapter 3. Installing and Configuring
Tape-Library and File-Device Sharing
Environments . . . . . . . . . . . .17
Overview of Installation and Configuration Tasks .17
Step 1. Verifying the Network Connection . . . .18
Step 2. Establishing Communications among Client,
Storage Agent, and Tivoli Storage Manager . . . .19
Step 2.1 Client System: Installing Software . . .19
Step 2.2 IBM Tivoli Storage Manager Server:
Defining the Storage Agent and Configuring
Devices . . . . . . . . . . . . . . .24
Step 3. Configuring Devices for the Storage Agent to
Access . . . . . . . . . . . . . . . .26
Tape Devices . . . . . . . . . . . . .27
Disk Devices . . . . . . . . . . . . .28
Step 4. (z/OS only) Formatting Volumes for
LAN-free Data Movement . . . . . . . . .28
Step 5. Starting the Storage Agent and Verifying the
LAN-free Configuration . . . . . . . . . .28
Step 5.1 Start the Storage Agent . . . . . .28
Step 5.2 Verify the LAN-free Configuration . . .29
Chapter 4. Installing and Configuring
External Library Environments . . . .31
Overview of Installation and Configuration Tasks .31
Step 1. Verifying the Network Connection . . . .32
Step 2. Establishing Communications and
Configuring the Client, Storage Agent, and Tivoli
Storage Manager Server . . . . . . . . . .32
Step 2.1 Client System: Installing Software . . .33
Step 2.2 IBM Tivoli Storage Manager Server:
Defining the Storage Agent and Configuring
Devices . . . . . . . . . . . . . . .37
Step 3. Starting the Storage Agent and Verifying the
LAN-free Configuration . . . . . . . . . .40
Step 3.1 Start the Storage Agent . . . . . .40
Step 3.2 Verify the LAN-free Configuration . . .40
Appendix A. Administration and
Configuration Reference . . . . . . .43
Starting and Stopping the Storage Agent . . . .43
Automating the Storage Agent Startup . . . .43
Manually Starting and Stopping the Storage
Agent . . . . . . . . . . . . . . .43
Adding Communication Information for the Storage
Agent . . . . . . . . . . . . . . . .44
Format . . . . . . . . . . . . . . .44
Parameters . . . . . . . . . . . . .44
Examples . . . . . . . . . . . . . .45
The Storage Agent Options File . . . . . . . .46
Required Options . . . . . . . . . . .46
Additional Options . . . . . . . . . . .46
The Device Configuration File for the Storage Agent 49
Appendix B. Legacy ACSLS Data
Migration and Coexistence . . . . . .51
Data Migration . . . . . . . . . . . . .51
Appendix C. Notices . . . . . . . . .53
Trademarks . . . . . . . . . . . . . .54
Glossary . . . . . . . . . . . . . .57
Index . . . . . . . . . . . . . . .61
© Copyright IBM Corp. 2000, 2007 iii
iv IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide
About This Book
This guide is for administrators who install and use the storage agent component
of the IBM® Tivoli® Storage Manager for Storage Area Networks product (referred
to as storage agent throughout this publication). 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
should be familiar with Tivoli Storage Manager, storage area network (SAN),
You
and AIX
while configuring the storage agent environment, refer to the list of Tivoli Storage
Manager publications in “Where to Look for Information” on page vi.
For information on the Internet about Tivoli Storage Manager, see
www.ibm.com/software/sysmgmt/products/
support/IBMTivoliStorageManager.html.
®
operating system administration. If you need additional information
How to Use This Book
If you have not installed and configured the storage agent before, the following
steps serve as a guide for the information in this book:
1. Confirm the type of environment in which you will be installing and
configuring the storage agent. There are three:
v ACSLS, SCSI, and 349X Tape Library sharing
|
|
|
|
v File device sharing using software such as Tivoli SANergy® or IBM
v External library (ACSLS-managed)
See
of environments.
2. Confirm that your configuration meets the system requirements. These
requirements are listed in “System Requirements” on page 12.
3. Having confirmed the environment and the system requirements, it is
recommended that you gather several pieces of client and server information
that will speed the installation and configuration of the storage agent.
Gather client and server information that will speed the installation and
configuration of the storage agent. Use the two forms in “Configuration
Information Worksheets” on page 13.
4. Finally, depending on the type of configuration you have, you will need to go
to either of two chapters:
v If you have a ACSLS, SCSI, or 349X Tape Library sharing or a file device
v If you have an external library configuration, go to Chapter 4, “Installing and
TotalStorage SAN File System. For current information about supported
file-sharing software, see www.ibm.com/software/sysmgmt/products/
support/IBMTivoliStorageManager.html.
“Types of Environments” on page 5 for complete descriptions of the types
sharing configuration, go to Chapter 3, “Installing and Configuring
Tape-Library and File-Device Sharing Environments,” on page 17.
Configuring External Library Environments,” on page 31.
© Copyright IBM Corp. 2000, 2007 v
Where to Look for Information
The following information describes the service that IBM provides for Tivoli
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.
IBM Tivoli Storage Manager Library
The following documents are available in theTivoli Storage Manager library:
Publication Title Order Number
IBM Tivoli Storage Management Products License Information GH09-4572
IBM Tivoli Storage Manager Messages SC32-0140
IBM Tivoli Storage Manager for AIX Administrator’s Guide SC32-0117
IBM Tivoli Storage Manager for AIX Administrator’s Reference SC32-0123
IBM Tivoli Storage Manager for AIX Installation Guide SC32-0134
IBM Tivoli Storage Manager Basic Concepts Poster SC32-9464
The following table lists Tivoli Storage Manager storage agent publications.
Publication Title Order Number
IBM Tivoli Storage Manager for SAN for AIX Storage Agent User’s
SC32-0129
Guide
IBM Tivoli Storage Manager for SAN for HP-UX Storage Agent User’s
SC32-0130
Guide
IBM Tivoli Storage Manager for SAN for Linux Storage Agent User’s
SC32-0131
Guide
IBM Tivoli Storage Manager for SAN for Sun Solaris Storage Agent
SC32-0132
User’s Guide
IBM Tivoli Storage Manager for SAN for Windows Storage Agent User’s
SC32-0133
Guide
The following table lists Tivoli Storage Manager client publications.
Publication Title Order Number
IBM Tivoli Storage Manager for Space Management for UNIX and Linux:
User’s Guide
IBM Tivoli Storage Manager for Macintosh: Backup-Archive Clients
Installation and User’s Guide
IBM Tivoli Storage Manager for NetWare: Backup-Archive Clients
Installation and User’s Guide
IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive
Clients Installation and User’s Guide
IBM Tivoli Storage Manager for Windows: Backup-Archive Clients
Installation and User’s Guide
vi IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide
SC32-0148
SC32-0143
SC32-0144
SC32-0145
SC32-0146
Publication Title Order Number
IBM Tivoli Storage Manager Using the Application Program Interface SC32-0147
The following table lists publications for application protection products.
Publication Title
IBM Tivoli Storage Manager for Application Servers: Data Protection for
Order
Number
SC32-9075
WebSphere Application Server Installation and User’s Guide
IBM Tivoli Storage Manager for Databases: Data Protection for Microsoft SQL
SC32-9059
Server Installation and User’s Guide
IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX
SC32-9064
and Linux Installation and User’s Guide
IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for
SC32-9065
Windows Installation and User’s Guide
IBM Tivoli Storage Manager for Databases: Data Protection for Informix
SH26-4095
Installation and User’s Guide
IBM Tivoli Storage Manager for Enterprise Resource Planning: Data Protection for
SC33-6341
mySAP Installation and User’s Guide for DB2
IBM Tivoli Storage Manager for Enterprise Resource Planning: Data Protection for
SC33-6340
mySAP Installation and User’s Guide for Oracle
IBM Tivoli Storage Manager for Hardware: Data Protection for EMC Symmetrix
SC33-6386
for R/3 Installation and User’s Guide
IBM Tivoli Storage Manager for Hardware: Data Protection for Enterprise Storage
SC32-9060
Server for DB2 UDB Installation and User’s Guide
IBM Tivoli Storage Manager for Hardware: Data Protection for FlashCopy Devices
GC32-1772
for Oracle Installation and User’s Guide
IBM Tivoli Storage Manager for Hardware: Data Protection for FlashCopy Devices
SC33-8208
for mySAP Installation and User’s Guide for DB2 UDB
IBM Tivoli Storage Manager for Hardware: Data Protection for FlashCopy Devices
SC33-8207
for mySAP Installation and User’s Guide for Oracle
IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Domino for
SC32-9056
UNIX, Linux, and OS/400 Installation and User’s Guide
IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Domino for
SC32-9057
Windows Installation and User’s Guide
IBM Tivoli Storage Manager for Mail: z/OS Edition Licensed Program
GC32-0838
Specifications
IBM Tivoli Storage Manager for Mail: Data Protection for Microsoft Exchange
SC32-9058
Server Installation and User’s Guide
Related IBM Publications
The following table lists related IBM products publications.
Title Order Number
IBM Magstar 3494 Tape Library Introduction and Planning Guide GA32-0279
IBM 3490E Model E01 and E11 User’s Guide GA32-0298
IBM Magstar MP 3570 Tape Subsystem Operator’s Guide GA32-0345
IBM TotalStorage Tape Device Drivers Installation and User’s Guide GC35-0154
About This Book vii
Title Order Number
IBM TotalStorage Enterprise Tape System 3590 Operator Guide GA32-0330
IBM Magstar 3494 Tape Library Dataserver Operator Guide GA32-0280
IBM TotalStorage Enterprise Tape System 3592 Operator Guide GA32-0465
||
||
IBM TotalStorage SAN File System Administrator’s Guide and Reference GA27-4317
IBM Tivoli SANergy Administrator’s Guide GC26-7389
Accessing Publications Online
The product CD contains the publications that are in the product library. The
format of the publications is PDF, HTML, or both. To access the publications using
a 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. Access the Tivoli software information center by first going to the Tivoli
software library at the following Web address:
http://www.ibm.com/software/tivoli/library/
Scroll down and click the Product manuals link. In the Tivoli Technical Product
Documents Alphabetical Listing window, click the <Tivoli Storage Manager> link
to access the product library at the Tivoli software information center.
Note: If you print PDF documents on other than letter-sized paper, set the option
in the File → Print window that allows Adobe Reader to print letter-sized
pages on your local paper.
Ordering Publications
You can order many Tivoli publications online at the following Web site:
www.elink.ibmlink.ibm.com/public/
applications/publications/cgibin/pbi.cgi
You can also order publications in the United States by calling 800-879-2755.
Tivoli Technical Training
For Tivoli technical training information, refer to the following IBM Tivoli
Education Web site:
http://www.ibm.com/software/tivoli/education
Support Information
This section describes the following options for obtaining support for IBM
products:
v “Searching knowledge bases” on page ix
v “Obtaining fixes” on page ix
v “Contacting IBM Software Support” on page ix
viii IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide
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. Yo u can run the
information center from the CD, or copy it to your local computer or an intranet
server. Yo u can use the search function of this information center to query
conceptual information, instructions for completing tasks, reference information,
and support documents.
Search the Internet: If you cannot find an answer to your question in the
information center, search the Internet for the latest, most complete information
that might help you resolve your problem. To search multiple Internet resources
for your product, go to the support web site for the product www.ibm.com/
software/sysmgmt/products/
support/IBMTivoliStorageManager.html and look for the section to search the
support knowledge base. From this section, you can search a variety of resources
including:
v IBM technotes
v IBM downloads
v IBM Redbooks
v Forums and newsgroups
™
Obtaining fixes
A product fix might be available to resolve your problem. Yo u can determine what
fixes are available for your IBM software product by checking the product support
Web site:
|
|
|
|
1. Go to the Tivoli Storage Manager support Web site (www.ibm.com/software/
sysmgmt/products/
support/IBMTivoliStorageManager.html).
2. From this page you can view all product downloads or search for specific fixes.
receive weekly e-mail notifications about fixes and other news about IBM
To
products, follow these steps:
1. From the support page for any IBM product, click My support in the
upper-right corner of the page.
2. If you have already registered, skip to the next step. If you have not registered,
click register in the upper-right corner of the support page to establish your
user ID and password.
3. Sign in to My support.
4. On the My support page, click Edit profiles in the left navigation pane, and
scroll to Select Mail Preferences. Select a product family and check the
appropriate boxes for the type of information you want.
5. Click Submit.
6. For e-mail notification for other products, repeat Steps 4 and 5.
more information about types of fixes, see the Software Support Handbook
For
(http://techsupport.services.ibm.com/guides/handbook.html).
Contacting IBM Software Support
IBM Software Support provides assistance with product defects.
About This Book ix
Before contacting IBM Software Support, your company must have an active IBM
software maintenance contract, and you must be authorized to submit problems to
IBM. The type of software maintenance contract that you need depends on the
type of product you have:
v For IBM distributed software products (including, but not limited to, Tivoli,
Lotus®, and Rational® products, as well as DB2® and WebSphere® products that
run on Windows® or UNIX® operating systems), enroll in Passport Advantage
®
in one of the following ways:
– 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 We b site (http://techsupport.services.ibm.com/guides/
contacts.html)
For IBM eServer
v
and click the name of your geographic region.
™
software products (including, but not limited to, DB2 and
WebSphere products that run in zSeries®, pSeries®, and iSeries™ environments),
you can purchase a software maintenance agreement by working directly with
an IBM sales representative or an IBM Business Partner. For more information
about support for eServer software products, go to the IBM Technical Support
Advantage Web page (http://www.ibm.com/servers/eserver/techsupport.html).
you are not sure what type of software maintenance contract you need, call
If
1-800-IBMSERV (1-800-426-7378) in the United States or, from other countries, go to
the contacts page of the IBM Software Support Handbook on the Web
(http://techsupport.services.ibm.com/guides/contacts.html) and click the name of
your geographic region for phone numbers of people who provide support for
your location.
Follow the steps in this topic to contact IBM Software Support:
1. Determine the business impact of your problem.
2. Describe your problem and gather background information.
3. Submit your problem to IBM Software Support.
Determine the business impact of your problem: When you report a problem to
IBM, you are asked to supply a severity level. Therefore, you need to understand
and assess the business impact of the problem you are reporting. Use the following
criteria:
Severity 1 Critical business impact: You are unable to use the program,
resulting in a critical impact on operations. This condition
requires an immediate solution.
Severity 2 Significant business impact: The program is usable but is
severely limited.
Severity 3 Some business impact: The program is usable with less
significant features (not critical to operations) unavailable.
Severity 4 Minimal business impact: The problem causes little impact on
operations, or a reasonable circumvention to the problem has
been implemented.
Describe your problem and gather background information: When explaining a
problem to IBM, be as specific as possible. Include all relevant background
information so that IBM Software Support specialists can help you solve the
problem efficiently. To save time, know the answers to these questions:
x IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide
v What software versions were you running when the problem occurred?
v Do you have logs, traces, and messages that are related to the problem
symptoms? IBM Software Support is likely to ask for this information.
v Can the problem be re-created? If so, what steps led to the failure?
v Have any changes been made to the system? (For example, hardware, operating
system, networking software, and so on.)
v Are you currently using a workaround for this problem? If so, please be
prepared to explain it when you report the problem.
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.
v By phone: For the phone number to call in your country, go to the contacts page
of the IBM Software Support Handbook on the Web (http://
techsupport.services.ibm.com/guides/contacts.html)
geographic region.
If the problem you submit is for a software defect or for missing or inaccurate
documentation, IBM Software Support creates an Authorized Program Analysis
Report (APAR). The APAR describes the problem in detail. Whenever possible,
IBM Software Support provides a workaround for you to implement until the
APAR is resolved and a fix is delivered. IBM publishes resolved APARs on the
IBM product support Web pages daily, so that other users who experience the
same problem can benefit from the same resolutions.
For more information about problem resolution, see “Searching knowledge bases”
on page ix and “Obtaining fixes” on page ix.
Conventions Used in This Guide
v Command to be entered on the AIX command line:
> dsmadmc
v Command to be entered on the command line of an administrative client:
query devclass
and click the name of your
About This Book xi
xii IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide
Changes for IBM Tivoli Storage Manager Version 5
This section summarizes changes that have been made to the Tivoli Storage
Manager product and this publication.
Changes for IBM Tivoli Storage Manager Version 5 Release 4 —
|
January 2007
|
|
|
|
|
|
|
|
Changes for IBM Tivoli Storage Manager Version 5 Release 3 —
|
October 2005
|
|
|
|
|
|
|
|
|
|
|
The following changes have been made to the product for this edition:
Query Disk Space in a FILE Device Class
The new command QUERY DIRSPACE lets you display the amount of
total and available disk space for each directory in a FILE device class.
For details, see the Administrator’s Reference.
General Updates
Updates based on the input of users have been made throughout the book.
The following changes have been made to the product for this edition:
General Updates
Updates based on the input of users have been made throughout the book.
Format volumes for z/OS LAN-free operations
For LAN-free operations, Tivoli Storage Manager previously required an
operation such as MOVE DATA or LAN-based backup to write data to the
tape so that it could be used from open systems. Yo u can continue to use
this method. However, with this release, you can configure Tivoli Storage
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.
Changes for IBM Tivoli Storage Manager Version 5 Release 3 — December 2004
The following changes have been made to the product for this edition:
General Updates
Updates based on the input of users have been made throughout the book.
Automated Cartridge System Library Software (ACSLS) Enhancements
ACSLS library sharing is available. See “ACSLS, SCSI and 349X Tape
Library Sharing” on page 6 for more information.
Multiple file system support for FILE device types
IBM Tivoli Storage Manager server improvements to sequential-access FILE
device type and random-access DISK device class storage requires that the
storage agent be able to access newly created FILE volumes. See “Disk
Devices” on page 28 for information.
© Copyright IBM Corp. 2000, 2007 xiii
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Minimum I/O to Volumes Associated with FILE Device Class
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. For example, if you are backing up one
500-byte object, it will take 256 KB of I/O to store it on the volume. In
terms of performance, the size of the I/O for a volume associated with a
FILE device class has the greatest impact when backing up or archiving a
large number of small objects (for example, small files or small directories).
To reduce the potential for performance degradation, you can increase the
size of aggregates created by the server. (An aggregate is an object that
contains multiple logical files that are backed up or archived from a client
in a single transaction.) To increase the size of aggregates, increase the
value of the TXNGROUPMAX option in the server options file
(dsmserv.opt) or increase the value of the TXNGROUPMAX parameter on
the REGISTER NODE or UPDATE NODE server commands. In addition to
increasing the TXNGROUPMAX value, you might also need to increase the
values for the following options:
v The client option TXNBYTELIMIT in the client options file (dsm.opt)
v The server options MOVEBATCHSIZE and MOVESIZETHRESH
For details about the server options and commands, refer to the
Administrator’s Reference. For details about the client option
TXNBYTELIMIT, refer to the Backup-Archive Clients Installation and User’s
Guide.
For certain tasks (for example, using content-management products,
|
|
|
|
|
|
|
Note:
using the DIRMC client option to store directory information, or
migrating very small files using the hierarchical space management
(HSM) client), you can minimize wasted space on storage volumes
in a FILE-type storage pool by specifying the NONBLOCK data
format when defining the storage pool. In most situations, however,
the NATIVE format is preferred.
Changes for IBM Tivoli Storage Manager Version 5 Release 2—January 2004
The following changes have been made to the product for this edition:
General Updates
Updates based on the input of users have been made throughout the book.
A new section for automating the storage agent startup has also been
added. See “Automating the Storage Agent Startup” on page 43 for more
information.
Changes for IBM Tivoli Storage Manager Version 5 Release 2—June 2003
The following changes have been made to the product for this edition:
LAN-free for z/OS
Tivoli Storage Manager now supports LAN-free data movement in storage
area network (SAN) environments on the z/OS® and OS/390® operating
systems. The z/OS or OS/390 server acts as the data manager for a client
that uses a storage agent See Chapter 2, “Planning,” on page 5 for an
xiv IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide
overview of this function. 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. See www.ibm.com/software/tivoli/solutions/storage/ for
complete details.
Configuration Information Worksheets
Client and server configuration information worksheets have been added
to the Planning chapter to aid the user in more quickly installing and
configuring the storage agent. See “Configuration Information Worksheets”
on page 13 for details.
Changes for IBM Tivoli Storage Manager Version 5 xv
xvi 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. Data movement is thereby off-loaded
from the LAN and from the Tivoli Storage Manager server, making network
bandwidth available for other uses. For instance, using the SAN for client data
movement decreases the load on the Tivoli Storage Manager server and allows it to
support a greater number of concurrent client connections. See Figure 1 on page 2.
The storage agent, a component of the feature, makes LAN-free data movement
possible.
The storage agent can support several clients while installed on only one of the
clients. You can install the storage agent on a client machine that shares storage
resources with the Tivoli Storage Manager server (Figure 1 on page 2) or on a
client machine that does not share storage resources but is connected to a client
machine that does share storage resources with the Tivoli Storage Manager server.
Figure 2 on page 2shows multiple clients connected to a client machine that
contains the storage agent. Yo u must specify the LANFREECOMMMETHOD
option in the client system options file (dsm.sys) to allow the client machine (that
shares storage resources) to communicate with the storage agent. A Tivoli Storage
Manager server, acting as a library manager, controls the storage devices. This
server may be the server working in conjunction with the storage agent or another
Tivoli Storage Manager server in the enterprise. The Tivoli Storage Manager server
keeps track of the metadata that the client has stored. The metadata, such as policy
information and file name and size, is passed over the LAN connection between
the storage agent and server.
© Copyright IBM Corp. 2000, 2007 1
Client
Storage Agent installed
Tivoli Storage Manager Server
Library Control
Client Metadata
LAN
Client
Data
Library
Control
SAN
File Library
Tape Library
Figure 1. SAN Data Movement. Solid lines indicate data movement. Broken lines indicate
movement of control information and metadata.
Client
Client
Client
Data
Library Control
Client Metadata
LAN
Tivoli Storage Manager Server
Client
with
Storage Agent
Client
Data
File Library
Figure 2. SAN Data Movement with the LANFREECOMMMETHOD option. Solid lines
indicate data movement. 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.
2 IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide
SAN
Library
Control
Tape Library
The storage agent communicates with the server to obtain and store database
information and to coordinate device and volume access. The server and client
coordinate and negotiate data access through the SAN. The client will use the
storage agent for operations where appropriate. For example, if a SAN path is
defined, the client (by means of the storage agent) transfers data on that path. If a
failure occurs on the SAN path, failover occurs and the client uses its LAN
connection to the Tivoli Storage Manager server and moves the client data over the
LAN.
There are cases when the storage agent can send the data directly to the server
using the LAN control paths between the storage agent and the server. An example
of this would be a LAN-free storage pool that is updated to read-only after the
client connects to the server and obtains its initial policy information. The storage
agent, instead of failing the operation, will send the data to the server, and,
providing that the storage hierarchy is configured so that the next storage pool
destination is available, the server will handle the operation. You can also prevent
data from transferring over the LAN by specifying the Tivoli Storage Manager
server parameters DATAREADPATH and DATAWRITEPATH with the REGISTER
NODE or UPDATE NODE commands for the desired node. These settings can be
reviewed by issuing the following command on the server for this node:
query node node_name format=detailed
Tivoli Storage Manager supports SAN-attached device sharing in one of the
following ways:
v Tivoli Storage Manager native library management support consisting of a
library manager and library clients or just a library manager. See “ACSLS, SCSI
and 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/
support/IBMTivoliStorageManager.html.
v External libraries as defined in the Administrator’s Guide in the appendix,
″External Media Management Interface Description.″
additional information about these configurations, see “Types of
For
Environments” on page 5.
LAN-free Client Data Backup Scenario
The following outlines a typical backup scenario for a Tivoli Storage Manager
client that uses SAN data movement:
1. The client begins a backup operation. The server reports policy information to
the client, including whether a destination is LAN-free. As the client assigns
policy settings for files during backup processing, it sends the data LAN-free
when the destination for that policy is LAN-free enabled.
A storage pool is a LAN-free destination when the storage pool uses a device
shared on a SAN. That device must also have a defined path between the
device and the storage agent.
2. The storage agent receives data for those files backed up by the client and
assigned to policy settings that use a LAN-free enabled storage pool. The
storage agent sends a request for a volume mount to the library manager
server. In the external library case, the storage agent contacts the external
library manager, using the provided path to the executable.
Chapter 1. Storage Agent Overview 3
3. A request is made to the storage device to mount the appropriate media.
4. The library manager notifies the storage agent of the location where the
mounted media resides. In the external library case, the storage agent is
informed of the device location by the external library manager.
5. The client, by means of the storage agent, writes the backup data directly to the
device over the SAN.
6. The storage agent sends metadata information to the Tivoli Storage Manager
server, and the server stores the information in its database.
Multi-session No-Query Restore for LAN-free Path
When performing a no-query restore, the Tivoli Storage Manager server builds a
list of files to restore and sends data to the client while continuing to build the list.
This allows the restore to be restarted if interrupted.
Multiple sessions are used for the no-query restore when data for the restore
resides on devices with a LAN-free path and devices with a LAN-only path. Some
sessions restore data from the server with a LAN-only path. The other sessions use
the storage agent to restore data over the LAN-free path. This works only with
clients at Version 4.2 or above.
Note that the number of sessions used for the restore is dependent on the value of
the client RESOURCEUTILIZATION option and the number of server volumes that
contain the client data to be restored.
The following outlines a typical multi-session no-query restore for a LAN-free
path:
1. The client requests a file space to be restored. This request is forwarded to the
server.
2. The server determines the files to restore and the volume on which those files
reside. The server generates a list, sorted by the volume name.
3. The client is informed of the progress and the number of volumes. The client
can start more sessions to restore the information.
4. The location of the volume, and whether or not the storage agent can access the
volume, will determine how the data is handled. When the volume can be
mounted on a shared device that the storage agent can access, the data is read
from the volume by the storage agent and sent to the client. When the volume
cannot be mounted on a shared device that the storage agent can access, the
data is read from the volume by the server and sent directly to the client. The
client then begins additional sessions: some to the storage agent for the
volumes that are 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.
4 IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide
Chapter 2. Planning
You can set up IBM Tivoli Storage Manager for Storage Area Networks in a
number of environments. Planning the system configuration provides a smooth
transition through system setup and into production. As part of your planning,
you need to identify the following:
v Which environment to implement.
v Devices to be used for LAN-free data movement.
v The clients that will use LAN-free data movement.
v The server that will manage particular clients’ data.
v The library used for the LAN-free enabled device. If the library is a Tivoli
Storage Manager shared library, you must identify the Tivoli Storage Manager
server that is the library manager. If the library is an externally managed library
using StorageTek ACSLS, you must identify the control point.
Supported Operating Systems
In addition to setting up the storage agent on AIX, you can set it up on the
following operating systems:
v Linux
v HP-UX
v Sun Solaris
v Windows
®
storage agents on the operating systems listed above can work in conjunction
The
with a Tivoli Storage Manager server on any of the platforms listed. In addition to
the platforms listed, the storage agent can also work in conjunction with a Tivoli
Storage Manager server on z/OS. However, you must install and configure another
server to function as the library manager or implement external library support
through an external library manager (for example, Gresham’s EDT-DistribuTAPE).
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.
Types of Environments
There are different types of configurations that take advantage of what can be
accomplished using a storage agent in a LAN-free environment. Your environment
is dependent upon the type of storage device you will be using for LAN-free data
storage. The following sections cover descriptions and planning considerations for
several typical LAN-free environments. These environments are:
v A shared ACSLS, SCSI, and 349X Tape Library
|
|
|
|
|
v A shared file device using 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/
support/IBMTivoliStorageManager.html.
v An External Library as defined in the Administrator’s Guide in the appendix,
″External Media Management Interface Description.″
© Copyright IBM Corp. 2000, 2007 5
|
|
|
v 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. The library manager operations include
checking volumes into and out of the library, labeling volumes, mounting and
dismounting volumes, auditing volumes, and tracking an inventory of library
contents. The storage agents, along with other Tivoli Storage Manager servers that
share this library, are considered library clients. As a library client, the storage agent
is able to store data and request drives, tapes, and volumes.
When the Tivoli Storage Manager server (data manager server) is also the library
manager for the devices where data is stored by the storage agent, then the storage
agent communicates requests to this Tivoli Storage Manager server. When the
Tivoli Storage Manager server (data manager server) is another library client, then
the storage agent communicates requests for itself or the metadata server directly
to the library manager.
Note that when using a shared ACSLS library, the library manager must be a Tivoli
Storage Manager server on AIX, Solaris, or Windows.
A library client requests shared library resources, such as drives or media, from the
library manager, but uses the resources independently. The library manager
coordinates the access to these resources. Data moves over the SAN between the
storage device and either the library manager or the library client. Either the
library manager or any library client can manage the LAN-free movement of client
data as long as the client system includes a storage agent.
In this library-sharing environment, the most important relationship is the one
between the server and the storage agent. The server, working in conjunction with
the storage agent, manages the storage hierarchy. The server could be a library
client or library manager, and it is responsible for:
v Migrations
v Expiration of files based on policy information
v Reclamation of free space on volumes and consolidation of the volumes
v Disaster recovery
storage agent contributes information to the storage hierarchy through various
The
operations, but this role is independent of the library sharing role.
The library manager and library client configurations are represented in Figure 3
on page 7 and Figure 4 on page 8.
6 IBM Tivoli Storage Manager for SAN for AIX: Storage Agent User’s Guide
Tivoli Storage Manager
Clients with Storage Agents
Tivoli Storage Manager
Server Library Manager
LAN
Tivoli Storage Manager
Server Library Client
SAN
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. The library manager must reside on a Tivoli Storage
Manager server on AIX, Solaris, or Windows.
The configurations in Figure 3 are the following:
v A Tivoli Storage Manager server library manager manages a client’s data, which
is stored on a tape library.
v A Tivoli Storage Manager server library client manages a client’s data, which is
stored on a tape library.
Chapter 2. Planning 7
Loading...