====================================
Webserver Monitor Installation Guide
====================================

The Webserver Monitor software package consists of two separate components:
* the Logfeeder service (available for Windows and Linux/i386 servers)
* the Webserver Monitor client

This ZIP archive contains all software that you need to set up a reliable monitoring
system for your webservers. For each component a separate installer is provided.

This installation guide shows you how to get started with Webserver Monitor in two simple steps:
Step 1: Install and configure the Logfeeder service on each webserver you want monitor
Step 2: Install and configure the Webserver Monitor client on a Windows PC 

======================================================================================
Step 1: Install and configure the Logfeeder service on each webserver you want monitor
======================================================================================

The Logfeeder service is available for Windows and Linux/i386 web servers.
You can collect logfile data from any number of webservers and view them all
with a single Webserver Monitor instance.

Step 1a: Installing Logfeeder on a Windows server
-------------------------------------------------

- Double-click the Logfeeder.exe setup program contained in this ZIP archive.
  This will launch the Logfeeder Setup Wizard.

- After completing the setup, the Logfeeder Admin Wizard will be started automatically. 
  It guides you through the Logfeeder configuration.

Step 1b: Installing Logfeeder on a Linux server
-----------------------------------------------

- Get the logfeeder.tar.gz archive contained in this ZIP archive and unpack it into a directory 
  of your choice on the Linux server.

- LogFeeder by default binds to the port 9080 of all network interfaces. You can override the 
  default setting by editing the logfeeder.cf configuration file.

  IMPORTANT: Logfeeder needs access to your web server's logfiles. One way
  to achieve this is to run it with root privileges.

- Edit the first lines of the "logfeeder" script to reflect your installation path.
  Copy this to /etc/init.d, and use the debian update-rc.d command to make logfeeder start/stop automatically on system boot.

- The sample configuration in Logfeeder.cf configures Logfeeder to monitor all "*.log" files
  in the "/var/log/apache" subtree:

  DocumentRoot="/var/log/apache"
  SearchPattern="*.log"

  If your logfiles are stored elsewhere, please edit logfeeder.cf to reflect your setup. When in doubt, check Apache's config file (usually in /etc/httpd.conf).

- Start Logfeeder by typing "./logfeeder start".

==========================================================================
Step 2: Install and configure the Webserver Monitor client on a Windows PC
==========================================================================

- Double-click the webservermonitor.exe setup program contained in this ZIP archive.
  This will launch the Webserver Monitor Setup Wizard.

================
Start Monitoring
================

- Launch the Webserver Monitor client and add a logfeed by choosing "Add" from the "Logfeeds" menu.
  The view on the right side of the main window will be replaced with the "Add Logfeed" dialog.

- Enter the Logfeeder server's IP address (or hostname), the listening port of the Logfeeder agent
  (default is 9080) and the Logfeeder password (leave this as it is if you did not change the 
  Logfeeder password during setup). 
  These settings must be the same values you used in the Logfeeder agent setup.

- To continue, press the "Show Logfiles" button. This will display all log files available from this 
  Logfeeder agent in the window below. You can now choose one of the log files for monitoring, and 
  press "Start Monitoring". After this, Webserver Monitor will immediately begin to collect and 
  display data of this logfeed.

The "Session View" should now start to fill up with data of the currently active sessions.
If this is not the case, please check the following:

1. Launch your browser and direct it to the website that you are monitoring.
   Remember to do a "Refresh" in your browser and to clear browser caches if necessary
   to make sure that the webserver actually gets a request.
   
2. You can test the connectivity by opening a DOS prompt on the Windows PC you installed 
   Webserver Monitor on and typing:

   telnet <Logfeeder-Host> <Logfeeder-Port>

   Remember to replace <Logfeeder-Host> with the IP address of the webserver you want to monitor.
   The default port is 9080.
   If the connection can not be established, please check if
   - the firewall on your webserver allows incoming connections on port 9080
   - the firewall on your client PC allows outgoing connections to port 9080 of your webserver
   - the Logfeeder service is running (using e.g. "ps ax" on Linux, or the services manager on Windows)
   - if you changed the default password, make sure you use the same password in both the Logfeeder service and the Webserver Monitor client.

3. If all fails, please send an email to the Webserver Monitor support team (webmon@byteplant.com).
