Basic Troubleshooting Steps for Library and Tape Drive Issues with Tivoli Storage Manager for Windows

Technote (FAQ)


Question

Often, issues with a Tivoli Storage Manager Server in Windows connecting to tape libraries and/or drives can be resolved by checking some basics. The first things to do when addressing hardware issues are given in the steps below.

Answer

1) Verify RSM service is Disabled (note: only valid for Windows 2008 R2 if Removable Storage Manager was explicitly installed; it is not installed on R2 by default)


    From Windows Services, verify that the Removable Storage service is Disabled. If it is not Disabled and you do not intend to use it, then set it to a Start Type of Manual and a State of Disabled. Reboot Windows to have this change take effect.

2) Verify that Windows Device Manager lists the library (Medium Changer) and/or Tape Drives

3) Verify that Windows Device Manager has the correct device driver for the library and/or tape drives


    Check the device driver provider and version from Windows Device Manager, To see this information, right-click on the device, select Properties, then select the Device Driver tab.

    IBM tape drives and libraries typically use IBMtape (driver provider IBM) or ibmatl (for IBM 3494 tape libraries), though there are a few exceptions that use tsmscsi (driver provider would again be IBM, but the version should match the Tivoli Storage Manager server level). Non-IBM tape drives and libraries typically use the tsmscsi device driver (at exactly the same version as the Tivoli Storage Manager Server version, to 4 digits) that comes packaged with the Tivoli Storage Manager Server and Storage Agent, though there are a few exceptions that use other device drivers. A non-IBM library that uses IBM tape drives will typically use tsmscsi for the library and IBMtape for the drives.

    Check the Tivoli Storage Manager supported device list for which device driver is needed for supported tape libraries and drives
    http://www-01.ibm.com/software/sysmgmt/products/support/IBM_TSM_Supported_Devices_for_AIXHPSUNWIN.html

    IBMtape and ibmatl (for IBM 3494 libraries) are available for download at FixCentral here:
    http://www-933.ibm.com/support/fixcentral/

      Product Group: Storage Systems
      Product Family: Tape Systems
      Product Type: Tape device drivers and software
      Product: Tape device drivers
      Installed Version: 1.0 (default)
      Platform Windows

      Hit Continue

      Browse for fixes (the default)
      Hit Continue

      Download: IBMtape

    Also download:
    * IBM Tape Device Drivers Installation and User's Guide
    Available under the fixpack

    Then go back to FixCentral, and download
    * Product: Tape Diagnostic Tool (ITDT)

    itdt replaces the legacy tape utility called ntutil.


    For IBMtape, run install-exclusive.exe to install IBMtape and assign IBMtape as the device driver for supported IBM tape libraries and drives.

    For tsmscsi, verify that it was installed by checking Windows Add/Remove Programs. To set the tape devices to use tsmscsi in Windows, from Windows Device Manager, right-click on the device, select Update Driver -> Install from a list or specific location (Advanced) -> Don't search. I will select the driver to install -> Select the IBM Tivoli Storage Manager device driver -> Continue Anyway.

    For details, see the Tivoli Storage Manager Server manual section on "Controlling devices with the Tivoli Storage Manager device driver"

    http://www-01.ibm.com/support/knowledgecenter/search/Configuring%20Tivoli%20Storage%20Manager%20device%20drivers%20for%20tape%20or%20optical%20drives%20windows?scope=SSGSG7


