Administrator’s Guide
Administrator’s Guide
5608-ISM,  5608-ISX,  5608-SAN,  5608-ARM)  and  to  any  subsequent  releases  until  otherwise  indicated  in  new  editions 
or   technical
 
Changes  since  the  previous  edition  are  marked  with  a  vertical   bar  (  |  )  in  the  left  margin.  Ensure  that  you  are  using 
the   correct
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  have 
comments   a bout
US  Government  Users  Restricted  Rights  –  Use,  duplication  or  disclosure  restricted   by  GSA  ADP  Schedule  Contract 
with   IBM
About this Publication . . . . . . . . xiii IBM  Tivoli   Storage  Manager  Publications  .  .  .   . xiii
IBM  Tivoli  Storage  Manager  Library  .   .  .  .   . xiii 
Related   IBM
Support  Information  .   .   .  .  .   .   .  .  .   .   . xv Searching  knowledge   bases  .  .   .   .  .  .   .   . xv Obtaining  fixes  .  .  .   .   .  .  .   .   .  .  .   . xvi  
Contacting  IBM  Software  Support  .   .  .  .   . xvi  
Conventions  Used  in  This  Guide  .  .   .   .   .  . xviii 
Changes for Tivoli Storage Manager Version 5 . . . . . . . . . . . . . xix Technical  Changes  for  Version  5  Release  5  — 
November   2007  .  .  .   .   .   .  .  .   .   .  .  .   . xix 
Part 1. IBM Tivoli Storage Manager Basics . . . . . . . . . . . . . . . 1  
Chapter 1. Introducing IBM Tivoli Storage Manager . . . . . . . . . . . 3 How  IBM  Tivoli  Storage  Manager  Stores   Client  Data   5 
Options  for  Data  Protection  .   .  .  .   .   .  .  . 8 How  Data   Moves   to  Server  Storage  .   .   .   .  . 14 Consolidating  Backed-up  Data  for  Clients  .  .  . 15
How  the  Server  Manages  Storage  .   .  .   .   .   .  . 16 
IBM  Tivoli  Storage  Manager  Device  Support  .  . 16 Migrating  Data  through  the  Storage  Hierarchy  . 16 Removing
  Expired
  Data
 
Chapter 2. Getting Started with Tivoli Storage Manager . . . . . . . . . . 19 Interfaces  to  Tivoli  Storage  Manager  .  .   .   .  . . 19 
Customizing  the  Server  with  the  Server  Options  File  20 
Configuring  and  Managing  Server  Storage  .   .  .  . 20 
Using   Hard
 
Storage  Manager  .   .  .  .   .   .  .  .   .   .  . 21 Using  Tape Volumes  .  .  .   .   .  .  .   .   .  . 22 Migrating  Data  from   Disk  to  Tape .  .  .   .   .  . 22 Managing  Storage  Pools  and  Volumes  .   .   .  . 23 
Using  HACMP  for  Server  Availability   .   .   .  .  . 24 
Managing  Client  Operations  .   .   .   .  .  .   . .  . 25 
  Policies
  for
  Client
  Data
Managing  the  Database  and  Recovery  Log  .   . . 33
Monitoring  the  IBM  Tivoli  Storage  Manager 
Server  . .  .  .   .   .  .  .   .   .   .  .  .   .   . 34 
Manager  Servers .   .   .  .  .   .   .  .  .   .   .   . 34 
Protecting   IBM
Functions  not  in  the  Administration  Center  .  .  . 39 Protecting  the  Administration  Center  .   .   .  .  . 42 
Part 2. Configuring and Managing Server Storage . . . . . . . . . . 45 
Chapter 3. Introducing Storage Devices 47 How
  to
  Use
  the
  Server
  Storage
  Chapters
Library,  Drive,  and  Device  Class  .  .  .   .   .  . 53 
Storage  Pool  and  Storage  Pool   Volume  .   .   .  . 53 Data  Movers  .  .   .   .  .  .   .   .   .  .   .   .   . 55 Path  .   .   .  .  .   .   .   .  .   .   .   . .  . .   . 55 
Server  
Selecting  a  Device  Configuration  .  .  .   .   .  . . 58 
Devices  on  a  Local  Area  Network   .  .  .   .   .  . 58 Devices  on  a  Storage  Area  Network   .   .   . .  . 58 
LAN-Free  Data  Movement  .   .   .  .  .   . .  . 60 
Dismounts  Removable  Media  .   . . . .   . .  . 63 How
  IBM
  Tivoli
  Storage
  Manager
  Uses
  and
  Reuses
Devices  .   . . .   .   .  .  .   .   .   .  .   .   .   . 68
  Disk
  Devices
Access  Disk  Devices  .  .  .   .   .  .  .   .   .  . 73 
 
Devices  .   .   .  .  .   .   .  .  .   .   .  .  .   .   . 77 Configuring  FILE  Sequential  Volumes  on  Disk 
Devices  .   .   .  .  .   .   .  .  .   .   .  .  .   .   . 77 Varying  Disk  Volumes  Online  or  Offline  .  .   .   .  . 78 
Using   Cache
Chapter 5. Attaching Devices to the Server System . . . . . . . . . . . 81 Devices
  Supported
   by
  Tivoli
  Storage
  Manager
  . 82
Setting  the  Library  Mode  .  .   .   .   .  .  .   .   . 82 Installing  and  Configuring  Device  Drivers  .   .   .  . 83
Drivers  for  IBM  Devices  .  .   .   .   .  .  .   .   . 83 
Drivers  for  non-IBM  Devices  .   .  .  .   .   .   . 84 
Determining  Device  Special  File  Names  .   .   .  . 85 
Installing  Device  Drivers  for  IBM  SCSI  Tape Devices  .   .   .  .  .   .   .  .  .   .   .  .  .   .   . 86 Installing
  Device
  Drivers
  for
  IBM
  349X
  Libraries
  87
