Library and Drive Configuration - Troubleshoot

Topics | How To | Troubleshoot | Related Topics

Device Detection on AIX MediaAgent is Slow

Unable to Detect Non-IBM Libraries on AIX

Non-IBM Libraries are not Configurable in an LPAR Environment

Device Detection on AIX MediaAgent is Slow

This might occur for the following reason:

Cause: On AIX MediaAgents, the presence of a number of SCSI adaptors may result in slowing down the detection process. If you know that some of these adaptors are not required by the MediaAgent, you can skip them during the detection process as described in below.

Create the following file:

<software installation path>/Base/detectdevices.skip

Use the following format to add the list of adapters that must be skipped during device detection.

adapter <adapter name>

For example:

adapter scsi2

adapter fscsi1

Note the following:

Entries are case-sensitive
Adapters to be skipped can be specified in any order
Each entry must identify a single adapter to be skipped

Unable to Detect the Devices in Solaris

If you have the QLOGIC Sun FC HBA with Sun drivers (qlgc driver by SUN), you may not be able to detect the devices from the Library and Drive Configuration window. Use one of the following procedures to attach the WA Driver to the Solaris MediaAgent in the above environment:
- To attach the wa drivers when the library is attached to QLOGIC FC HBA by SUN
- To attach the wa drivers when the library is attached to QLOGIC FC HBA by SUN with a storage router
Your devices may have LUNS greater than 7. Follow the procedure described in To Scan Devices with LUNs greater than 7 to correct this problem.

To attach the wa drivers when the library is attached to QLOGIC FC HBA by SUN

Ensure that the tape devices are visible to the Solaris kernel.

You can do this using the following commands:

Run cfgadm -al

grep/look for type as tape devices

If (cfgadm -al) displays all the devices configured on system, look for the word tape to identify tape devices.

For example, the output of the cfgadm -al command may be as follows:

Ap_Id	Type	Receptacle	Occupant	Condition
c0	scsi-bus	connected	configured	unknown
c0::dsk/c0t0d0	disk	connected	configured	unknown
c0::dsk/c0t10d0	disk	connected	configured	unknown
c0::dsk/c0t6d0	CD-ROM	connected	configured	unknown
c0::dsk/c0t8d0	disk	connected	configured	unknown
c0::dsk/c0t9d0	disk	connected	configured	unknown
c3	scsi-bus	connected	unconfigured	unknown
c6	fc-fabric	connected	configured	unknown
c6::100000d08000167d	tape	connected	configured	unknown
c6::100000d080001986	tape	connected	configured	unknown
c6::100000e00221b69	array-ctrl	connected	unconfigured	unknown
c6::100000e00221d909	disk	connected	unconfigured	unknown
c6::2100002037194c51	disk	connected	configured	unknown
c6::210000203719599e	disk	connected	configured	unknown
c7	fc	connected	unconfigured	unknown
c8	fc	connected	unconfigured	unknown

If you do not see the devices as shown in the above example, make sure that the devices are visible to the Solaris kernel before proceeding any further.

If you see the tape devices, as shown in the above example, run the following script:
<software installation path>/WA/wa_sunqlc_add

After running the script, you will be able detect the devices from the Library and Drive Configuration window.

To attach the wa drivers when the library is attached to QLOGIC FC HBA by SUN with a storage router

Ensure that the tape devices are visible to the Solaris kernel.
You can do this using the following commands:
Run cfgadm -al

grep/look for type as array-ctrl

For example, the output of the cfgadm -al command would be as follows:

c6::100000e00221b691 array-ctrl connected unconfigured unknown

If you do not see the devices as shown in the above example, make sure that the devices are visible to the Solaris kernel before proceeding any further.
If you see the array-ctrl as shown in the above example, you will have to add the necessary information in the following file:
/usr/kernel/drv/wa.conf

Add the necessary entries using the following pattern to add each device.

name="wa" parent="fp" target=16 lun=0 fc-port-wwn="WWPN"

Using the above example, it will be as follows:

name="wa" parent="fp" target=16 lun=0 fc-portwwn="100000e00221b691"

Add 8 entries from lun=0-7

Example:

