Skip Headers

StorageTek SL3000 User's Guide E20875-05 |
| Contents | Index

Previous | Next |

# 6 Library Management

Library management tasks involve viewing the library status, device status, and alerts. Additionally, you can view IP addresses, library and drive controller properties, and event statistics.

## Library and Device Status

SLConsole shows health status for devices, SLConsole communication, and the library.

Table 6-1 Status Indicators

Icon | Meaning
--- | ---
| Normal
| Warning
| Error

Health Status of a Device

Found in navigation tree of System Details and Diagnostics page

- Normal — library device is functioning normally

- Warning — device is offline or operating in a degraded state

- Error — device has experienced a failure

Communication Status

Found in lower left of all SLConsole screens. Indicates the communication status between SLConsole and the library controller.

- Normal — SLConsole is communicating normally with the library controller

- Warning — server is taking longer than 10 seconds to respond

- Error — server is taking longer than 30 seconds respond

After about 30–60 seconds of lost communication the heartbeat monitor turns gray, then red, and the following error message appears:

    Heartbeat message not received from the library controller.

Log off the SLConsole, and then log on again to restore communication.

Health Status of the Library

Found in lower right of all SLConsole screens.

- Normal — all library devices are functioning normally

- Warning — one or more library devices is offline or operating in a degraded state

- Error — one or more library devices has experienced a failure

  After a device error is fixed, the library health indicator changes to "Warning". The indicator will not change to "Normal" until the library is taken offline. If there are multiple problems with a device or status alert condition, the health indicator displays the most severe condition.

## Upgrade Library Firmware

To upgrade firmware, use the SLConsole code load utility. You cannot perform a code download or activation at the local operator panel.

Library firmware does not contain drive code upgrades (see drive-specific documentation). Firmware upgrades for libraries with the redundant electronics feature are minimally disruptive (see Chapter 7, "Redundant Electronics").

### Download Code to the Library Controller

1. Locate the firmware upgrade package (.jar file) at: `http://edelivery.oracle.com`

2. Download the code to your workstation.

3. Log in to the SLConsole.

4. Select Tools > Diagnostics, and then click the Library folder.

5. Click the Load Code tab.

6. Enter the full path of the firmware package to download, and then press Enter.

   Optionally, click Browse and navigate to the file location.

7. Verify the contents and file name. Click Load.

8. Click OK. The download process could take up to 10 minutes.

   Note: Next to the Failed label, you should see "0". If there are any failures indicated, contact your Oracle support representative for assistance.

9. After the code unpacks, activate the code at any time (see "Activate Code on the Library Controller").

### Activate Code on the Library Controller

The library controller can store up to two versions of firmware, but only one is active. The active version is identified as "running". You can restore the earlier firmware version if required.

A reboot of the library is required. Schedule the code activation accordingly.

1. If you have not done so, download and unpack the code (see "Download Code to the Library Controller").

2. Select Tools > Diagnostics, and then click the Library folder.

3. Click the Activate Code tab.

4. In the Target list, select the code package to activate (in this case SL3000 Code).

5. In the Available Versions section, select the code version to activate.

6. Click Activate.

7. Click OK to start activation.

   Caution: POTENTIAL INTERNAL FILE CORRUPTION. Do not reboot any devices in the library or execute any operations on the library while activating code.

8. When the activation process finishes, click OK to reboot the library.

9. Click OK to terminate the SLConsole session.

10. After library initialization completes, log in to SLConsole.

## Special Library Configuration Options

The Library Configuration page provides the following configuration options. In partitioned libraries, these options can be configured separately for each partition.

- Barcode presentation (see"Configure Cartridge Barcode Presentation (FC-SCSI only)")

- SCSI FastLoad controls the criteria by which cartridge mounts are considered complete (see "SCSI FastLoad Feature").

- Library Auto Clean controls the management of cleaning cartridge and drive clean functions (see "Drive Cleaning").

## Display Library Information

- "Display Library Status"

- "Display Library Properties"

- "Library Reports"

- "Display Library Power Supply Information"

### Display Library Status

1. Select Tools > System Detail, and then click the Library folder in the navigation tree.

2. Click the Status tab.