Configuring  Tivoli  Storage  Manager  Device 
Drivers  for  Tape or  Optical  Drives  .  .  .   .   .   . 87 Managing  SCSI  Devices  and  Fibre  Channel 
Devices  .   .   .  .  .   .   .  .  .   .   .  .  .   .   . 88
Chapter 6. Configuring Storage Devices 91 Device  Configuration  Overview .   .  .  .   .   . . 92 
Mixing   Device
Configuring  SCSI  Libraries  used   by  One  Server  .  . 95 
Set  up  the  Devices  on  the  Server  System .   .   .  . 95 
Define  the  Devices  to  IBM  Tivoli  Storage 
Manager  .   .  .  .   .   .  .  .   .   .   .  .  .   . 95 
Check  in  and  Label  Library  Volumes  .  .   .   .   . 99 Using  the  Devices  to  Store  Client  Data  .   .   .   . 100 
Configuring   SCSI
Set  up  the  Device  on  the  Server  Systems  and  the 
SAN  .   .   .   .  .   .   .   .  .  .   .   .  .  .   . 100 Setting  up  the  Library  Manager  Server  .  .   .   . 101 
Setting  up  the  Library  Client  Servers  .   .   .   . 102 
Using  the  Devices  to  Store  Client  Data  .   .   .   . 103 
Migrating  DEFINE   DRIVE  and  DEFINE   PATH Definitions  to  the  Library  Manager  Server  .   .  . 103 
Configuring   IBM
Configuring  an  IBM  3494  Library  for  Use   by   One 
Server  . .   .   .  .  .   .   .   .  .  .   .   .  .  .   . 105 
Define  the  Devices  to  IBM  Tivoli  Storage 
Manager  .   .   .  .  .   .   .  .  .   .   .  .  .   . 106 
Check  in  and  Label  Library  Volumes  . .   .   . 109 Using  the  Devices  to  Store  Client  Data  . . . . 110  
Sharing  an  IBM  3494  Library  Among  Servers  .  .   . 110 
Setting  up  Server  Communications  .   .  .  .   . 110 
Set   up
Using  the  Devices  to  Store  Client  Data  . . . . 112  
Migrating  an  IBM  3494  Library  to  Control    by  a 
Library  Manager  . .  .  .   .   .  .  .   .   .  .  . 113 Sharing  an  IBM  3494  Library   by  Static  Partitioning 
of   Drives  .  .  .   .   .  .  .   .   .  .  .   .   .  .  . 114 
Set  up  the  Device  on  the  Server  System  .  .   . 117 
Define  the  Devices  to  IBM  Tivoli  Storage 
Manager  . . . . . .   .   .  .  .   .   .   .  . 117 Setting  up  the  Library  Manager  Server  .  .   .   . 121 
Setting   up
Removable  Files  Devices  .  .   .   .  .  .   .   . 125 
Manager  Programs  . . .   .  .  .   .   .  .  .   . 125 
an   External
Configuring  Manually  Mounted  Devices  .  .   .   . 127 
Set  up  the  Device  on  the  Server  System  .   .   . 127 
Define  the  Device  to  IBM  Tivoli  Storage 
Manager  .   .   .  .  .   .   .  .  .   .   .  .  .   . 128 
Configuring   IBM
NDMP  Operations . .   .   .  .  .   .   .   .  .  .   . 131 
Defining  Devices  and  Paths  .  .   .   .  .  .   .   . 131 Defining  Libraries  .   .   .  .  .   .   .  .  .   .   . 132 Defining  Drives  .   . . . .   .   .  .  .   .   . 133 Defining
  Data Movers
 
 
Data  Formats  for  Backup  Operations  Using  NDMP   142 
Planning  for  NDMP   Operations  .   .  .  .   .   .  . 142 
Planning  for  Tape Libraries  and  Drives  used  in 
NDMP Operations .   .  .  .   .   .   .  .   .   .   . 142 
Directly  to  the  NAS  Device  .   .   .  .  .   .   .  . 147 
Planning  for  File-Level  Restore  .  .  .   .   .  . 149 
Directory-Level  Backup  and  Restore  .  .   .   . . 150 
Configuring  Tivoli  Storage  Manager  for  NDMP  
Operations  
Policy  for  NDMP   Operations  .   .  .  .   .   .  . 155 
Step  4.  Registering  NAS  Nodes   with  the  Tivoli 
Storage  Manager  Server  .  .   .   .  .  .   . .   . 156 
Step  5.  Defining  a  Data  Mover  for  the  NAS  File 
Server   .
the  Library  .  .   .   .  .  .   .   .   .  .  .   .   . 158 
Step  10.  Defining  Virtual  File  Spaces .  .   .   .  . 159 
Step  11.  Tape-to-Tape  Copy  to  Back  Up  Data  159 
Step  12.  Tape-to-Tape  Copy   to  Move   Data  .   .  . 159 
Backing  Up  and  Restoring  NAS  File  Servers  Using 
NDMP  
Managing  NAS  File  Server  Nodes   .  .   .   .  . 164 
Managing  Data  Movers  Used  in  NDMP  
Operations  .  .   .   .  .  .   .   .   .  .  .   .   . 165 
Dedicating   a
  Removable
  Media
Reusing  Tapes  in  Storage  Pools  .  .  .   .   .  . 177 
Setting  Up  a  Tape Rotation  .   .   .  .  .   .   .  . 177 
Reusing  Volumes   Used  for  Database  Backups 
and  Export  Operations  .  .   .   .  .  .   .   . . 179 
Maintaining  a  Supply  of   Volumes  in  a  Library 
Containing  WORM   Media  .   .   .  .  .   .   .   . 179 
Changing  the  Status  of   a  Volume  . . . .   .  . 181 
Removing  Volumes   from  a  Library  .  .   .   .  . 181 Returning
  Volumes
  to
  a
  Library
