IBM Support

Determining the device names of the AWS Tape Gateway iSCSI media changer and drives on Microsoft® Windows and Linux x86_64

Preventive Service Planning


Abstract

The following information is provided to help you find the device names of the AWS Tape Gateway iSCSI media changer and drives on Microsoft® Windows and Linux x86_64.

Content

Prerequisites:

The following requirements apply to Linux x86-64 systems:
  • One of the following distributions: Red Hat Enterprise Linux (RHEL) 7.6 or later or SUSE Linux Enterprise Server 12, Service Pack 2 or later
  • iscsi-initiator-utils (for RHEL)
  • open-iscsi (for SUSE Linux Enterprise Server)
  • yast2-iscsi-client (for SUSE Linux Enterprise Server)
  • IBM Spectrum Protect Version 8.1.10 or later
  • IBM Linux lin_taped-3.0.46-1 or later
  • Persistent Naming Support on Linux is enable.
  • IBM Tape Diagnostic Tool (ITDT)
The following requirements apply to Microsoft® Windows systems:
  • One of the following 64-bit operating systems: Microsoft Windows Server 2012 R2 or Microsoft Windows server 2016
  • Microsoft iSCSI Initiator
  • IBM Spectrum Protect V8.1.10.101 or a subsequent maintenance release
  • IBM Windows device driver 6.2.6.8 or later (Install_exclusive)
  • Persistent Naming Support on Windows is enable.
  • IBM Tape Diagnostic Tool (ITDT)
Determining the device names for iSCSI devices on Microsoft® Windows
There are 3 methods to get the iSCSI device names  on Windows.
Method 1.  Getting the persistent device names with IBM Tape Diagnostic Tool(ITDT) on Windows
You may obtain  IBM Tape Diagnostic Tool(ITDT) from IBM Fix Central.

c:\ITDT>itdt scan

Scanning SCSI Bus ...

#0 \\.\Tape4801101 - [ULT3580-TD5]-[0103] S/N:DFAF4FB610 H3-B0-T10-L0 Changer:AMZN_SGW-DFAF4FB6_MC_01 (IBM-Device)

#1 \\.\Tape4801102 - [ULT3580-TD5]-[0103] S/N:DFAF4FB602 H3-B0-T2-L0 Changer:AMZN_SGW-DFAF4FB6_MC_01 (IBM-Device)

#2 \\.\Tape4801103 - [ULT3580-TD5]-[0103] S/N:DFAF4FB603 H3-B0-T3-L0 Changer:AMZN_SGW-DFAF4FB6_MC_01 (IBM-Device)

#3 \\.\Tape4801110 - [ULT3580-TD5]-[0103] S/N:DFAF4FB601 H3-B0-T1-L0 Changer:AMZN_SGW-DFAF4FB6_MC_01 (IBM-Device)

#4 \\.\Changer0 - [03584L32 TS3500]-[0402] S/N:AMZN_SGW-DFAF4FB6_MC_01 H3-B0-T0-L0  (IBM-Device)

#5 \\.\Tape4801104 - [ULT3580-TD5]-[0103] S/N:DFAF4FB604 H3-B0-T4-L0 Changer:AMZN_SGW-DFAF4FB6_MC_01 (IBM-Device)

#6 \\.\Tape4801105 - [ULT3580-TD5]-[0103] S/N:DFAF4FB605 H3-B0-T5-L0 Changer:AMZN_SGW-DFAF4FB6_MC_01 (IBM-Device)

#7 \\.\Tape4801106 - [ULT3580-TD5]-[0103] S/N:DFAF4FB606 H3-B0-T6-L0 Changer:AMZN_SGW-DFAF4FB6_MC_01 (IBM-Device)

#8 \\.\Tape4801107 - [ULT3580-TD5]-[0103] S/N:DFAF4FB607 H3-B0-T7-L0 Changer:AMZN_SGW-DFAF4FB6_MC_01 (IBM-Device)

#9 \\.\Tape4801108 - [ULT3580-TD5]-[0103] S/N:DFAF4FB608 H3-B0-T8-L0 Changer:AMZN_SGW-DFAF4FB6_MC_01 (IBM-Device)

#10 \\.\Tape4801109 - [ULT3580-TD5]-[0103] S/N:DFAF4FB609 H3-B0-T9-L0 Changer:AMZN_SGW-DFAF4FB6_MC_01 (IBM-Device)

Exit with code: 0

