Administrator's Guide


Table of Contents

  • Preface
  • Who Should Read This Publication
  • What You Should Know before Reading This Publication
  • Tivoli Storage Manager Web Site
  • Conventions Used in This Book
  • Tivoli Storage Manager Publications
  • Referenced MVS System Publications
  • Related IBM Hardware Products Publications
  • IBM International Technical Support Center Publications (Redbooks)
  • Do You Have Comments or Suggestions?
  • Translations
  • Summary of Changes for Tivoli Storage Manager
  • Product Repackaging Changes--September 1999
  • Technical Changes for Version 3 Release 7--September 1999

  • Part 1. Tivoli Storage Manager Basics

  • Chapter 1. Introducing Tivoli Storage Manager
  • How Tivoli Storage Manager Stores Client Data
  • How Tivoli Storage Manager Represents Storage Devices
  • Disk and Tape Devices
  • Files on Disk as Sequential Volumes
  • Sequential Volumes on Another Tivoli Storage Manager Server
  • How Tivoli Storage Manager Represents Storage Media
  • The Tivoli Storage Manager Storage Objects
  • Device Class
  • Storage Pool
  • Storage Pool Volume
  • Server
  • More on the Contents of the Device Class
  • Putting It All Together
  • Planning for Server Storage
  • Evaluating Your Storage Environment
  • Mapping Devices to Device Classes
  • Mapping Storage Pools to Device Classes and Devices
  • Configuring Devices
  • Automating Client Operations
  • Working with a Network of Tivoli Storage Manager Servers
  • Chapter 2. Administrator Tasks
  • Interfaces to Tivoli Storage Manager
  • Using Magnetic Disk Devices with Tivoli Storage Manager
  • Using Removable Media Devices with Tivoli Storage Manager
  • Managing Tape Operations
  • Defining Device Classes
  • Managing Storage Pools
  • Adding Nodes
  • Managing Client Nodes
  • Managing Client Data Using Policies
  • Scheduling Operations for Clients
  • Performing Operations for Clients
  • Working with a Network of Tivoli Storage Manager Servers
  • Managing Server Operations
  • Automating Server Operations
  • Managing the Database and Recovery Log
  • Monitoring the Tivoli Storage Manager Server
  • Exporting and Importing Data
  • Protecting and Recovering Your Server
  • Using Tivoli Disaster Recovery Manager

  • Part 2. Configuring and Managing Server Storage

  • Chapter 3. Using Magnetic Disk Devices with Tivoli Storage Manager
  • Setting Up Storage Pools on Disk Devices
  • Using Random Access Volumes on Disk Devices
  • Using Disk for FILE Sequential Devices
  • Varying Disk Volumes Online or Offline
  • Notes on Operations
  • Using Cache
  • Freeing Space on Disk
  • FILE Volumes Used for Database Backups and Export Operations
  • Chapter 4. Using Tape Devices with Tivoli Storage Manager
  • Overview of Using Tape Devices with Tivoli Storage Manager
  • Example of Setting Up Two 3490E Drives
  • Define the Tivoli Storage Manager Objects
  • Update Tivoli Storage Manager Policy
  • Register Clients to the Policy Domain
  • Notes on Operations
  • Collocation
  • Maintaining the Volume Inventory
  • Chapter 5. Managing Tape Operations
  • Understanding Tivoli Storage Manager Server Tape Processing
  • Processing Tapes
  • Understanding How the Server Selects and Handles Tapes
  • Querying and Dismounting Tapes
  • Querying Mounted Tapes
  • Dismounting Tapes
  • Setting Up Tivoli Storage Manager with Your Tape Management System
  • Defining Tivoli Storage Manager to Your Tape Management System
  • Specifying Permanent Tape Retention
  • Setting Up Tape Installation-Wide Exits
  • Chapter 6. Managing Device Classes
  • How to Choose Device Classes
  • Defining and Updating Tape Device Classes
  • Mount Limit
  • Mount Wait Period
  • Mount Retention Period
  • Maximum Capacity
  • File Expiration Date
  • MVS Device Unit Name
  • Data Compression
  • Tape Volume Prefix
  • Protection Status
  • File Retention Period
  • Estimated Capacity
  • Example: 3480 Devices
  • Defining FILE Device Classes
  • Device Type
  • Mount Limit
  • Maximum Capacity
  • Prefix
  • Defining and Updating SERVER Device Classes
  • Server Name
  • Mount Limit
  • Maximum Capacity Value
  • Prefix
  • Retry Period
  • Retry Interval
  • Requesting Information about Device Classes
  • Deleting Device Classes
  • How TSM Fills Volumes
  • Using Data Compression
  • Tape Volume Capacity and Data Compression
  • Chapter 7. Managing Storage Pools and Volumes
  • Storage Pools
  • An Example of Server Storage
  • Defining or Updating Primary Storage Pools
  • Task Tips for Storage Pools
  • Volumes in Storage Pools
  • Preparing Volumes for Random Access Storage Pools
  • Preparing Volumes for Sequential Access Storage Pools
  • Updating Storage Pool Volumes
  • The Storage Pool Hierarchy
  • How the Server Stores Files in a Storage Pool Hierarchy
  • Using Copy Storage Pools to Back Up a Storage Hierarchy
  • Using the Hierarchy to Stage Client Data from Disk to Tape
  • Migration of Files in a Storage Pool Hierarchy
  • Migration for Disk Storage Pools
  • Migration for Sequential Access Storage Pools
  • Migration and Copy Storage Pools
  • The Use of Cache on Disk Storage Pools
  • How the Server Removes Cached Files
  • Effect of Caching on Storage Pool Statistics
  • Grouping Client Files: Collocation on Sequential Access Storage Pools
  • The Effects of Collocation on Operations
  • How the Server Selects Volumes with Collocation Enabled
  • How the Server Selects Volumes with Collocation Disabled
  • Turning Collocation On or Off
  • Collocation on Copy Storage Pools
  • Reclaiming Space in Sequential Access Storage Pools
  • How Tivoli Storage Manager Reclamation Works
  • Choosing a Reclamation Threshold
  • Reclaiming Volumes in a Storage Pool with One Drive
  • Reclamation of Volumes with the Device Type of SERVER
  • Reclamation for Copy Storage Pools
  • How Collocation Affects Reclamation
  • Estimating Space Needs for Storage Pools
  • Estimating Space Needs in Random Access Storage Pools
  • Estimating Space Needs in Sequential Access Storage Pools
  • Monitoring Storage Pools and Volumes
  • Monitoring Space Available in a Storage Pool
  • Monitoring the Use of Storage Pool Volumes
  • Monitoring Migration Processes
  • Monitoring the Use of Cache Space on Disk Storage
  • Requesting Information on the Use of Storage Space
  • Moving Files from One Volume to Another Volume
  • Moving Data to Other Volumes in the Same Storage Pool
  • Moving Data to Another Storage Pool
  • Moving Data from an Offsite Volume in a Copy Storage Pool
  • Procedure for Moving Data
  • Renaming a Storage Pool
  • Defining a Copy Storage Pool
  • Example: Defining a Copy Storage Pool
  • Comparing Primary and Copy Storage Pools
  • Deleting a Storage Pool
  • Deleting Storage Pool Volumes
  • Deleting an Empty Storage Pool Volume
  • Deleting a Storage Pool Volume with Data

  • Part 3. Managing Client Operations

  • Chapter 8. Adding Nodes
  • Overview of Clients and Servers as Nodes
  • Installing Client Node Software
  • Registering Nodes with the Server
  • Accepting Default Closed Registration or Enabling Open Registration
  • Registering Nodes with Client Options Sets
  • Registering a Source Server as a Node on a Target Server
  • Registering an Application Programming Interface to the Server
  • Connecting Nodes with the Server
  • Required Client Options
  • Non-Required Client Options
  • UNIX Client Options
  • Adding Clients from the Administrative Command Line Client
  • Enabling Open Registration
  • Configuring the Client Options File to Connect with the Server
  • Example: Register Three Client Nodes Using the Administrative Command Line
  • Chapter 9. Managing Client Nodes
  • Managing Clients
  • Defining Client Options from the Server
  • Managing Client Node Access
  • Accessing Clients with Client Access User IDs
  • Requesting Information about Client Nodes
  • Requesting Information about File Spaces
  • Deleting File Spaces and Client Nodes
  • Controlling Administrator and Client Node Passwords
  • Setting Password Authentication
  • Setting the Administrative Web Interface Authentication
  • Setting User Password Expiration
  • Setting Invalid Password Limit
  • Setting a Minimum Password Length
  • Managing Client Sessions
  • Requesting Information about Client Sessions
  • Canceling a Client Session
  • Managing Client Restartable Restore Sessions
  • Controlling Administrator Access to the Server and Clients
  • Registering Administrators or Updating Information
  • Granting Administrative Authority
  • Renaming an Administrator
  • Changing Administrative Authority
  • Removing Administrators
  • Locking and Unlocking Administrators from the Server
  • Requesting Information about Administrators
  • Disabling or Enabling Access to the Server
  • Chapter 10. Managing Client Data Using Policies
  • Client Operations Controlled by Policy
  • Backup and Restore
  • Archive and Retrieve
  • Client Migration and Recall
  • The Parts of a Policy
  • More on Management Classes
  • Contents of a Management Class
  • Default Management Classes
  • The Include-Exclude List
  • How Files and Directories Are Associated with a Management Class
  • How Files Are Deleted
  • How Tivoli Storage Manager Selects Files for Policy Operations
  • Incremental Backup
  • Selective Backup
  • Logical Volume Backup
  • Archive
  • Automatic Migration from a Client Node
  • How Client Migration Works with Backup and Archive
  • Getting Users Started
  • Using the Standard Policy
  • Creating Your Own Policies
  • Example: Sample Policy Objects
  • Defining and Updating a Policy Domain
  • Defining and Updating a Policy Set
  • Defining and Updating a Management Class
  • Defining and Updating a Backup Copy Group
  • Defining and Updating an Archive Copy Group
  • Assigning a Default Management Class
  • Validating and Activating a Policy Set
  • Running Expiration Processing to Delete Expired Files
  • Changing Policy with the Active Policy Set
  • Setting Policy to Enable Point-in-Time Restore for Clients
  • Policy for Tivoli Storage Manager Servers as Clients
  • Configuring Policy for Tivoli Data Protection Application Clients
  • Policy for Logical Volume Backups
  • Distributing Policy Using Enterprise Configuration
  • Querying Policy
  • Querying Copy Groups
  • Querying Management Classes
  • Querying Policy Sets
  • Querying Policy Domains
  • Deleting Policy
  • Deleting Copy Groups
  • Deleting Management Classes
  • Deleting Policy Sets
  • Deleting Policy Domains
  • Chapter 11. Scheduling Operations for Clients
  • Automating a Basic Client Operation
  • Defining Client Schedules
  • Associating Client Nodes with Schedules
  • Starting the Scheduler on the Clients
  • Creating Command Files to Run on Schedules
  • Displaying the Scheduling Information
  • Updating the Client Options File to Automatically Generate a New Password
  • Comparing Tivoli Storage Manager Scheduling Across Platforms and Components
  • Scheduling Tivoli Storage Manager Commands
  • Chapter 12. Performing Operations for Clients
  • Issuing Commands for Immediate Processing on a Client Node
  • Coordinating Client Schedules
  • Setting the Scheduling Mode
  • Specifying the Schedule Period for Incremental Backup Operations
  • Controlling the Server's Scheduled Workload
  • Controlling Contact with the Server
  • Tailoring Schedules
  • Example: Defining a New Client Schedule
  • Example: Updating an Existing Client Schedule
  • Copying Schedules
  • Deleting Schedules
  • Managing Scheduled Event Records
  • Querying Event Records
  • Removing Event Records from the Database
  • Managing Client Associations with Schedules
  • Querying Associations
  • Deleting Associations
  • What are Client Backup Sets?
  • Generating Client Backup Sets on the Server
  • Selecting a Name for the Backup Set
  • Choosing Media for the Backup Set
  • Setting a Retention Period for the Backup Set
  • Example: Generating a Client Backup Set
  • Understanding How Backup Sets are Managed
  • Moving Backup Sets to Other Servers
  • Managing Client Backup Sets
  • Updating the Retention Period of a Backup Set
  • Deleting Backup Sets
  • Displaying Backup Sets

  • Part 4. Maintaining the Server

  • Chapter 13. Working with a Network of Tivoli Storage Manager Servers
  • Concepts for Working with a Network of Servers
  • Configuring and Managing Servers: Enterprise Configuration
  • Performing Tasks on Multiple Servers
  • Central Monitoring
  • Storing Data on Another Server
  • Example Scenarios
  • Planning for Enterprise Administration
  • Setting Up Communications Among Servers
  • Setting Up Communications for Enterprise Configuration and Enterprise Event Logging
  • Setting Up Communications for Command Routing
  • Updating and Deleting Servers
  • Setting Up an Enterprise Configuration
  • Enterprise Configuration Scenario
  • Creating the Default Profile on a Configuration Manager
  • Creating and Changing Configuration Profiles
  • Getting Information about Profiles
  • Subscribing to a Profile
  • Refreshing Configuration Information
  • Returning Managed Objects to Local Control
  • Setting Up Administrators for the Servers
  • Handling Problems with Synchronization of Profiles
  • Switching a Managed Server to a Different Configuration Manager
  • Deleting Subscribers from a Configuration Manager
  • Renaming a Managed Server
  • Performing Tasks on Multiple Servers
  • Using Tivoli Storage Manager Enterprise Logon
  • Routing Commands
  • Setting Up Server Groups
  • Querying Server Availability
  • Using Virtual Volumes to Store Data on Another Server
  • Setting Up Source and Target Servers for Virtual Volumes
  • Performing Operations at the Source Server
  • Reconciling Virtual Volumes and Archive Files
  • Chapter 14. Managing Server Operations
  • Tivoli Storage Manager Licensing
  • Licensed Features
  • License Compliance
  • Registering Licensed Features
  • Monitoring Licenses
  • Starting, Halting, and Restarting the Server
  • Starting the Server
  • Halting the Server
  • Restarting the Server
  • Managing Server Processes
  • Requesting Information about Server Processes
  • Canceling Server Processes
  • Preemption of Client or Server Operations
  • Setting the Server Name
  • Adding or Updating Server Options
  • Adding or Updating a Server Option without Restarting the Server
  • Automatic Tuning of Server Options
  • Getting Help on Commands and Error Messages
  • Chapter 15. Automating Server Operations
  • Automating a Basic Administrative Command Schedule
  • Defining the Schedule
  • Verifying the Schedule
  • Tailoring Schedules
  • Example: Defining and Updating an Administrative Command Schedule
  • Copying Schedules
  • Deleting Schedules
  • Managing Scheduled Event Records
  • Querying Events
  • Removing Event Records from the Database
  • Tivoli Storage Manager Server Scripts
  • Defining a Server Script
  • Managing Server Scripts
  • Running a Server Script
  • Using Macros
  • Writing Commands in a Macro
  • Writing Comments in a Macro
  • Using Continuation Characters
  • Using Substitution Variables in a Macro
  • Running a Macro
  • Controlling Command Processing in a Macro
  • Chapter 16. Managing the Database and Recovery Log
  • Database and Recovery Log
  • How Tivoli Storage Manager Processes Transactions
  • How Space Is Managed by the Server
  • Estimating and Monitoring Database and Recovery Log Space Requirements
  • Monitoring the Database and Recovery Log
  • Increasing the Size of the Database or Recovery Log
  • Automating the Increase of the Database or Recovery Log
  • Manually Increasing the Database or Recovery Log
  • Decreasing the Size of the Database or Recovery Log
  • Step 1: Determining If Volumes Can Be Deleted
  • Step 2: Reducing the Capacity of the Database or Recovery Log
  • Step 3: Deleting a Volume from the Database or Recovery Log
  • Optimizing the Performance of the Database and Recovery Log
  • Dynamically Adjusting the Database Buffer Pool Size
  • Improving VSAM and Tivoli Storage Manager Performance
  • Manually Adjusting the Database Buffer Pool Size
  • Adjusting the Recovery Log Buffer Pool Size
  • Compressing the Database
  • Chapter 17. Monitoring the Tivoli Storage Manager Server
  • Using Tivoli Storage Manager Queries to Display Information
  • Requesting Information about Tivoli Storage Manager Definitions
  • Requesting Information about Client Sessions
  • Requesting Information about Server Processes
  • Requesting Information about Server Settings
  • Querying Server Options
  • Querying the System
  • Using SQL to Query the Tivoli Storage Manager Database
  • Using the ODBC Driver
  • Issuing SELECT Commands
  • Using SELECT Commands in Tivoli Storage Manager Scripts
  • Canceling a SELECT Command
  • Controlling the Format of SELECT Results
  • Querying the SQL Activity Summary Table
  • Creating Output for Use by Another Application
  • Using the Tivoli Storage Manager Activity Log
  • Changing the Size of the Activity Log
  • Setting the Activity Log Retention Period
  • Requesting Information from the Activity Log
  • Logging Tivoli Storage Manager Events to Receivers
  • Controlling Event Logging
  • Logging Events to the Tivoli Storage Manager Server Console and Activity Log
  • Logging Events to a File Exit and a User Exit
  • Logging Events to NetView for MVS
  • Logging Events to the Tivoli Event Console
  • Enterprise Event Logging: Logging Events to Another Server
  • Querying Event Logging
  • Monitoring Errors and Diagnosing Problems
  • Monitoring Tivoli Storage Manager Accounting Records
  • Chapter 18. Exporting and Importing Data
  • Data That Can Be Exported and Imported
  • Preparing to Export or Import Data
  • Using Preview before Exporting or Importing Data
  • Planning for Sequential Media Used to Export Data
  • Monitoring Export and Import Processes
  • Requesting Information about an Export or Import Process
  • Viewing Information from an Administrative Client
  • Querying the Activity Log for Export or Import Information
  • Exporting Data to Sequential Media Volumes
  • Deciding When to Export Data
  • Exporting Server Data
  • Exporting Administrator Information
  • Exporting Client Node Information
  • Exporting Policy Information
  • Importing Data from Sequential Media Volumes
  • Step 1: Previewing Information before You Import Data
  • Step 2: Importing Definitions
  • Step 3: Tailoring Server Storage Definitions on the Target Server
  • Step 4: Importing File Data Information
  • Considerations When Importing Data
  • Recovering from Errors during the Import Process
  • Exporting and Importing Data from Virtual Volumes

  • Part 5. Protecting the Server

  • Chapter 19. Protecting and Recovering Your Server
  • Levels of Protection
  • Storage Pool Protection
  • Database and Recovery Log Protection
  • Protecting and Recovering Data: An Overview
  • Protecting Your Database and Storage Pool
  • Recovering to a Point-in-Time
  • Recovering a Lost or Damaged Storage Pool Volume
  • Mirroring the Database and Recovery Log
  • Allocating Volume Copies to Separate Physical Disks
  • Defining Database or Recovery Log Mirrored Volumes
  • Specifying Mirroring and Database Page Shadowing Server Options
  • Requesting Information about Mirrored Volumes
  • Backing Up Storage Pools
  • Delaying Reuse of Sequential Access Volumes
  • Using Copy Storage Pools to Improve Data Availability
  • Example: Simple Hierarchy with One Copy Storage Pool
  • Backing Up the Database
  • Defining Device Classes for Backups
  • Setting the Recovery Log Mode
  • Scheduling Database Backups
  • Estimating the Size of the Recovery Log
  • Automating Database Backups
  • Saving the Volume History File
  • Saving the Device Configuration File
  • Doing Full and Incremental Backups
  • Doing Snapshot Database Backups
  • Recovering by Using Mirrored Volumes
  • Recovering by Using Database and Storage Pool Backups
  • Restoring a Database to a Point-in-Time
  • Restoring a Database to its Most Current State
  • Restoring Storage Pools
  • Restoring Storage Pool Volumes
  • What Happens When a Volume Is Restored
  • When a Volume Restoration Is Incomplete
  • Auditing a Storage Pool Volume
  • What Happens When You Audit Storage Pool Volumes
  • Auditing a Volume in a Disk Storage Pool
  • Auditing Multiple Volumes in a Sequential Access Storage Pool
  • Auditing a Single Volume in a Sequential Access Storage Pool
  • Correcting Damaged Files
  • Maintaining the Integrity of Files
  • Restoring Damaged Files
  • Backup and Recovery Scenarios
  • Protecting Your Database and Storage Pool
  • Recovering to a Point-in-Time from a Disaster
  • Recovering a Lost or Damaged Storage Pool Volume
  • Chapter 20. Using Tivoli Disaster Recovery Manager
  • Features of Tivoli Disaster Recovery Manager
  • Automated Generation of a Server Disaster Recovery Plan
  • Offsite Recovery Media Management
  • Storage of Client Recovery Information
  • Setting Up and Using Tivoli Disaster Recovery Manager
  • Licensing Tivoli Disaster Recovery Manager
  • Defining Tivoli Storage Manager Server Machine Information
  • Backing up the Primary Storage Pools and the Database
  • Creating and Storing the Disaster Recovery Plan
  • Querying, Displaying, and Expiring Recovery Plan Files Saved on a Target Server
  • Storing Client Recovery Information
  • Customizing Tivoli Disaster Recovery Manager
  • Customizing the Contents of Disaster Recovery Plan Files
  • Customizing the Management of Offsite Recovery Media
  • Querying the Tivoli Disaster Recovery Manager System Parameters
  • Customizing the Site-Specific Recovery Instructions
  • Performing Routine Operations
  • Sending Server Backup Volumes Offsite
  • Moving Reclaimed or Expired Volumes Back Onsite
  • Recovering Your Tivoli Disaster Recovery Manager System
  • Recovering the Server
  • Recovering the Clients
  • Using Tivoli Disaster Recovery Manager without a Tape Management Product
  • Tivoli Disaster Recovery Manager Controls Volume Movement without the Tape Management Product
  • Routine Operations
  • Using Tivoli Disaster Recovery Manager with a Tape Management Product
  • DRM User Scenarios
  • Scenario 1: Tivoli Disaster Recovery Manager Controls Volume Movement
  • Scenario 2: Removable Media Management Controls Volume Movement
  • Recovering the Server Scenario
  • Recovering Clients Scenario
  • Summary of Tivoli Disaster Recovery Manager Use
  • Tivoli Disaster Recovery Manager Checklist
  • The Disaster Recovery Plan
  • Breaking Out a Disaster Recovery Plan File
  • Structure of the Disaster Recovery Plan File
  • Example Disaster Recovery Plan File
  • Example SMS Version of the Disaster Recovery Plan File

  • Part 6. Appendixes

  • Appendix A. User Exit and File Exit Receivers
  • Sample User Exit Declarations (ANRUSRXH.H)
  • Sample User Exit Program (ANRUSRXC.C)
  • Sample Assembler User Exit DSECT (ANRUSRXA)
  • Readable Text File Exit (FILETEXTEXIT) Format
  • Appendix B. Notices
  • Programming Interface
  • Trademarks
  • Glossary

  • Index

  • [ Top of Page | Previous Page | Next Page | Table of Contents | Index ]