Automated  Library  .  .  .   .   .   .  .   .   .   . 183 
Messages  . . . . . .   .  .   .   .  .  .   .   . 185 Mount  Operations  for  Manual  Libraries  .   .  . 185 
Handling   Messages
Responding  to  Requests  for  Volume  Check-In  186 
Determining  Which  Volumes  Are  Mounted  .  . 187 
Dismounting  an  Idle  Volume  .   .  .  .   .   .  . 187 
Managing  Libraries  .   .  .  .   .   . .  .  .   .   . 187 
Updating   Libraries
Updating   Paths
Handling  Tape Alert  Messages  .   .  .  .   .   .   . 197 
Chapter 9. Defining Device Classes 199 Defining  and  Updating  Device  Classes  for 
Sequential  Media  .   .   .  .  .   .   .   .  . .   .   . 200 Defining
Classes  .   . . .   .   .  .  .   .   .  .  .   .   . 208 
Defining   and
Classes  .   .   .  .   .   .   .  .  .   .   .  .  .   . 219 
Deleting  a  Device  Class  .   .  .  .   .   .  .  .   .   . 222 
How  Tivoli  Storage  Manager  Fills  Volumes  .   .   . 223 
Using  Data  Compression  .  .   .   .  .  .   .   . 223 
 
Chapter 10. Managing Storage Pools and Volumes. . . . . . . . . . . . 227 Overview:  Storage  Pools .   .  .  .   .   .  .  .   .   . 228 
Primary  Storage  Pool   .   .  .  .   .   .  .  .   .   . 228 Copy  Storage  Pool  .   .   .  .  .   .   .  .  .   .   . 229 
Active-data   Pool
Pools  .   .   .  .  .   .   .   .  .  .   .   .  .  .   . 241 
Storage   Pools
How  the  Server  Groups   Files   before  Storing  .  . 248 
Where   the  Files  Are  Stored   .  .   .   .  .  .   .   . 248 
How  the  Server  Stores   Files  in  a  Storage 
Hierarchy  .  .  .   .   .   .  .   .   .   .  .  .   . 249 
Implementing   Copy
 
Disk  to  Tape.  . .   .   .   .  .   .   .   .  .  .   . 255 Migration  of   Files  in  a  Storage  Pool  Hierarchy  .  . 256 
Migration  for  Disk  Storage  Pools  .   .  .  .   .   . 257 
Migration  for  Sequential  Access  Storage  Pools  262 
Migration:  Copy  Storage  Pools  and  Active-data 
Pools  .   .   .  .  .   .   .   .  .  .   .   .  .  .   . 265 
How   the
How  Simultaneous  Write Works  .   .  .  .   .   . 269 Operational  Considerations  .  .   .   .  .  .   .   . 275 
Example:  Simultaneous  Write as  Part  of   a 
Backup  Strategy  .   .   .  .  .   .   .   .  .  .   . 278 
The   Effects
Collocation  Disabled  .   .  .  .   .   .  .  .   .   . 284 
Active-data  Pools  .   .   .  .  .   .   .  .  .   .   . 285 
Planning  for  and  Enabling  Collocation  .   .   .   . 286 Reclaiming  Space  in  Sequential  Access  Storage 
Pools  . .   .   .   .  .  .   .   .  .  .   .   .  .  .   . 288 How  IBM  Tivoli  Storage  Manager  Reclamation 
Works  .   .   .   .  .  .   .   .  .  .   .   .  .  . . 289 
Choosing   a
Drive  .   .   .   .  .   .   .   .  .  .   . .  . .   . 293 
Capacity  . . . .   .   .   .  .  .   .   .  .  .   . 294 
Reclamation   of 
Estimating  Space  Needs  for  Storage  Pools  .   .   .   . 299 
Estimating  Space  Needs   in  Random  Access 
Storage  Pools  .  .   . . . . .   .   .  .  .   . 300 Estimating  Space  Needs   in  Sequential  Access 
Storage  Pools  .  .   . . . . .   .   .  .  .   . 301 Monitoring
Storage  .   .   .  .   .   .   .  .  .   .   .  .  .   . 313 
Moving  Data   to  Other  Volumes  in  the  Same 
Storage   Pool
Procedure   for  Moving  Data .  .   .   .  .  .   .   . 320 
Moving  Data  for  a  Client  Node   .   .   .  .  .   .   . 323 
Moving  Data   for  All  File  Spaces  for  One  or 
More  Nodes  .   .  .   .   .   .  .  .   .   .  .  .   . 323 
Node  
Defining  Copy  Storage  Pools  and  Active-data  Pools  326 
Example:  Defining  a  Copy  Storage  Pool   .   .   . 327 
Comparing  Primary,  Copy  Storage,  and 
Active-data  Pools  .   .   .  .  .   .   .  .  .   .   . 328 
Chapter 11.  Adding Client Nodes . . . 335 Overview
  of 
  Clients
  and
  Servers
  as
  Nodes
Registering  a  Network-attached  Storage  File 
Server  as  a  Node   .   .  .  .   .   .   .  .  .   . . 338 
Registering  a  Source   Server  as  a  Node   on  a 
Target   Server  .   .   .  .  .   .   .   .  .  .   . . 338 
UNIX   and  Linux  Client  Options  .  .  .   .   .  . 340 
Methods  for  Creating  or  Updating  a  Client  Options 
File  .  .   .   .   .  .   .   .   .  .  .   .   .  .  .   .   . 340 
Using  the  Client  Configuration  Wizard  .   .   .  . 341 
Comparing   Network-Attached
with  the  Server  .   .   .  .  .   .   .  .  .   .   .   . 342 
Administrative  Command  Line  .  .  .   .   .  . 342 
Chapter 12. Managing Client Nodes 343 Managing Client Node Registration Techniques . . 343 Managing
  Nodes
Updating  Client  Node   Information  .   .   .   .  . 346 Renaming  Client  Nodes   .  .   .   .  .  .   .   .  . 346 
Locking  and  Unlocking  Client  Nodes   .   .   .  . 346 
Deleting  Client  Nodes  .  .   .   .  .  .   .   . . 347 
Client  Node   Name   .  .  .   .   .  .  .   . .   . 347 Displaying
  Information
  about
  Client
  Nodes