4) Run tsmdlst to check device names
    From a DOS command prompt window, cd C:\Program Files\tivoli\tsm\console, and run:
      tsmdlst

    You should see output similar to the following list of current lb and mt device names for the library and tape devices.
      Tivoli Storage Manager -- Device List Utility

      Licensed Materials - Property of IBM

      5697-TSM (C) Copyright IBM Corporation 2000, 2005. All rights reserved.
      U.S. Government Users Restricted Rights - Use, duplication or disclosure
      restricted by GSA ADP Schedule Contract with IBM Corporation.

      Computer Name: WINDOWS_SERVER1
      OS Version: 5.2
      OS Build #: 3790
      TSM Device Driver: TSMScsi - Running

      One HBA was detected.

      Manufacturer Model Driver Version Firmware Description
      ----------------------------------------------------------------------
      LSI Corporation LSI7102XP-LC lsi_fc 1.27.01.00 01.02.27.00LSI 2GB FC 7002 series, Dual or Quad port (w/929X)

      TSM Name ID LUN Bus Port SSN WWN TSM Type Device Identifier
      ----------------------------------------------------------------------
      lb0.0.0.2 0 0 0 2 0010c5101f0008002724 21000090A50013A6 LIBRARY SPECTRA GATOR 0129
      mt0.1.0.2 0 1 0 2 0001050056 21000090A50013A6 GENERICTAPESONY SDX-900V 0103
      mt0.2.0.2 0 2 0 2 0001050538 21000090A50013A6 GENERICTAPESONY SDX-900V 0103

      Completed in: 0 days, 0 hours, 0 minutes, 0 seconds.


    5) Confirm that the Tivoli Storage Manager Server drive definitions are online:

    From a Tivoli Storage Manager server command line, run:
      q drive
    If drive(s) are not online, update them with:
      update drive <libr> <drive> online=yes


    6) Confirm that the Tivoli Storage Manager Server paths are online and are using the correct lb or mt device name:

    From a Tivoli Storage Manager server command line, run:
      q path f=d

    If any path(s) are not online or are using the wrong device name, update them with the following command(s) (if device names are correct, you don't need to include the device parm):
      Library:
        update path <server> <library> srct=server destt=libr device=<lb#.#.#.#> online=yes
      Tape drive:
        update path <server> <drive> srct=server destt=drive libr=<libname> device=<mt#.#.#.#> online=yes

    7) Check for hardware issues from DOS

    From a DOS command prompt window, use ntutil (for devices using IBMtape) or lbtest or mttest (for devices using tsmscis) to test the library or drives.

    7a) lbtest, for libraries using tsmscsi

      From DOS, run:
        lbtest

      Go into manual test and open the library
      1: Manual test

      1: set device special file
        Enter device special file name: lb#.#.#.# [enter]
      6: open

      Get library inventory
      8: ioctl return element count
      10: ioctl return library inventory

      Move a tape from a tape slot to a drive
      11: ioctl move medium
        transport element address: XX
        source address moving from: YY
        destination address moving to: ZZ

      Move the tape back to where it came from
      11: ioctl move medium
        transport element address: XX
        source address moving from: ZZ
        destination address moving to: XX

      Close the device and exit lbtest
      7: close
      99: return to main menu
      9: exit lbtest


      Reference: Technote # 1326205: LBTEST - Practical Examples to Test Functionality
      http://www-01.ibm.com/support/docview.wss?uid=swg21326205


    7b) mttest, for tape drives using tsmscsi
      From DOS, run:
      mttest

      Go into manual test and open the drive
      1: Manual test

      1: set device special file
          Enter device special file name: mt#.#.#.# [enter]
      20: open

      Check basic functionality:
       22. read
       60. write block to "block.out"

      Note: You will get an error stating that only 80 bytes could be read out of 1024. This is normal and can be ignored
      Close the device and exit lbtest
      21: close
      99: return to main menu
      9: exit mttest



    7c) itdt (or ntutil), for libraries and tape drives using IBMtape

      itdt (which replaces ntutil) operates basically the same as lbtest and mttest, except that you access both the library and the drives from itdt. When you start, it operates in Base Mode by default for access to tape drives. Hit 8 to switch to Library Mode.

      List tape device names you can open from either mode with:
        88: List registered devices

      A good basic test for tape drives in Base Mode is
        39: test unit ready


    8) Delete and redefine paths, drive, and library, and checkin scratch tapes, then private

    Sometimes deleting and redefining everything works to reconnect Tivoli Storage Manager Server to the devices correctly. The following technote gives these steps in detail.

    Technote # 1190124: "Redefine Library and Drives on Windows Tivoli Storage Manager server"
    https://www-304.ibm.com/support/docview.wss?uid=swg21190124

Rate this page:

(0 users)Average rating

Document information


More support for:

Tivoli Storage Manager
Server

Software version:

All Supported Versions

Operating system(s):

Windows

Software edition:

Edition Independent

Reference #:

1393009

Modified date:

2014-05-20

Translate my page

Machine Translation

Content navigation