name="wa"	parent="fp"	target=16	lun=0	fc-port-wwn="100000e00221b691";
name="wa"	parent="fp"	target=16	lun=1	fc-port-wwn="100000e00221b691";
name="wa"	parent="fp"	target=16	lun=2	fc-port-wwn="100000e00221b691";
name="wa"	parent="fp"	target=16	lun=3	fc-port-wwn="100000e00221b691";
name="wa"	parent="fp"	target=16	lun=4	fc-port-wwn="100000e00221b691";
name="wa"	parent="fp"	target=16	lun=5	fc-port-wwn="100000e00221b691";
name="wa"	parent="fp"	target=16	lun=6	fc-port-wwn="100000e00221b691";
name="wa"	parent="fp"	target=16	lun=7	fc-port-wwn="100000e00221b691";

Save the changes.
Stop the services in the MediaAgent in which the entries were added.
Execute the following commands to create the device nodes:
rem_drv wa

add_drv wa
Start the services in the MediaAgent in which the entries were added.
You will now be able detect the devices from the Library and Drive Configuration window.

To Scan Devices with LUNs greater than 7

By default the MediaAgent scans for devices with LUNs 0-7. If the devices are over these values they will not be detected. Perform the following steps to correct this problem:

Edit the following file:
/usr/kernel/drv/wa.conf
Add an additional line across all targets to add a specific LUN. For example, to add LUN 8 and assuming that you have one target - Target 0 - you need the following line:
name="wa" class="scsi" target=0 lun=8;

Unable to Detect Non-IBM Libraries on AIX

Cause

By default, AIX does not have a driver that attaches to non-IBM libraries. The driver provided by IBM, Atape, attaches only to IBM libraries.

Solution

If you have AIX 5.3 (maintenance level 5 and above), AIX 6.1 or AIX 7.1, use the following procedure to detect any non-IBM libraries that are not detected.
If you have IBM only libraries connected to the MediaAgent, install the IBM Atape driver on this MediaAgent and proceed to step 11.
Arm-changer will be detected as smcX device (where X=1,2,3...).

Ensure that no jobs are running in the CommCell Console.

Stop the Calypso services on this MediaAgent.

Run cfgmgr command to configure devices currently detected by the OS.

If the adapter ID is known, use the -l option to limit action to adapter.

cfgmgr -v

Navigate to <Software_Installation_Path>/Base folder.

Run the following command:

cd <Software_Installation_Disc>/Base

Determine device details for currently detected devices. This information will be used to discover the library inquiry string.

Run ./detectdevices -add tape

Messages similar to the following will be displayed

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

scsi3 rmt0.1 5 0 pthru_adapter tape

scsi3 gnode0 5 1 pthru_adapter tape

fscsi0 rmt1.1 131328 0 pthru_adapter tape

fscsi0 rmt2.1 131584 0 pthru_adapter tape

fscsi0 smc0 131584 1 pthru_adapter tape

fscsi0 rmt3.1 131840 0 pthru_adapter tape

Note down the above device details for drive:

adapter - fscsi0, device - rmt1.1, target - 131328, Lun - 0

Navigate to <Software_Installation_Path>/MediaAgent folder.

Run test inquiry (testinq) command.

To determine the library's inquiry string, you may need to run the testinq command on the next or previous LUN of the drive device found.
Run this command till the Device Type option in the result displays 8. If the Device Type is displayed as 8 then it confirms that this device is an arm-changer.
For example, if the drive above in step 5 was found on adapter fscsi0, target 131328, LUN 0, then the testinq command may be issued on LUN 1.
When Device Type 8 is discovered, the library's inquiry string is defined by characters 9-24 following the ":". Within this example, inquiry string is "Scalar i500 ".

It may be necessary to run the testinq command on both, the next Target and LUN for SAS devices.
Note that the inquiry string is case and space sensitive.

Run ./testinq /dev/fscsi0 131328 1

/dev/fscsi0@131328,1:ADIC Scalar i500 600G|Serial# ADICA0C0035914_LLB |Device Type 8

Run ksh ./removegnode.ksh

# ksh ./removegnode.ksh

Before proceeding, please make sure Calypso services are shutdown

Hit enter to continue

0518-307 odmdelete: 0 objects deleted.

If detecting a SAS non-IBM library for the first time, run the following command:
Run ksh ./addSASgnodestring.ksh

You need to provide library's inquiry string. From the previous testinq result in step 7, enter Scalar i500. The script will pad out this string so 16 characters total are entered.

