#man INQUIRE

NAME

inquire - list devices available

SYNOPSIS

inquire [ -a b.t.l ] [ -clp ] [ -N NDMPhost ] [ -s ] [ -T [ -t ] ]

DESCRIPTION

The inquire program lists SCSI devices available. The inquire program returns INQUIRY data either for the named SCSI device (with the -a option), or for all SCSI devices attached to the system. In addition to the standard SCSI inquiry data, inquire now returns serial number information obtained from the Vital Product Data (VPD) pages supported by the devices that are being queried. There may be anywhere from zero to eight different identifiers for each device, depending on which of the VPD pages that particular device supports.

In NetWorker 7.2.1 and higher, the support of LUS was discontinued for Solaris 10 and higher. This means that after installation 'inquire' might not necessarily show any devices meant to be used by NetWorker. If this is the case, the Solaris Server might not be configured correctly.

A quick check is to run 'cfgadm -lav' to see what is listed. Looking at the 'cfgadm' output and if the devices are listed, make sure that the '/dev/rmt' path is used for the devices. This is the preferred NetWorker path and it is created automatically by the Solaris 'st' driver. If the devices are not listed; please refer to the NetWorker Administration Guide, SUN Administration Guide and Manufacturer's Manual.

Sample output including serial number information:

scsidev@0.0.0:SEAGATE ST34371W SUN4.2G7462|Disk, /dev/rdsk/c0t0d0s2

S/N: JDY217500LUW5N

scsidev@0.1.0:QUANTUM ATLAS IV 36 SCA 0B0B|Disk, /dev/rdsk/c0t1d0s2

S/N: 363009430963 ATNN:QUANTUM 363009430963

scsidev@0.6.0:TOSHIBA XM5701TASUN12XCD2395|CD-ROM, /dev/rdsk/c0t6d0s2 scsidev@4.0.0:SONY TSL-11000 L1 |Tape, /dev/rmt/0cbn

S/N: 0001100158 ATNN:SONY TSL-11000 0001100158

scsidev@4.0.1:SONY TSL-11000 L1 |Autochanger (Jukebox)

S/N: 3761633968 ATNN:SONY TSL-11000 3761633968

scsidev@4.2.0:IBM ULTRIUM-TD1 0CE0|Tape

S/N: 6811004028 ATNN:IBM ULTRIUM-TD1 6811004028

scsidev@4.3.0:HP Ultrium 1-SCSI N16D|Tape, /dev/rmt/1cbn

S/N: GB81A00316 ATNN:HP Ultrium 1-SCSI GB81A00316

scsidev@4.4.0:IBM ULTRIUM-TD1 0CE0|Tape

S/N: 6811003960 ATNN:IBM ULTRIUM-TD1 6811003960

scsidev@4.5.0:EXABYTE Exabyte 221L 2.4 |Autochanger (Jukebox)

S/N: 99999999

Lines starting with S/N: represent the device's serial number as returned by VPD page 80 hex.

Lines that start with a four character prefix plus a colon are those returned in SCSI-3 format on VPD page 83 hex. The four character prefix tells which of the various SCSI-3 Device Identifiers it represents.

ATNN: ASCII Text identifier of unspecified format

describing the device itself (usually Vendor, Product, Serial number)

ATPN: ASCII Text identifier of unspecified format

describing the port that you are connected to the device through (not commonly used)

VENN: An ASCII vendor specific identifier of unknown

uniqueness describing the device itself

VEPN: An ASCII vendor specific identifier of unknown

uniqueness describing the port you are connected through

VBNN: A binary vendor specific identifier of unknown

uniqueness describing the device itself

VBPN: A binary vendor specific identifier of unknown

uniqueness describing the port you are connected through

IENN: An IEEE 64-bit identifier (EUI-64) describing

the device itself (shown in hexadecimal format)

IEPN: An IEEE 64-bit identifier (EUI-64) describing

the port you are connected through (shown in hexadecimal format)

WWNN: A Fibrechannel identifier (World Wide Node Name)

describing the device itself (shown in hexadecimal format)

WWPN: A Fibrechannel identifier (World Wide Port Name)

describing the port you are connected through (shown in hexadecimal format)

PORT: The relative port number that you are connected

through. Port "A" would return a value of 1, Port "B" a value of 2...

RESV: The device returned a combination of Association

and Identifier Type bits that was reserved at the time this code was written.

UNKN: The device returned information that this program

was unable to decipher

The HP-UX 11iv3 system supports two different addressing modes, LEGACY and AGILE. Different Device Special files (DSFs) are used based on the addressing mode. The AGILE addressing mode is the default addressing mode on the HP-UX 11iv3 system and it creates DSFs based on the device type, for example, /dev/rtape/tape106_BESTnb. For the LEGACY addressing mode, the HP-UX 11iv3 system creates additional DSFs based on B.T.L notation for backward compatibility with previous version, for example, /dev/rmt/c0t0d0. Addressing modes can be switched with the insf -L (install special device file) program or the rmsf -L (remove special device file) program on the HP-UX 11iv3 system. The inquire program lists devices using the B.T.L notation for the LEGACY addressing mode, for example, scsidev@B.T.L. For the AGILE addressing mode, it lists devices using the DSF notation, for example, /dev/rtape/tape106_BESTnb.