3. Select a secondary tab:

   - General - displays the current operational state of the library. These values update whenever there is host activity, background operations, or operator activity.

   - Status Module - displays library status alerts and highlights significant messages. This feature is available only if service is active on the library. If service is not active on the library, this screen will be blank except for a message indicating that the "Service activation is not valid". If you see the "warning" status, a failure may occur. Contact a service representative.

   - HLI - displays the current status of all HLI interface ports on the library. Information includes the local TCP/IP socket, local IP, connection status, port status, and transmission sent and received from the time of connection.

   - FC-SCSI - display the current status of all host FC–SCSI interface ports on the library. Detailed information is shown by port number. If the Multi Port Fibre feature has been activated on the library, detail is shown for all ports.

### Display Library Properties

1. Select Tools > System Detail, and then click the Library folder.

2. Click the Properties tab.

3. Select a secondary tab:

   - General - displays the physical, mechanical, logical, and network configuration of the library. Some of the information can be set up automatically during library initialization, while other information can be defined by the user.

   - Library Controller - displays details of the library controller, including the serial number and firmware versions.

   - Drive Controller - displays details of the drive controller, including the serial number and current firmware versions.

### Library Reports

Use this procedure to display, search, or save library reports available from the Tools > Reports menu. Additional reports are available from the Tools > Partitions menu.

All report output is a static display of information at the time the report is generated. Click Update in the upper right corner to refresh the information.

1. Select Tools > Reports.

2. In the navigation tree, expand a report category.

3. Select a report.

#### Search a Library Report

1. With the report displayed, click Search.

2. Enter a text string (case-sensitive and wildcards are invalid). Click Search.

#### Save Library Report Data to a File

1. With the report displayed, click Save.

2. Browse to the desired directory, enter a file name, select a format, and click Save.

#### Display Library Statistics Reports

The Energy Monitor Reports help you monitor your power and energy usage, and identify periods of peak and low usage over time.

To change the sort order of the screen or rearrange and resize the columns, see "Modifying the Screen Layout".

1. Select Tools > Reports.

2. Expand the Statistics folder, and then click a report: .

   - General Events - displays summary statistics for library operations. For each event, the report lists the event type, number of occurrences, and the date and time of the most recent occurrence of the event.

   - Energy Monitor - Last 24 Hours - displays minute-by-minute energy and average power usage for the entire library over the last 24 hours

   - Last Month Energy Monitor - Last Month - displays energy and average power usage for the entire library, measured in 15-minute intervals over the last 32 days

   - Last Month Energy Monitor - Last Year - displays energy and average power usage for the entire library, measured in one-day intervals over the last 365 days

### Display Library Power Supply Information

For power configuration information, see the SL3000 Systems Assurance Guide "Power" chapter found on OTN.

The Power Supply Data screen displays summary information for all power supplies in the library. Use this screen to monitor the status of the power supplies for maintenance or replacement. By default, the display is sorted by internal address. To change the sort order, and rearrange and resize the columns, see "Modifying the Screen Layout".

1. Select Tools > System Detail.

2. In the Library navigation tree, click the Power Supply folder to display summary information.

3. For detailed information, expand the Power Supply folder. Select a power supply.

## Generate Library Diagnostic Files

These procedures generate files to diagnose library problems.

### Transfer the Library MIB File

Use this procedure to transfer the public SNMP management information base (MIB) file to an Oracle support representative.

1. Select Tools > Diagnostics.

2. Click the Library folder in the navigation tree.

3. Click the TransferFile tab.

4. Select the Transfer Type of SNMP MIB. Click Transfer File.

5. Browse to the desired directory, and then enter the file name with a .txt suffix.

6. Click Save.

7. E-mail the file to your Oracle support representative.

### Generate and Transfer the Library Log Snapshot File

If a support representative requests a library Log Snapshot, use this procedure to generate and transfer the file. The system saves the file in an encrypted format, so you cannot view or edit it. You must save the log within 15 minutes of generation.

1. Select Tools > Diagnostics.

2. Click the Library folder in the navigation tree.

3. Click the Transfer File tab.

4. Select the Log Snapshot radio button.