Continue to step 11.
If adding a SCSI, FC or additional SAS non-IBM library:
Edit the gnode.Pdat.withatape file to add new entry that will define the 16 characters of the library inquiry string.

Make the entry for the appropriate adapter type (SCSI, FC, SAS).

Make sure that the inquiry string is prefixed with 1010, and is exactly 16 characters wide excluding the prefix. If the inquiry string is less than 16 characters, the remaining characters must be padded with spaces.

Example of gnode.Pdat.withatape file entries

This example illustrates entries, using Scalar i500 library for various adapter types.

Entry for SCSI library

PdAt:
uniquetype = "tape/scsi/gnode"
attribute = "model_map"
deflt = "1010Scalar i500 " /* The model number should be prefixed with 1010 and must be exactly 16 characters long
excluding the prefix*/
values = ""
width = ""
type = "R"
generic = ""
rep = "s"
nls_index = 0

Entry for FC library

PdAt:
uniquetype = "tape/fcp/gnode"
attribute = "model_map"
deflt = "1010Scalar i500 " /* The model number should be prefixed with 1010 and must be exactly 16 characters long
excluding the prefix */
values = ""
width = ""
type = "R"
generic = ""
rep = "s"
nls_index = 0

Entry for SAS library

PdAt:
uniquetype = "tape/SAS/gnode"
attribute = "model_map"
deflt = "1010Scalar i500 " /* The model number should be prefixed with 1010 and must be exactly 16 characters long
excluding the prefix */
values = ""
width = ""
type = "R"
generic = ""
rep = "s"
nls_index = 0

10.

Run ksh ./addgnode.withatape.ksh

ksh ./addgnode.withatape.ksh

Before proceeding, please make sure Galaxy services are shutdown

Hit enter to continue

11.

Rerun cfgmgr command to check if the library is detected.

Once cfgmgr has completed, check if the arm changer is detected using:

lsdev -Cc tape command

Arm-changers detected for non-IBM libraries are represented by gnode devices in the lsdev -Cc tape output.

cfgmgr �v

lsdev -Cc tape

Messages similar to the following will be displayed

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

Take note of the new gnodeX device listed below.

gnode0 Available 10-70-00-5,1 Other SCSI Tape Drive

gnode1 Available 20-58-02 Other FC SCSI Tape Drive

rmt0 Available 10-70-00-5,0 Other SCSI Tape Drive

rmt1 Available 20-58-02 LTO Ultrium Tape Drive (FCP)

rmt2 Available 20-58-02 IBM 3580 Ultrium Tape Drive (FCP)

rmt3 Available 20-58-02 Other FC SCSI Tape Drive

smc0 Available 20-58-02 IBM 3576 Library Medium Changer (FCP)

12.

Restart the Calypso services on this MediaAgent.

Example

This example illustrates the procedure for the Scalar i500 library (FC adapter)

# calypso stop

# cfgmgr -v

# cd <Software Installation Path>/Base

# ./detectdevices -add tape

fscsi0 rmt1.1 131328 0 pthru_adapter tape

# cd <Software Installation Path>/MediaAgent

# ./testinq /dev/fscsi0 131328 1

/dev/fscsi0@131328,1:ADIC Scalar i500 600G|Serial# ADICA0C0035914_LLB |Device Type 8

* Will need to add �Scalar i500 � inquiry string to the gnode.Pdat.withatape file.

Insert entry into the file gnode.Pdat.withatape as given below:

Entry for SCSI library

PdAt:

    uniquetype = "tape/fcp/gnode"
    attribute = "model_map"
    deflt = "1010Scalar i500     " /* The model number should be prefixed with 1010 and must be exactly 16 characters long
    excluding the prefix*/
    values = ""
    width = ""
    type = "R"
    generic = ""
    rep = "s"
    nls_index = 0

# ./removegnode.ksh

# ./addgnode.withatape.ksh

Before proceeding, please make sure Galaxy services are shutdown

Hit enter to continue

# cfgmgr -v

# lsdev -Cc tape

gnode1 Available 20-58-02 Other FC SCSI Tape Drive

rmt1 Available 20-58-02 LTO Ultrium Tape Drive (FCP)

# calypso start

Non-IBM libraries are not configurable in an LPAR environment

To configure non-IBM libraries in an LPAR environment, install the latest service pack and then follow the steps described in Unable to Detect Non-IBM Libraries on AIX procedure to detect any non-IBM libraries that are not detected.