IBM Support

Basic Troubleshooting Steps for Library and Tape Drive Issues

Question & Answer


Question

Often, issues with a IBM Spectrum Protect 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 IBM Spectrum Protect server level). Non-IBM tape drives and libraries typically use the tsmscsi device driver (at exactly the same version as the IBM Spectrum Protect Server version, to 4 digits) that comes packaged with the 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 IBM Spectrum Protect 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 IBM Spectrum Protect 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 IBM Spectrum Protect 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 IBM Spectrum Protect Server paths are online and are using the correct lb or mt device name:

From a IBM Spectrum Protect 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 IBM Spectrum Protect 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-01.ibm.com/support/docview.wss?uid=swg21190124

 

[{"Product":{"code":"SSEQVQ","label":"IBM Spectrum Protect"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Server","Platform":[{"code":"PF033","label":"Windows"}],"Version":"All Versions","Edition":"Edition Independent","Line of Business":{"code":"LOB26","label":"Storage"}}]

Product Synonym

TSM

Document Information

Modified date:
01 October 2018

UID

swg22006006