Managing Libraries

The library management area, at the top of the LibMON Home Page, provides information on the status of each library connected to the server.



To Create a New Library


Note - When creating or updating a library with LibMON, make sure the library is not in use by another application. This allows LibMON to gather the initial information required to monitor the library.
  1. On the Create menu, click Library.

    LibMON opens the Library Device Name dialog box.

  2. Type the medium changer device name and click OK.

    You made a note of this device name when you ran the SCAN-DEVICES utility.

    LibMON performs the initial verification and information gathering process and opens the Create Library Property Book dialog box.

    The left side of the dialog box, labeled Sections, provides hypertext links to the sections of the dialog box:



    For a complete description of the options in each of these sections, see TABLE 4.

  3. Click Device Names.

    The dialog box displays the Device Names section.

  4. Enter the device names for the tape drives:

    1. If the tape drive is connected to the server, enter the device name you determined when you ran the SCAN-DEVICES utility.

    2. If the tape drive is not connected to the server, enter a duplicate device name for the drive.

      For an explanation of duplicate device name entries, see Using Duplicate Entries.


Note - Be sure the device names you enter are consistent with those used by your backup software. In most cases, you should select a device name associated with the "no rewind" device.
  1. Enter any other library information you have at this time.

  2. Click OK to save your changes.

    The tape library device names are verified, the library is entered in the database, and LibMON monitoring for that tape library is initiated.

    To exit the Create Library Property Book dialog box without creating a library, click Cancel.

Using Duplicate Entries


Note - LibMON cannot monitor tape drives that are not connected to the server, nor does it allow you to create a library without completing the Tape Drive device name fields. If the library contains tape drives that are connected to another host, bypass these restrictions by creating a duplicate entry for each unconnected tape drive.
Duplicate device name entries are necessary when you are using LibMON to monitor a library in which one or more tape drives are connected to a host other than the LibMON server.

LibMON does not allow you to create duplicate entries unless you start LibMON with the -dup option. To start LibMON with the -dup option, execute the following as root:

# /opt/SUNWlmon/START-LIBMON -dup


For example, if the tape library has four drives, but only two of the drives (/dev/rmt/0n and /dev/rmt/1n) are connected to the LibMON server, you must enter either of the two valid device names for the two remaining tape drives. The completed Device Names section would show:

Tape Drive 0: /dev/rmt/0n
Tape Drive 1: /dev/rmt/1n
Tape Drive 2: /dev/rmt/0n (duplicate entry)
Tape Drive 3: /dev/rmt/0n (duplicate entry)

In this case, LibMON displays the contents of each drive on the Physical and Logical View Pages. However, the drive data displayed is that of the named physical drive.

To Select a Library

Before you can configure the display attributes of a library or access detailed information for a library, you must select it.



To Select the Library Page Layout

The Library Page Layout option is set to Large Icon View by default. To change this setting:

  1. Go to the LibMON Home Page.

    On the LibMON Home menu, click Properties.

  2. LibMON displays the LibMON Home Page Properties dialog box.

  3. Select a setting for the Library Page Layout option: Large Icon View or Table View.

    For a description of each of these settings, see Using the Library Management Area.

  4. Click OK to save your setting and return to the LibMON Home Page.

    To restore the previous option setting, click Reset. To return to the LibMON Home Page without saving the new setting, click Cancel.


Note - LibMON saves this setting as a user preference. Each time you log in to LibMON, it uses this setting.

To Set the Library Display Attributes

  1. On the LibMON Home Page, select a library.

  2. On the View menu, click Display.

    LibMON displays the Library Display Attributes dialog box.

  3. Select an attribute in the list, and then click the Add or Remove buttons to move it to or from the Show Attributes box.


Note - The attributes you select appear in the library management area when Table View is selected. If Large Icon View is selected, the library management area displays only the first attribute in the list.

Note - The Show Attributes box must contain at least one attribute.
    The following table describes the library display attributes that are available.

TABLE 2 Library Display Attributes
Attribute
Description
Library Name1
The name of the library, if defined. If the library name is not defined, the library is listed by the device name for the media changer (robot).
Serial Number
The serial number of the library.
Library Location1
The location of the library.
Product ID1
The unique Product ID for the library model.
Contact Name1
The name of the contact assigned to the library.
Contact Email
The email address for the contact.
Contact Phone
The phone number for the contact.
Contact Pager
The pager number for the contact.
1 These attributes are displayed by default.


  1. Click OK to save your changes and exit the Library Display Attributes dialog box.

    To restore the previously saved settings, click Reset. To exit the Library Display Attributes dialog box without saving any changes, click Cancel.


Note - LibMON saves these settings as user preferences. Each time you log in to LibMON, it uses these settings.

To Set the Library Sort Order

  1. On the LibMON Home Page, select a library.

  2. On the View menu, click Sort.

    LibMON displays the Library Sort Order dialog box.

  3. Select an attribute in the list, and then click the Add or Remove buttons to move it to or from the Sort Order box.

    The attributes in the Sort Order box are the sorting keys for the library management area when Table View is selected.


Note - The Sort Order box must contain at least one attribute.
    The following table describes the sort order attributes that are available.
TABLE 3 Library Sort Order Attributes
Attribute
Description
Library Name1
The name of the library, if defined. If the library name is not defined, the library is listed by the device name for the media changer (robot).
Library Location
The location of the library.
Contact Name
The name of the contact assigned to the library.
1 This attribute is the default primary key used for sorting.


  1. To move an attribute up or down in the Sort Order box, click the up or down arrow buttons.

    The placement of an attribute in the Sort Order box determines whether it is a primary, secondary, or tertiary sorting key.

  2. Select Ascending or Descending:



  3. Click OK to save your changes and exit the Library Sort Order dialog box.

    To restore the previously saved settings, click Reset. To exit the Library Sort Order dialog box without saving any changes, click Cancel.


