====================================================================== Tivoli Storage Manager (TSM) Server Read1st File -- Version 3.7.1.0 Licensed Materials - Property of IBM (C) Copyright IBM Corporation 1999. All rights reserved. ====================================================================== Welcome to Tivoli Storage Manager. Contents - What's new - Installation -- Database upgrade -- TSM Versioning - Known issues | -- Latest Quantum DLT Drive Microcode is required for APAR IY03251 -- HTMLHELP online information issues -- Default program folder name has been changed -- Data Base Page Shadow Function Disabled -- Query Volhistory Command -- Library sharing support -- Changes to the TSM Administrator's Reference -- Changes to the TSM Administrator's Guide -- ADSM V3 DRM Disk Image Dump and Restore Diskettes and Doc. -- CONVERT USSFILESPACE command - Trademarks ====================================================================== What's new ====================================================================== The Tivoli Storage Manager Quick Start Manual provides details for all of the new features in this release. The Quick Start manual is available in the TSM Online Information. ====================================================================== Installation ====================================================================== -- Database upgrade When this setup is run to install TSM over an existing version of TSM the setup program will automatically upgrade the TSM database. Once the database is upgraded to V3.7 it will no longer be accessible from a previous version of TSM. -- TSM Versioning Beginning with Tivoli Storage Manager, version 3, release 7, "versioning" has changed. When a new PTF is released, the maintenance level will be raised by one. Thus 3.7.0.0 is the Initial GA level, and the first PTF will be 3.7.1.0. The last number (fix level) is reserved for individual APAR fixes and special fixtests which are sometimes necessary between PTF levels. ====================================================================== Known Issues ====================================================================== -- Latest Quantum DLT Drive Microcode is required for APAR IY03251 Customers should request the latest Quantum DLT microcode level from their library vendors. For example, for STK customers, it is V95. For ATL customers, it is level 95. -- HTMLHELP Online Information issues -- Prerequisites This release includes integrated HTMLHELP Online Information including books, readmes, questions and answers and TSM related web links. The HTMLHELP Help Viewer requires that Microsoft Internet Explorer version 3.02 or later be set up on a user's computer. It is not required that Internet Explorer be used as the system's default browser, or that the Internet Explorer icon be visible on the user's desktop. To obtain the latest version of Internet Explorer visit: http://www.microsoft.com/windows/ie Note that TSM will not set up an old version of the Help Viewer over a newer one. If you want to update the help viewer at any time visit: http://msdn.microsoft.com/workshop/author/htmlhelp -- Table of Contents subitem selection For certain entries in the table of contents you may select an item and not notice a change in position for the text displayed. There is a limitation in HTMLHELP that requires topics to be in their own file. If more than one topic is contained in a file then the HTMLHELP viewer will bring you to the right page but you will have to scroll down or search within that page to get to the topic. -- Default Program Folder name has been changed The documentation contains a number of references to the program folder named Tivoli TSM. The actual program folder name is Tivoli Storage Manager. -- Data Base Page Shadow Function Disabled The Data Base Page Shadowing function has been disabled. The DBPAGESHADOW option in the options file will have no effect. This function will be re-enabled at a later time. -- Query Volhistory Command The nodename, backupsetname, and description parameters included in the Query Volhistory command description have been deleted. The inforamtion provided by these parameters can be obtained with the query backupset command. -- Library sharing support A problem can arise where a dismount operation fails on the library client and the volume is not physically dismounted from the device. The following condition must be met for this problem to occur: 1. The library manager is down or cannot be contacted from the library client server 2. The library client attempts to dismount a volume, yet the volume is not physically removed from the drive. Issuing a QUERY MOUNT shows there are no volumes mounted. 3. The library manager can again be contacted within a 15 minute period from the initial failure. 4. Server to server communication is able to resume as normal and the library sharing recovery logic is able to verify the drive is still in use. The end result is that no mount points (QUERY MOUNT returns no volume in mount state) are in use on both the library manager and the library client, and a volume is now stuck in a device. To resume normal operation halt and restart the library client that had the volume last mounted. -- Changes to the TSM Administrator's Reference Commands Related to Expiring Database Backup Volumes and Recovery Plan Files: + SET DRMDBBACKUPEXPIREDAYS days Use this command to specify when a database backup series is eligible to be expired. The value set by this command controls expiration of full plus incremental database backup series and snapshot database backup series. The latest backup series of either type is not deleted. A full plus incremental or snapshot database backup series is eligible for expiration if all the following conditions are met: - The age of the last volume of the series has exceeded the expiration value of the SET DRMDBBACKUPEXPIREDAYS command. - The series is not the latest full plus incremental database backup series or snapshot database backup series. - In addition, for volumes that are not virtual volumes, all the volumes in the series are in the VAULT state. See the MOVE DRMEDIA command for additional information on expiration of database backup volumes that are not virtual volumes. See the EXPIRE INVENTORY command for additional information on expiration of database backup volumes that are virtual volumes. NOTE: This command only applies to environments that are licensed to use the Tivoli Disaster Recovery Manager product . + SET DRMRPFEXPIREDAYS days Use this command to specify when recovery plan files are eligible to be expired. This command and expiration processing only applies to recovery plan files that were created using the DEVCLASS parameter with the PREPARE command (i.e. virtual volumes of type RPFILE and RPFSNAPSHOT). The latest RPFILE and RPFSNAPSHOT files are not deleted. Expiration processing on the source server expires plan files stored on the target server. RPFILE and RPFSNAPSHOT files are associated with a database backup series during the generation of these recovery plan files: - An RPFILE is associated with a full plus incremental database backup series - An RPFSNAPSHOT is associated with a snapshot database backup series. An RPFILE or RPFSNAPSHOT file is eligible for expiration if all the following conditions are met: - The age of the last recovery plan file associated with a database backup series has exceeded the expiration value specified with the SET DRMRPFEXPIREDAYS command. - The recovery plan file is not associated with the most recent database backup series. See the EXPIRE INVENTORY command for additional information. NOTE: This command only applies to environments that are licensed to use the Tivoli Disaster Recovery Manager product. + EXPIRE INVENTORY When the Tivoli Disaster Recovery Manager (DRM) is licensed, the inventory expiration process removes eligible virtual volumes that are used for: - Full, incremental or snapshot database backups, that is virtual volumes of type BACKUPFULL, BACKUPINCR or DBSNAPSHOT respectively. See the SET DRMBACKUPEXPIREDAYS command for details on when these volumes are eligible for expiration. - Recovery plan files, that is virtual volumes of type RPFILE or RPFSNAPSHOT. See the SET DRMRPFEXPIREDAYS command for details on when these volumes are eligible for expiration. These volumes are not processed by expiration processing that occurs during Tivoli Storage Manager initialization. + MOVE DRMEDIA Use the MOVE DRMEDIA command to track database backup volumes and copy storage pool volumes that are to be moved offsite and to identify the expired or empty volumes that are to be moved onsite for reuse. The database backup volumes include volumes used for full, incremental, and snapshot database backups. This command does not process copy storage pool volumes and database backup volumes (full, incremental and snapshot database backup volumes) that are stored stored on another server via electronic vaulting (virtual volumes). NOTE: The state displayed by the QUERY DRMEDIA command for a volume stored on another server via electronic vaulting is REMOTE. Moving Reclaimed or Expired Volumes Back Onsite: ------------------------------------------------ MOVE DRMEDIA uses the following states for copy storage pool and database backup volumes that are to be moved back onsite: VAULT Volumes in this state contain valid data and are at the offsite location. When volume data becomes invalid the volumes automatically transition to the VAULTRETRIEVE state. VAULTRETRIEVE Volumes in this state do not contain valid data and are at the offsite vault. Volumes are to transition to this state from the VAULT state when: - Copy storage pool volumes are empty and have met the REUSEDELAY days in your copy storage pool definition - Database backup volumes are associated with a database backup series that has expired according to the SET DRMDBBACKUPEXPIREDAYS value. COURIERRETRIEVE Volumes in this state do not contain valid data, are with the courier, and being moved back to the onsite location. ONSITERETRIEVE Volumes in this state do not contain valid data, are at the onsite location, and are not managed by DRM. The volume records for the database backup (full, incremental and snapshot) and scratch copy storage pool volumes are deleted from the Tivoli Storage Manager database. The volume records of the private copy storage pool volumes are updated with the READWRITE access mode in the Tivoli Storage Manager database. -- Changes to the TSM Administrator's Guide - On page 389 in the section "Automatic Tuning of Server Options", the reference to TXNGROUPMAX should be removed. The server will not adjust the TXNGROUPMAX value on a node-by-node basis until it obtains the best performance. The tuning of the TXNGROUPMAX option is still a user configurable in the server options file. -- ADSM V3 DRM Disk Image Dump and Restore Diskettes and Doc. - The DRM Stand-alone Disk Image Dump and Restore Diskettes and Documentation have been stabilized at the ADSM Version 3.1.2 level. - The DRM Stand-alone Disk Image Dump and Restore Diskettes and Documentation will not be shipped with Tivoli Disaster Recovery Manager Product. - No maintenance or changes to the Disk Dump and Restore diskettes or documentation will be done to support new client hardware and environments or for changes in the Tivoli Storage Manager Version 3.7 Server. - If a Disk Image Dump and Restore client is used with a Tivoli Storage Manager Version 3.7 server, a warning message will be issued to the server console and written to the server activity log. The message indicates that the Disk Image Dump and Restore function has been stabilized and that no new maintenance or development will be done. - Customers can still restore disk images to the Disk Dump and Restore ADSM 3.1.2 supported hardware environment from the Tivoli Storage Manager server version 3.7. -- CONVERT USSFILESPACE command TSM now provides a utility to correct problems with the names of files and filespaces backed up or archived by an Open Edition MVS client (OEMVS client, now called System 390 UNIX client). Use this utility only if your existing TSM server has data from these clients. New TSM server databases installed with ADSM Server Version 3.1.2.30 or newer are not affected with this problem and do not have to use this utility. Problem Description ------------------- The TSM server displays incorrect character strings for filespaces and filenames in the output of a QUERY CONTENT command for files backed-up or archived by the System390 UNIX client. The problem is, that in the past and until the filespace conversion of the server is complete, System390 UNIX client sends filespace names and file names in a character set incompatible with the server. A new server command, CONVERT USSFILESPACE, corrects these character strings in the server database. You can determine if a server has files that need to be converted by issuing the following SQL commands: SELECT COUNT(*) FROM BACKUPS WHERE NODE_NAME IN () AND SUBSTR(HL_NAME,1,1)<>'/' SELECT COUNT(*) FROM ARCHIVES WHERE NODE_NAME IN () AND SUBSTR(HL_NAME,1,1)<>'/' where node list is a comma delimited list of node names that are of OEMVS platform type. This displays the number of files backed-up or archived that need conversion for the specified nodes. Example: SELECT COUNT(*) FROM BACKUPS WHERE NODE_NAME IN ( 'LISA','JIM', 'KATHY','JARED' ) AND SUBSTR(HL_NAME,1,1)<>'/' ************************************************************** * Note: * * It is recommended to back-up the server database * * before starting the conversion with the BACKUP DB command. * ************************************************************** To perform the conversion do the following : 1. Update the System390 UNIX clients to the latest level (V3.1.0.7) if you have not already done so. 2. Ensure that System390 UNIX client sessions are not running on the server. 3. Use the CONVERT USSFILESPACE command to correct the database entries. Command Details --------------- The CONVERT USSFILESPACE command processes TSM server database entries for filespaces for all nodes of platform type OEMVS and filespace type of HFS. The command corrects the database by converting character strings for file names and filespaces from System390 UNIX clients to the server compatible character set. Once the command is issued, System390 UNIX clients older than version 3.1.0.7 cannot log on to the server again. It is highly recommended to have no node sessions for System390 UNIX clients running on the server during the conversion process. If client sessions for nodes with platform type OEMVS are still running at the time this command is issued, they are cancelled by the server. All nodes eligible for conversion are locked until the conversion process is complete. If the conversion process is cancelled or stopped, the nodes remain locked until the conversion process is allowed to complete. Once the conversion is successfully complete, you will not have to run it again. Note: An administrator can unlock a node while the conversion process is running, or, when the process is not running but conversion is not complete ( ie. due to cancelled process, server stopped, etc ). However, this is not recommended since conversion may not be complete for this node. Any new data backed-up or archived with this node name before conversion is complete may cause unpredictable results for restore or retrieval of data. Privilege Class: To issue this command, you must have system privilege. Syntax >>---CONVert USSFilespace { CONTinue = Yes | No } ----<> Parameters CONTinue=continuevalue No Specifies that you want to start from the beginning of the conversion process and do not want to continue where the last conversion process stopped. This is the default. Yes Specifies that you want to continue from the last conversion. If the conversion process was cancelled or stopped for some reason, this option allows the administrator to continue the conversion from where it left off. Example: Convert all OEMVS filespaces and filenames to the correct character set. Command: CONVERT USSF ====================================================================== Trademarks ====================================================================== Tivoli and The Power to Manage. Anything. Anywhere. are trademarks or registered trademarks of Tivoli Systems Inc. in the United States, other countries, or both. In Denmark, Tivoli is a trademark licensed from Kjobenhavns Sommer - Tivoli A/S. IBM is a trademark of International Business Machines Corporation in the United States, other countries, or both.