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":"BU054","label":"Systems 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