Tape library issues in a TSM environment can be fixed by knowing the cause and type of errors we see in the TSM server console. Issues with Tivoli Storage Manager Server in AIX connecting to tape libraries and/or drives can be resolved by doing some basic tasks. The first things to do when addressing hardware issues are given in the steps below.
1) Does AIX have the correct device driver for the library and/or tape drives?
2) Does AIX list the library and/or tape drives as Available?
If 6.1, does the db2 instance owner account have read/write access?
3) Does TSM list the drives as online?
4) Does TSM list the paths as online and using the correct device name?
6) Does reconfiguring the library and/or drives in AIX and TSM resolve the issue?
Troubleshooting TSM Tape Library in AIX/UNIX
1) Verify that AIX has the correct device driver for the library and/or tape drives
IBM tape drives and libraries typically use Atape (currently 11.7.7.0) or atldd (for IBM 3494 tape libraries, currently 6.8.4.0), though there are a few exceptions that use tsmscsi. Non-IBM tape drives and libraries typically use the tsmscsi device driver (at exactly the same version as the TSM Server version, to 4 digits) that comes packaged with TSM 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 TSM supported device list for which device driver is needed for supported tape libraries and drives
Check current versions installed with:
lslpp -l Atape.*
lslpp -l atldd.* (for IBM 3494 libraries)
Atape and atldd (for IBM 3494 libraries) are available for download at the following ftp site
To install and commit the Atape driver, uninstall the older version:
installp -u Atape.driver
Then install the new vesrion. For example, if you downloaded the file to /tmp/Atape.11.7.7.0.engr.bin:
installp -acXd /tmp/Atape.11.7.7.0.engr.bin all
Configure the tape device:
cfgmgr -v
(-v is not required but will show where it hangs if it does)
Verify the new devices are Available:
lsdev -Cc tape
For details, see Technote # 1174910: Upgrading Atape device driver in AIX
For details on configuring non-IBM library and/or tape drives to use tsmscsi in AIX, see TSM Server 5.5 for AIX Administrator's Guide, Ch. 5: "Attaching Devices to the Server System", Section: "Installing and Configuring Device Drivers", Subsections: "Configuring Tivoli Storage Manager Device Drivers for Autochangers" and "Configuring Tivoli Storage Manager Device Drivers for Tape or Optical Drives"
2) Verify that AIX lists the library and/or tape drives
From AIX, run:
* For tape devices using Atape or atldd
# lsdev -Cc tape
* For tape devices using tsmscsi
# lsdev -Cc adsm
Tape devices should be listed as Available.
AIX device names:
* Tape drives that use tsmsci*
/dev/mtx (for example: /dev/mt0)
* Tape libraries that use tsmsci*
/dev/lbx (for example: /dev/lb0)
* IBM 3575, 3581, 3583, 3584 libraries
/dev/smcx (for example: /dev/smc0)
* IBM® 349X libraries
/dev/lmcpx (for example: dev/lmcp0)
* tsmsci: Tivoli Storage Manager device driver, packaged with TSM Server
Reference: TSM Server 5.5 Administrator's Guide, Ch 5. "Attaching Devices to the Server System", Section: "Installing and Configuring Device Drivers", Subsection: "Determining Device Special File Names"
For TSM Server 6.1, does the db2 instance owner account have read/write access?
# ls -l /dev
For example:
# ls -l rmt[0-9]
crw-rw-rwT 1 root system 40,192 Mar 08 14:02 rmt1
crw-rw-rwT 1 root system 40,256 Mar 08 14:02 rmt2
3) Check TSM Server drives are online:
From a TSM server command line run
q drive
If drive(s) are not online, update them with:
4) Check the TSM Server paths are online and using the correct device name
From a TSM server command line run
q path f=d
If path(s) are not online or are using the wrong device device name (for example /dev/smc0 or /dev/rmt0), update them with the following (if device names are correct, you don't need to include the device parm):
Library (for example, using smc0):
update path srct=server destt=libr device=/dev/smc0 online=yes
Tape drive (for example, using rmt0):
update path srct=server destt=drive libr= device=/dev/rmt0 online=yes
5) Check for hardware issues from AIX
From an AIX command prompt window, use tapeutil (for devices using IBMtape) or lbtest or mttest (located in /usr/tivoli/tsm/devices/bin, for devices using tsmsci) to test the library or drives.
5a) lbtest, for libraries using tsmscsi
From AIX, run:
lbtest
Go into manual test and open the library
1: Manual test
1: set device special file
Enter device special file name:
For example: /dev/smc0 [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
5b) mttest, for tape drives using tsmscsi
From AIX, run:
mttest
Go into manual test and open the drive
1: Manual test
1: set device special file
Enter device special file name:
For example: /dev/rmt0 [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 mttest
21: close
99: return to main menu
9: exit mttest
5c) tapeutil, for libraries and tape drives using IBMtape
tapeutil operates basically the same as lbtest and mttest, except that you access both the library and the drives from tapeutil.
A good basic test for tape drives in Base Mode is
6: test unit ready
6) Delete and redefine paths, drive, and library, and checkin scratch tapes, then private
Sometimes deleting and redefining everything works to reconnect TSM Server to the devices correctly. The following technote gives these steps in detail.
Read: IBM Spectrum Protect (TSM) Basic Free Tutorials
Read: IBM Spectrum Protect (TSM) Basic Free Tutorials
0 Comment to "How to fix tape library and tape drive errors in Tivoli Storage Manager"
Post a Comment