1.Tivoli Storage Manager for AIXVersion 5.5Administrators GuideSC32-0117-01

2. Tivoli Storage Manager for AIXVersion 5.5Administrators GuideSC32-0117-01 3. Note!Before using this information and the product it supports, be sure to read the general information under Appendix E,Notices, on page 831.Edition NoticeThis edition applies to Version 5.5 of the IBM Tivoli Storage Manager for AIX (product numbers 5608-HSM,5608-ISM, 5608-ISX, 5608-SAN, 5608-ARM) and to any subsequent releases until otherwise indicated in new editionsor technical newsletters.Changes since the previous edition are marked with a vertical bar ( | ) in the left margin. Ensure that you are usingthe correct edition for the level of the product.Order publications through your sales representative or the branch office serving your locality.Your feedback is important in helping to provide the most accurate and high-quality information. If you havecomments about this book or any other Tivoli Storage Manager documentation, please see Support Informationon page xv. Copyright International Business Machines Corporation 1993, 2007. All rights reserved.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp. 4. ContentsAbout this Publication . . . . . . . . xiii Monitoring the IBM Tivoli Storage ManagerIBM Tivoli Storage Manager Publications . . . . xiiiServer . . . . . . . . . . . . . . . 34 IBM Tivoli Storage Manager Library . . . . . xiiiWorking with a Network of IBM Tivoli Storage Related IBM Publications . . . . . . . .. xv Manager Servers . . . . . . . . . . .. 34 Accessing Publications Online . . .. . .. xv Exporting and Importing Data . . . . . . . 35Tivoli Technical Training . . . . . . . . .. xvProtecting IBM Tivoli Storage Manager and ClientSupport Information . . . . . . . . . .. xvData . . . . . . . . . . . . . . . .. 36 Searching knowledge bases . . . .. . .. xv Protecting the Server . . . . . . . . .. 36 Obtaining fixes . . . . . . . .. . . . xviManaging Servers with the Administration Center 37 Contacting IBM Software Support .. . . . xvi Using the Administration Center . . . . .. 37Conventions Used in This Guide . . .. . .xviiiFunctions not in the Administration Center . . . 39 |Protecting the Administration Center . . . . . 42Changes for Tivoli Storage ManagerVersion 5 . . . . . . . . . . . . . xixPart 2. Configuring and Managing| Technical Changes for Version 5 Release 5 Server Storage . . . . . . . . . . 45| November 2007 . . . . . . . . . . . . . xix Chapter 3. Introducing Storage Devices 47Part 1. IBM Tivoli Storage Manager How to Use the Server Storage Chapters . . . . 47Basics . . . . . . . . . . . . . . . 1 IBM Tivoli Storage Manager Storage Devices . . . 48 IBM Tivoli Storage Manager Storage Objects . . . 48Libraries . . . . . . . . . . . . . . 48Chapter 1. Introducing IBM Tivoli Drives . . . . . . . . . . . . . . .50Storage Manager . . . . . . . . . . . 3 Device Class . . . . . . . . . . . . .50How IBM Tivoli Storage Manager Stores Client Data 5 Library, Drive, and Device Class . . . . . .53Options for Data Protection . . . . . . . . 8 Storage Pool and Storage Pool Volume . . . .53How Data Moves to Server Storage . . . . . 14 Data Movers . . . . . . . . . . . . . 55Consolidating Backed-up Data for Clients . . . 15 Path . . . . . . . . . . . . . . . .55How the Server Manages Storage . . . . . . . 16 Server . . . . . . . . . . . . . . .55IBM Tivoli Storage Manager Device Support . . 16 IBM Tivoli Storage Manager Volumes . . . . . . 55Migrating Data through the Storage Hierarchy . 16 The Volume Inventory for an Automated Library 56Removing Expired Data . . . . . . . . . 17 Planning for Server Storage . . . . . . . . .57 Selecting a Device Configuration . . . . . . . 58Chapter 2. Getting Started with TivoliDevices on a Local Area Network . . . . . . 58Storage Manager . . . . . . . . . . 19Devices on a Storage Area Network . . . . . 58Interfaces to Tivoli Storage Manager . . . . . . 19 LAN-Free Data Movement . . . . . . . .60Customizing the Server with the Server Options File20 Network-attached Storage . . . . . . . .61Configuring and Managing Server Storage . . . .20How IBM Tivoli Storage Manager Mounts and Using Hard Disk Devices with IBM Tivoli Dismounts Removable Media . . . . . . . .63 Storage Manager . . . . . . . . . . . 21How IBM Tivoli Storage Manager Uses and Reuses Using Removable Media Devices with IBM Tivoli Removable Media . . . . . . . . . . . .64 Storage Manager . . . . . . . . . . . 21Configuring Devices . . . . . . . . . . .67 Using Tape Volumes . . . . . . . . . .22 Example: Mapping Devices to Device Classes . .68 Migrating Data from Disk to Tape . . . . . .22 Mapping Storage Pools to Device Classes and Managing Storage Pools and Volumes . . . .23 Devices . . . . . . . . . . . . . . . 68Using HACMP for Server Availability . . . . .24Managing Client Operations . . . . . . . . . 25Chapter 4. Using Magnetic Disk Managing Client Nodes . . . . . . . . . 25Devices . . . . . . . . . . . . . . 71 Managing Security . . . . . . . . . . . 26Configuring Disk Devices . . . . . . .. . 71 Implementing Policies for Client Data . . . . 27Requirements for Disk Subsystems . . .. . 71 Scheduling Client Operations . . . . . . .29Comparing Random Access and SequentialMaintaining the Server . . . . . . . . . . 32Access Disk Devices . . . . . . . . . . 73 Managing Server Operations . . . . . . .32Choosing Between Files and Raw Logical Automating Server Operations . . . . . . .32Volumes for Random Access Volumes . . . . 76 Managing the Database and Recovery Log . . .33 Copyright IBM Corp. 1993, 2007iii 5. Configuring Random Access Volumes on DiskDefine the Devices to IBM Tivoli Storage Devices . . . . . . . . . . . . . .. 77Manager . . . . . . . . . . . . . . 106 Configuring FILE Sequential Volumes on DiskCheck in and Label Library Volumes . . . .109 Devices . . . . . . . . . . . . . .. 77Using the Devices to Store Client Data . . . .110Varying Disk Volumes Online or Offline . . . .. 78 Sharing an IBM 3494 Library Among Servers . . .110Using Cache . . . . . . . . . . . . . . 79Setting up Server Communications . . . . .110Freeing Space on Disk . . . . . . . . . . . 79Set up the Device on the Server System and theSpecifying Scratch FILE Volumes . . . . . . . 80SAN . . . . . . . . . . . . . . . 110Using FILE Volumes for Database Backups and Setting up the Library Manager Server . . . . 111Export Operations . . . . . . . . . . . . 80Setting up the Library Client Servers . . . . 111Using the Devices to Store Client Data . . . .112Chapter 5. Attaching Devices to theMigrating an IBM 3494 Library to Control by aServer System . . . . . . . . . . . 81 Library Manager . . . . . . . . . . . .113 Sharing an IBM 3494 Library by Static PartitioningDevices Supported by Tivoli Storage Manager . . . 81 of Drives . . . . . . . . . . . . . . .114Attaching a Manual Drive . . . . . . . .. 81Set up the Device on the Servers . . . . . .114Attaching an Automated Library Device . . . . . 82Define the Devices to IBM Tivoli Storage Setting the Library Mode . . . . . . . . . 82Manager ASTRO . . . . . . . . . . . 114Installing and Configuring Device Drivers . . . . 83Define the Devices to Tivoli Storage Manager Drivers for IBM Devices . . . . . . . .. 83JUDY . . . . . . . . . . . . . . .116 Drivers for non-IBM Devices . . . . . .. 84 Configuring ACSLS-Managed Libraries . . . . .117 Determining Device Special File Names . . .. 85Set up the Device on the Server System . . .117 Installing Device Drivers for IBM SCSI TapeDefine the Devices to IBM Tivoli Storage Devices . . . . . . . . . . . . . .. 86Manager . . . . . . . . . . . . . . 117 Installing Device Drivers for IBM 349X Libraries 87Setting up the Library Manager Server . . . . 121 Configuring Tivoli Storage Manager DeviceSetting up the Library Client Servers . . . . 122 Drivers for Autochangers . . . . . . . . . 87Check In and Label Library Volumes . . . .123 Configuring Tivoli Storage Manager DeviceUsing the Devices to Store Client Data . . . .123 Drivers for Tape or Optical Drives . . . . . . 87 Configuring Removable File Devices . . . . . 123 Managing SCSI Devices and Fibre ChannelExample of Removable File Support . . . . . 124 Devices . . . . . . . . . . . . . .. 88Labeling Requirements for Optical and OtherRemovable Files Devices . . . . . . . . 125Chapter 6. Configuring Storage Devices 91Configuring Libraries Controlled by MediaDevice Configuration Overview . . . . . . . 92 Manager Programs . . . . . . . . . . . 125Mixing Device Types in Libraries . . . . . . . 92 Setting up Tivoli Storage Manager to Work with Mixing Different Media Generations in Libraries 93 an External Media Manager . . . . . . . 125 Mixed Media and Storage Pools . . . . . . 94 Managing Externally Controlled IBM TivoliServer Options that Affect Storage Operations . . . 94Storage Manager Media . . . . . . . . . 126Configuring SCSI Libraries used by One Server . . 95Using the Devices to Store Client Data . . . .127 Set up the Devices on the Server System. . . . 95 Configuring Manually Mounted Devices . . . . 127 Define the Devices to IBM Tivoli Storage Set up the Device on the Server System . . .127 Manager . . . . . . . . . . . . . . 95 Define the Device to IBM Tivoli Storage Check in and Label Library Volumes . . . . . 99Manager . . . . . . . . . . . . . . 128 Using the Devices to Store Client Data . . . . 100 Label Volumes . . . . . . . . . . . . 129Configuring SCSI Libraries Shared Among Servers Using the Devices to Store Client Data . . . .129on a SAN . . . . . . . . . . . . . . 100 Configuring IBM Tivoli Storage Manager for Setting up Server Communications . . . . . 100LAN-free Data Movement . . . . . . . . . 129 Set up the Device on the Server Systems and theValidating your LAN-free Configuration . . .130 SAN . . . . . . . . . . . . . . . 100 |Running SAN Discovery Functions for Non-root Setting up the Library Manager Server . . . . 101 |Users . . . . . . . . . . . . . . . 130 Setting up the Library Client Servers . . . . 102 Configuring IBM Tivoli Storage Manager for Using the Devices to Store Client Data . . . . 103NDMP Operations. . . . . . . . . . . . 131 Migrating DEFINE DRIVE and DEFINE PATHDefining Devices and Paths . . . . . . . . 131 Definitions to the Library Manager Server . . . 103Defining Libraries . . . . . . . . . . .132Configuring IBM 3494 Libraries . . . . . . . 103Defining Drives . . . . . . . . . . . 133 Categories in an IBM 3494 Library . . . . . 104Defining Data Movers . . . . . . . . .134 Upgrade Procedure for 3494 Libraries with Both Defining Paths . . . . . . . . . . . .134 3490 and 3590 Drives Defined . . . . . . . 105Recovering from Device Changes on the SAN . .136Configuring an IBM 3494 Library for Use by OneServer . . . . . . . . . . . . . . . . 105 Chapter 7. Using NDMP for Set up the Device on the Server System . . . 105 Operations with NAS File Servers. . 139iv IBM Tivoli Storage Manager for AIX: Administrators Guide 6. Requirements . . . . . . . . . . . . .139 Maintaining a Supply of Scratch Volumes . . .179Interfaces Used for NDMP Operations . . . . . 141 Maintaining a Supply of Volumes in a LibraryData Formats for Backup Operations Using NDMP 142 Containing WORM Media . . . . . . . .179Planning for NDMP Operations . . . . . . .142 Managing Volumes in Automated Libraries . . .180 Planning for Tape Libraries and Drives used in Changing the Status of a Volume . . . . . .181 NDMP Operations. . . . . . . . . . . 142 Removing Volumes from a Library . . . . .181 Determining Where to Attach the Tape Library Returning Volumes to a Library . . . . . . 181 Robotics When Backing Up to a Library Directly Managing a Full Library . . . . . . . . .181 Attached to the NAS Device . . . . . . . 142 Auditing a Librarys Volume Inventory . . . .182 Determining How to Use the Drives in the Maintaining a Supply of Scratch Volumes in an Library When Backing Up to a Library AttachedAutomated Library . . . . . . . . . .183 Directly to the NAS Device . . . . . . . . 147 Performing Operations with Shared Libraries183 Planning for File-Level Restore . . . . . .149 Managing Server Requests for Media . . . . . 184 Directory-Level Backup and Restore . . . . . 150 Using the Administrative Client for MountConfiguring Tivoli Storage Manager for NDMP Messages . . . . . . . . . . . . . . 185Operations . . . . . . . . . . . . . .150 Mount Operations for Manual Libraries . . .185 Step 1. Determining Location of NAS Backup 151 Handling Messages for Automated Libraries185 Step 2. Setting Up Tape Libraries for NDMP Requesting Information about Pending Operator Operations . . . . . . . . . . . . . 153 Requests . . . . . . . . . . . . . . 185 Step 3. Configuring Tivoli Storage Manager Replying to Operator Requests . . . . . .185 Policy for NDMP Operations . . . . . . . 155 Canceling an Operator Request . . . . . .186 Step 4. Registering NAS Nodes with the TivoliResponding to Requests for Volume Check-In 186 Storage Manager Server . . . . . . . . . 156 Determining Which Volumes Are Mounted . .187 Step 5. Defining a Data Mover for the NAS File Dismounting an Idle Volume . . . . . . . 187 Server . . . . . . . . . . . . . . . 156 Managing Libraries . . . . . . . . . . . 187 Step 6. Defining a Path to a Library . . . . . 157 Requesting Information About Libraries . . . 187 Step 7. Defining Tape Drives and Paths for Updating Libraries . . . . . . . . . . 188 NDMP Operations. . . . . . . . . . . 158 Deleting Libraries . . . . . . . . . . . 189 Step 8. Labeling Tapes and Checking Tapes into Managing Drives . . . . . . . . . . . .189 the Library . . . . . . . . . . . . .158 Requesting Information about Drives . . . .189 Step 9. Scheduling NDMP Operations . . . . 158 Updating Drives . . . . . . . . . . .189 Step 10. Defining Virtual File Spaces. . . . . 159 Using Drive Encryption . . . . . . . . . 190 Step 11. Tape-to-Tape Copy to Back Up Data 159 Cleaning Drives . . . . . . . . . . .191 Step 12. Tape-to-Tape Copy to Move Data . . .159 Deleting Drives . . . . . . . . . . . .195Backing Up and Restoring NAS File Servers Using Managing Paths . . . . . . . . . . . . 195NDMP . . . . . . . . . . . . . . .160 Requesting Information About Paths . . . . 195 Performing File-Level Restore . . . . . . .160 Updating Paths . . . . . . . . . . . . 196 Performing Directory-Level Backup and Restore161 Deleting Paths . . . . . . . . . . . . 196Performing NDMP Filer to Tivoli Storage Manager Managing Data Movers . . . . . . . . . . 196Server Backups . . . . . . . . . . . . .162 Requesting Information About Data Movers . . 196Managing NDMP Operations . . . . . . . .164 Updating Data Movers . . . . . . . . . 196 Managing NAS File Server Nodes . . . . . 164 Deleting Data Movers . . . . . . . . . 197 Managing Data Movers Used in NDMPHandling Tape Alert Messages . . . . . . . 197 Operations . . . . . . . . . . . . . 165 Dedicating a Tivoli Storage Manager Drive to Chapter 9. Defining Device Classes 199 NDMP Operations. . . . . . . . . . . 165 Defining and Updating Device Classes for Managing Storage Pools for NDMP Operations 165 Sequential Media . . . . . . . . . . . . 200 Managing Table of Contents . . . . . . . 166Defining and Updating Tape Device Classes . . 201 Defining and Updating 3592 Device Classes . . 205Chapter 8. Managing RemovableDefining and Updating GENERICTAPE DeviceMedia Operations . . . . . . . . . 167 Classes . . . . . . . . . . . . . . 208Preparing Removable Media . . . . . . . . 167Defining and Updating OPTICAL Device Labeling Removable Media Volumes . . . . 168Classes . . . . . . . . . . . . . . 208 Checking New Volumes into a Library . . .. 171Defining and Updating REMOVABLEFILE Special Considerations for WORM Tape Media 174Device Classes . . . . . . . . . . . .209Managing the Volume Inventory . . . . . . . 176Defining and Updating FILE Device Classes . . 210 Controlling Access to Volumes . . . . .. 176Defining and Updating LTO Device Classes . .214 Reusing Tapes in Storage Pools . . . . . . 177Defining and Updating SERVER Device Classes 216 Setting Up a Tape Rotation . . . . . . . . 177Defining and Updating VOLSAFE Device Reusing Volumes Used for Database Backups Classes . . . . . . . . . . . . . . 218 and Export Operations . . . . . . . .. 179Contentsv 7. Defining and Updating CENTERA DevicePlanning for and Enabling Collocation . . . .286Classes . . . . . . . . . . . . .. 219 Reclaiming Space in Sequential Access StorageRequesting Information about a Device Class . .. 221 Pools . . . . . . . . . . . . . . . . 288Deleting a Device Class . . . . . . . . .. 222How IBM Tivoli Storage Manager ReclamationHow Tivoli Storage Manager Fills Volumes . . . 223Works . . . . . . . . . . . . . . .289Using Data Compression . . . . . . . . 223Choosing a Reclamation Threshold . . . . . 291Tape Volume Capacity and Data Compression224Lowering the Reclamation Threshold . . . . 292Starting Reclamation Manually or in a Schedule 292Chapter 10. Managing Storage PoolsSpecifying the Number of Reclamationand Volumes. . . . . . . . . . . . 227Processes . . . . . . . . . . . . . .293Reclaiming Volumes in a Storage Pool with OneOverview: Storage Pools . . . . . . . . .. 228Drive . . . . . . . . . . . . . . .293Primary Storage Pool . . . . . . . . . . 228Reclamation of Tape Volumes with HighCopy Storage Pool. . . . . . . . . . . 229Capacity . . . . . . . . . . . . . . 294Active-data Pool . . . . . . . . . . . 229Reclamation of WORM Media . . . . . . .295An Example of Server Storage . . . . . . . 230Reclamation of Volumes with the Device TypeDefining or Updating Primary Storage Pools 232of SERVER . . . . . . . . . . . . .295Task Tips for Storage Pools . . . . . . .. 237Reclamation for Copy Storage Pools andOverview: Volumes in Storage Pools . . . . . 239Active-data Pools . . . . . . . . . . .295Random Access Storage Pool Volumes . . . . 239How Collocation Affects Reclamation . . . .299Sequential Access Storage Pool Volumes . . . 240 Estimating Space Needs for Storage Pools . . . .299Preparing Volumes for Random Access StorageEstimating Space Needs in Random AccessPools . . . . . . . . . . . . . .. 241Storage Pools . . . . . . . . . . . .300Preparing Volumes for Sequential AccessEstimating Space Needs in Sequential AccessStorage Pools . . . . . . . . . . .. 242Storage Pools . . . . . . . . . . . .301Updating Storage Pool Volumes . . . . .. 243 Monitoring Storage Pools and Volumes . . . . .301Access Modes for Storage Pool Volumes . .. 244Monitoring Space Available in a Storage Pool 302Overview: The Storage Pool Hierarchy . . . . . 246Monitoring the Use of Storage Pool Volumes 304Setting Up a Storage Pool Hierarchy. . . . . 246Monitoring Migration Processes . . . . . . 311How the Server Groups Files before Storing . . 248Monitoring the Use of Cache Space on DiskWhere the Files Are Stored . . . . . . . . 248Storage . . . . . . . . . . . . . .313How the Server Stores Files in a StorageRequesting Information about the Use ofHierarchy . . . . . . . . . . . .. 249Storage Space . . . . . . . . . . . .315Backing Up a Storage Hierarchy . . . . . . 250 Moving Files from One Volume to Another Volume318Implementing Copy Storage Pools andMoving Data to Other Volumes in the SameActive-data Pools . . . . . . . . . .. 251Storage Pool . . . . . . . . . . . . . 319Using the Hierarchy to Stage Client Data fromMoving Data to Another Storage Pool . . . .319Disk to Tape . . . . . . . . . . . . . 255Moving Data from an Offsite Volume in a CopyMigration of Files in a Storage Pool Hierarchy . . 256Storage Pool or an Active-data Pool . . . . .320Migration for Disk Storage Pools . . . . . . 257Procedure for Moving Data . . . . . . . .320Migration for Sequential Access Storage Pools262 Moving Data for a Client Node . . . . . . . 323Migration: Copy Storage Pools and Active-dataMoving Data for All File Spaces for One orPools . . . . . . . . . . . . . .. 265More Nodes . . . . . . . . . . . . . 323Using Cache on Disk Storage Pools . . . . .. 266Moving Data for Selected File Spaces for OneHow the Server Removes Cached Files . . .. 267Node . . . . . . . . . . . . . . . 324Effect of Caching on Storage Pool Statistics . . 267Requesting Information about the DataUsing the Simultaneous-write Function to ProtectMovement Process . . . . . . . . . . 325Your Data . . . . . . . . . . . . .. 267Preventing Incomplete Data MovementFunction Overview . . . . . . . . .. 268Operations . . . . . . . . . . . . . 325How Simultaneous Write Works . . . . . . 269 Renaming a Storage Pool . . . . . . . . . 325Operational Considerations . . . . . . . . 275 Defining Copy Storage Pools and Active-data Pools 326Example: Simultaneous Write as Part of aExample: Defining a Copy Storage Pool . . .327Backup Strategy . . . . . . . . . .. 278Comparing Primary, Copy Storage, andKeeping a Clients Files Together: Collocation . . 279Active-data Pools . . . . . . . . . . .328The Effects of Collocation on Operations . . . 281 Deleting a Storage Pool . . . . . . . . . . 329How the Server Selects Volumes with Deleting Storage Pool Volumes . . . . . . . 330Collocation Enabled . . . . . . . . .. 282Deleting an Empty Storage Pool Volume . . .330How the Server Selects Volumes withDeleting a Storage Pool Volume with Data . . 331Collocation Disabled . . . . . . . . . . 284Turning Collocation On or Off . . . . . .. 285Collocation on Copy Storage Pools andActive-data Pools . . . . . . . . . .. 285vi IBM Tivoli Storage Manager for AIX: Administrators Guide 8. Part 3. Managing Client Canceling an IBM Tivoli Storage ManagerSession . . . . . . . . . . . . .. 371Operations . . . . . . . . . . . . 333When a Client Session is AutomaticallyCanceled . . . . . . . . . . . . . . 372Chapter 11. Adding Client Nodes . . . 335 Disabling or Enabling Access to the Server . . 373Overview of Clients and Servers as Nodes . . .335 Managing Client Restartable Restore Sessions 373Installing Client Node Software . . . . . . . 336 Managing IBM Tivoli Storage Manager Security 375Registering Nodes with the Server . . . . . . 336 The Server Console . . . . . . . . . . 375 Accepting Default Closed Registration or Administrative Authority and Privilege Classes 375 Enabling Open Registration . . . . . . . 336 Managing Access to the Server and Clients .. 377 Registering Nodes with Client Options Sets . . 338 Managing IBM Tivoli Storage Manager Registering a Network-attached Storage FileAdministrators . . . . . . . . . . . . 378 Server as a Node . . . . . . . . . . . 338 Managing Levels of Administrative Authority380 Registering a Source Server as a Node on a Managing Passwords and Login Procedures .. 382 Target Server . . . . . . . . . . . .338 Registering an Application Programming Chapter 13. Implementing Policies for Interface to the Server . . . . . . . . .339 Client Data . . . . . . . . . . . . 385Connecting Nodes with the Server . . . . . .339Basic Policy Planning . . . . . . . . . . .386 Required Client Options . . . . . . . . .340 The Standard Policy . . . . . . . . . . 387 NonRequired Client Options . . . . . . .340 Getting Users Started . . . . . . . . . . 388 UNIX and Linux Client Options . . . . . .340 Changing Policy . . . . . . . . . . . 388Methods for Creating or Updating a Client Options File Expiration and Expiration Processing . . . 389File . . . . . . . . . . . . . . . . .340Client Operations Controlled by Policy . . . . . 390 Using a Text Editor . . . . . . . . . .340 Backup and Restore . . . . . . . . . .390 Using the Client Configuration Wizard . . . .341 Archive and Retrieve . . . . . . . . . .390Comparing Network-Attached Nodes to Local Client Migration and Recall . . . . . . . 391Nodes . . . . . . . . . . . . . . . . 341The Parts of a Policy . . . . . . . . . . .392Adding Clients from the Administrative Command Relationships among Clients, Storage, andLine Client . . . . . . . . . . . . . . 342 Policy . . . . . . . . . . . . . . .393 Enabling Open Registration . . . . . . . 342More on Management Classes . . . . . . . . 395 Configuring the Client Options File to Connect Contents of a Management Class . . . . . .395 with the Server . . . . . . . . . . . .342 Default Management Classes . . . . . . .396 Example: Register Three Client Nodes Using the The Include-Exclude List . . . . . . . .396 Administrative Command Line . . . . . .342 How Files and Directories Are Associated with a Management Class . . . . . . . . . .398Chapter 12. Managing Client Nodes 343 How IBM Tivoli Storage Manager Selects Files forManaging Client Node Registration Techniques .. 343 Policy Operations . . . . . . . . . . . .400Managing Nodes . . . . . . . . . . .. 344Incremental Backup . . . . . . . . . .400Managing Client Nodes across a Firewall . . . 344Selective Backup . . . . . . . . . . .402Updating Client Node Information . . . .. 346Logical Volume Backup . . . . . . . . . 402Renaming Client Nodes . . . . . . . . . 346Archive . . . . . . . . . . . . . . 403Locking and Unlocking Client Nodes . . .. 346Automatic Migration from a Client Node . . .403Deleting Client Nodes . . . . . . . . . 347 How Client Migration Works with Backup andConsolidating Multiple Clients under a Single Archive . . . . . . . . . . . . . . .404Client Node Name . . . . . . . . .. 347 Creating Your Own Policies . . . . . . . . 404Displaying Information about Client Nodes . . 349Example: Sample Policy Objects . . . . . .405Overview of Remote Access to Web Defining and Updating a Policy Domain . . . 406Backup-Archive Clients . . . . . . . .. 351Defining and Updating a Policy Set . . . . .408Managing Client Access Authority Levels . . . 353Defining and Updating a Management Class408Managing File Spaces . . . . . . . . .. 355Defining and Updating a Backup Copy Group 409Client Nodes and File Spaces . . . . . .. 355Defining and Updating an Archive Copy Group 415Supporting Unicode-Enabled Clients . . .. 357Assigning a Default Management Class . . .417Displaying Information about File Spaces . .. 365Validating and Activating a Policy Set . . . .417Moving Data for a Client Node . . . . . . 366 Assigning Client Nodes to a Policy Domain . . .419Deleting File Spaces . . . . . . . . .. 366 Running Expiration Processing to Delete ExpiredManaging Client Option Files . . . . . . .. 367 Files . . . . . . . . . . . . . . . .419Creating Client Option Sets on the Server . . . 368Running Expiration Processing Automatically 420Managing Client Option Sets . . . . . . . 369Using Commands and Scheduling to ControlManaging IBM Tivoli Storage Manager Sessions370Expiration Processing . . . . . . . . . . 420Displaying Information about IBM TivoliAdditional Expiration Processing with DisasterStorage Manager Sessions . . . . . . .. 370Recovery Manager . . . . . . . . . .420Contents vii 9. Protection and Expiration of Archive Data . . . .421 Restoring Files to a Point in Time . . . . . 463 Data Retention Protection . . . . . . . . 421 Concepts for Client Restore Operations . . . . 463 Deletion Hold . . . . . . . . . . . . 422 Managing Archive Data . . . . . . . . .. 466Protecting Data Using the SnapLock Feature . . . 422 Archive Operations Overview . . . . . .. 467 Reclamation and the SnapLock Feature . . . .423 Managing Performance for Archive Operations467 Set up SnapLock Volumes as Tivoli Storage Managing Storage Usage for Archives . . .. 470 Manager WORM FILE Volumes . . . . . . 427 Auditing Archive Descriptions . . . . .. 472Policy Configuration Scenarios . . . . . . . 428 Getting Information about Archives . . . . . 472 Configuring Policy for Direct-to-Tape Backups 428 Configuring Policy for Tivoli Storage Manager Chapter 15. Scheduling Operations for Application Clients . . . . . . . . . . 429 Client Nodes . . . . . . . . . . . . 473 Policy for Logical Volume Backups . . . . . 429 Prerequisites to Scheduling Operations . . . . . 473 Configuring Policy for NDMP Operations . . .430 Scheduling a Client Operation . . . . . . .. 474 Configuring Policy for LAN-free DataDefining Client Schedules . . . . . . . . 474 Movement . . . . . . . . . . . . .431Associating Client Nodes with Schedules . . . 475 Policy for IBM Tivoli Storage Manager ServersStarting the Scheduler on the Clients . . . . 475 as Clients . . . . . . . . . . . . . .433Displaying Schedule Information . . . . . . 476 Setting Policy to Enable Point-in-Time Restore Creating Schedules for Running Command Files 477 for Clients . . . . . . . . . . . . . 433 Updating the Client Options File to AutomaticallyDistributing Policy Using Enterprise Configuration 434 Generate a New Password . . . . . . . .. 478Querying Policy . . . . . . . . . . . .435 Commands for Scheduling Client Operations . .. 478 Querying Copy Groups . . . . . . . . .435 Querying Management Classes . . . . . . 436 Querying Policy Sets . . . . . . . . . .436 Chapter 16. Managing Schedules for Querying Policy Domains . . . . . . . . 436 Client Nodes . . . . . . . . . . . . 481Deleting Policy . . . . . . . . . . . . .437 Managing IBM Tivoli Storage Manager Schedules481 Deleting Copy Groups . . . . . . . . .437 Verifying that the Schedule Ran . . . . . .481 Deleting Management Classes . . . . . . . 437 Adding New Schedules . . . . . . . . . 482 Deleting Policy Sets . . . . . . . . . .438 Copying Existing Schedules . . . . . . . 482 Deleting Policy Domains . . . . . . . . 438 Modifying Schedules . . . . . . . . . .482 Deleting Schedules . . . . . . . . . . 482Chapter 14. Managing Data for Client Displaying Information about Schedules . . . 483 Managing Node Associations with Schedules . . .483Nodes . . . . . . . . . . . . . . 441 Adding New Nodes to Existing Schedules . . . 484Validating a Nodes Data . . . . . . . . . 441 Moving Nodes from One Schedule to Another484 Performance Considerations for Data Validation442 Displaying Nodes Associated with Schedules 484 Validating a Nodes Data During a Client Removing Nodes from Schedules . . . . . .484 Session . . . . . . . . . . . . . . 442 Managing Event Records . . . . . . . . . 484| Securing Client and Server Communications . . .442 Displaying Information about Scheduled Events485|Setting up Secure Sockets Layer . . . . . . 443 Managing Event Records in the Server Database486Encrypting Data on Tape . . . . . . . . .444 Managing the Throughput of Scheduled Choosing an Encryption Method . . . . . . 445 Operations . . . . . . . . . . . . . . 486 Changing Your Encryption Method and Modifying the Default Scheduling Mode . . .487 Hardware Configuration . . . . . . . .446 Specifying the Schedule Period for IncrementalSecuring Sensitive Client Data . . . . . . . . 447 Backup Operations . . . . . . . . . .489 Setting up Shredding . . . . . . . . . .447 Balancing the Scheduled Workload for the Ensuring Shredding is Enforced . . . . . .448 Server . . . . . . . . . . . . . . . 489Creating and Using Client Backup Sets . . . . .450 Controlling How Often Client Nodes Contact Generating Client Backup Sets on the Server 451 the Server . . . . . . . . . . . . . 491 Restoring Backup Sets from a Backup-Archive Specifying One-Time Actions for Client Nodes . . 492 Client . . . . . . . . . . . . . . .454 Determining How Long the One-Time Schedule Moving Backup Sets to Other Servers . . . . 455 Remains Active . . . . . . . . . . . . 493 Managing Client Backup Sets . . . . . . . 456Enabling Clients to Use Subfile Backup . . . . . 458 Example of Subfile Backups . . . . . . .459 Part 4. Maintaining the Server . . . 495 Setting Up Clients to Use Subfile Backup . . .459 Managing Subfile Backups . . . . . . . .459 Chapter 17. Managing ServerOptimizing Restore Operations for Clients . . . .460 Operations . . . . . . . . . . . . 497 Environment Considerations . . . . . . .461 Licensing IBM Tivoli Storage Manager . . . . . 497 Restoring Entire File Systems . . . . . . . 461 |Registering Licensed Features . . . . . . . 498 Restoring Parts of File Systems . . . . . . 462Saving Your Licenses . . . . . .. . . . 499 Restoring Databases for Applications . . . .463viii IBM Tivoli Storage Manager for AIX: Administrators Guide 10. Monitoring Licenses . . . . . . . . . . 499 Increasing the Size of the Database or RecoveryStarting and Halting the Server . . . . . .. 499 Log . . . . . . . . . . . . . . . . .541 Starting the Server. . . . . . . . . .. 500Automating the Increase of the Database or Halting the Server . . . . . . . . . .. 506Recovery Log . . . . . . . . . . . .541Moving the IBM Tivoli Storage Manager Server 507Recovering When the Recovery Log Runs OutChanging the Date and Time on the Server . . . 507of Space . . . . . . . . . . . . . .543Managing Server Processes . . . . . . . .. 508Manually Increasing the Database or Recovery Requesting Information about Server Processes 509Log . . . . . . . . . . . . . . . . 543 Canceling Server Processes . . . . . . .. 509 Decreasing the Size of the Database or Recovery Preemption of Client or Server Operations . . 510 Log . . . . . . . . . . . . . . . . .545Setting the Server Name . . . . . . . . .. 511Step 1: Determining If Volumes Can Be Deleted 546Adding or Updating Server Options . . . . .. 512Step 2: Reducing the Capacity of the Database Adding or Updating a Server Option without or Recovery Log . . . . . . . . . . . 547 Restarting the Server . . . . . . . . . . 512Step 3: Deleting a Volume from the Database orUsing Server Performance Options . . . . . . 512Recovery Log . . . . . . . . . . . .547 Automatic Tuning of Server Options . . .. 513 Optimizing Database and Recovery LogGetting Help on Commands and Error Messages513 Performance . . . . . . . . . . . . . .548Optimal Database Volume Allocation . . . .548Chapter 18. Automating Server Utilizing Hardware with Non-Volatile WriteOperations . . . . . . . . . . . . 515Cache . . . . . . . . . . . . . . . 549Adjusting the Database Buffer Pool Size . . . 549Automating a Basic Administrative CommandManually Adjusting the Database Buffer PoolSchedule . . . . . . . . . . . . . . . 515Size . . . . . . . . . . . . . . .549 Defining the Schedule . . . . . . . . . 516Adjusting the Recovery Log Buffer Pool Size 551 Verifying the Schedule . . . . . . . .. 516Estimating Database Reorganization . . . . .551Tailoring Schedules . . . . . . . . . .. 517Reorganizing the Database . . . . . . . . 553 Example: Defining and Updating an Administrative Command Schedule . . . . . 519Copying Schedules . . . . . . . . . .. 520 Chapter 20. Monitoring the IBM TivoliDeleting Schedules . . . . . . . . . . . 520 Storage Manager Server . . . . . . . 557Managing Scheduled Event Records . . . . . . 520 Using IBM Tivoli Storage Manager Queries to Querying Events . . . . . . . . . . . 520 Display Information . . . . . . . . . . .557 Removing Event Records from the Database .. 521Requesting Information about IBM TivoliIBM Tivoli Storage Manager Server Scripts . .. 521Storage Manager Definitions . . . . . . . 557 Defining a Server Script . . . . . . . .. 522Requesting Information about Client Sessions558 Managing Server Scripts . . . . . . . . . 525Requesting Information about Server Processes 559 Running a Server Script . . . . . . . . . 528Requesting Information about Server Settings560Using Macros . . . . . . . . . . . . . 528Querying Server Options . . . . . . . . 560 Writing Commands in a Macro . . . . . . 529Querying the System . . . . . . . . . . 561 Writing Comments in a Macro . . . . . . . 529 Using SQL to Query the IBM Tivoli Storage Using Continuation Characters . . . . . . 530 Manager Database . . . . . . . . . . . . 562 Using Substitution Variables in a Macro . . . 530Using the ODBC Driver . . . . . . . . . 562 Running a Macro . . . . . . . . . . . 531Issuing SELECT Commands . . . . . . . 562 Controlling Command Processing in a Macro 531Using SELECT Commands in IBM TivoliStorage Manager Scripts . . . . . . . . . 565Chapter 19. Managing the Database Canceling a SELECT Command . . . . . .566and Recovery Log . . . . . . . . . 533Controlling the Format of SELECT Results . .566Querying the SQL Activity Summary Table . . 566How IBM Tivoli Storage Manager ProcessesCreating Output for Use by Another Application567Transactions . . . . . . . . . . . . . . 534 Using the IBM Tivoli Storage Manager Activity Log567 Performance Considerations: Transferring FilesRequesting Information from the Activity Log568 as a Group between Client and Server . . . .534Setting a Retention Period for the Activity Log 569How IBM Tivoli Storage Manager Manages Space 536Setting a Size Limit for the Activity Log . . . 569 Available Space . . . . . . . . . . . . 536 Logging IBM Tivoli Storage Manager Events to Assigned Capacity. . . . . . . . . . .537 Receivers . . . . . . . . . . . . . . .570 Utilization . . . . . . . . . . . . . 537Controlling Event Logging . . . . . . . . 571The Advantages of Using Journal File System FilesLogging Events to the IBM Tivoli Storagewith Database and Log Volumes . . . . . . .538Manager Server Console and Activity Log . . . 572Estimating and Monitoring Database and RecoveryLogging Events to a File Exit and a User Exit 572Log Space Requirements. . . . . . . . . .538Logging Events to the Tivoli Enterprise Console 573 Monitoring the Database and Recovery Log . .540Logging Events to an SNMP Manager . . . . 577Contentsix 11. Enterprise Event Logging: Logging Events toWorking with Multiple Servers Using theAnother Server . . . . . . . . . . . . 582 Administration Center . . . . . . . . .640Querying Event Logging . . . . . . . . 584 Routing Commands . . . . . . . . . . 641Using Tivoli Decision Support . . . . . . .. 584 Setting Up Server Groups . . . . . . . . 643Scheduling the Decision Support Loader withQuerying Server Availability . . . . . . . 645IBM Tivoli Storage Manager . . . . . . . 585Using Virtual Volumes to Store Data on AnotherMonitoring IBM Tivoli Storage Manager Server . . . . . . . . . . . . . . . .645Accounting Records . . . . . . . . . . . 585 Setting Up Source and Target Servers for VirtualDaily Monitoring Scenario . . . . . . . .. 587 Volumes . . . . . . . . . . . . . .646Using IBM Tivoli Storage Manager Operational Performing Operations at the Source Server . . 648Reporting . . . . . . . . . . . . .. 587 Reconciling Virtual Volumes and Archive Files650Operational Reporting Concepts . . . . . . 588Installing the IBM Tivoli Storage Manager Chapter 22. Exporting and ImportingOperational Reporting Stand-alone Package .. 590Data . . . . . . . . . . . . . . . 653Generating a Comprehensive Report at RegularData That Can Be Exported and Imported . . . .653Intervals . . . . . . . . . . . . .. 591Exporting Restrictions . . . . . . . . .654Generating a Comprehensive Monitor atDeciding What Information to Export . . . . 654Regular Intervals . . . . . . . . . .. 595Deciding When to Export . . . . . . . . 655Completing the Set Up . . . . . . . .. 597Exporting Data Directly to Another Server. . . .656Viewing Reports and Other Features from theOptions to Consider Before Exporting . . . .656Management Console. . . . . . . . .. 599Preparing to Export to Another Server forGenerating Reports and Monitors from theImmediate Import . . . . . . . . . . .660Command Line . . . . . . . . . . . . 602Monitoring the Server-to-Server Export Process661Exporting Administrator Information to AnotherChapter 21. Working with a NetworkServer . . . . . . . . . . . . . . .661of IBM Tivoli Storage Manager Exporting Client Node Information to AnotherServers . . . . . . . . . . . . . . 607 Server . . . . . . . . . . . . . . .662Concepts for Working with a Network of Servers 607Exporting Policy Information to Another Server662 Configuring and Managing Servers: Enterprise Exporting Server Data to Another Server . . . 663 Configuration . . . . . . . . . . . . 608Exporting and Importing Data Using Sequential Performing Tasks on Multiple Servers . . .. 609Media Volumes . . . . . . . . . . . . . 663 Central Monitoring . . . . . . . . .. 609Preparing to Export or Import Data (Sequential Storing Data on Another Server . . . . .. 610Media) . . . . . . . . . . . . . .663 Example Scenarios. . . . . . . . . .. 610Exporting Tasks . . . . . . . . . . . 665Planning for Enterprise Administration . . . . . 612Importing Data from Sequential Media Volumes668Setting Up Communications Among Servers . .. 612Monitoring Export and Import Processes . . .677 Setting Up Communications for Enterprise Exporting and Importing Data from Virtual Configuration and Enterprise Event Logging .. 612Volumes . . . . . . . . . . . . . . 680 Setting Up Communications for Command Routing . . . . . . . . . . . . . . 615Part 5. Protecting the Server . . . 683 Updating and Deleting Servers . . . . . . 618Setting Up an Enterprise Configuration . . . . . 619 Enterprise Configuration Scenario . . . . . 620Chapter 23. Protecting and Creating the Default Profile on a ConfigurationRecovering Your Server . . . . . . . 685 Manager . . . . . . . . . . . . . . 623Levels of Protection . . . . . . . . . . .686 Creating and Changing Configuration Profiles624Storage Pool Protection: An Overview . . . . .686 Getting Information about Profiles . . . .. 631 How Restore Processing Works . . . . . . 687 Subscribing to a Profile . . . . . . . .. 633 How the Destroyed Volume Access Mode Works 688 Refreshing Configuration Information . . .. 637Database and Recovery Log Protection: An Returning Managed Objects to Local Control638Overview. . . . . . . . . . . . . . . 688 Setting Up Administrators for the Servers . . . 638 Mirroring . . . . . . . . . . . . . .689 Handling Problems with Synchronization of Database and Recovery Log Protection . . . . 689 Profiles . . . . . . . . . . . . .. 639Snapshot Database Protection . . . . . . . .691 Switching a Managed Server to a DifferentMirroring the Database and Recovery Log . . . . 691 Configuration Manager . . . . . . . . . 639 Separating Disk Volume Copies On Separate Deleting Subscribers from a Configuration Physical Disks When Mirroring the Database Manager . . . . . . . . . . . . . . 640 and Recovery Log . . . . . . . . . . . 692 Renaming a Managed Server . . . . . . . 640 Defining Database or Recovery Log MirroredPerforming Tasks on Multiple Servers . . . . . 640 Volume Copies . . . . . . . . . . . .692 Specifying Mirroring and Database Page Shadowing Server Options . . . . . . . . 693x IBM Tivoli Storage Manager for AIX: Administrators Guide 12. Requesting Information about Mirrored Chapter 24. Using Disaster Recovery Volumes . . . . . . . . . . . . . . 694 Manager . . . . . . . . . . . . . 739Backing Up Storage Pools . . . . . . . . . 695 Querying Defaults for the Disaster Recovery Plan Scheduling Storage Pool Backups . . . . . . 697 File . . . . . . . . . . . . . . . . .740 Example: Simple Hierarchy with One CopySpecifying Defaults for the Disaster Recovery Storage Pool . . . . . . . . . . . . .698Plan File . . . . . . . . . . . . . .740 How to Backup Data Stored in a Centera Specifying Defaults for Offsite Recovery Media Storage Pool . . . . . . . . . . . . .699Management . . . . . . . . . . . . 742 Using Simultaneous Write to Copy StorageSpecifying Recovery Instructions for Your Site . .744 Pools . . . . . . . . . . . . . . . 699 Specifying Information About Your Server and Using Multiple Copy Storage Pools and Client Node Machines . . . . . . . . . .745 Active-data Pools . . . . . . . . . . . 699 Specifying Recovery Media for Client Machines 747 Delaying Reuse of Volumes for RecoveryCreating and Storing the Disaster Recovery Plan 748 Purposes . . . . . . . . . . . . . .700Storing the Disaster Recovery Plan Locally . . 749Backing Up the Database . . . . . . . . .701Storing the Disaster Recovery Plan on a Target Defining Device Classes for Backups . . . . 701Server . . . . . . . . . . . . . . . 749 Setting the Recovery Log Mode . . . . . . 702 Managing Disaster Recovery Plan Files Stored on Estimating the Size of the Recovery Log . . . 702 Target Servers . . . . . . . . . . . . .750 Scheduling Database Backups . . . . . . . 703Displaying Information about Recovery Plan Automating Database Backups . . . . . . 703Files . . . . . . . . . . . . . . .750 Saving the Volume History File . . . . . .705Displaying the Contents of a Recovery Plan File750 Saving the Device Configuration File . . . .707Restoring a Recovery Plan File . . . . . . 751 Saving the Server Options . . . . . . . . 709Expiring Recovery Plan Files Automatically . . 751 Saving the Database and Recovery Log Deleting Recovery Plan Files Manually . . . .751 Information . . . . . . . . . . . . . 709 Moving Backup Media . . . . . . . . . . 752 Doing Full and Incremental Backups . . . .709Moving Backup Volumes Offsite . . . . . .754 Performing Snapshot Database Backups . . .710Moving Backup Volumes Onsite . . . . . . 755Recovering Your Server Using Database andSummary of Disaster Recovery Manager DailyStorage Pool Backups . . . . . . . . . . . 710 Tasks . . . . . . . . . . . . . . . . 757 Restoring a Database to a Point-in-Time . . . 711 Staying Prepared for a Disaster . . . . . . . 758 Restoring a Database to its Most Current State715 Recovering From a Disaster . . . . . . . .759 Restoring Storage Pools . . . . . . . . . 715Server Recovery Scenario . . . . . . . . 760Restoring Your Server Using Mirrored Volumes 718Client Recovery Scenario . . . . . . . . 762Restoring Storage Pool Volumes . . . . . . . 719 Recovering When Using Different Hardware at the What Happens When a Volume Is Restored . .720 Recovery Site . . . . . . . . . . . . . 764 When a Volume Restoration Is Incomplete . . . 720Automated SCSI Library at the Original Site andAuditing a Storage Pool Volume . . . . . . . 721a Manual SCSI Library at the Recovery Site . . 764 What Happens When You Audit Storage Pool Automated SCSI Library at the Original and Volumes . . . . . . . . . . . . . . 722Recovery Sites . . . . . . . . . . . . 765 Data Validation During Audit VolumeManaging Copy Storage Pool Volumes at the Processing . . . . . . . . . . . . .723Recovery Site . . . . . . . . . . . .766 Auditing a Volume in a Disk Storage Pool . . .727 Disaster Recovery Manager Checklist . . . . . 766 Auditing Multiple Volumes in a Sequential The Disaster Recovery Plan File . . . . . . . 769 Access Storage Pool . . . . . . . . . . 727Breaking Out a Disaster Recovery Plan File . . 769 Auditing a Single Volume in a Sequential AccessStructure of the Disaster Recovery Plan File . . 769 Storage Pool . . . . . . . . . . . . .728Example Disaster Recovery Plan File . . . .772 Auditing Volumes by Date Written . . . . .728 Auditing Volumes in a Specific Storage Pool . . 728 Defining a Schedule to Audit Volumes on a Appendix A. Setting Up an IBM Tivoli Regular Basis . . . . . . . . . . . . 729 Storage Manager Server in an HACMPCorrecting Damaged Files . . . . . . . . . 729 Cluster . . . . . . . . . . . . . . 793 Maintaining the Integrity of Files . . . . . .729 Failover and Fallback . . . . . . . . . . . 793 Restoring Damaged Files . . . . . . . . 730 Setup Procedure . . . . . . . . . . . . 794Backup and Recovery Scenarios . . . . . . .731Install and Configure HACMP for AIX . . . .794 Protecting Your Database and Storage Pools . .731Install the IBM Tivoli Storage Manager Server Recovering to a Point-in-Time from a Disaster 732on the Production Node . . . . . . . . . 795 Recovering a Lost or Damaged Storage PoolInstall the IBM Tivoli Storage Manager Client on Volume . . . . . . . . . . . . . .735the Production Node . . . . . . . . . .796Restoring a Library Manager Database . . . . . 736Configure the IBM Tivoli Storage ManagerRestoring a Library Client Database . . . . . .737Server . . . . . . . . . . . . . . . 796Set Up the Standby Node . . . . . . . .797 Contentsxi 13. Define the Removable Media Storage Devices toAppendix D. Setting up the Secure AIX . . . . . . . . . . . . . . . 797Sockets Layer (SSL) . . . . . . . . 821 Complete the HACMP and IBM Tivoli StorageEnabling SSL for the Integrated Solutions Console Manager Configurations . . . . . . . . . 798 Official Certificates . . . . . . . . . .. 821Troubleshooting Hints . . . . . . . . . . 7981. Create the SSL Server/Client key and trust files . . . . . . . . . . . . . . . 821Appendix B. External Media 2. Create the JACL script inManagement Interface Description . . 801 AppServerbin . . . . . . .. 824CreateProcess Call . . . . . . .. . . . . 8013. Modify wsadmin.properties to reflect theProcessing during Server Initialization . . . . . 802correct SOAP port . . . . . . . . . . . 825Processing for Mount Requests . . . . . . . 8024. Run wsadmin on the JACL script . . . . . 825Processing for Release Requests . . . . . . . 8025. Modify ConfigService.properties . . . .. 826Processing for Batch Requests . . . . . . . . 8036. Modify web.xml . . . . . . . . . . 826Error Handling . . . . . . . .. . . . . 8037. Stop the ISC_Portal . . . . . . . .. 826Begin Batch Request . . . . . . . . . . . 8048. Modify the soap.client.props . . . . . . 826End Batch Request . . . . . . . . . . . 8049. Start the ISC_Portal . . . . . . . . . 827Volume Query Request . . . . .. . . . . 80410. Test your changes . . . . . . . . . . 827Initialization Requests . . . . . . . . . . 805 Setting up the Lightweight Directory AccessVolume Eject Request . . . . . .. . . . . 806 Protocol (LDAP) over SSL . . . . . . . . . 827Volume Release Request . . . . .. . . . . 807Volume Mount Request . . . . .. . . . . 807 Appendix E. Notices . . . . . . . . 831Volume Dismount Request . . . . . . . . . 810 Trademarks . . . . . . . . . . . . . . 833Appendix C. User Exit and File Exit Glossary . . . . . . . . . . . . . 835Receivers . . . . . . . . . . . . . 813Sample User Exit Declarations . . . . . . . . 814 Index . . . . . . . . . . . . . . . 845Sample User Exit Program . . . . . . . .. 817Readable Text File Exit (FILETEXTEXIT) Format 818xii IBM Tivoli Storage Manager for AIX: Administrators Guide 14. About this PublicationIBM Tivoli Storage Manager is a client/server program that provides storagemanagement solutions to customers in a multi-vendor computer environment. IBMTivoli Storage Manager provides an automated, centrally scheduled,policy-managed backup, archive, and space-management facility for file serversand workstations.IBM Tivoli Storage Manager PublicationsThis section lists publications in the IBM Tivoli Storage Manager library andrelated documents. It also describes how to access Tivoli publications online andhow to order Tivoli publications.IBM Tivoli Storage Manager LibraryThe following documents are available in theTivoli Storage Manager library:Publication Title Order NumberIBM Tivoli Storage Management Products License InformationGH09-4572IBM Tivoli Storage Manager Messages SC32-0140IBM Tivoli Storage Manager for AIX Administrators GuideSC32-0117IBM Tivoli Storage Manager for AIX Administrators ReferenceSC32-0123IBM Tivoli Storage Manager for AIX Installation Guide GC23-5969IBM Tivoli Storage Manager Basic Concepts PosterSC32-9464The following table lists Tivoli Storage Manager storage agent publications.Publication Title Order NumberIBM Tivoli Storage Manager for SAN for AIX Storage Agent Users SC32-0129GuideIBM Tivoli Storage Manager for SAN for HP-UX Storage Agent Users SC32-0130GuideIBM Tivoli Storage Manager for SAN for Linux Storage Agent Users SC32-0131GuideIBM Tivoli Storage Manager for SAN for Sun Solaris Storage AgentSC32-0132Users GuideIBM Tivoli Storage Manager for SAN for Windows Storage Agent Users SC32-0133GuideThe following table lists Tivoli Storage Manager client publications.Publication Title Order NumberIBM Tivoli Storage Manager for Space Management for UNIX and Linux: SC32-0148Users GuideIBM Tivoli Storage Manager for Macintosh: Backup-Archive ClientsSC32-0143Installation and Users Guide Copyright IBM Corp. 1993, 2007 xiii 15. Publication TitleOrder Number IBM Tivoli Storage Manager for NetWare: Backup-Archive Clients SC32-0144 Installation and Users Guide IBM Tivoli Storage Manager for UNIX and Linux: Backup-ArchiveSC32-0145 Clients Installation and Users Guide IBM Tivoli Storage Manager for Windows: Backup-Archive Clients SC32-0146 Installation and Users Guide IBM Tivoli Storage Manager Using the Application Program Interface SC32-0147 The following table lists publications for application protection products. Order Publication Title Number IBM Tivoli Storage Manager for Application Servers: Data Protection for SC32-9075 WebSphere Application Server Installation and Users Guide Version 5.2 IBM Tivoli Storage Manager for Databases: Data Protection for Microsoft SQL SC32-9059 Server Installation and Users Guide IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX SC32-9064 and Linux Installation and Users Guide Version 5.4 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle forSC32-9065 Windows Installation and Users Guide Version 5.4 IBM Tivoli Storage Manager for Databases: Data Protection for InformixSH26-4095 Installation and Users Guide IBM Tivoli Storage Manager for Enterprise Resource Planning: Data Protection for SC33-6341 SAP Installation and Users Guide for DB2 IBM Tivoli Storage Manager for Enterprise Resource Planning: Data Protection for SC33-6340 SAP Installation and Users Guide for Oracle IBM Tivoli Storage Manager for Hardware: Data Protection for EMC SymmetrixSC33-6386 for R/3 Installation and Users Guide IBM Tivoli Storage Manager for Hardware: Data Protection for Enterprise Storage SC32-9060 Server for DB2 UDB Installation and Users Guide IBM Tivoli Storage Manager for Hardware: Data Protection for FlashCopy Devices GC32-1772 for Oracle Installation and Users Guide Version 5.3 IBM Tivoli Storage Manager for Advanced Copy Services: Data Protection for SC33-8208 Snapshot Devices for mySAP Installation and Users Guide for DB2 UDB Version 5.4 IBM Tivoli Storage Manager for Advanced Copy Services: Data Protection forSC33-8207 Snapshot Devices for mySAP Installation and Users Guide for Oracle Version 5.4 IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Domino for SC32-9056 UNIX, Linux, and OS/400 Installation and Users Guide IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Domino for SC32-9057 Windows Installation and Users Guide IBM Tivoli Storage Manager for Mail: z/OS Edition Licensed ProgramGC32-0838 Specifications IBM Tivoli Storage Manager for Mail: Data Protection for Microsoft Exchange SC32-9058 Server Installation and Users Guidexiv IBM Tivoli Storage Manager for AIX: Administrators Guide 16. Related IBM Publications The following table lists related IBM hardware products publications. Title Order Number IBM Magstar 3494 Tape Library Introduction and Planning Guide GA32-0279 IBM 3490E Model E01 and E11 Users GuideGA32-0298 IBM Magstar MP 3570 Tape Subsystem Operators Guide GA32-0345 IBM TotalStorage Tape Device Drivers Installation and Users GuideGC35-0154 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-0465Accessing Publications Online You can access and download IBM Tivoli Storage Manager publications from the following locations: IBM Tivoli Storage Manager Information Center You can find PDF and HTML versions in the Information Center at publib.boulder.ibm.com/infocenter/tivihelp/v1r1/index.jsp IBM Publications Center You can find PDF versions in the IBM Publications Center at www.ibm.com/shop/publications/orderTivoli Technical Training For Tivoli technical training information, refer to the following IBM Tivoli Education Web site: http://www.ibm.com/software/tivoli/educationSupport Information This section describes the following options for obtaining support for IBM products: v Searching knowledge bases v Obtaining fixes on page xvi v Contacting IBM Software Support on page xviSearching 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 You can use the search function of IBM Tivoli Storage Manager Information Center to query conceptual information, instructions for completing tasks, reference information, and support documents. The information center is at the following Web site: publib.boulder.ibm.com/infocenter/tivihelp/v1r1/index.jsp.About this Publication xv 17. 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. You 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. To receive weekly e-mail notifications about fixes and other news about IBM products, follow these steps: 1. From the support page for any IBM product, click My support in theupper-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 youruser ID and password. 3. Sign in to My support. 4. On the My support page, click Edit profiles in the left navigation pane, andscroll to Select Mail Preferences. Select a product family and check theappropriate boxes for the type of information you want. 5. Click Submit. 6. For e-mail notification for other products, repeat Steps 4 and 5. For more information about types of fixes, see the Software Support Handbook (http://techsupport.services.ibm.com/guides/handbook.html). Contacting IBM Software Support IBM Software Support provides assistance with product defects. 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:xvi IBM Tivoli Storage Manager for AIX: Administrators Guide 18. 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.v For IBM eServer software products (including, but not limited to, DB2 andWebSphere products that run in zSeries, pSeries, and iSeries environments),you can purchase a software maintenance agreement by working directly withan IBM sales representative or an IBM Business Partner. For more informationabout support for eServer software products, go to the IBM Technical SupportAdvantage Web page (http://www.ibm.com/servers/eserver/techsupport.html).If you are not sure what type of software maintenance contract you need, call1-800-IBMSERV (1-800-426-7378) in the United States or, from other countries, go tothe contacts page of the IBM Software Support Handbook on the Web(http://techsupport.services.ibm.com/guides/contacts.html) and click the name ofyour geographic region for phone numbers of people who provide support foryour 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 problemWhen 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 problemyou 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 informationWhen explaining a problem to IBM, be as specific as possible. Include all relevantbackground information so that IBM Software Support specialists can help yousolve the problem efficiently. To save time, know the answers to these questions:v What software versions were you running when the problem occurred?v Do you have logs, traces, and messages that are related to the problemsymptoms? 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, operatingsystem, networking software, and so on.)About this Publication xvii 19. 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) and click the name of your 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 and Obtaining fixes.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 devclassxviii IBM Tivoli Storage Manager for AIX: Administrators Guide 20. Changes for Tivoli Storage Manager Version 5This section summarizes changes that were made to the Tivoli Storage Managerproduct and this publication.| Technical Changes for Version 5 Release 5 November 2007| The following changes have been made to the product for this edition:| New method for calculating migration thresholds for storage pools associated| with sequential-access disk (FILE) devices|In previous releases of Tivoli Storage Manager, migration thresholds for|storage pools associated with sequential-access disk (FILE) devices were|based on volume utilization. In this release, migration thresholds are based|on a percentage of the storage pools total data capacity. For example, a|sequential-access disk storage pool with a capacity of 100 TB and a high|migration threshold of 70% is migrated when the pool contains 70 TB of|data. This method of calculating migration thresholds provides a|potentially more efficient use of large, sequential-access disk storage pools.|The server continues to migrate files by volume; after each volume is|migrated, the server checks to determine if the low migration threshold has|been reached.|If you are upgrading from a previous version of Tivoli Storage Manager,|you will notice that more data must be stored before migration starts. Be|sure to adjust your migration thresholds so that you do not run out of|space for routine storage operations such as backups.|For more information, see Migration for Sequential Access Storage Pools|on page 262.| Concurrent access to volumes in storage pools with a device type of FILE|In previous versions of Tivoli Storage Manager, a client session or server|process had to wait for a FILE volume if the volume was in use by another|session or process. In this version, the Tivoli Storage Manager server|allows concurrent read-access and write-access to the volume.|Concurrent access improves restore performance by allowing two or more|clients to access the same volume at the same time. Multiple client sessions|(archive, retrieve, backup, and restore) or server processes (for example,|storage pool backup) can read the volume concurrently. In addition, one|client session can write to the volume while it is being read.|The following server processes are allowed shared read access to FILE|volumes:|v BACKUP DB|v BACKUP STGPOOL|v COPY ACTIVEDATA|v EXPORT/IMPORT NODE|v EXPORT/IMPORT SERVER|v GENERATE BACKUPSET|v RESTORE STGPOOL|v RESTORE VOLUME Copyright IBM Corp. 1993, 2007xix 21. | The following server processes are not allowed shared read access to FILE| volumes:| v AUDIT VOLUME| v DELETE VOLUME| v MIGRATION| v MOVE DATA| v MOVE NODEDATA| v RECLAMATION| A FILE volume can appear as the current volume for more than one| session and as the target of concurrent read and write operations. There are| no command changes associated with this feature.|Restartable server-to-server export|You can now suspend and later restart an export operation if it is a|server-to-server export that is designated with a FILEDATA value other|than NONE. If an export operation was suspended because of errors or|because the SUSPEND EXPORT command was issued, you can restart the|export at the point where it was suspended. To find those export|operations that can be restarted, issue the QUERY EXPORT command.| You can also specify the TODATE and TOTIME parameters when issuing| an EXPORT NODE or EXPORT SERVER command.|New Support for Plasmon and IBM UDO2 Optical Disk Drives and Media|Tivoli Storage Manager now supports Plasmon and IBM UDO2 optical disk|drives and media. A new recording format is available for the OPTICAL|device type. Note that you cannot mix UDO1 and UDO2 drives in a single|library.| See the Administrators Reference for more information.|IBM and HP LTO-4 Drive Support and Encryption|Tivoli Storage Manager now supports IBM and HP LTO-4 tape drives. New|recording formats are available for the linear tape open (LTO) device class.|Tape device encryption is also supported. Encryption provides security for|data on individual tapes and protects sensitive information that might be|transported offsite. When enabled, Tivoli Storage Manager manages|encrypting and decrypting data on tapes, according to specifications set|when defining the LTO device class. To enable drive encryption with IBM|LTO-4, you must have the IBM RMSS Ultrium device driver installed. IBM|LTO-4 SCSI drives do not support encryption.| For details, see Using Drive Encryption on page 190 and the| Administrators Reference.|TCP/IP Version 6| Tivoli Storage Manager is now able to use TCP/IP Version 6 (IPv6) as its| communications protocol. IPv6 is interoperable with TCP/IP Version 4. You| can specify either IPv4 or IPv4/IPv6 in the COMMMETHOD option when| you start the server, storage agent, client, or API application. The same| port numbers are used by the server, storage agent, client, or API| application for both IPv4 and IPv6.| IPv6 address formats are acceptable for all functions that support IPv6.| However, if you use IPv6 addresses for functions that do not support IPv6,| communications will fail. The following functions do not support IPv6:| v NDMP: backing up and restoring storage pools, copying and moving| data (continue to use IPv4)xx IBM Tivoli Storage Manager for AIX: Administrators Guide 22. |v ACSLS (continue to use IPv4)|v SNMP (continue to use IPv4)|v Centera device support (continue to use IPv4)|v Shared Memory Protocol (continue to use IPv4)|v Windows Microsoft Management Console functions (continue to use|IPv4)|v Tivoli Enterprise Console (TEC) support|v Administration Center (continue to use IPv4)|See the Administrators Reference for more information.| Secure Sockets Layer communication option|Communications between the Tivoli Storage Manager server and the|backup-archive client, administrative command-line client (dsmadmc), and|client Application Programming Interface are always password protected.|However, you can now add another level of data protection by using|Secure Sockets Layer (SSL). SSL is the standard technology for creating|encrypted links between servers and clients. SSL provides a secure channel|for servers and clients to communicate over open communications paths.|See Securing Client and Server Communications on page 442 for more|information.| Support for Long Object Names|Tivoli Storage Manager now supports fully qualified object names of up to|8704 bytes in length. This support is available for backup and restore|functions, and is dependent on whether or not the client also supports the|byte length. Long names might be abbreviated in message or query output|due to length. You can display them using the DISPLAY OBJNAME|command.|For details, see Object Names for Clients on page 356 and the|Administrators Reference.| Running SAN Discovery for Non-root Users| You can run SAN discovery to obtain information about devices on a| storage area network for LAN-free configuration or to automatically correct| device special file names if they have changed. SAN discovery on AIX| requires root user authority. To allow both root and non-root users to| perform SAN discovery, a special utility module, dsmqsan, is invoked| when a SAN-discovery function is launched. The module performs as root,| giving SAN-discovery authority to non-root users. The dsmqsan module| works only for SAN-discovery functions, and does not provide root| privileges for any other Tivoli Storage Manager functions. For details, see| Determining Device Special File Names on page 85 and Configuring| IBM Tivoli Storage Manager for LAN-free Data Movement on page 129.Changes for Tivoli Storage Manager Version 5 xxi 23. xxii IBM Tivoli Storage Manager for AIX: Administrators Guide 24. Part 1. IBM Tivoli Storage Manager Basics Copyright IBM Corp. 1993, 20071 25. 2 IBM Tivoli Storage Manager for AIX: Administrators Guide 26. Chapter 1. Introducing IBM Tivoli Storage ManagerIBM Tivoli Storage Manager is an enterprise-wide storage management application.It provides automated storage management services to workstations, personalcomputers, and file servers from a variety of vendors, with a variety of operatingsystems. Tivoli Storage Manager includes the following components:ServerServer program The server program provides backup, archive, and space management services to the clients. You can set up multiple servers in your enterprise network to balance storage, processor, and network resources.Administrative interfaceThe administrative interface allows administrators to control and monitorserver activities, define management policies for clients, and set upschedules to provide services to clients at regular intervals. Administrativeinterfaces available include a command-line administrative client and a Webbrowser interface called the Administration Center. Tivoli Storage Managerallows you to manage and control multiple servers from a single interfacethat runs in a Web browser.Server database and recovery log The Tivoli Storage Manager server uses a database to track information about server storage, clients, client data, policy, and schedules. The server uses the recovery log as a scratch pad for the database, recording information about client and server actions while the actions are being performed.Server storage The server can write data to hard disk drives, disk arrays and subsystems, stand-alone tape drives, tape libraries, and other forms of random- and sequential-access storage. The media that the server uses are grouped into storage pools. The storage devices can be connected directly to the server, or connected via local area network (LAN) or storage area network (SAN).Client Nodes A client node can be a workstation, a personal computer, a file server, a network-attached storage (NAS) file server, or even another Tivoli Storage Manager server. The client node has IBM Tivoli Storage Manager client software installed (except for NAS file servers using NDMP). A client node is registered with the server.Backup-archive client The backup-archive client allows users to maintain backup versions of files, which they can restore if the original files are lost or damaged. Users can also archive files for long-term storage and retrieve the archived files when necessary. Users themselves or administrators can register workstations and file servers as client nodes with a Tivoli Storage Manager server. The storage agent is an optional component that may also be installed on a system that is a client node. The storage agent enables LAN-free data movement for client operations and is supported on a number of operating systems. Copyright IBM Corp. 1993, 20073 27. Network-attached storage file server (using NDMP) The server can use the Network Data Management Protocol (NDMP) to back up and restore file systems stored on a network-attached storage (NAS) file server. The data on the NAS file server is backed up to a tape library. No Tivoli Storage Manager software needs to be installed on the NAS file server. A NAS file server can also be backed up over the LAN to a Tivoli Storage Manager server. See Chapter 7, Using NDMP for Operations with NAS File Servers, on page 139 for more information, including supported NAS file servers.Application clientApplication clients allow users to perform online backups of data forapplications such as database programs. After the application programinitiates a backup or restore, the application client acts as the interface toTivoli Storage Manager. The Tivoli Storage Manager server then applies itsstorage management functions to the data. The application client canperform its functions while application users are working, with minimaldisruption.The following products provide application clients for use with the TivoliStorage Manager server:v Tivoli Storage Manager for Application Serversv Tivoli Storage Manager for Databasesv Tivoli Storage Manager for Enterprise Resource Planningv Tivoli Storage Manager for MailAlso available is Tivoli Storage Manager for Hardware, which works withthe backup-archive client and the API to help eliminate backup-relatedperformance effects.Application program interface (API)The API allows you to enhance existing applications to use the backup,archive, restore, and retrieve services that Tivoli Storage Manager provides.Tivoli Storage Manager API clients can register as client nodes with a TivoliStorage Manager server.Tivoli Storage Manager for Space Management Tivoli Storage Manager for Space Management provides space management services for workstations on some platforms. The space management function is essentially a more automated version of archive. Tivoli Storage Manager for Space Management automatically migrates files that are less frequently used to server storage, freeing space on the workstation. The migrated files are also called space-managed files.Users can recall space-managed files automatically simply by accessing them asthey normally would from the workstation. Tivoli Storage Manager for SpaceManagement is also known as the space manager client, or the hierarchicalstorage management (HSM) client.Storage agents The storage agent is an optional component that may be installed on a system that is also a client node. The storage agent enables LAN-free data movement for client operations.The storage agent is available for use with backup-archive clients andapplication clients on a number of operating systems. The Tivoli StorageManager for Storage Area Networks product includes the storage agent.4 IBM Tivoli Storage Manager for AIX: Administrators Guide 28. For information about supported operating systems for clients, see the IBM TivoliStorage Manager Web site at www.ibm.com/software/sysmgmt/products/support/IBMTivoliStorageManager.htmlClient programs such as the backup-archive client and the HSM client (spacemanager) are installed on systems that are connected through a LAN and areregistered as client nodes. From these client nodes, users can back up, archive, ormigrate files to the server.The following sections present key concepts and information about IBM TivoliStorage Manager. The sections describe how Tivoli Storage Manager manages clientfiles based on information provided in administrator-defined policies, and managesdevices and media based on information provided in administrator-defined TivoliStorage Manager storage objects.The final section gives an overview of tasks for the administrator of the server,including options for configuring the server and how to maintain the server.Concepts:How IBM Tivoli Storage Manager Stores Client DataHow the Server Manages Storage on page 16Chapter 2, Getting Started with Tivoli Storage Manager, on page 19How IBM Tivoli Storage Manager Stores Client DataTivoli Storage Manager policies are rules that determine how the client data isstored and managed. The rules include where the data is initially stored, howmany backup versions are kept, how long archive copies are kept, and so on. Youcan have multiple policies and assign the different policies as needed to specificclients, or even to specific files.Policy assigns a location in server storage where data is initially stored. Serverstorage is divided into storage pools that are groups of storage volumes. Serverstorage can include hard disk, optical, and tape volumes.When you install Tivoli Storage Manager, you have a default policy that you canuse. For details about this default policy, see The Standard Policy on page 387.You can modify this policy and define additional policies.Clients use Tivoli Storage Manager to store data for any of the following purposes:Backup and restore The backup process copies data from client workstations to server storage to ensure against loss of data that is regularly changed. The server retains versions of a file according to policy, and replaces older versions of the file with newer versions. Policy includes the number of versions and the retention time for versions. A client can restore the most recent version of a file, or can restore earlier versions.Archive and retrieve The archive process copies data from client workstations to server storage for long-term storage. The process can optionally delete the archived files from the client workstations. The server retains archive copies according to the policy for archive retention time. A client can retrieve an archived copy of a file. Chapter 1. Introducing IBM Tivoli Storage Manager 5 29. Instant archive and rapid recovery Instant archive is the creation of a complete set of backed-up files for a client. The set of files is called a backup set. A backup set is created on the server from the most recently backed-up files that are already stored in server storage for the client. Policy for the backup set consists of the retention time that you choose when you create the backup set.You can copy a backup set onto compatible portable media, which can then betaken directly to the client for rapid recovery without the use of a network andwithout having to communicate with the Tivoli Storage Manager server.Migration and recallMigration, a function of the Tivoli Storage Manager for Space Managementprogram, frees up client storage space by copying files from workstations toserver storage. On the client, the Tivoli Storage Manager for Space Managementprogram replaces the original file with a stub file that points to the original inserver storage. Files are recalled to the workstations when needed.This process is also called hierarchical storage management (HSM). Onceconfigured, the process is transparent to the users. Files are migrated andrecalled automatically.Policy determines when files are considered for automatic migration. On theUNIX or Linux systems that support the Tivoli Storage Manager for SpaceManagement program, policies determine whether files must be backed up tothe server before being migrated. Space management is also integrated withbackup. If the file to be backed up is already migrated to server storage, the fileis backed up from there.Figure 1 on page 7 shows how policy is part of the Tivoli Storage Manager processfor storing client data.6 IBM Tivoli Storage Manager for AIX: Administrators Guide 30. ClientsServer Client Data Storage Pools 4MigrationBackuporArchive Database Policy DomainPolicy Set Management ClassCopy GroupFigure 1. How IBM Tivoli Storage Manager Controls Backup, Archive, and MigrationProcessesThe steps in the process are as follows: 1 A client initiates a backup, archive, or migration operation. The file involved in the operation is bound to a management class. The management class is either the default or one specified for the file in client options (the clients include-exclude list). 2 If the file is a candidate for backup, archive, or migration based on information in the management class, the client sends the file and file information to the server. 3 The server checks the management class that is bound to the file to determine the destination, the name of the Tivoli Storage Manager storage pool where the server initially stores the file. For backed-up and archived files, destinations are assigned in the backup and archive copy groups, which are within management classes. For space-managed files, destinations are assigned in the management class itself. The storage pool can be a group of disk volumes, tape volumes, or optical volumes. 4 The server stores the file in the storage pool that is identified as the storage destination. The Tivoli Storage Manager server saves information in its database about each file that it backs up, archives, or migrates. If you set up server storage in a hierarchy, Tivoli Storage Manager can later migrate the file to a storage pool different from the one where the file was Chapter 1. Introducing IBM Tivoli Storage Manager 7 31. initially stored. For example, you may want to set up server storage so thatTivoli Storage Manager migrates files from a disk storage pool to tape volumesin a tape storage pool.Files remain in server storage until they expire and expiration processing occurs, oruntil they are deleted from server storage. A file expires because of criteria that areset in policy. For example, the criteria include the number of versions allowed for afile and the number of days that have elapsed since a file was deleted from theclients file system. If data retention protection is activated, an archive objectcannot be inadvertently deleted.For information on assigning storage destinations in copy groups and managementclasses, and on binding management classes to client files, see Chapter 13,Implementing Policies for Client Data, on page 385.For information on managing the database, see Chapter 19, Managing theDatabase and Recovery Log, on page 533.For information about storage pools and storage pool volumes, see Chapter 10,Managing Storage Pools and Volumes, on page 227.For information about event-based policy, deletion hold, and data retentionprotection, see Chapter 13, Implementing Policies for Client Data, on page 385.Options for Data ProtectionIBM Tivoli Storage Manager provides a variety of backup and archive operations,allowing you to select the right protection for the situation. Table 1 shows someexamples of the protection options.Table 1. Examples of Meeting Your Goals with IBM Tivoli Storage ManagerFor this goal... Do this...Back up files that are on a users Use the backup-archive client to performworkstation, and have the ability to restore incremental backups or selective backups.individual files.Back up a file server, and have the ability to Use the backup-archive client to performrestore individual files.incremental backups or selective backups. If the file server is a network-attached storage file server that is supported, you can have the server use NDMP to perform image backups. This support is available in the IBM Tivoli Storage Manager Extended Edition product.Make restore media portable, or make Use the backup-archive client to performrestores easier to perform remotely. incremental backups, and then generate backup sets by using the Tivoli Storage Manager server.Provide the ability to more easily restore the Use the backup-archive client to performentire contents of a single logical volume,logical volume backups (also called imageinstead of restoring individual files. backups).Set up records retention to meet legal orUse the backup-archive client to occasionallyother long-term storage needs. perform archiving. To ensure that the archiving occurs at the required intervals, use central scheduling.8 IBM Tivoli Storage Manager for AIX: Administrators Guide 32. Table 1. Examples of Meeting Your Goals with IBM Tivoli Storage Manager (continued)For this goal... Do this...Create an archive for a backup-archive client, Use the backup-archive client to performfrom data that is already stored for backup. incremental backups, and then generate a backup set by using the Tivoli Storage Manager server. This is also called instant archive.Provide the ability to restore data to a point Use the backup-archive client to regularlyin time. perform incremental backups (either manually or automatically through schedules). Then do one of the following: v Set up policy to ensure that data is preserved in server storage long enough to provide the required service level. See Setting Policy to Enable Point-in-Time Restore for Clients on page 433 for details. v Create backup sets for the backup-archive client on a regular basis. Set the retention time to provide the required service level. See Creating and Using Client Backup Sets on page 450 for details.Save a set of files and directories before Use the backup-archive client to archive themaking significant changes to them.set of files and directories. If this kind of protection is needed regularly, consider creating backup sets from backup data already stored for the client. Using backup sets instead of frequent archive operations can reduce the amount of metadata that must be stored in the servers database.Manage a set of related files, which are not Use the backup group command on thein the same file system, with the same backup-archive client to create a logicalbackup, restore, and server policies.grouping of a set of files, which can be from one or more physical file systems. The group backup process creates a virtual file space in server storage to manage the files, because the files might not be from one file system on the client. Actions such as policy binding, migration, expiration, and export are applied to the group as a whole. See the Backup-Archive Clients Installation and Users Guide for details.Back up data for an application that runsUse the appropriate application client. Forcontinuously, such as a database application example, use Tivoli Storage Manager for Mail(for example, DB2 or Oracle) or a mail to protect the Lotus Domino application.application (Lotus Domino).Exploit disk hardware capable of dataUse the appropriate component in the Tivolisnapshots. Storage Manager for Hardware product, such as IBM System Storage Archive Manager for IBM Enterprise Storage Server for DB2.Make backups transparent to end users. Use the backup-archive client with centrally scheduled backups that run during off-shift hours. Monitor the schedule results. Chapter 1. Introducing IBM Tivoli Storage Manager9 33. Table 1. Examples of Meeting Your Goals with IBM Tivoli Storage Manager (continued) For this goal... Do this... Reduce the load on the LAN by moving Use LAN-free data movement or, for backup data over your SAN. supported network-attached storage (NAS)file servers, use NDMP operations. Schedule the backups of client data to help enforce the data management policy that you establish. If you schedule the backups, rather than rely on the clients to perform the backups, the policy that you establish is followed more consistently. See Chapter 15, Scheduling Operations for Client Nodes, on page 473. The standard backup method that Tivoli Storage Manager uses is called progressive incremental backup. It is a unique and efficient method for backup. See Progressive Incremental Backup Compared with Other Backup Types on page 14. Table 2 on page 11 summarizes the client operations that are available. In all cases, the server tracks the location of the backup data in its database. Policy that you set determines how the backup data is managed.10 IBM Tivoli Storage Manager for AIX: Administrators Guide 34. Table 2. Summary of Client OperationsType ofDescriptionUsage Restore optionsFor more informationoperationProgressiveThe standard method of backup used Helps ensure complete, effective, The user can restore just the version of See Incrementalincrementalby Tivoli Storage Manager. After the policy-based backup of data. Eliminates the file that is needed. Backup on page 400backup first, fu