2 StorageTek Library Console

Oracle's StorageTek Library Console (SLConsole) is a Java-based software application that provides a graphical user interface (GUI) for monitoring and managing the StorageTek SL3000. You can perform activities with the SLConsole such as:

View and modify status and properties of the library and associated devices (drives, CAP, robot, and elevators)
Perform an audit, self-test, or diagnostic move
Locate or move a cartridge
Display library logs, status messages, error explanations, context-sensitive help
Download new library firmware while the library is in operation

SLConsole Modes

Throughout this document you can perform the procedures using any SLConsole mode, unless otherwise noted.

"Local Operator Panel"
"Web-launched SLConsole"
"Standalone SLConsole"

Download the SLConsole Media Pack

The Media Pack includes the web-launched SLConsole server, web-launched SLConsole client, and the standalone SLConsole.

Go to the Oracle Software Delivery Cloud at:

http://edelivery.oracle.com/
Click Sign In/Register. Sign in or register.
On the Terms & Restrictions screen, read the License Agreement and Export Restrictions, and select the check boxes to indicate your acceptance. Click Continue.
On the Media Pack Search screen:
1. In the Select a Product Pack list, select Oracle StorageTek Products.
2. In the Platform list, select Generic Platform.
3. Click Go.
Select the SLConsole version to download, click Continue.
To review the download instructions, click Readme. Optionally, use the View Digest button to verify the MD5 and SHA-1 digests of the download files.
Verify the SLConsole version is correct, click Download.
Save the file.
Extract the media pack to the desired location.

SLConsole Screen Display

Figure 2-1 SLConsole Screen Layout

Callout	Component Name	Description
1	Menu bar: Includes the Tools Menu and the Help Menu	Tools — access to SLConsole utilities Help — access to the help system and identifies the SLConsole version
2	Title bar	Displays the title of the current page
3	Function tabs	Identifies the available functions for a page
4	Options bar	Contains buttons related to active utility. Always includes the Help button (?).
5	Work area	Location of the page data
6	Library health indicator	Identifies the library connected to SLConsole, and displays library health
7	UserID indicator	Displays the user ID currently logged in to the SLConsole
8	Server communication indicator	Displays current heartbeat monitor indicating server communication health
9	Navigation tree	Lists the devices included in the library

Modifying the Screen Layout

To sort a column: Click the heading of the column. The initial sort is in ascending order. Click the heading again to switch between ascending and descending order.
To arrange the columns: Click and drag a column heading horizontally to any position in the heading row.
To resize the columns: Click the border of the column heading and drag it left or right to change the column width.

Synchronizing the SL Console With the Controller Database

SLConsole receives library configuration data from the library controller. Configuration data may be unavailable if you log in to SLConsole before the library is fully initialized. Exit and log in again after initialization. Additionally, configuration data displayed during an audit may not be accurate until the audit completes.

Library Configuration Updates

SLConsole displays the most recently saved data from the library controller database. When the configuration changes (such as taking a drive offline, or removing or adding a cartridge), synchronize SLConsole by clicking the Refresh button.

Multiple users can access the library simultaneously. Coordinate with other library users when making major modifications to the configuration (such as adding modules, defining partitions, and so on), to prevent conflicts.

In SLConsole, no changes are made to the library controller database until you click the Apply button.

SLConsole Help

The SLConsole help displays information about SLConsole utilities.

To display context-sensitive help for the current SLConsole screen, click the ? button in the Options bar.
To display general help information, click Help > Contents in the Menu bar.

SLConsole help uses JavaHelp. For information about the JavaHelp interface, see: http://docs.oracle.com/cd/E19253-01/819-0913/

SLConsole Reports

The SLConsole library reports provide information on the library and its associated devices, events, and tape cartridges. Use the reports to monitor library activity and identify potential problems (see "Library Reports").

Note:

Running multiple instances of SLConsole on the same workstation can cause inconsistent data on reports. Only one user per workstation should produce reports, unless all instances of SLConsole are the same version.

Report Types

Log: Detailed system event logs
Statistics: Statistical information on library operations
Status Detail: Details on the status of the library and associated devices, such as CAPs, drives, and robots
Status Summary: Summary information on the status of the library and devices
Version: Details about library hardware and software versions

User Management

To access SLConsole you must have a valid user ID and password. Only one user at a time can log in to the local operator panel, but any number of users can log in to the standalone or web-launched SLConsole.

User IDs