Example of defining AWS VTL  library and drives with persistent device names on Windows:
def library AWSVTL libtype=VTL resetdrives=no relabelscratch=yes
def path SERVER1 AWSVTL srctype=server destt=libr device=\\.\changer0
def drive AWSVTL VTLDR1
def path SERVER1 VTLDR1 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801110
def drive AWSVTL VTLDR2
def path SERVER1 VTLDR2 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801102
def drive AWSVTL VTLDR3
def path SERVER1 VTLDR3 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801103
def drive AWSVTL VTLDR4
def path SERVER1 VTLDR4 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801104
def drive AWSVTL VTLDR5
def path SERVER1 VTLDR5 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801105
def drive AWSVTL VTLDR6
def path SERVER1 VTLDR6 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801106
def drive AWSVTL VTLDR7
def path SERVER1 VTLDR7 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801107
def drive AWSVTL VTLDR8
def path SERVER1 VTLDR8 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801108
def drive AWSVTL VTLDR9
def path SERVER1 VTLDR9 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801109
def drive AWSVTL VTLDR10
def path SERVER1 VTLDR10 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801101
Method 2.  Getting the persistent device names with Microsoft® Windows  iscsicli sessionlist command
See iscsicli sessionlist command output: iSCSI.Device.Names_.Windows.pdf
Example of defining AWS VTL  library and drives with persistent device names on Windows:
def library AWSVTL libtype=VTL resetdrives=no relabelscratch=yes
def path SERVER1 AWSVTL srctype=server destt=libr device=\\.\changer0
def drive AWSVTL VTLDR1
def path SERVER1 VTLDR1 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801110
def drive AWSVTL VTLDR2
def path SERVER1 VTLDR2 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801102
def drive AWSVTL VTLDR3
def path SERVER1 VTLDR3 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801103
def drive AWSVTL VTLDR4
def path SERVER1 VTLDR4 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801104
def drive AWSVTL VTLDR5
def path SERVER1 VTLDR5 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801105
def drive AWSVTL VTLDR6
def path SERVER1 VTLDR6 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801106
def drive AWSVTL VTLDR7
def path SERVER1 VTLDR7 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801107
def drive AWSVTL VTLDR8
def path SERVER1 VTLDR8 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801108
def drive AWSVTL VTLDR9
def path SERVER1 VTLDR9 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801109
def drive AWSVTL VTLDR10
def path SERVER1 VTLDR10 srctype=server autod=yes desttype=drive library=AWSVTL device=\\.\tape4801101
Method 3. Getting the device names with IBM Spectrum Protect Q OSDEV command on Windows
Protect: SPWIN01>q osdev
Device      Vendor       Product              Serial Number        Device           Driver     Element
Type
-------     --------     ----------------     ----------------     ------------     ------     -------
CHANGER     IBM          03584L32             AMZN_SGW-DFAF4F-     lb0.0.0.3        IBM
                                               B6_MC_01
DRIVE       IBM          ULT3580-TD5          DFAF4FB601           mt1.0.0.3        IBM         10,000
DRIVE       IBM          ULT3580-TD5          DFAF4FB602           mt2.0.0.3        IBM         10,001
DRIVE       IBM          ULT3580-TD5          DFAF4FB603           mt3.0.0.3        IBM         10,002
DRIVE       IBM          ULT3580-TD5          DFAF4FB604           mt4.0.0.3        IBM         10,003
DRIVE       IBM          ULT3580-TD5          DFAF4FB605           mt5.0.0.3        IBM         10,004
DRIVE       IBM          ULT3580-TD5          DFAF4FB606           mt6.0.0.3        IBM         10,005
DRIVE       IBM          ULT3580-TD5          DFAF4FB607           mt7.0.0.3        IBM         10,006
DRIVE       IBM          ULT3580-TD5          DFAF4FB608           mt8.0.0.3        IBM         10,007
DRIVE       IBM          ULT3580-TD5          DFAF4FB609           mt9.0.0.3        IBM         10,008
DRIVE       IBM          ULT3580-TD5          DFAF4FB610           mt10.0.0.3       IBM         10,009
Protect: SPWIN01>
Example of defining AWS VTL  library and drives on Windows:
def library AWSVTL libtype=VTL resetdrives=no relabelscratch=yes
def path SERVER1 AWSVTL srctype=server destt=libr device=lb0.0.0.3

