E ACSLS Support of the SL150

The SL150 library is a SCSI-attached, single-LSM library. This chapter discusses ACSLS support for the SL150 library.

ACSLS Connectivity

The ACSLS server needs an FC Host-Bus Adapter (HBA) that is compatible with the bridged drive in the SL150 library.

When you run $ACS_HOME/install/install_scsi_sol.sh, the system is probed for the existence of new hardware: either a JNI card or an LSILogic card. If either of these HBA cards is present on the system, but the corresponding driver is not in place, the routine displays a prompt that asks you for permission to locate the appropriate driver package and install it.

Note:

Although the SL150 can be partitioned, ACSLS does not support partitioned SL150s.

Note:

SAS bridged drives for control path are not supported. Only fibre-channel connections to bridged drives are supported.

ACSLS and SL150 Library Differences

This section discusses ACSLS and SL150 library differences.

Library Configuration

  • ACS, LSM - SL150 library is an ACS with a single LSM (1 ACS and 1 LSM).

  • SL150 does not currently support the pass-thru port.

  • SL150 has at least one base module, and can have up to nine expansion modules.

  • ACSLS considers each SL150 module as a panel.

  • SL150 libraries managed by ACSLS reports 6-character volser labels through ACSLS interface.

Identifying Library Locations

This section discusses library locations.

Addressing schemes

  • ACSLS addressing is ACS, LSM, panel, row, column.

  • SL150 addressing is module, sides, row, column for storage cells.

  • ACSLS addresses are zero-based. They start with panel 0, row 0, and column 0.

  • SL150 libraries are one-based. They start with module 1, row 1, and column 1.

  • In order to ensure consistency between the SL150 library and ACSLS internal addresses, ACSLS defines placeholders for panel 0, row 0, and column 0.

Panels

  • panel 0 = not installed

  • panel 1 = base module

  • panels 2-10 = expansion modules

Row numbers

  • Within each module (panel), rows are numbered 1-3.

  • Rows are numbered consecutively from the top down.

  • Numbering is identical between the SL150 and ACSLS.

Column numbers

SL150 Addressing:

  • module, side, row, column

  • Columns 1-5, front to back on each side

ACSLS Addressing:

  • Numbered from 1 to 10.

  • Columns 1-5 are on the left side from front to back.

  • Columns 6-10 on are the right side from front to back.

Drive addresses

SL150 addressing:

  • module, position

  • module 1 = base

  • modules 2-10 = expansions

  • position = top to bottom

ACSLS addressing:

  • ACS, LSM, panel, drive

  • Panel = module

  • Drive number = 1-20, numbered from top to bottom  

Table E-1 Example of drive addressing

Module ACSLS Drive Identifier SL150 Drive Address

Base module

0, 0, 1, 1

1, T

 

0, 0, 1, 2

1, B

Expansion module

0, 0, 2, 3

2, T

 

0, 0, 2, 4

2, B

Expansion module

0, 0, 3, 5

3, T

 

0, 0, 3, 6

3, B

Expansion module

0, 0, 4, 7

4, T

 

and so on.

and so on.


ACSLS Limitations

  • Maximum number of SL150 libraries = 31.

  • Maximum number of LSMs = 127.

  • Maximum number of modules (panels) in an SL150 library = 10.

  • Expansion modules add one panel each.

  • An SL150 with only the base module has just one panel.

  • The SL150 firmware does not support unlabeled cartridges. This means that the venter command cannot be used.

  • Partitioned SL150 libraries are not supported.

  • SAS bridged drives for control path are not supported.

Configuring SL150 Library Settings

The SL150 supports configuration settings that affect ACSLS.

  • Partitioning

    Partitioned SL150 libraries are not supported by ACSLS.

  • Bridged Drives

    ACSLS supports only FC control path. SAS bridged drives for control path are not supported.

  • Configure the Mailslot

    Enables you to use the storage slots on one side of the base module as an extension of the standard mailslot.

    • Required setting for ACSLS: Standard Mailslot (4 slots)

  • Drive Element Addressing Mode

    Enables you to control how SCSI element addresses are reported when empty drive slots are present in the library.

    • Required setting for ACSLS: Address Only Installed Drives

      Note:

      If ACSLS is attached to an SL150, the library addressing mode is set to "Address Only Installed Drives" and STA is also monitoring this library, then STA may not show drives that are in the SL150 Media Validation Pool/Partition. This behavior will be addressed in a subsequent SL150 firmware release.
  • Reserved Cells

    The reserved cells are for library use only (diagnostic and cleaning cartridges):

    • Number (n) can be configured from 0 to 3 (maximum rows in base module).

    • Only affects base module - the first (n) cells in column 1 are reserved.

    • These cells are considered inaccessible to ACSLS

  • Library Volume Label Format

    The SL150 library supports a variety of label format types (6-character, 8-character, etc.). For ACSLS operations supporting client operations, the default library setting is appropriate.

    • Required setting for ACSLS: Trim last two characters (default)