Note - LibMON saves these settings as user preferences. Each time you log in to LibMON, it uses these settings.

To View Detailed Library Information

LibMON maintains a Library Property Book Page for each monitored library. This page contains all the information you entered when you created the library, and enables you to set thresholds for each library device (robot or tape drive).

To open the Library Property Book Page for a library:

  1. On the LibMON Home Page, select the library.

  2. On the Selected menu, click Properties.

    LibMON opens the Library Property Book Page for the selected library.

    The left side of the page, labeled Sections, provides hypertext links to the sections of the page.

  3. To navigate to a section, click its link:



    The following table provides a detailed description of each field on the Library Property Book Page.

TABLE 4 Library Property Book Page Field Descriptions
Section Name
Field/Option
Description
Configuration
Library Name
This field allows you to enter a name for the library. If no name is entered in this field, LibMON refers to the library by the device name for the medium changer (robot).
Serial Number
This field allows you to enter the library serial number. This number is located on the back panel of the tape library.
Library Location
This field allows you to enter the location of the library (for example, the room number).
Product ID
This field displays the unique Product ID for the tape library model. LibMON automatically sets this value as the result of a SCSI inquiry. You cannot change this value.
Product Revision
This field displays the firmware revision level. LibMON automatically sets this value as the result of a SCSI inquiry. You cannot change this value.
Automatic Cleaning
Initially, the value in this field is set by LibMON as the result of a SCSI mode sense. You can change this setting:
  • `On' enables the automatic drive cleaning feature.
  • `Off' disables the automatic drive cleaning feature.
This option is not available for all tape libraries.
Automatic Inventory
Initially, the value in this field is set by LibMON as the result of a SCSI mode sense. You can change this setting:
  • `On' enables the automatic inventory feature, causing the library to inventory all elements before going online.
  • `Off' disables the automatic inventory feature. When this feature is disabled, the library inventories itself only when the Init Element Status or Init Element Status with Range commands are issued.
This option is not available for all tape libraries.
Barcode Label
Checking
Initially, the value in this field is set by LibMON as the result of a SCSI mode sense. You can change this setting:
  • `On' enables the bar code label checking feature. When this feature is enabled, the library scans all the bar code labels when it performs an inventory prior to going online.
  • `Off' disables the bar code label checking feature. When this feature is disabled, the bar code labels are not scanned.
Note: The tape library performs bar code scanning only as part of its normal inventory process. If you change this option setting, the tapes in the library will not be re-scanned until an inventory occurs.
This option is not available for all tape libraries.
Drive Load Retry
Initially, the value in this field is set by LibMON as the result of a SCSI mode sense. You can change this setting:
  • `On' enables the drive load retry feature.
  • `Off' disables the drive load retry feature.
Note: We recommend you do not change this setting.
This option is not available for all tape libraries.
Device Names
Robot
This field displays the device name for the medium changer. You entered this value when you created the library.
Tape Drive x
These fields display the device names of the tape drives. You entered these values when you created the library.
Set Threshold
Clicking the Set Threshold button (to the right of each device name field) opens a Set Threshold dialog box for the device. For more information about setting thresholds, see To Set Up Threshold-Based Notification.
This option is not available in the Create Library Property Book dialog box.
Contact
Contact Name
This list box allows you to select the contact person for the library. This list is built from the contacts on the Contact List Page.
Phone
This field displays the phone number defined for the contact.
Email Addresses
This field displays the email addresses defined for the contact. If email notification is enabled and a library availability-based or threshold-based event occurs, email messages will be sent to each email address shown.
Actions--Library Available Actions
Email
Library Available Actions are triggered when the library becomes available.
This field (Email) allows you to enable or disable email notification of library available events.
  • `On' enables email notification.
  • `Off' disables email notification.
User-Defined
This field allows you to enable or disable user-defined notification of library available events.
  • `On' enables user-defined notification.
  • `Off' disables user-defined notification.
Action
This list box allows you to select the user-defined command that LibMON will execute when a library becomes available. See To Set Up Library Availability-Based Notification and To Create a Command Definition File.
Actions--Library Unavailable Actions
Email
Library Unavailable Actions are triggered when the library becomes unavailable.
This field (Email) allows you to enable or disable email notification of library unavailable events.
  • `On' enables email notification.
  • `Off' disables email notification.
User-Defined
This field allows you to enable or disable user-defined notification of library unavailable events.
  • `On' enables user-defined notification.
  • `Off' disables user-defined notification.
Action
This list box allows you to select the user-defined command that LibMON will execute when a library becomes unavailable. See To Set Up Library Availability-Based Notification and To Create a Command Definition File.
Service Module
Serial Port
This field displays the serial port used to issue service commands to the library. The default setting is /dev/ttya.


  1. If desired, make changes to the settings on this page.

  2. Click Apply to save your changes.


Note - If you move to another LibMON page without clicking Apply, any changes you have made will be lost.

    To return to the previously saved settings, click Reset.

To Delete a Library

  1. Select the library you wish to delete.

  2. On the Selected menu, click Delete.

    LibMON displays a dialog box, prompting you to confirm the deletion.

  3. To delete the library, click Yes.

    LibMON deletes the library from the library management area.