Installation of the GLTMon Network Monitoring Web Application
     =============================================================

This version of the GLTMon application contains only the parts of the
GLTMon application.

The GLTMon application contains two parts: a server and a Webapp. The
server part gathers data from network devices and stores the data into
the MySQL database. The Webapp part controls the population of the MySQL
database with network devices, generates reports on the gathered data, and
causes the stopping of the server. Each runs separately and require some
configuration to work properly.

NOTE: Java 1.4.2.09 or later must be installed on the computer where you
      plan to run both the GLTMon server and Web application. 

New Installation:
=================
  1) Download and unzip the GLTMon-apponly.zip file to the location you
     want GLTMon to reside. This file contains only the GLTMon application.

  2) Modify the shell scripts used to start the GLTMon server and Webapp.
  
     Change the GLTMON_HOME value in:
       GLTMon-apponly/bin/gltmonitor.sh
       GLTMon-apponly/bin/starttomcat.sh
       GLTMon-apponly/bin/stoptomcat.sh
     OR
       GLTMon-apponly/bin/gltmonitor.bat
       GLTMon-apponly/bin/starttomcat.bat
       GLTMon-apponly/bin/stoptomcat.bat
     to the location you unzipped the GLTMon-complete folder 
     (e.g., /usr/local/GLTMon-apponly).

  3) Install, configure, and test Tomcat 5.
  
  4) Download and install the commons-beanutils.jar into the
     $CATALINA_HOME/common/lib directory.
	 
  5) Download and install the mysql-connector-java-3.0.15-ga-bin.jar
     into the $CATALINA_HOME/common/lib directory.
  
  6) Install, configure, and test MySQL 4.0.20 or newer. Make sure you
     have included InnoDB in the installation.
  
  7) Create the GLTMon database in MySQL.
     
     The provided SQL file (database.sql) in the 'docs' directory creates
     a database titled "gltmon" and all the supporting tables. Do not
     change the name of any of the tables in the file or your database.

  8) Create the GLTMon database user and grant privileges to the GLTMon
     database.
     
     The provided SQL file (db-user.sql) in the 'docs' directory creates
     a user named "gltmon" with a password of "gltmon" with limited
     access to the "gltmon" database from any host (%). Change the name,
     password, and host to meet your security requirements. Any changes 
     require modifications in two other files (GLTMonDB.xml and 
     conf/gltmon.conf).

  9) With the Tomcat server stopped, copy the contents of the GLTMonDB.xml
     file (in the 'docs' directory) into Tomcat's server.xml file.
     Place the contents before the '</Host>' tag for the "localhost"
     Host settings. This establishes the JNDI database context for the
     GLTMon Webapp.
     
     You may make a number of changes to this context in your server.xml
     file to match your security needs.
     1) Change the Context path setting if you will place the GLTMon
        Webapp somewhere besides the default of "/gltmon" (e.g., 
        /networktools/gltmon).
        
     2) The Logger defaults to "localhost_gltmon_log.<date>.txt" in
        the tomcat 'logs' directory. Optionally change this to match
        your log name standards.
     
     3) Change the "username" and "password" parameters to match any
        changes made while creating the MySQL database user.
        
     4) Change the "url" parameter to match the location of your MySQL
        database server and the name of the database (if changed during
        creation).

 10) Copy the GLTMon 'webapp' contents into a Tomcat directory (default
     location of $CATALINA_HOME/webapps/gltmon). If you specified a
     different location in the above Context, place the GLTMon Webapp
     into that location.

 11) Fire up your MySQL server (if not already done) and your Tomcat
     server. Point your browser at http://localhost:8080/gltmon/ to
     see the home page of the GLTMon Webapp.

 12) Start your GLTMon Webapp by running the startup command in the bin
     folder:
     $GLTMON_HOME/bin/webstart.sh (UNIX/Linux/MacOS)
     $GLTMON_HOME/bin/webstart.bat (Windows)
     Point your browser at http://localhost:8080/gltmon/ to see the home 
     page of the GLTMon Webapp.

     To stop the GLTMon Webapp, use the following command:
     $GLTMON_HOME/bin/webstop.sh (UNIX/Linux/MacOS)
     $GLTMON_HOME/bin/webstop.bat (Windows)
     

Existing Installation:
======================
  1) Copy the GLTMon 'webapp' contents into your existing Tomcat directory.


Configuring and Running the GLTMonitor Server:
==================================
  The GLTMonitor server resides within the GLTMon Webapp class files.
  However, the files to run the server reside in the 'bin' and 'conf'
  directories of the distribution.
  
  To configure and run the GLTMonitor server:
  1) Modify the $GLTMON_HOME/conf/gltmon.conf file to set your GLTMon server
     settings. Specifically, set the server name for the MySQL server.

  2) Start the server by running the gltmonitor command.
     $GLTMON_HOME/bin/gltmonitor.sh (UNIX/Linux/MacOS)
     $GLTMON_HOME/bin/gltmonitor.bat (Windows)
  
  3) To stop the server, use the Server option in the Webapp.