Managing  File  Spaces  .  .  .   .   .  .  .   .   .   . 355 Client  Nodes  and  File  Spaces  .   .  .  .   .   .  . 355 
Supporting  Unicode-Enabled  Clients  .   .   .  . 357 Displaying  Information  about  File  Spaces  .   .  . 365 
Moving  Data  for  a  Client  Node   .  .  .   .   .  . 366 
Deleting  File  Spaces  .  .  .   .   .  .  .   .   . . 366 
Storage  Manager  Sessions  .   .   .  .  .   .   .  . 370 
Session  .  .  .   .   .   .  .  .   .   .  .  .   .   . 371 
Managing   Client
Managing  IBM  Tivoli  Storage  Manager 
Administrators  .   .   .  .  .   .   .   .  .  .   .   . 378 
Managing  Levels  of   Administrative  Authority  380 
Managing  Passwords  and  Login  Procedures   .  . 382 
Chapter 13. Implementing Policies for Client Data . . . . . . . . . . . . 385 Basic  Policy  Planning  . . .  .   .   .  .  .   .   .   . 386 
The  Standard  Policy  .  .  .   .   .  .  .   .   . . 387 Getting  Users  Started  . . . .   .  .  .   .   .   . 388 Changing  Policy  .   .  .  .   .   .   .  . . .   . 388 File  Expiration  and  Expiration  Processing  .   .  . 389 
Client  Operations  Controlled   by   Policy  .   .   .   .  . 390 Backup
  and
  Restore
Policy  .   .   .  .   .   .   .  .  .   .   .  .  .   .   . 393 More  on  Management  Classes  .   .   .  .  .   .   .   . 395 
Contents  of   a  Management  Class  .  .  .   .   .  . 395 
Default  Management  Classes  .   .  .  .   .   .   . 396 
The  Include-Exclude List  .   .   .  .  .   .   .  . 396 
Logical  Volume  Backup  .  .   .   .  .  .   .   . . 402 
Archive  
Defining  and  Updating  a   Backup  Copy  Group   409 
Defining  and  Updating  an  Archive  Copy  Group   415 
Assigning  a  Default  Management  Class  .   . . 417 Validating  and  Activating  a  Policy  Set  .   .   . . 417 
Assigning   Client
Expiration  Processing .  .  .   .   .  .  .   .   .   . 420 Additional  Expiration  Processing  with  Disaster 
Recovery  Manager  .   .  .   . . . . . .   . 420 
Reclamation  and  the  SnapLock  Feature  .  .   . . 423 
Set  up  SnapLock  Volumes   as  Tivoli  Storage 
Manager   WORM
Application  Clients  .   .  .  .   .   .  .  .   .   . 429 Policy  for  Logical  Volume  Backups  .  .  .   .   . 429 
Configuring  Policy  for  NDMP   Operations  .   .   . 430 
Configuring  Policy  for  LAN-free  Data 
Movement   .  .  .   .   .   .  .   .   .   .  .  .   . 431 
as   Clients
Querying  Policy  .  .   .   .  .  .   .   .  .  .   .   . 435 
Deleting   Copy
  a
Encrypting  Data  on  Tape .  .  .   .   .  .  .   .   . 444 
Choosing  an  Encryption  Method  .   .  .  .   .   . 445 Changing  Your Encryption  Method   and 
Hardware   Configuration  .  .   .   .  .  .   .   . 446 Securing
Restoring  Backup  Sets  from  a  Backup-Archive 
Client  .   .   .  .  .   . .   .  .  .   .   .  .  .   . 454 
Managing  Client  Backup  Sets  .   .   .  .  .   .   . 456 
Enabling  Clients  to  Use  Subfile  Backup  .  .   .   .   . 458 Example
  of 
  Subfile
  Backups
Environment  Considerations  .   .   .  .  .   .   . 461 Restoring  Entire  File  Systems  .   .   .  .  .   .   . 461 Restoring  Parts  of   File  Systems  .   .  .  .   .   . 462 
Restoring  Databases  for  Applications  .  .   .   . 463 
Restoring  Files  to  a  Point  in  Time  .  .  .   .   . 463 
Concepts  for  Client  Restore   Operations  .  .   .   . 463 
Managing  Archive  Data   .   .  .  .   .   .  .  .   .   . 466 
Archive  Operations  Overview  . .   .  .  .   .   . 467 
Auditing   Archive
Chapter 15. Scheduling Operations for Client Nodes. . . . . . . . . . . . 473 Prerequisites  to  Scheduling  Operations  .  .   .   .   . 473 
Scheduling  a  Client  Operation  .  .   .   .  .  .   .   . 474 
Defining   Client
Creating  Schedules  for  Running  Command  Files  477 
Updating  the  Client  Options  File  to  Automatically 
Generate  a  New  Password  .  .  .   .   .   .  .   .   . 478 Commands  for  Scheduling  Client  Operations  .   .   . 478 
Chapter 16. Managing Schedules for Client Nodes. . . . . . . . . . . . 481 Managing  IBM  Tivoli  Storage  Manager  Schedules  481 
Verifying  that  the  Schedule  Ran  .   .  .  .   .   . 481 
Adding  New  Schedules  .  .  .   .   .  .  .   .   . 482 
Copying  Existing  Schedules  .   .   .  .  .   .   . 482 
Managing   Node
Removing  Nodes  from  Schedules .   .  .  .   .   . 484 
Managing  Event  Records   .  .  .   .   .  .  .   .   . 484 
Managing  Event  Records   in  the  Server  Database  486 
Managing  the  Throughput  of   Scheduled 
Operations  .   .  .  .   .   .   .  .  .   .   .  .  .   . 486 
Modifying   the
Server  .   .   .   .  .   .   .   .  .  . . . . . . 489  
the  Server  . . . . .   .  .  .   .   .  .  .   . 491 
Determining  How  Long  the  One-Time   Schedule 
Remains   Active
Part 4. Maintaining the Server . . . 495
Chapter 17. Managing Server Operations . . . . . . . . . . . . 497 Licensing  IBM  Tivoli  Storage  Manager  .  .  .   .   . 497 
Registering  Licensed  Features  .   .   .  .  .   .   . 498 
Saving  Your   Licenses  . . . .   .   .  .  .   .   . 499 
Starting  the  Server .   .  .  .   .   .  .  .   .   .  . 500 
Halting  the  Server  .   .  .  .   .   .  .  .   .   .  . 506 Moving  the  IBM  Tivoli  Storage  Manager  Server  507 
Changing  the  Date  and  Time   on  the  Server  .   .  . 507 Managing
  Server
  Processes
