Customizing LibMON

After installing LibMON, you can configure it to meet your site needs. This section describes the options you can customize.

Before performing any of the operations in this section, log in as root.

local% su root
Password: root-password
#

To Change the LibMON Poll Interval

The default poll interval is 5 minutes. The poll interval sets:

You can change the poll interval by using a command line argument when you start LibMON.


Note - If you set the poll interval to less than 15 seconds for a single tape library attached to the server, it is likely that one poll cycle will not complete fully before another one is scheduled to begin. Poll intervals of less than 5 minutes are not recommended.
  1. Log in as root.

  2. If the LibMON server is running, stop it.

    # /opt/SUNWlmon/STOP-LibMON


  3. Open the LibMON startup script (START-LibMON).

  4. Edit the following line in the LibMON startup script:

    ${NOHUP} {TOP}/JRE/bin/jre ${OPT_NATIVE_THREADS} \
    -D"atl.serverInstallDir=${TOP}" \
    atl.server.Server > ${TOP}/LibMON.log 2>&1 &



    to read as follows:

    ${NOHUP} {TOP}/JRE/bin/jre ${OPT_NATIVE_THREADS} \
    -Datl.service.lib.pollInterval="
    newpoll" \
    -D"atl.serverInstallDir=${TOP}" \
    atl.server.Server > ${TOP}LibMON.log 2>&1 &



    where newpoll is the desired poll interval (in milliseconds). For example, to change the poll interval to 300 seconds (5 minutes), enter 300000.


Note - The value for the poll interval is specified in milliseconds, and must be enclosed in quotation marks.
  1. Start the LibMON server.

    # /opt/SUNWlmon/START-LibMON


To Change the LibMON Port Assignment

The server accepts requests and sends data to clients using port 7467. If there is a conflict because some other software product is using this port, you can change this port value.

  1. Log in as root.

  2. If the LibMON server is running, stop it.

    # /opt/SUNWlmon/STOP-LibMON


  3. Stop the HTTP server.

    # /opt/Apache/apache_1.2.5/STOP-Apache


  4. Open the request port cgi file.

    The path for the request port cgi file is as follows:

    /opt/Apache/apache_1.2.5/htdocs/LibMON/atl-cgi-bin/getrequestport


  5. In the request port cgi file, replace the number 7467 with the desired port value (for example, 8000).

  6. Open the LibMON startup script (START-LibMON).

  7. Edit the following line in the LibMON startup script:

    ${NOHUP} {TOP}/JRE/bin/jre ${OPT_NATIVE_THREADS} \
    -D"atl.serverInstallDir=${TOP}" \
    atl.server.Server > ${TOP}/LibMON.log 2>&1 &



    to read as follows:

    ${NOHUP} {TOP}/JRE/bin/jre ${OPT_NATIVE_THREADS} \
    -D"atl.serverInstallDir=${TOP}" \
    -D"atl.comm.server.requestPort=
    portvalue" \
    atl.server.Server > ${TOP}/LibMON.log 2>&1 &



    where portvalue is the desired port value.

  8. Restart the HTTP server software and LibMON.

    # /opt/Apache/apache_1.2.5/START-Apache
    # /opt/SUNWlmon/START-LibMON


To Change the Database and Log Directories

The server maintains an event log and a database that maintains libraries and contacts. By default, these are located in the following directories:



To place the database and event log files in another directory:

  1. Log in as root.

  2. If the LibMON server is running, stop it.

    # /opt/SUNWlmon/STOP-LibMON


  3. Create two new directories and set the correct permissions.

    mkdir -p db_directoryname
    mkdir -p log_directoryname
    chmod -R 775 db_directoryname
    chmod -R 775 log_directoryname


    where:



  4. Open the LibMON startup script (START-LibMON).

  5. Edit the following line in the LibMON startup script:

    ${NOHUP} {TOP}/JRE/bin/jre ${OPT_NATIVE_THREADS} \
    -D"atl.serverInstallDir=${TOP}" \
    atl.server.Server > ${TOP}/LibMON.log 2>&1 &



    to read as follows:

    ${NOHUP} {TOP}/JRE/bin/jre ${OPT_NATIVE_THREADS} \
    -D"atl.serverInstallDir=${TOP}" \
    -D"atl.db.dbDir=
    db_directoryname" \
    -D"atl.eventLogDir=
    log_directoryname" \
    atl.server.Server > ${TOP}/LibMON.log 2>&1 &


    where:



  6. Start the LibMON server.

    # /opt/SUNWlmon/START-LibMON