The user ID controls user authorization. Each user ID is assigned a set of permissions, which determines access to utilities within SLConsole. There are a fixed set of user IDs at each site:

admin: customer administrator
service: Oracle support representative
oem: third-party field service technician

Passwords

The library administrator must activate the admin user ID with the first 8 characters of a one-time use activation password provided by an Oracle support representative. After logging in with the activation password, the administrator should change the admin user ID password to ensure system security.

For details about this process, Oracle representatives can refer to the SL3000 Installation Guide.

Change a User Password

Log in to the SLConsole using the account you want to modify.
Select Tools > User Mgmt
On the navigation tree, expand the Permanent folder. Select the current user account
Complete the following fields: Current Password, New Password, and Retype Password.
Click Modify.

SLConsole Login

When you log in to SLConsole you must provide.

User ID: SLC_login. SLConsole user ID.
Password: password. Password assigned to this user ID. (Beginning with SLConsole 4.50 password must be between 5-8 characters.)
Library: library_ID. Either the IP address or DNS alias of the library to which to connect.

Automatic Logout

After six hours (default), the SLConsole session will expire. The system allows four attempts to log back in, the logs the user ID out. To log in, return to the main login screen.

SLConsole Logoff

Before you log off, make sure all operations for the current SLConsole session have completed (for example, code loads, audits, diagnostic moves).

Select Tools > Log Off.
Click OK.
Click Exit to close the SLConsole.

Web-launched SLConsole

The web-launched version enables SLConsole to be installed on a centralized server. Then, individual clients can use a web browser to download the web-launched SLConsole. Using the Web-launched SLConsole you can connect to any library for which you have a valid user ID.

To install the web-launch version on a server, download the web-launch SLConsole server (.war) file from the Oracle Software Delivery Cloud (see "Download the SLConsole Media Pack"). Deploy the file on the web-server of your choice. The web-launched SLConsole is delivered to clients as a Java Web Start process, which executes outside the browser.

You only have to install updates to the web-launched SLConsole on the centralized web-server. You can update the web-launched SLConsole server while it is running. After the updates are installed on the server, they are downloaded automatically to all clients whenever the application is started.

Security Considerations

The web-launched SLConsole software is digitally signed, which guarantees that it has been issued by Oracle Corporation and has not been altered or corrupted since it was created. As a Java Web Start process, the Web-launched SLConsole includes the security features provided by the Java 2 platform.

The customer is responsible for implementing all appropriate security systems, including firewalls, user access, and so on.

Client Requirements

Platform

Solaris 9: SPARC (Firefox 2.x) or Solaris 10: SPARC (Firefox 2.x)
Windows 2000: 32 bit (IE 5, IE 5.5, Firefox 2.x)
Windows XP: 32 or 64bit (IE 7, Firefox 3.x), Windows 7: 64 bit (IE 7, Firefox 3.x)

Other

Java 1.5 Plug-in (the browser should install this automatically)
Ethernet connection to the Web-launched SLConsole server

Log in to the Web-launched SLConsole

To log in using a web-browser, download a recent version of the Firefox web-browser from http://www.mozilla.com. On Solaris platforms, you can also log in to the web-launched SLConsole using the command line.

Obtain the DNS alias or IP address of the SLConsole server. See your library administrator for assistance.
Choose a login method:
- Command line: Available on Solaris only. In the terminal window, enter:
  
  javaws http://server_ID:port_ID/opel/slc.jnlp
- Web browser: Available on either Windows or Solaris. In a web-browser on the client workstation go to the SLConsole Web Start application:
  
  http://server_ID:port_ID/opel
where:
- server_ID: Either the IP address or DNS alias of the SLConsole server
- port_ID: Port ID of the SLConsole application, typically 8080
- opel: The name (context root) of the Web-launched SLConsole application on the server.
Click Launch Now.
Complete the Opening slc.jnlp dialog box:
1. Specify the action to take with the slc.jnlp file:
  
  Select Open with Java(TM) Web Start Launcher to start the SLConsole directly.
  
  Select Save to Disk to save the slc.jnlp file to your client and log in to the SLConsole later (see "Log in to the Web-launched SLConsole Using an Icon").
2. Optionally, select Do this automatically for files like this from now on.
3. Click OK.
If this is your first time running the web-launched SLConsole, complete the digital signature warning dialog box:
1. Verify the Publisher.
2. Optionally, select Always trust content from the publisher.
3. Click Run.
Enter your SLConsole login information, and click Log on.