5. In the Selected Devices list, select either All Devices or Selected Device. If you choose Selected Device, select the device.

6. Click Generate Log Snapshot on Library.

7. Click Yes, and then OK.

8. Click Transfer Log Snapshot To Your Computer.

9. Browse to the desired directory or enter the directory path. Click Save. The file is named automatically.

10. E-mail the file to your Oracle support representative.

## Clear Library Status Alerts

You can only clear alerts marked as "Clearable" and only if service is active on the library.

Clearing an alert only removes it from the Status Module display; it does not resolve the underlying cause. The library health indicator returns to "Normal" if there are no other device or status alerts. If the alert is subject to periodic updates, it will reappear at the next update cycle.

1. Select Tools > System Detail, and click the Library folder.

2. Click the Status tab, and then the Status Module tab.

3. On the Clear Alert Number list, select the alert number to clear, and then click Apply.

## Perform a Library Self-Test

The self-test diagnostic can help diagnose library operational problems. A self-test typically runs after the library is installed. You can run library self-test routines in either non-disruptive (cartridges are returned to home cells) or disruptive mode (cartridges may be moved to new cells).

When performing a self-test, the system:

- Checks the communication path between the library controller, drives, elevators, and robots.

- Performs get and put operations to check the health of the robots, elevators, and CAPs. This includes get and put operations from a reserved system cell to a random empty storage cell or CAP cell.

- Performs a full library audit.

- Performs mounts and dismounts of diagnostic cartridges for all the drives installed in the library. The self-test does not begin unless a diagnostic cartridge is found in the system cells. If the system finds a compatible diagnostic cartridge, the self-test repeats for each drive type. If the system does not find a diagnostic cartridge for a drive type, the system skips the mount/dismount operation for the drive.

Note: Before performing a disruptive test, the library must be taken offline. See "Place the Library Online or Offline".

1. Make sure the proper drive diagnostic cartridges are in the library (see "Display Cartridge Information").

2. Select Tools > Diagnostics, and click the Library folder.

3. Click the SelfTest tab.

4. In the Mode list, select the type of self-test:

   - Non-Disruptive - all cartridges used in the test are returned to their original locations

   - Disruptive - the library must be taken offline to all hosts before running this test

5. Click Run. When the test completes, the results of the test display.

6. For disruptive tests, bring the library online to resume normal operations.

## Reboot the Library

Use this procedure to reboot the library. This process involves reloading the firmware from flash memory and restarting the library controller.

1. Select Tools > Diagnostics.

2. Click the Library folder in the navigation tree.

3. Click Reboot.

4. All other users must log off. Click OK.

5. If the library is online, click OK to take the library offline.

6. Click OK to reboot the library.

7. Click OK to terminate this SLConsole session. Do not log back in to the SLConsole until the library has fully initialized.

## Place the Library Online or Offline

Use this procedure only if you are not using ACSLS or ELS tape management software, or if ACSLS/ELS servers cannot communicate with the library. For instructions on changing the state of the library and its components through ACSLS or ELS, see the appropriate tape management software documentation.

### Place the Library Offline

You may need to place the library offline at the following times:

- Before powering down the library

- Before opening a library access door

- When the library is inoperative and requires maintenance

To place the library offline:

1. Take all library drives offline. See "Change a Drive Online/Offline Status".

2. Select Tools > System Detail.

3. Click the Library folder in the navigation tree.

4. Click the Status tab, and then the General tab.

5. In the Transition Request field, click Take offline.

6. Click Apply. Before the library goes offline, all outstanding library jobs complete.

7. Wait for the offline confirmation message. If the library does not come offline, check the status of the library.

### Bring the Library Online

1. Select Tools > System Detail.

2. Click the Library folder in the navigation tree.

3. Click the Status tab, and then the General tab.

4. In the Transition Request field, click Bring online.

5. Click Apply.

6. If applicable, bring the library online to ACSLS and ELS hosts. See the ACSLS and ELS documentation.

### Bring the Drives Online

LTO drives are automatically brought online when you bring the library online. To bring T-series drives online manually:

1. To verify that the T-series drives are ready and online, press the MENU switch. The display should now read Online.

