This section list common questions you may have while installing and using your LibMON software. Use this section as a guide to resolve problems encountered while operating LibMON.
I can't communicate with the tape drives.
First, verify power is applied to the tape library and the library is powered on. The LEDs on the front panel of each drive should be on also. See your drive product manual for a description of what the front panel LEDs indicate.
Most SCSI bus communication problems are due to cabling or termination problems. Verify that each of the connectors on all SCSI cables are fully engaged. Also check that all busses are properly terminated.
How do I determine the device names for my medium changer?
The medium changer is the robot for your tape library. When LibMON is installed, the LibMON passthru driver is loaded and a symbolic link to the medium changer passthru driver is created. When a single tape library is attached to the server, the medium changer device name is usually /dev/passthru0.
How do I determine the device names for my tape drives?
The server tape drive device files are created automatically when the server boots. The server uses the entry in /usr/kernel/st.conf to build the device files.
You must also verify that the st.conf file contains the proper entries for the tape drives. Refer to the Sun Enterprise Tape Library Installation Guide that came with your library for more information about the st.conf file. If you change the st.conf file, you must reboot the server for the changes to take effect. The Sun Enterprise Tape Library Installation Guide that came with your library describes the proper way to shutdown and reboot the server.
Use the SCAN-DEVICES utility (included on the LibMON distribution CD) to determine the medium changer and tape drive device names.
I can't determine the SCSI bus device addresses.
LibMON does not require that you enter the SCSI bus device addresses for a library. However, knowing the SCSI address for each tape drive may help you in identifying the correct device name to use for each library when multiple tape libraries are attached to a single server.
The default factory settings are as follows:
Device | SCSI ID |
Tape Library | 0 |
Top Tape Drive | 2 |
Second Tape Drive | 3 |
Third Tape Drive | 4 |
Bottom Tape Drive | 5 |
You can verify the settings from the front control panel of the Sun Enterprise Tape Library. Refer to the Sun Enterprise Tape Library Installation Guide that came with your library for more details. If you change the SCSI address of any device, you must cycle power to the library and reboot the server for the change to take effect. Refer to the Sun Enterprise Tape Library Installation Guide that came with your library for more details about the proper way to shutdown and reboot the server.
I received an error message ‘Device Name File: ‘/dev/passthru1’ does not exist’ when creating a library.
When the server boots, it automatically creates device files for all tape libraries attached to the server. The files are located in /dev. For example, if you have one tape library attached to the server, verify '/dev/passthru0' is present. The device name for a second library would be /dev/passthru1. Each tape library will have a separate device name.
You must reboot the server to create the device files if they don't exist. Refer to the Sun Enterprise Tape Library Installation Guide that came with your library for more information about the proper way to shutdown and reboot the server.
I can't log in to the system.
Your system administrator can provide you with a password. LibMON does not directly control the user passwords. Passwords are handled by the HTTP server. LibMON must run with an NCSA compatible HTTP server, such as the Apache server. If you are running another HTTP server, refer to the HTTP server documentation..
I can't modify the configuration.
There are two user types in LibMON: Guest and Admin. Guest users are prevented from creating, deleting, or modifying any of the LibMON settings. Admin users, usually system administrators, can create, delete or modify any LibMON setting. Contact your system administrator to modify the configuration or to receive Admin status.
I can't monitor my Exabyte tape library.
LibMON only works with Sun Enterprise DLT Tape Libraries. LibMON cannot monitor other library types, for example 8mm or DAT. LibMON will monitor ETL compatible DLT tape libraries such as the ATL Products ACL 4/52, but you must have at least one Sun Enterprise Tape Library attached to your server.
My client browser does not work.
Verify that you are using Netscape Navigator Version 3.0 or later by selecting the About Netscape option from the Help menu in the Netscape application. This is the only supported Web browser. For Solaris clients, make sure that the environment variable CLASSPATH is not set before starting Netscape. To unset this environment variable for UNIX, execute the following command from the shell where the Netscape application is started:
% unsetenv CLASSPATH
When running LibMON as a client from a Web browser, the following Netscape Network Preferences are suggested:
Memory Cache | 5 Mbytes |
Disk Cache | 5 Mbytes |
Verify Document | Every Time |
To change the Netscape Network Preferences, select the Network Preferences option from the Netscape Options menu. Select the tab labeled Cache.
Verify that the server machine, where the HTTP server and the LibMON server are installed, is network reachable from your machine. In UNIX, you can use the ping command to verify this. For example, to ping the machine named harvest, use the following command:
% ping harvest
If the machine is reachable, the ping command will reply with the output:
% harvest is alive
I am not receiving event notification for library events.
You will need to check two LibMON pages. First, from the LibMON Home Page, select the library of interest. Next, select the Properties option from the Selected Menu. The Library Property Book page opens. Verify that your name is listed as the Contact for the library. Verify also that the email notification button is set.
Next, verify your email address. To do this, select Contact List from the LibMON Home menu on the LibMON Home Page. This opens the Contact List Page. Next, select the contact of interest and select the Properties option from the Selected menu. Verify that the email address is correct.
What do I do when I receive an event notification?
First, logon to LibMON as a admin user. If the tape library is in an unavailable state (indicated by a red background for the tape library), there will be a red or yellow alert icon in the Event table in the LibMON Home page. Select the event and select the Properties option from the Selected menu in the LibMON Home Page. The Event Property Book Page is displayed. Follow the instructions in recovery message section to solve the problem.
The tape library in the Physical View of LibMON appears empty.
This can happen if you enter the Physical View when tape library data is not available. Check your event log to verify that the tape library is online and operating normally.
I am unable to select any option on a LibMON page.
If you are on the LibMON Home Page, verify that the correct Manager is selected for the operation you are selecting. For example, in order to select the Physical View button, you must first select the Libraries Manager by selecting the colored border labeled Libraries.
Verify that there is not a dialog hidden behind another window. LibMON dialogs are modal, so if a dialog is displayed, none of the operations in the parent window are selectable.
Verify that the LibMON databases have the correct ownership and read/write privileges. The LibMON installation places the LibMON databases in the /var/opt/SUNWlmon directory. The top level directories are named db and log. The root user must have read/write access to these databases. If the ownership was changed, it should be changed back to the root user for the server. To do this, use the following commands:
chown -R root /var/opt/SUNWlmon/db
chown -R root /var/opt/SUNWlmon/log
Events are not maintained in the LibMON Event Log between LibMON client sessions.
Verify that the LibMON databases have the correct ownership and read/write privileges. The default LibMON installation places the LibMON databases in the /var/opt/SUNWlmon directory. The top level directories are named db and log. The root user must have read/write access to these databases. If the ownership was changed, it should be changed back to the root user for the server. To do this, use the following commands:
chown -R root /var/opt/SUNWlmon/db
chown -R root /var/opt/SUNWlmon/log
The LibMON pkgadd command did not complete successfully.
If the following message was received during LibMON installation:
Adding ‘pt’ driver ...
drvconfig: System call ‘modctl_modconfig’ failed: No such device or address
Warning: Driver (pt) configuration failed. System could not install driver.
pkgadd: ERROR: postinstall script did not complete successfully
Verify that the tape library is attached to the server, powered on, and configured correctly according to your tape library installation guide. Then, use pkgrm to remove the LibMON package and re-install LibMON.
For other types of errors, take action based on the message that is output during the LibMON pkgadd process. Then, use pkgrm to remove the LibMON package and re-install LibMON. For whatever reason the LibMON pkgadd failed, always perform a pkgrm to remove the LibMON package and then re-install the package using the pkgadd facility once the problem has been fixed.
The LibMON server exits with the message Cannot open database /var/opt/SUNWlmon/db.
The LibMON server must be started by the root user. Verify that you are executing the START-LibMON script as the root user. Also, verify that the LibMON databases exist and are owned by the root user.
The LibMON server exits with the message Exception creating server socket: java.net.SocketException: Address already in use.
Verify that there is not already a LibMON server running. If there is no LibMON server running, the problem may be that another application is running at the default ports used by LibMON.
When I navigate to the LibMON Home Page, nothing is displayed on the screen.
If the network is very busy or the network connection is very slow, there may be a considerable delay before the LibMON Home Page is displayed.
The Apache HTTP Server exits with the message httpd: could not open transfer log file /opt/Apache/apache_1.1.3/logs/access_log. open: Permission denied.
The Apache HTTP Server is configured to be run by the root user. If you are running it as someone other than the root user, you need to make sure that all files are owned by you. Also, you will need to edit the httpd.conf file in the /opt/Apache/apache_1.1.3/conf directory and change the value of 'Port 80' to a number that is greater than 2000. In this case, you will need to indicate the port number that the HTTP server is listening in the URL. For example, if the value in httpd.conf is 'Port 3500' and the server name is 'harvest', use the following URL to open the LibMON home page with administrative privileges:
http://harvest:3500/LibMON/admin/LibMON.shtml