Adding  or  Updating  Server  Options  .  .   .   .   .  . 512 
Adding  or  Updating  a  Server  Option  without 
Restarting  the  Server  .  .  .   .   .  .  .   .   .  . 512 
Automatic  Tuning  of   Server  Options  .   .   .  . 513 
Getting   Help
Chapter 18. Automating Server Operations . . . . . . . . . . . . 515 Automating  a  Basic  Administrative  Command 
Schedule  .   .  .  .   .   .  .  .   .   .   .  .  .   .   . 515 
Querying  Events  .   .  .  .   .   .  .  .   .   .   . 520 
Removing  Event  Records   from   the  Database  .  . 521 IBM  Tivoli   Storage  Manager  Server  Scripts  .   .  . 521 
Defining   a
Using  Continuation  Characters  .  .  .   .   .  . 530 
Running  a  Macro  .   .  .  .   .   .   .  .  .   .   . 531 
Controlling  Command  Processing  in  a  Macro  531 
Chapter 19. Managing the Database and Recovery Log . . . . . . . . . 533 How  IBM  Tivoli  Storage  Manager  Processes 
Transactions   .  .  .   .   .  .  .   .   .   .  .  .   .   . 534 
Available   Space
The  Advantages  of   Using   Journal  File  System  Files 
with  Database  and  Log  Volumes  .   .  .  .   .   .  . 538 Estimating  and  Monitoring  Database  and  Recovery 
Log  Space  Requirements .  .  .   .   .  .  .   .   .   . 538 
Increasing  the  Size  of   the  Database  or  Recovery  
Log .  .   .   .   .  .  .   .   .  .  .   .   .  .  .   .   . 541 
Recovery  Log  .   .   .   .  .   .   .   .  .  .   .   . 541 
of    Space
Step  2:  Reducing  the  Capacity  of   the  Database 
or  Recovery  Log  .   .  .  .   .   .   .  .  .   .   . 547 
Recovery  Log  .   .   .   .  .   .   .   .  .  .   .   . 547 
Utilizing  Hardware   with  Non-Volatile  Write Cache  . . . .   .   .   .  .  .   .   .  .  .   .   . 549 
Adjusting  the  Database  Buffer  Pool   Size  .   .  . 549 Manually  Adjusting  the  Database  Buffer  Pool  
Size  .   . . . .   .   .  .  .   .   .  .  .   .   . 549 
Estimating   Database
 
Chapter 20. Monitoring the IBM Tivoli Storage Manager Server. . . . . . . 557 Using  IBM  Tivoli   Storage  Manager  Queries  to 
Display  Information  .   .  .  . . . . .   .   .   . 557 
Storage   Manager
Querying  Server  Options  .   .   .  .  .   .   .  . 560 
Querying  the  System  .  .  .   .   .  .  .   .   .   . 561 
Manager  Database  .   .   .   .  .  .   .   .  .  .   .   . 562 
Issuing  SELECT  Commands  .   .  .  .   .   .   . 562 
Controlling  the  Format  of   SELECT  Results  .  . 566 
Querying  the  SQL  Activity  Summary  Table . . 566 Creating  Output  for  Use   by   Another  Application  567 
Using  the  IBM  Tivoli  Storage  Manager  Activity  Log  567 
Requesting  Information  from   the  Activity  Log  568 
Setting  a  Retention  Period  for  the  Activity  Log  569 
Setting  a  Size  Limit  for  the  Activity  Log  .  .  . 569 
Logging   IBM
Logging  Events   to  the  IBM  Tivoli   Storage 
Manager  Server  Console  and  Activity  Log  .   .  . 572 Logging  Events   to  a  File  Exit  and  a  User  Exit  572 
Logging  Events   to  the  Tivoli  Enterprise  Console  573 
Logging  Events   to  an  SNMP   Manager  .   .   .  . 577
 
Another  Server  .  .   .   .  .  .   .   .  .  .   .   . 582 
Scheduling  the  Decision  Support  Loader  with 
IBM   Tivoli
Reporting  .   .  .  .   .   .   .  .   .   .   .  .  .   . 587 
Operational  Reporting  Stand-alone  Package  .   . 590 
Generating  a  Comprehensive  Report  at  Regular 
Intervals  
 
Completing  the  Set  Up  .  .  .   .   .  .  .   .   . 597 Viewing  Reports  and  Other  Features  from   the 
Management  Console .   .  .  .   .   .  .  .   .   . 599 
Command  Line  .  . . .  .  .   .   .   .  .  .   . 602 
Chapter 21. Working with a Network  of IBM Tivoli Storage Manager Servers . . . . . . . . . . . . . . 607 Concepts  for  Working  with  a  Network   of   Servers  607 
Configuring  and  Managing  Servers:  Enterprise 
Configuration  
Example  Scenarios .   .   .  .  .   .   .   .  .   .   . 610 
Setting  Up  Communications  for  Enterprise 
Configuration  and  Enterprise  Event  Logging  .  . 612 Setting  Up  Communications  for  Command 
Routing  
Manager  .   .   .  .   .   .   .  .  .   .   .  .  .   . 623 
Getting  Information  about  Profiles  .  .   .   .   . 631 
Subscribing  to  a  Profile  .  .  .   .   .  .  .   .   . 633 
Refreshing  Configuration  Information  .   .   .   . 637 Returning Managed
  Objects
  to
  Local
  Control
  638