def drive AWSVTL VTLDR1
def path SERVER1 VTLDR1 srctype=server autod=yes desttype=drive library=AWSVTL device=mt1.0.0.3
def drive AWSVTL VTLDR2
def path SERVER1 VTLDR2 srctype=server autod=yes desttype=drive library=AWSVTL device=mt2.0.0.3
def drive AWSVTL VTLDR3
def path SERVER1 VTLDR3 srctype=server autod=yes desttype=drive library=AWSVTL device=mt3.0.0.3
def drive AWSVTL VTLDR4
def path SERVER1 VTLDR4 srctype=server autod=yes desttype=drive library=AWSVTL device=mt4.0.0.3
def drive AWSVTL VTLDR5
def path SERVER1 VTLDR5 srctype=server autod=yes desttype=drive library=AWSVTL device=mt5.0.0.3
def drive AWSVTL VTLDR6
def path SERVER1 VTLDR6 srctype=server autod=yes desttype=drive library=AWSVTL device=mt6.0.0.3
def drive AWSVTL VTLDR7
def path SERVER1 VTLDR7 srctype=server autod=yes desttype=drive library=AWSVTL device=mt7.0.0.3
def drive AWSVTL VTLDR8
def path SERVER1 VTLDR8 srctype=server autod=yes desttype=drive library=AWSVTL device=mt8.0.0.3
def drive AWSVTL VTLDR9
def path SERVER1 VTLDR9 srctype=server autod=yes desttype=drive library=AWSVTL device=mt9.0.3
def drive AWSVTL VTLDR10
def path SERVER1 VTLDR10 srctype=server autod=yes desttype=drive library=AWSVTL device=mt10.0.3
Determining the device names for iSCSI devices on Linux
There are 2 methods to get the iSCSI device names  on Linux
 
Method 1.  Getting the persistent device names from /proc/scsi/IBMchanger & /dev/lin_tape/by-id 
[root@tapsrv05:/]# cat /proc/scsi/IBM
lin_tape version: 3.0.46
lin_tape major number: 242
Attached Changer Devices:
Number  model       SN                       HBA             SCSI            FO Path
0       03584L32    AMZN_SGW-0E799D67_MC_01  iSCSI Initiator over TCP/IP9:0:0:0         NA
[root@tapsrv05:/]# ls -l /dev/lin_tape/by-id
total 0
lrwxrwxrwx. 1 root root 14 Sep 30 00:04 lin_tape_0E799D6701 -> ../../IBMtape1
lrwxrwxrwx. 1 root root 14 Sep 30 00:04 lin_tape_0E799D6702 -> ../../IBMtape0
lrwxrwxrwx. 1 root root 14 Sep 30 00:04 lin_tape_0E799D6703 -> ../../IBMtape5
lrwxrwxrwx. 1 root root 14 Sep 30 00:04 lin_tape_0E799D6704 -> ../../IBMtape8
lrwxrwxrwx. 1 root root 14 Sep 30 00:04 lin_tape_0E799D6705 -> ../../IBMtape2
lrwxrwxrwx. 1 root root 14 Sep 30 00:04 lin_tape_0E799D6706 -> ../../IBMtape9
lrwxrwxrwx. 1 root root 14 Sep 30 00:04 lin_tape_0E799D6707 -> ../../IBMtape7
lrwxrwxrwx. 1 root root 14 Sep 30 00:04 lin_tape_0E799D6708 -> ../../IBMtape4
lrwxrwxrwx. 1 root root 14 Sep 30 00:04 lin_tape_0E799D6709 -> ../../IBMtape6
lrwxrwxrwx. 1 root root 14 Sep 30 00:04 lin_tape_0E799D6710 -> ../../IBMtape3
[root@tapsrv05:/dev/lin_tape/by-id]#
Example of defining AWS VTL  library and drives with persistent device names on Linux:
def library AWSVTL libtype=VTL resetdrives=no relabelscratch=yes
def path SERVER1 AWSVTL srctype=server destt=libr device=/dev/IBMchanger0
def drive AWSVTL VTLDR1
def path SERVER1 VTLDR1 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/lin_tape/by-id/lin_tape_0E799D6701
def drive AWSVTL VTLDR2
def path SERVER1 VTLDR2 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/lin_tape/by-id/lin_tape_0E799D6702
def drive AWSVTL VTLDR3
def path SERVER1 VTLDR3 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/lin_tape/by-id/lin_tape_0E799D6703
def drive AWSVTL VTLDR4
def path SERVER1 VTLDR4 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/lin_tape/by-id/lin_tape_0E799D6704
def drive AWSVTL VTLDR5
def path SERVER1 VTLDR5 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/lin_tape/by-id/lin_tape_0E799D6705
def drive AWSVTL VTLDR6
def path SERVER1 VTLDR6 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/lin_tape/by-id/lin_tape_0E799D6706
def drive AWSVTL VTLDR7
def path SERVER1 VTLDR7 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/lin_tape/by-id/lin_tape_0E799D6707
def drive AWSVTL VTLDR8
def path SERVER1 VTLDR8 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/lin_tape/by-id/lin_tape_0E799D6708
def drive AWSVTL VTLDR9
def path SERVER1 VTLDR9 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/lin_tape/by-id/lin_tape_0E799D6709
def drive AWSVTL VTLDR10
def path SERVER1 VTLDR10 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/lin_tape/by-id/lin_tape_0E799D6710
 
