ADSM to TSM Upgrade

About this document
    Related documentation
TSM overview
Cleanup procedures

About this document

This document serves as a guide for upgrading from ADSM to TSM. The procedure described in this document will allow a complete recovery to an earlier service level if needed at a later date. This document is not specific to any particular ADSM supported operating system or specific ADSM version. Where an operating system command example is appropriate, AIX commands are used.

NOTE: Please use this document in combination with the README file for your type of operating system.

Related documentation

The product documentation library is also available:

TSM overview

The Tivoli Storage Manager (TSM) Server includes recovery log and database structural enhancements to support new functionality. For this reason, once this upgrade is applied, returning to an earlier service level requires the reinitialization of the database and recovery log volumes. This reinitialization process (dsmserv format), will remove all previous information stored in the database and recovery log. This upgrade procedure, while more detailed than previous upgrade instructions, is designed to ensure that should a reversion to an earlier service level be necessary for any reason, all information that could be required to assist in that process is stored for future use. IMPORTANT: If a reversion is later needed, ensure that you keep your old installation media.

TSM Server README files are available online at:

Select one of the server directories, such as:

Inside each server directory will be server and client code in their respective directory paths.

NOTE: Server full-product code, required for an ADSM to TSM Version/Release upgrade (for example, 3.7, 4.1), can be purchased through Tivoli Marketing at 1-800-2-TIVOLI or your local branch/marketing office.


  1. Use the BACKUP DEVCONFIG command to back up the ADSM Device Configuration file to an alternate location (assuming that you have one defined), for example:
    	BACKUP DEVCONFIG <FILENAMES>=/tmp/devconfig.bak

    The QUERY OPTION command will show the DEVCONFIG option, if defined, which will identify the current location of this file. If you do not have one defined, please define it now by adding the following option to the dsmserv.opt file:

    	DEVCONFIG /<my_directory>/deconfig.out

    NOTE: You can acquire the same information through the QUERY LIBRARY, QUERY DRIVE, and other types of commands. Examples follow:

    	Q LIBRARY * F=D
    	Q DRIVE <lib_name> F=D
  2. Copy the Server Options file, (dsmserv.opt), to an alternate location, for example:
    	cp /usr/lpp/adsmserv/bin/dsmserv.opt /tmp/dsmserv.opt.bak
  3. If you are also updating ADSM code for the client residing on the same machine as the server, you should copy the Client Options file(s) to an alternate location. The default location for these files on AIX is usr/lpp/adsm/bin. An AIX platform example follows:
    	cp /usr/lpp/adsm/bin/dsm.sys /tmp/dsm.sys.bak
    	cp /usr/lpp/adsm/bin/dsm.opt /tmp/dsm.opt.bak

    NOTE: Windows, OS/2, and Netware clients do not have a dsm.sys file.

  4. Copy the operating system definitions for any devices utilized by ADSM. Use the AIX lsdev command to save the device definitions for any tape or optical device used with, and supported by, the ADSM device driver (the op, mt, lb names). AIX example commands follow:
    	lsdev -Cc adsmtape > /tmp/device.config
    	lsdev -Cc tape >> /tmp/device.config
    	lsdev -Cc library >> /tmp/device.config
    	lsdev -Cc rwoptical >> /tmp/device.config
    You will also need to know the parent adapter of each device, enter:
    	lsdev -Cc adapter >> /tmp/device.config

    NOTE: This is not needed for Atape/IBMTAPE devices, such as the 3570, 3575, 358X 3490, 3590, 3494, or any device classified as GENERICTAPE to ADSM.

    Please refer to the TSM Server README file for your specific operating system to determine any special requirements related to the installation or support for devices. This may include required device-driver upgrades or required operating system maintenance.

  5. Collect the log and database information, as well as any other information that will be important to have, should an error occur during this upgrade. To collect this information, enter:

  6. Copy the dsmserv.dsk file to an alternate location, for example:
         cp /usr/lpp/adsmserv/bin/dsmserv.opt /tmp/dsmserv.opt.bak
  7. Prevent new processes from establishing themselves:

  8. Restart ADSM.

  9. Complete a full ADSM database backup as shown in the following example:

    SCRATCH=NO can also be used if appropriate for your environment.

  10. Use the BACKUP VOLHIST command to backup the ADSM Volume History file to an alternate location - if you have one defined. An example follows:
    	BACKUP VOLHIST FILENAMES=/tmp/volhist.bak

    NOTE: The QUERY OPTION command will show the VOLUMEHISTORY option, if defined, which will identify the current location of this file. If you do not have one defined, please define it now by adding the following option to the dsmserv.opt file:

    	VOLUMEHISTORY /<my_directory>/volhis.out

  11. Use QUERY MOUNT and DISMOUNT VOLUME to empty the drives if required.

  12. Halt ADSM from the ADSM command line, enter:

  13. If you are upgrading your client, accomplish the following:

  14. Specifically for AIX, first remove your ADSM device definitions by entering:
    	rmdev -dl mtX
    	rmdev -dl lbX
    	rmdev -dl odX

    Where X represents the drive number. Do this for each drive contained in your output from step 4 (/tmp/device.config).

  15. Install the new code from base-install media according to the instructions contained in the README file for you operating system type.

  16. Install any required device driver updates or operating system updates as required from Step 4.

  17. If the preceding steps were followed, and your devices are deleted from AIX, redefine your AIX devices using SMIT, enter:
    	smitty devices
    1. Select TSM Devices
    2. Select Tape for mt's and add Device for each.
    3. Select Optical for od's and add Device for each.
    4. Select Library for lb's and add Device for each.

  18. Verify that the dsmserv.opt file, and optionally the dsm.sys and dsm.opt files, are present in their default location as determined in steps 2 and 3.

    NOTE: The verification of the dsm.opt and dsm.sys files is only required when updating the ADSM client code.

  19. Make any modifications to the dsmserv.opt, dsm.sys, and dsm.opt files as required - based on changes to the options contained within the files as outlined in the Release Notes and README files for the current version. Additionally, verify that the environment variables reflect the new directory structure.

  20. Verify that the Device Configuration and Volume History files are present in the their default locations, as determined in step 4 and 10, respectively, in this document.

  21. Ensure that the dsmserv.dsk file is present in the default location, as determined above.

  22. Start the TSM server. If you are given a notice that the database needs to be updated, you can restart the ADSM server with the upgradedb parameter. This will not be required on subsequent restarts of the server.

    NOTE: On the AIX and NT platforms, it is not necessary to explicitly specify the upgradedb parameter as the initial dsmserv process will automatically perform this function. However, you can issue it without negative effect to the server.

  23. Once you have verified that the server is operating normally, reset any values changed in step 7, including:

    1. Remove ENABLE SCHEDS from the dsmserv.opt file.

    2. Remove EXPINTERVAL 0 from the dsmserv.opt file.

    3. For each pool changed, enter:
      	UPDATE STG <name> RECLAIM=<orig> HI=<orig>
    4. At a dsmadmc command prompt, enter:
    5. Stop ADSM from a dsmadmc command prompt, enter:
  24. Restart TSM.

Cleanup procedures

  1. If appropriate for your environment, it is highly recommended that you install the current maintenance level for your version and release of TSM. This can be obtained via FTP over the public Internet within the maintenance subdirectory of the following ftp site: tivoli-storage-management

  2. Search for and remove any obsolete ADSM code that has been replaced with TSM code.

    NOTE: Ensure that you do not uninstall a package that you have not replaced, with the exception of Space Management, which cannot run backlevel.

  3. For technical assistance, contact Tivoli Support at 1-800-TIVOLI-8 or the IBM Support Line at 1-800-237-5711.

[ Doc Ref: 98052918210162     Publish Date: Feb. 06, 2001     4FAX Ref: 8801 ]