Configuration  Manager  .  .  .   .   .  .  .   .   . 639 
Manager  .   .   .  .   .   .   .  .  .   .   .  .  .   . 640 
Performing  Tasks  on  Multiple  Servers  .  .  .   .   . 640 
Working  with  Multiple  Servers  Using  the 
Administration  Center  .  .  .   .   .  . . . . 640 Routing  Commands  .   .  .  .   .   .   .  .  .   . 641 
Setting  Up  Server  Groups   .  .   .   .  .  .   .   . 643 
Querying  Server  Availability   .   .   .  .  .   .   . 645 
Server   . . .
Chapter 22. Exporting and Importing Data . . . . . . . . . . . . . . . 653 Data
  That
  Can
  Be
  Exported
  and
  Imported
Deciding  What  Information  to  Export   .  .   .   . 654 
Deciding  When  to  Export  .  .   .   .  .  .   .   . 655 Exporting  Data  Directly  to  Another  Server .   .   .   . 656 
Options  to  Consider  Before   Exporting  .  .   .   . 656 Preparing  to  Export   to  Another  Server  for 
Immediate  Import  .   .   .  .  .   .   .   .  .  .   . 660 
Exporting   Administrator
Exporting  and  Importing  Data  Using  Sequential 
Media  Volumes  .  .  .   .   .   .  .  .   .   .  .  .   . 663 
Media)  
Volumes  . . . .   .   .   .  .  .   .   .  .  .   . 680 
Chapter 23. Protecting and Recovering Your Server . . . . . . . 685 Levels
  of 
  Protection
How  Restore  Processing  Works   .   .  .  .   .   . 687 
How  the  Destroyed  Volume  Access  Mode   Works  688 
Database  and  Recovery  Log  Protection:  An 
Overview .   .   .  .  .   .   .   .  .  .   .   .  .  .   . 688 
Mirroring .   .  .  .   .   .   .  .  .   .   .  .  .   . 689 
Database   and
and  Recovery  Log  .   .   .  .  .   .   .   .  .  .   . 692 
Volume  Copies  .  .   .   .   .  .  .   .   .  .  .   . 692 
Shadowing  Server  Options  . . . . .   .   .   . 693 
Example:  Simple  Hierarchy  with  One  Copy 
Storage   Pool
Active-data  Pools  .   .  .  .   .   .  .  .   .   .   . 699 
Purposes  . . . .   .   .  .  .   .   .  .  .   .   . 700 
Defining   Device
Saving  the  Server  Options  .   .   .  .  .   .   .  . 709 
Saving  the  Database  and  Recovery  Log 
Information  .  .   .   .  .  .   .   .   .  .   .   .   . 709 
Doing   Full
Restoring  a  Database  to  its  Most  Current  State  715 
Restoring  Storage  Pools  .  .   .   .  .  .   .   .  . 715 
Restoring  Storage  Pool   Volumes  .   .  .  .   .   .  . 719 
What  Happens  When  a   Volume  Is  Restored   .  . 720 
When   a
Data  Validation  During  Audit  Volume 
Processing  .  .   .   .  .  .   .   .   .  .  .   .   . 723 Auditing  a  Volume  in  a  Disk  Storage  Pool   .   .  . 727 
Auditing  Multiple  Volumes  in  a  Sequential 
Access  Storage  Pool  .  .  .   .   .  .  .   . .   . 727 
Storage   Pool
Maintaining  the  Integrity  of   Files  .  .   .   .   .  . 729 Restoring  Damaged  Files  .   .   .  .  .   .   .  . 730 
Backup  and  Recovery  Scenarios  .   .  .  .   .   . . 731 Protecting  Your Database  and  Storage  Pools  .  . 731 
Recovering   to
Chapter 24. Using Disaster Recovery Manager . . . . . . . . . . . . . 739 Querying
  Defaults
  for
  the
  Disaster
  Recovery
  Plan
Plan  File  .  .  .   .   .   .  .  .   .   .  .  .   .   . 740 
Management  .   .   .   .  .  .   .   .  .  .   . . 742 
Specifying   Information
Storing  the  Disaster  Recovery  Plan  on  a  Target  
Server . . . . . . . . . . . . . . . 749 Managing  Disaster  Recovery   Plan  Files  Stored   on 
Target  Servers  .  .   .   .   .  .   .   .   .  .  .   .   . 750 
Files  
Moving  Backup  Media  .  .  . .   .   .  .  .   .   . 752 
Moving  Backup  Volumes  Offsite  .  .  .   .   .  . 754 
Moving  Backup  Volumes  Onsite  .  .  .   .   .  . 755 Summary  of   Disaster  Recovery   Manager  Daily 
Tasks  .  .   .   .  .  .   .   .  .  .   .   .  .  .   .   . 757 Staying
Recovery  Site  .  .   . . .  .   .   .   .  .  .   .   . 764 
a  Manual  SCSI  Library  at  the  Recovery  Site  . . 764 
Automated  SCSI  Library  at  the  Original  and 
Recovery  Sites  . . . .   .   .   .   .  .  .   .   . 765 
Breaking  Out  a  Disaster  Recovery  Plan  File  . . 769 
Structure  of   the  Disaster  Recovery   Plan  File  .  . 769 
Example  Disaster  Recovery  Plan  File  .   .   . . 772 
Appendix A. Setting Up an IBM Tivoli Storage Manager Server in an HACMP Cluster . . . . . . . . . . . . . . 793 Failover  and  Fallback  .   .  .  .   .   .  .  .   .   .   . 793 Setup  Procedure   .   .   .  .  .   .   .   .  .  .   .   . 794 
Install  and  Configure  HACMP  for  AIX  .   .   .  . 794 
Install   the
Server  .   .   .  .   .   .   .  .  .   .   .  .  .   .   . 796 
Contents   xi
AIX  .   .   .   .  .  .   .   .  .  .   .   .  .  .   . 797 
Manager  Configurations  .  .  .   .   .  .  .   .   . 798 
Troubleshooting   Hints  .   .  .  .   .   .  .  .   .   . 798
Processing  during  Server  Initialization  .  .   .   .  . 802 
Processing  for  Mount  Requests  .   .   .  .  .   .   . 802 Processing  for  Release  Requests  .   .   .  .  .   .   . 802 Processing  for  Batch  Requests  .  .   .   .  .  .   .   . 803 
Error   Handling
Volume  Eject  Request . . .  .  .   .   .  .  .   .   . 806 
Volume  Release  Request  .   .  .  .   .   .  .  .   .   . 807 
Volume  Mount  Request  .   .  .  .   .   .  .  .   .   . 807 
Volume  Dismount  Request  .  .  .   .   .  .  .   .   . 810
Appendix C. User Exit and File Exit Receivers . . . . . . . . . . . . . 813 Sample  User  Exit  Declarations  .  .   .   .  .  .   .   . 814 
Sample  User  Exit  Program  .  .  .   .   .  .  .   .   . 817 
Readable  Text File  Exit  (FILETEXTEXIT)   Format  818 
Appendix D. Setting up the Secure Sockets Layer (SSL) . . . . . . . . 821 Enabling
  SSL
  for
  the
  Integrated
  Solutions
  Console
