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

This version of the GLTMon application contains everything, excluding
the MySQL database server, to load and run 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 (via Tomcat). 

New Installation:
=================
  1) Download and unzip the GLTMon-complete.zip file to the location you
     want GLTMon to reside. This file contains everything, excluding the
     database server, needed for the GLTMon application.

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

  3) Install, configure, and test MySQL 4.0.20 or newer. Make sure you
     have included InnoDB in the installation.
  
  4) 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.

  5) 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 to the conf/gltmon.conf file.

  6) Change the GLTMon-complete/jakarta-tomcat-5.0.28/conf/server.xml file
     to match your MySQL settings.
     
     1) Change the "username" and "password" parameters to match any
        changes made while creating the MySQL database user.
        
     2) Change the "url" parameter to match the location of your MySQL
        database server and the name of the database (if changed during
        creation).

  7) Fire up your MySQL server, if not already done.
  
  8) 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)
     

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.


Existing Installation:
======================
  1) Before replacing your existing installation, save the Tomcat server conf
     file:
     $GLTMON_HOME/jakarta-tomcat-5.0.28/conf/server.xml

  2) Unzip the GLTMon-complete.zip file where you want the GLTMon application
     to reside.

  3) Replace the Tomcat server.xml file with the one you saved.

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

  4) See step 8 of the "New Installation" steps and "Configuring and Running
     the GLTMonitor Server" section.