SL150 CAP Behavior

The SL150 uses the term ”mailslot” for the CAP. The mailslot in the base module has one four-slot magazine.

All mailslot operations are performed using either the library touch screen or the BUI.

  • The SL150 must have one active mailslot for entering and ejecting cartridges.

  • When ACSLS audits the mailslot, it examines all cells.

CAP (Mailslot) Not Opening During an Eject

It is possible for problems to occur during an eject (or enter) operation if the SL150 CAP (mailslot) has been left locked by an instance of ACSLS that was previously managing the library. Scenarios in which this could occur include migration to a new ACSLS server, or an HA fail-over event.

When the mailslot has been locked by a host, the library touch screen display shows the following:

State: Locked by SCSI Prevent Media

The problem is less likely to be seen with a CAP in automatic mode, since ACSLS typically does not keep an auto-CAP locked. The problem is more likely to occur with a manual-mode CAP, or with any CAP (either mode) in a library that has been varied offline.

Mitigation:

To avoid encountering this problem, the following procedures are recommended.

  • When migrating control of an SL150 library to a new ACSLS server (non-HA configurations):

    • Automatic mode CAP (recommended):

      Do not vary the library offline before shutting down ACSLS on the original server. ACSLS leaves the CAP unlocked at shutdown when the library is online.

    • Manual mode CAP:

      Before shutting down ACSLS on the original server, set the CAP to operate in automatic mode. Do not vary the library offline.

  • When managing the library in an ACSLS HA installation, operating the CAP in automatic mode is strongly advised.

    • Automatic mode CAP (recommended):

      No action should be needed for an online library (the CAP is normally unlocked). If the library was offline at the time of a fail-over event, follow the steps below to unlock the CAP by restarting the bridged drive.

    • Manual mode CAP:

      Follow the steps below to unlock the CAP by restarting the bridged drive.

Resolution:

A lock left by a previous host can be cleared by restarting the bridged drive using the SL150 BUI. Refer to the SL150 product documentation for information about restarting a bridged drive.

WARNING:

This operation is disruptive to any current data path operation on the drive. You can schedule restarting the bridged drive for a time when it will not interrupt data path activity.

In the event that this problem has occurred, and the lock must be cleared:

  1. Ensure that no data path (read/write) activity is occurring on the bridged drive.

  2. Restart the bridged drive using the SL150 BUI.

Auditing the Library

Perform an audit, if:

  • This is a new library.

  • One or more modules have been added, removed, or swapped.

  • Cartridges have been manually added or removed through the mailslot.

  • After library configuration settings have changed.

A self-audit of the library occurs when you:

  • Power-on or re-initialize the library.

  • Open and close the mailslot.

After the self-audit is complete, you must update your database using ACSLS.

When this is a new library

A new library must be audited to synchronize the actual contents of the library with the database.

After adding, removing, or swapping modules

After an SL150 module has been added, removed, swapped, or if you are auditing the library for the first time, perform the following steps:

  1. Vary the SL150 library offline to ACSLS and power down the library.

  2. Perform the library change, such as adding a module.

  3. Power on or re-initialize the SL150 library.

  4. Terminate ACSLS (if it is running) by using the following command:

    acsss disable

  5. Run acsss_config.

  6. Start up ACSLS by using the following command:

    acsss enable

  7. Perform an audit of the SL150 panel(s) affected.

After manually adding or removing cartridges through the mailslot

If you have manually added or removed cartridges from the LSM through the library mailslot, you must synchronize the databases. Perform an audit as described under "query pool".

If you have entered or ejected cartridges from the LSM through the mailslot using the ACSLS cmd_proc, the database is automatically updated.

After changing library configuration settings

If you have changed library configuration settings, you should reconfigure ACSLS using acsss_config, and then audit the library. You should also reconfigure and audit the library after changing the number of reserved cells

Follow these steps:

  1. Vary the SL150 library offline to ACSLS, and power down the library.

  2. Perform the library change.

  3. Re-initialize the SL150 library.

  4. Terminate ACSLS (if it is running) by using the following command:

    acsss disable

  5. Run acsss_config.

  6. Start up ACSLS by using the following command:

    acsss enable

  7. Perform an audit of the SL150 panel(s) affected.