files  .   .   .   .  .  .   .   .  .  .   .   .  .  .   . 821 
<isc_root>\AppServer\bin  .  .   .   .  .  .   . . 824 3.  Modify  wsadmin.properties  to  reflect  the 
correct   SOAP
9. Start the ISC_Portal . . . . . . . . . 827 10.  Test your  changes  .   . . . . .   .  .  .   . 827 
Setting  up  the  Lightweight  Directory  Access 
Protocol   (LDAP)  over  SSL  .  .  .   .   .  .  .   .   . 827 
Appendix E. Notices . . . . . . . . 831 Trademarks
  .
  .
  .
  .
  .
  .
  .
  . . . . . .
About  this  Publication 
IBM® Tivoli® Storage  Manager  is   a  client/server  program  that  provides  storage 
management  solutions  to  customers  in   a  multi-vendor  computer  environment.  IBM 
Tivoli   Storage  Manager  provides  an  automated,  centrally  scheduled, 
policy-managed   backup,  archive,  and  space-management  facility  for  file   servers 
and  workstations. 
IBM  Tivoli   Storage  Manager Publications 
This  section  lists  publications  in  the  IBM  Tivoli   Storage  Manager  library  and 
related  documents.  It  also  describes  how  to  access  Tivoli   publications  online  and 
how  to  order  Tivoli   publications. 
IBM  Tivoli   Storage  Manager Library 
The  following  documents  are  available  in  theTivoli  Storage  Manager  library: 
Publication  Title  Order  Number 
IBM  
Tivoli  
Storage  
 Manager  
 for  
 AIX   
IBM  Tivoli  Storage    Manager   for    AIX    Administrator’s  Reference  SC32-0123 
IBM  Tivoli  Storage    Manager   for    AIX   Installation   Guide  GC23-5969 
IBM  
Tivoli  
Storage  
 Manager  
Basic  
Concepts  
Poster  
SC32-9464
The  following  table  lists   Tivoli   Storage  Manager  storage  agent  publications. 
Publication  Title  Order  Number 
IBM  Tivoli  Storage    Manager   for   SAN    for   AIX   Storage   Agent  User’s 
Guide 
SC32-0129 
IBM  
Tivoli  
Storage  
 Manager  
 for  
SAN   
 for  
 HP-UX   
Storage  
 Agent  
Guide  
SC32-0130  
IBM  Tivoli  Storage    Manager   for   SAN    for  Linux  Storage   Agent  User’s 
Guide 
SC32-0131 
IBM  
Tivoli  
Storage  
 Manager  
 for  
SAN   
 for  
Sun  
Solaris  
Storage  
 Agent  
Guide  
SC32-0132  
IBM  Tivoli  Storage    Manager   for   SAN    for  Windows  Storage   Agent  User’s 
Guide 
SC32-0133
Publication  Title  Order  Number 
IBM  Tivoli  Storage    Manager   for   Space   Management   for  UNIX   and  Linux:  
User’s  Guide 
Installation  
and  
Clients  Installation   and  User’s  Guide 
SC32-0145 
IBM  
Tivoli  
Storage  
 Manager  
 for  
Windows:  
Backup-Archive  
Clients  
Installation  
and  
 
Publication  Title 
WebSphere    Application  Server  Installation   and  User’s  Guide  Version   5.2  
SC32-9075  
IBM  Tivoli  Storage   Manager   for  Databases:  Data  Protection   for   Microsoft  SQL 
Server  
Installation  
and  
SC32-9064  
IBM  Tivoli  Storage   Manager   for  Databases:  Data  Protection   for  Oracle    for 
Windows  
Installation  
and  
SH26-4095  
IBM  Tivoli  Storage   Manager   for  Enterprise  Resource  Planning:   Data Protection   for 
SAP  
Installation  
and  
SC33-6340  
IBM  Tivoli  Storage   Manager   for   Hardware:  Data   Protection   for   EMC  Symmetrix 
 for  
R/3  
Installation  
and  
SC32-9060  
IBM  Tivoli  Storage   Manager   for   Hardware:  Data   Protection   for   FlashCopy  Devices 
 for Oracle Installation and User’s Guide Version 5.3 GC32-1772 
IBM  
Tivoli  
Storage  
 Manager  
 for  
 Advanced  
Copy  
Services:  
Data  
Protection  
 for  
