A Tapelist Utility Program calledtapelistis installed in the /opt/IBMtapedirectory as part of the IBMtape package. The tapelist utility provides the user a listing of tape, medium changer and SAN data gateway devices configured with the IBMtape driver. It also displays the information of HBA with IBM tape drive attachment and the current status of load balancing. The following is an example of a Tapelist Utility Program output.
# tapelist Instance : 697
Special File : /dev/rmt/6st Device : 03592E05(e/e) Serial Number : 000001300168 TGT/LUN : 7/0 Ucode : 04C4 World Wide NN : 5005076302000127 World Wide PN : 5005076302400127
Dev Phy Path : /devices/pci@1f,2000/QLGC,qla@1/IBMtape@7,0:st Path Type : N/A
# tapelist -t
hba_index hba_inst hba_driver reg_count usage_count HBA Path
--- --- --- --- --- ---– 0 0 qla2300 4 1 /devices/pci@4,2000/fibre-channel@1 1 2 lpfc 4 2 /devices/pci@6,2000/pci@1/fibre-channel@4 2 3 lpfc 1 0 /devices/pci@6,2000/pci@1/fibre-channel@5
A new feature is added in tapelist to display the drive information in the library that is running /opt/IBMtape/tapelist -L.
# tapelist -L
Addr Inst# Special File Device Serial No TGT/LUN Ucode World Wide NN World Wide PN --- --- --- --- --–--- --- --- ---–-- ---–-- Library (/dev/rmt/5smc) Info:
2894 /dev/rmt/5smc 03584L22 0000000T003904E5 3/1 806c N/A N/A
274 2893 /dev/rmt/13st 03592E05(e/e) 000001365066 3/0 1D10 500507630019F016 500507630059F016 276 2914 /dev/rmt/14st 03592E06(e/e) 000001326803 14/0 2444 500507630019F019 500507630059F019
Library (/dev/rmt/7smc) Info:
2899 /dev/rmt/7smc 03584L32 0000000T00390401 6/1 806c N/A N/A
265 2898 /dev/rmt/6st ULT3580-TD4(e) 1300000044 6/0 82F0 500507630019F009 500507630059F009
Library 3494 Info:
322 /dev/rmt/10st 03592J1A 000001300147 1/0 0464 5005076300000000 5005076300400000
The following is a definition of the fields and headers that appear in the previous screens:
Inst # The instance number of the particular device.
Special File The device special file used to access this device.
Device A string indicating the device model and encryption information (e/e: encryption capable/encryption enable).
Serial No: The serial number of the device.
TGT/LUN The SCSI target and LUN of the device.
Ucode level The current microcode (firmware) loaded on the device.
World Wide NN A number indicating Fibre Channel World Wide Node Name of the device. World Wide PN A number indicating Fibre Channel World Wide Port Name of the device. Dev Phy Path A string indicating the device path in the device tree.
Path Type A primary or alternate path used for failover.
hba_index The index number of the particular HBA in the HBA list.
hba_inst The instance number of the particular HBA assigned by the Solaris system. hba_driver The HBA driver name with IBM tape drive attachment.
reg_count The number of IBM tape drives attached on the HBA. usage_count The number of IBM tape drives currently using the HBA. HBA Path A string indicating the HBA device path in the device tree.
Addr The element address where the drive is located in the library. e/e The first and second instances of "e" stand for encryption
capable and encryption enable. The usage of the tapelist program is as follows:
-l Print for all of the configured devices with the column headers in long list -L Display the tape drives information in the tape library
-c Don't print column headers in long list for all of the configured devices -t Display HBA information and current load balancing status
-f Print the list for a particular file only -A List the tape devices by HBA
-a Print out the info of all of FC HBAs -h Help menu
Running tapelist without any options displays the device information line by line for all of the configured devices.
Special Files
After the IBMtape driver is installed, a set of special files is available for
performing input/output (I/O) operations to each supported device. The device special file names created by the IBMtape device driver are similar to the SCSI tape special files generally used on Solaris systems.
Each tape instance has a set of minor numbers that provides access to the same physical device, but each minor number provides a different function or behavior for the tape subsystem. These minor numbers are accessed through variations of the special file name for that device. The special files are created in the/dev/rmt directory. These special files are actually symbolic links to files created within the /devices subdirectory hierarchy.
Issuing thels -la /dev/rmtcommand gives useful information about these device special files. The following example shows entries returned by this command for a single IBM tape subsystem. This listing is system dependent, so entries vary slightly in format, depending on the operating system and SCSI adapter support. There may also be entries included for other devices that are not supported by the IBMtape device driver.
lrwxrwxrwx root other 79 Aug 26 18:54 0smc -> /devices/iommu@f,e0000000/sbus@f,e0001000/QLGC,isp@3, 10000/IBMtape@2,0:smc
lrwxrwxrwx root other 78 Aug 26 18:54 0st -> /devices/iommu@f,e0000000/sbus@f,e0001000/QLGC,isp@3, 10000/IBMtape@2,0:st
lrwxrwxrwx root other 79 Aug 26 18:54 0stb -> /devices/iommu@f,e0000000/sbus@f,e0001000/QLGC,isp@3, 10000/IBMtape@2,0:stb
lrwxrwxrwx root other 80 Aug 26 18:54 0stbn -> /devices/iommu@f,e0000000/sbus@f,e0001000/QLGC,isp@3, 10000/IBMtape@2,0:stbn
lrwxrwxrwx root other 79 Aug 26 18:54 0stc -> /devices/iommu@f,e0000000/sbus@f,e0001000/QLGC,isp@3, 10000/IBMtape@2,0:stc
lrwxrwxrwx root other 80 Aug 26 18:54 0stcb -> /devices/iommu@f,e0000000/sbus@f,e0001000/QLGC,isp@3, 10000/IBMtape@2,0:stcb
lrwxrwxrwx root other 81 Aug 26 18:54 0stcbn -> /devices/iommu@f,e0000000/sbus@f,e0001000/QLGC,isp@3, 10000/IBMtape@2,0:stcbn
lrwxrwxrwx root other 80 Aug 26 18:54 0stcn -> /devices/iommu@f,e0000000/sbus@f,e0001000/QLGC,isp@3,
10000/IBMtape@2,0:stcn
lrwxrwxrwx root other 79 Aug 26 18:54 0stn -> /devices/iommu@f,e0000000/sbus@f,e0001000/QLGC,isp@3, 10000/IBMtape@2,0:stn
These entries show the device hierarchy established to support I/O for an IBM SCSI tape system. The attachment path of the device special files spans from the system board, through the S-bus, to the Sun F/W SCSI adapter (supported by the QLGC, isp SCSI adapter device driver), to the IBM device at SCSI target 2 and LUN 0 (supported by the IBMtape device driver). All nine of these special files are associated with the sameIBM device (device number 0).