[ NOTICE ]

1. In the LEGACY addressing mode, the HP-UX 11iv3 system has a limitation to support devices:

- 256 SCSI bus instances. - 16 targets per bus instance. - 8 logical unit number per target. - Eq, it can support max 128 tapes per bus with the LEGACY addressing mode.

2. Changing addressing mode can make a problem:

- Access failure for the configured jukebox library on the NetWorker. - Check the verifyconfig(1m) man page for more information.

The inquire program output for the LEGACY addressing mode on the HP-UX 11iv3 system:

scsidev@0.0.0:HP Virtual LvDisk 0.04|Disk, /dev/rdsk/c0t0d0

S/N: 00000000000000-00000 ATNN=HP /dev/vg01/rvPar0002

scsidev@0.1.0:HP Virtual FileDVD 0.04|CD-ROM, /dev/rdsk/c0t1d0

S/N: 00000000000000-00001 VENN=/opt/ISO/DC-OE_11i_v3_DVD_BA931-10010.iso

scsidev@0.2.0:STK L180 2.21|Autochanger (Jukebox), /dev/rac/c0t2d0

S/N: 18JYA0021B ATNN=STK L180 18JYA0021B Virtual device

scsidev@0.3.0:HP Ultrium 3-SCSI G27D|Tape, /dev/rmt/c0t3d0BESTnb

S/N: 18JYA0021G ATNN=HP Ultrium 3-SCSI 18JYA0021G WWNN=500630323147AAAA WW2N=50060B000029AAAA Virtual device

scsidev@0.4.0:HP Ultrium 3-SCSI G27D|Tape, /dev/rmt/c0t4d0BESTnb

S/N: 18JYA0021H ATNN=HP Ultrium 3-SCSI 18JYA0021H WWNN=500630323148AAAA WW2N=50060B000029AAAA Virtual device

The inquire program output for the AGILE addressing mode on the HP-UX 11iv3 system:

/dev/rchgr/autoch1:STK L180 2.21|Autochanger (Jukebox), /dev/rchgr/autoch1

S/N: 18JYA0021B ATNN=STK L180 18JYA0021B Virtual device

/dev/rtape/tape1_BESTnb:HP Ultrium 3-SCSI G27D|Tape, /dev/rtape/tape1_BESTnb

S/N: 18JYA0021G ATNN=HP Ultrium 3-SCSI 18JYA0021G WWNN=500630323147AAAA WW2N=50060B000029AAAA Virtual device

/dev/rtape/tape3_BESTnb:HP Ultrium 3-SCSI G27D|Tape, /dev/rtape/tape3_BESTnb

S/N: 18JYA0021H ATNN=HP Ultrium 3-SCSI 18JYA0021H WWNN=500630323148AAAA WW2N=50060B000029AAAA Virtual device

/dev/rdisk/disk2:HP Virtual FileDVD 0.04|CD-ROM, /dev/rdisk/disk2

S/N: 00000000000000-00001 VENN=/opt/ISO/DC-OE_11i_v3_DVD_BA931-10010.iso

/dev/rdisk/disk3:HP Virtual LvDisk 0.04|Disk, /dev/rdisk/disk3

S/N: 00000000000000-00000 ATNN=HP /dev/vg01/rvPar0002

OPTIONS

-a b.t.l

Selects a specific ordinal SCSI address, where b is the logical SCSI bus, t is the SCSI target, and l is the SCSI logical unit number (LUN) on that target. This option is not compatible with -N. See libscsi(1m).

-c (NOTE: USE WITH CAUTION)

This flag sends the SCSI inquiry command directly to the device and may cause unforeseen errors when there is other activity on the bus.

-l

Performs a complete LUN search for all SCSI adapters in the system. This argument is accepted on all systems, but does not have any effect on HP-UX systems because the method used to scan for available devices on HP-UX systems always shows all accessible devices. For systems other than HP-UX, the normal behavior is to start checking at LUN 0 for SCSI devices. The first empty LUN found will end the search for a given target ID. With the -l option, all LUNs present on all target IDs for all SCSI busses in the system will be checked for devices. This can take a very long time and should therefore only be used when necessary. For example, a Fibre Channel adapter can support 126 target IDs, each of which may have 80 or more LUNs. Checking all LUNs on this single adapter may take over 10 minutes. This option has no affect when -N present.

-p

Tells inquire to display persistent device names for devices on platforms where persistent names are supported. If persistent names do not exist for any particular device then the normal device name will be shown. Currently only linux has such support. Specifying -p on a platform that does not have NetWorker-recognized persistent names will have no effect.

-N NDMPhost

