Unable to Detect Non-IBM Libraries on AIX

Article ID: MM0017 When detecting tape libraries from an AIX hosted MediaAgent, the attached Non-IBM library fails detection.

Symptom

Attempts to detect a Non-IBM library from an AIX hosted MediaAgent fail.

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.

Resolution

  • 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 9.

    Arm-changer will be detected as smcX device (where X=1,2,3...).

  1. Ensure that no jobs are running in the CommCell Console.
  2. Stop the Commvault services on this MediaAgent.
  3. 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

  4. Navigate to /Base folder. Run the following command:

    cd /Base

  5. 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

  6. Navigate to /MediaAgent folder.
  7. 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 Typeis 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

  8. Run ./addgnodestring.ksh

    The addgnodestring.ksh script will add the inquiry string to the PdAt database. The script will pad out this string to 16 characters.

    You can run the removegnodestring.ksh to remove one specific inquiry string from the PdAt database.

    Run ./addgnodestring.ksh

    Inquiry String: Scalar i500

    The inquiry string entered was 'Scalar i500'. Is this correct y/n? y

    Inquiry string after padding to 16 characters is: 'Scalar i500     '

  9. 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)

  10. Restart the Commvault services on this MediaAgent.

Example

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

# simpana stop
# cfgmgr -v
# cd /Base
# ./detectdevices -add tape
  fscsi0 rmt1.1 131328 0 pthru_adapter tape
# cd /MediaAgent
# ./testinq /dev/fscsi0 131328 1
  /dev/fscsi0@131328,1:ADIC    Scalar i500     600G|Serial# ADICA0C0035914_LLB |Device Type 8
  * Will need to provide the addgnodestring.ksh script with inquiry "Scalar i500".
# ./addgnodestring.ksh
  Inquiry String: Scalar i500
  The inquiry string entered was 'Scalar i500'. Is this correct y/[n]? y
  Inquiry string after padding to 16 characters i: 'Scalar i500     '
# 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)
# simpana start