Snapshot  
Devices  
 for  
mySAP  
Installation  
and  
Guide  
 for  
DB2  
UDB  
Version  
5.4 
SC33-8208  
IBM  Tivoli  Storage   Manager   for   Advanced  Copy   Services:  Data  Protection   for 
Snapshot  
Devices  
 for  
mySAP  
Installation  
and  
SC32-9056  
IBM  Tivoli  Storage   Manager   for   Mail:  Data  Protection   for  Lotus   Domino   for  
Windows  
Installation  
and  
Guide  
SC32-9057 
IBM  
Tivoli  
Storage  
 Manager  
 for  
 Mail:  
 z/OS  
Edition  
Licensed  
Program  
Specifications 
GC32-0838  
IBM  Tivoli  Storage   Manager   for   Mail:  Data  Protection   for   Microsoft  Exchange 
Server  
Installation  
and  
Title  Order  Number 
IBM   Magstar  3494  Tape  Library   Introduction  and  Planning  Guide  GA32-0279 
IBM  3490E    Model  E01  and   E11  User’s  Guide  GA32-0298 
IBM  
 Magstar  
 MP  
3570  
Tape  
Subsystem  
Guide  
GA32-0345  
IBM  TotalStorage  Tape  Device  Drivers  Installation   and  User’s  Guide  GC35-0154 
IBM  TotalStorage  Enterprise   Tape  System  3590  Operator  Guide  GA32-0330 
IBM  
 Magstar  
3494  
Tape  
Library  
Dataserver  
Operator  
Guide  
GA32-0280  
 
Accessing   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/order
Tivoli   Technical  Training 
For  Tivoli   technical  training  information,  refer  to  the  following  IBM  Tivoli  
Education  Web  site:  
Support  Information 
This  section  describes  the  following  options  for  obtaining  support  for  IBM 
products: 
v  “Contacting  IBM  Software  Support”  on  page  xvi
Searching  knowledge  bases 
If   you  have  a  problem  with  your  IBM  software,   begin   by   searching  the  available 
knowledge   bases  to  determine  whether  the  resolution  to  your  problem  is   already 
documented. 
Search the information center 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. 
 
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: 
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  the 
upper-right  corner  of   the  page. 
2.  If   you  have  already  registered,  skip  to  the  next  step.  If   you  have  not  registered, 
click  register  in  the  upper-right  corner  of   the  support  page  to  establish  your 
user  ID  and  password. 
3.  Sign  in   to  My  support. 
4.  On  the  My  support  page,  click  Edit  profiles  in  the  left  navigation  pane,  and 
scroll  to 
appropriate   boxes  for  the  type  of   information  you  want. 
5.  Click  Submit.  
6.  For  e-mail  notification  for  other  products,  repeat  Steps  4  and  5.
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
–  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  and 
WebSphere  products  that  run in  zSeries®,  pSeries®,   and  iSeries®  environments), 
you  can   purchase  a  software  maintenance  agreement   by   working  directly  with 
an   IBM  sales  representative  or  an  IBM  Business  Partner.   For  more   information 
about  support  for  eServer  software products,  go  to  the  IBM  Technical  Support 
Advantage  Web  page  (http://www.ibm.com/servers/eserver/techsupport.html).
If   you  are  not  sure   what  type  of   software  maintenance  contract  you  need,  call 
1-800-IBMSERV   (1-800-426-7378)  in  the  United  States  or, from  other  countries,  go  to 
the  contacts  page  of   the  IBM  Software  Support  Handbook  on  the  Web 
(http://techsupport.services.ibm.com/guides/contacts.html)  and  click  the  name  of   your  geographic  region  for  phone  numbers  of   people  who  provide  support  for 
your  location. 
Follow  the  steps  in   this  topic  to  contact  IBM  Software  Support: 
1.  Determine  the   business  impact  of   your  problem. 
2.  Describe  your  problem  and  gather   background  information. 
3.   Submit  your  problem  to   IBM  Software  Support.
Determine the business impact of your problem When  you  report  a  problem  to   IBM,  you  are  asked  to  supply  a  severity  level. 
Therefore,  you  need  to  understand  and  assess  the   business  impact  of   the  problem 
you  are  reporting.  Use  the  following  criteria: 
Severity  1  Critical   business  impact: You are  unable  to  use  the  program, 
resulting  in  a  critical  impact  on  operations.  This  condition 
requires   an
 
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
 
Severity  4  Minimal   business  impact:  The  problem  causes  little  impact  on 
operations,  or  a  reasonable  circumvention  to  the  problem  has 
 been  implemented.
Describe your problem and gather background information When  explaining  a  problem  to  IBM,   be  as  specific  as  possible.  Include  all  relevant 
 background  information  so  that  IBM  Software  Support  specialists  can  help  you 
solve  the  problem  efficiently.   To save  time,  know  the  answers  to  these  questions: 
v  What   software  versions  were  you  running  when  the  problem  occurred? 
v  Do   you  have  logs,  traces,  and  messages  that  are  related  to  the  problem 
symptoms?  IBM  Software  Support  is   likely  to  ask  for  this   information. 
v  Can  the  problem   be  re-created?  If   so,  what  steps  led  to  the  failure? 
v  Have  any  changes   been  made  to  the  system?  (For  example,  hardware,  operating 
system,  networking  software,  and  so   on.) 
About   this
 
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 
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. 
v  Command  to   be  entered  on  the  AIX® command  line: 
>  dsmadmc 
v  Command  to   be  entered  on  the  command  line  of   an  administrative  client: 
query   devclass 
Changes  for  Tivoli   Storage  Manager  Version  5 
This  section  summarizes  changes  that  were   made  to  the  Tivoli   Storage  Manager 
product  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  pool’s  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: 
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
 
The  following  server  processes  are  not  allowed  shared  read   access  to  FILE 
volumes: 
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   Administrator’s   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 
 Administrator’s   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&nb