Log in to the Web-launched SLConsole Using an Icon

You must first save the web-launched SLConsole slc.jnlp file to your client (see"Log in to the Web-launched SLConsole").

Double-click the slc.jnlp desktop icon on your client.
Click Launch Now.
If this is your first time running the web-launched SLConsole, complete the security warning dialog box:
1. Verify the publisher is Oracle Corporation.
2. Optionally, select Always trust content from the publisher.
3. Click Run.
Enter your login information, and click Log on.

Standalone SLConsole

The standalone version runs SLConsole remotely from any workstation with a network connection to the library.

You must deinstall the previous version before installing a new version of the standalone SLConsole. Running multiple versions of SLConsole on the same workstation can cause inconsistent data.

Security Considerations

The SLConsole application interfaces with the primary library interface (PLI) over a secure sockets layer (SSL). SSL provides a secure communication path between the library and the customer's SLConsole session. This security prevents an unauthorized network user from monitoring library activity.

Installation Requirements

Platform

Solaris 9: SPARC, Solaris 10.9 SPARC, or Solaris 10.9 x86
Windows Server 2003, Windows Server 2008 SP2: 64bit, Windows XP SP3: 32 or 64bit
Windows Enterprise 7 SP1: 64bit
Oracle Unbrakable Linux 5
SUSE Enterprise Linux 10.2

Other

Ethernet connection to the library

Install the Standalone SLConsole

De-install any older versions of SLConsole before installing an update.

Download and extract the standalone SLConsole media pack (see "Download the SLConsole Media Pack").
Select the SLConsole installer file for your operating system (refer to the media pack readme).
Review the information. Click Next.
Specify where to install the SLConsole program. Click Next.
Specify where to create the SLConsole shortcut icons. Click Next.

Note:
On Solaris, you must choose something other than the default root directory. It is recommended you choose /u-sr/bin or a similar location.
Verify the information is correct. Click Install.
Click Done.

Log in to the Standalone SLConsole

To start the SLConsole application on your client workstation either:
- Double-click the SLConsole icon on the desktop.
- Select Start > RunSLConsole or Launch > RunSLConsole.
Enter your login information, and click Log on.

Local Operator Panel

The local operator panel is built in to the Customer Interface Module. It enables you to run most of the SLConsole utilities directly at the library. LEDs located directly below the local operator panel provide status information:

Active: Library processor is working.
Wait: Library firmware is loading.
Service Required: Library is rebooting.

Virtual Ke ypad

For screen fields that require text entry, click the keyboard icon to display the virtual keypad. Invalid characters are grayed out.

Table 2-1 Virtual Keypad Controls

Button	Function
Insert	If highlighted, inserts text at the cursor position. If not highlighted, replaces text to the right of the cursor.
Home	Places cursor at the beginning of the field.
Del	Deletes character to the right of the cursor.
End	Places cursor at the end of the field.
Back	Deletes character to the left of the cursor
Clear	Clears the entire field
Left	Moves cursor one character to the left
Right	Moves cursor one character to the right

Log in to the Local Operator Panel

Only one user at a time can log in to the local operator panel.

If the screen is blank, touch the screen anywhere to activate the Login screen.
Use the virtual keypad to enter your login information.
Click Log on.

Touch Screen Calibration

Alignment of the local operator panel touch screen is calibrated at the factory. If the touch screen becomes mis-alignment, re-calibrate or reset the touch screen.

If you have a Linux-based local operator panel, you can re-calibrate it yourself or reset it to factory setting with the procedures below.
If you have a Windows-based local operator panel, contact your Oracle support representative.

Re-calibrate the Local Operator Panel

For an accurate calibration, make sure there is no debris on the touch screen.

Log in to the local operator panel.
Select Tools > Calibrate.
Tap Calibrate.
Gently tap in the center of each target with your finger or a pointing stylus.
To save the new settings:
1. Tap the Click Me buttons within the indicated time period.
  
  If the buttons do not depress, the touch screen is not properly aligned. Discard the new settings, see Step 6.
2. Click OK to save the new settings.
To discard the new settings:
1. Let the timer run out without tapping the Click Me button.
2. Return to Step 4 and re-calibrate.
The local operator panel reboots automatically after an unsuccessful second calibration and restores the previously saved alignment.

Reset the Local Operator Panel Calibration

To restore the alignment to the factory settings:

Log in to the local operator panel.
Select Tools > Calibrate.
Click Reset Calibration. The local operator panel reboots.