2. If the drive displays Offline, press the SELECT switch once to bring it online.

   - If the drive message indicates Online, the transition to online completed.

   - If the Onl Pend message appears, the online state is pending due to completion of diagnostic tests.

   - If other messages appear, refer to the drive documentation.

## Change the Library Interface Type (Non-Partitioned Libraries)

Use this procedure to change the interface type that all hosts use to connect to the library. This procedure applies to non-partitioned libraries only.

Note: To change interface types in a partitioned library, see "Modify a Partition".

1. Select Tools > Select Active Cells.

2. Click the Select Active Cells tab.

3. In the Interface Type list, select the interface type you want to assign. Click Apply.

4. Click Yes to update the library controller database.

5. Click OK to return to the Select Active Cells page.

   The new interface type is active immediately. The library does not need to be rebooted.

## Audits

An audit is the process of cataloging or verifying cartridge locations within a library and updating the cartridge database. The database contains the volume ID (vol-id or volser), current location (in library internal address format), and verified status (true or false).

You can use the SLConsole to perform a "Physical Audit", "Verified Audit", or virtual audit. A virtual audit displays a report listing the contents of the cartridge database. Audit times vary according to the type of audit, size of the library, the number of HandBots, and the speed of the scan engine for the barcode scanner.

The library performs an audit when:

- One or both access doors have been opened and closed.

- An audit request is made through the SLConsole.

- A host request to audit the library is entered. (System-level problems may occur if a host's record of the cartridge does not match what is in the cartridge database of the library controller.)

- The library initializes at power on.

Audit Indicator

To indicate an audit is in progress, the SLConsole displays a spinning indicator and the message "Audit in progress". When you see this indicator do not open the library access door. This will cause the audit to restart.

The audit indicator only displays when an audit is initiated automatically (library access door has been opened and closed, library power up or reboot). The indicator does not display for audits initiated from SLConsole or the host.

### Physical Audit

In a physical audit, the robot visits cartridge locations and records the vol-id of the cartridges. The library controller updates the cartridge database based on the physical audit. This audit changes the "verified" status of the cartridge locations to `true`.

You can manually initiate a physical audit for either the entire library or a specific range of cells.

Note: You cannot stop a physical audit after it begins.

#### Audit the Entire Library

The robot verifies all cells (storage, CAP, drive, reserved). Although an entire library audit is a background process and does not interrupt library operations, it does require sharing of robot resources. It is not recommended that you run this audit during peak activity periods.The audit takes approximately 1/2 second per cartridge slot.

After a few hours of the audit, you can view the Cartridge Summary report for the latest cartridge locations and vol-ids. See "Library Reports".

1. Select Tools > Diagnostics.

2. Click the Library folder on the navigation tree.

3. Click the Audit tab.

   1. In the Entire Library section, click Yes.

   2. Click Audit.

4. Click OK to begin the audit.

#### Audit a Range of Cells

During this audit, the library verifies only a specific range of storage cells (including the CAP and drives). The audit information is displayed on the SLConsole while the audit is performed. After the audit completes, view the Cartridge Summary report for the latest cartridge locations and vol-ids. See "Library Reports".

1. Select Tools > Diagnostics.

2. Click the Library folder on the navigation tree.

3. Click the Audit tab.

   1. In the Entire Library section, click No.

      In the Physical Audit section, select Yes.

      In the Verified Audit section, select No.

   2. In the Start Address and End Address sections, select the device types to audit and the internal address locations.

   3. Click Audit.

4. Click OK to begin the audit. The Audit Console section displays the progress of the audit.

### Verified Audit

A verified audit validates the status of a specific cartridge location or range of locations (including CAPs and drives) in the cartridge database. If a cartridge address has a verified status of `false`, a physical audit of that location is performed and the cartridge database is updated.

1. Select Tools > Diagnostics.

2. Click the Library folder on the navigation tree.

3. Click the Audit tab.

   1. In the Entire Library section, select No.

      In the Physical Audit section, select No.

      In the Verified Audit section, select Yes.

   2. In the Start Address and End Address sections, select the device types to audit and the internal address locations.

4. Click Audit. The Audit Console section displays the progress of the audit.