Performs a device discovery on the NDMP Tape Server NDMPhost. User will be prompted for the NDMP user name and password. NDMP protocol exports only Jukeboxes and Tape Devices. No other device types will be discovered. When NDMP Tape Server is running at version 3 or higher and supports NDMP_CONFIG_GET_SCSI_INFO and NDMP_CONFIG_GET_TAPE_INFO interfaces, inquire will display the INQUIRY data for all the available Jukeboxes and Tape Devices. In all other cases, inquire will prompt for Jukebox handle and get the INQUIRY data for that Jukebox. This option is not compatible with -a. See -T for more details.

Sample output with NDMP Tape Server running at V3 and supporting of SCSI and TAPE CONFIG interfaces:

# inquire -N server-2 Enter NDMP user name: ? ndmp Enter 'ndmp' password on NDMP host 'server-2' (characters will not be echoed):

Communicating to devices on NDMP Server 'server-2', this may take a while...

scsidev@178.0.0:QUALSTARTLS-6110 2.09|Autochanger (Jukebox), c178t0l0 S/N: 44B43014 scsidev@178.0.1:QUANTUM DLT8000 0119|Tape, c178t0l1 S/N: CX938P2489 IENN:0000000000000000

Sample output with NDMP Tape Server running at V2:

# inquire -N molokai Enter NDMP user name: ? root Enter 'root' password on NDMP host 'molokai' (characters will not be echoed):

Communicating to devices on NDMP Server 'molokai', this may take a while...

NDMP Tape Server 'molokai' does not support of auto-discovery of SCSI and TAPE Devices. Will perform the operation on a single Jukebox in which you are interested.

Enter NDMP Jukebox handle: ? mc1

scsidev@-1.2.0:EXABYTE Exabyte 215 2.3 |Autochanger (Jukebox) S/N: 71000073

-s

Suppresses the collection of serial number information by inquire, so that inquire returns the same output that it did before the serial number information was added. This option is primarily added so that any scripts that rely on the former output behavior of inquire can be used with only minor modification.

-T

This option is only valid when -N is present else it is ignored. The option will display the NDMP Tape Devices in a non standard format. The Device Model and Device Handle(s) will be displayed. This option is useful on NDMP Tape Servers that do not support NDMP_SCSI_OPEN interface on Tape Devices (For example, NetApp).

Sample output with -T option on NetApp Filer.

# inquire -N molokai -T Enter NDMP user name: ? root Enter 'root' password on NDMP host 'molokai' (characters will not be echoed):

Communicating to devices on NDMP Server 'molokai', this may take a while...

scsidev@0.2.0:EXABYTE Exabyte 215 2.3 |Autochanger (Jukebox), mc1 S/N: 71000073 scsidev@0.3.0:QUANTUM Powerstor L200 0022|Autochanger (Jukebox), mc0 S/N: JF83801878

Model

Device Handle

---------

------------------

Quantum DLT7000

nrst0l

nrst0m

nrst0h

nrst0a

Exabyte Mammoth-2 8mm nrst2l

nrst2m

nrst2h

nrst2a

-t

This option is only valid when -T is present else it is ignored. The option will display the vendor specific NDMP Tape Devices Attributes for each tape device handles that are displayed with option -T.

Sample output with -t option on NetApp Filer.

# inquire -N rainbow -T -t Enter NDMP user name: ? root Enter 'root' password on NDMP host 'molokai' (characters will not be echoed):

Communicating to devices on NDMP Server 'molokai', this may take a while...

scsidev@0.3.0:QUANTUM Powerstor L200 0022|Autochanger (Jukebox), mc0 S/N: JF83801878

Model Device Handle

Attributes

--------

----------------

--------------

Quantum DLT7000 nrst0l

DENSITY -- 81633 bpi 40 GB (w/comp)

ELECTRICAL_NAME -- 0b.4

SERIAL_NUMBER -- CX902S0678

WORLD_WIDE_NAME --

ALIAS 0 -- st0

nrst0m

DENSITY -- 85937 bpi 35 GB

ELECTRICAL_NAME -- 0b.4

SERIAL_NUMBER -- CX902S0678

WORLD_WIDE_NAME --

ALIAS 0 -- st0

nrst0h

DENSITY -- 85937 bpi 50 GB (w/comp)

ELECTRICAL_NAME -- 0b.4

SERIAL_NUMBER -- CX902S0678

WORLD_WIDE_NAME --

ALIAS 0 -- st0

nrst0a

DENSITY -- 85937 bpi 70 GB (w/comp)

ELECTRICAL_NAME -- 0b.4

SERIAL_NUMBER -- CX902S0678

WORLD_WIDE_NAME --

ALIAS 0 -- st0

SEE ALSO

libscsi(1m)

WARNINGS

Use this command with caution. The inquire command sends the SCSI inquiry command to all devices it detects on all SCSI buses. Running inquire during normal device operations may cause unforeseen errors. Data loss may result.

LIMITATIONS

The inquire program always uses the built-in system drivers to test SCSI devices. The device type or path name printed by the inquire program may be incorrect for devices that require special, third-party drivers.

You must be logged in as the superuser (root) on Unix systems when running inquire. If not, the output may be erroneous.