Method 2. Getting the device names from /proc/scsi/IBMchanger & /proc/scsi/IBMtape
[root@tapsrv05:/]# cat /proc/scsi/IBM*
lin_tape version: 3.0.46
lin_tape major number: 242
Attached Changer Devices:
Number  model       SN                       HBA             SCSI                       FO Path
0       03584L32    AMZN_SGW-0E799D67_MC_01  iSCSI Initiator over TCP/IP9:0:0:0         NA

lin_tape version: 3.0.46
lin_tape major number: 242
Attached Tape Devices:
Number  model       SN                       HBA             SCSI                       FO Path
0       ULT3580-TD5 0E799D6702               iSCSI Initiator over TCP/IP14:0:0:0        NA
1       ULT3580-TD5 0E799D6701               iSCSI Initiator over TCP/IP5:0:0:0         NA
2       ULT3580-TD5 0E799D6705               iSCSI Initiator over TCP/IP13:0:0:0        NA
3       ULT3580-TD5 0E799D6710               iSCSI Initiator over TCP/IP6:0:0:0         NA
4       ULT3580-TD5 0E799D6708               iSCSI Initiator over TCP/IP7:0:0:0         NA
5       ULT3580-TD5 0E799D6703               iSCSI Initiator over TCP/IP15:0:0:0        NA
6       ULT3580-TD5 0E799D6709               iSCSI Initiator over TCP/IP8:0:0:0         NA
7       ULT3580-TD5 0E799D6707               iSCSI Initiator over TCP/IP11:0:0:0        NA
8       ULT3580-TD5 0E799D6704               iSCSI Initiator over TCP/IP12:0:0:0        NA
9       ULT3580-TD5 0E799D6706               iSCSI Initiator over TCP/IP10:0:0:0        NA
[root@tapsrv05:/]#
Example of defining AWS VTL  library and drives on Linux:
def library AWSVTL libtype=VTL resetdrives=no relabelscratch=yes
def path SERVER1 AWSVTL srctype=server destt=libr device=/dev/IBMchanger0
def drive AWSVTL VTLDR1
def path SERVER1 VTLDR1 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/IBMtape1
def drive AWSVTL VTLDR2
def path SERVER1 VTLDR2 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/IBMtape0
def drive AWSVTL VTLDR3
def path SERVER1 VTLDR3 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/IBMtape5
def drive AWSVTL VTLDR4
def path SERVER1 VTLDR4 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/IBMtape8
def drive AWSVTL VTLDR5
def path SERVER1 VTLDR5 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/IBMtape2
def drive AWSVTL VTLDR6
def path SERVER1 VTLDR6 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/IBMtape9
def drive AWSVTL VTLDR7
def path SERVER1 VTLDR7 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/IBMtape7
def drive AWSVTL VTLDR8
def path SERVER1 VTLDR8 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/IBMtape4
def drive AWSVTL VTLDR9
def path SERVER1 VTLDR9 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/IBMtape6
def drive AWSVTL VTLDR10
def path SERVER1 VTLDR10 srctype=server autod=yes desttype=drive library=AWSVTL device=/dev/IBMtape3

[{"Line of Business":{"code":"LOB26","label":"Storage"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSEQVQ","label":"IBM Spectrum Protect"},"ARM Category":[{"code":"a8m50000000Ci5XAAS","label":"Server"}],"ARM Case Number":"","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"8.1.10"}]

Document Information

Modified date:
03 November 2020

UID

ibm16357401

Page Feedback