*****************************************************************
*                 RINGSYS WebMonitor 1.1.1                      *
*           Simple and reliable web site monitoring.            *
*                                                               *
* WebSiteWatchers Ltd                                           *
* http://www.websitewatchers.co.uk/                             *
*****************************************************************

IMPORTANT NOTE FOR ISPs:
========================

NEVER install WebMonitor on the same computer as your web server, since it may
interfere with the proper operation of your web server. For information, WebMonitor
uses for its internal purposes two TCP/IP ports, by default 1099 and 7070.
We recommend you to install WebMonitor on a separate computer with a connection
to your web server (proxies are supported as long as they let http go through).
USING WEBMONITOR ON THE SAME COMPUTER AS THE WEB SERVER CAN CAUSE CONFLICTS AND
MAKE YOUR NETWORK INSTABLE.

REQUIREMENTS
============

To monitor your web site, WebMonitor needs to be always running and it needs to have
a permanent internet connection to your web server.

In general, you get better monitoring when the monitor agent doesn't run on the 
same computer as the web server.


INSTALLATION INSTRUCTIONS 
=========================

- Uninstall any previous version of WebMonitor

- Execute wm111_install.exe (answer no for jre1.1.8 if you have java 1.1.8 or better 
already installed on your computer)

- In the Start menu, select Programs\Webmonitor1.1\WebMonitor
It should display the WebMonitor control window, and your browser should
display the wizard page the first time you run the application (the next time, 
you should see the management page showing the list of urls monitored).

- To configure easily your monitoring solution, press in the WebMonitor window
the Wizard button. Your browser should display the wizard page. Follow carefully
the instructions since they help to complete the installation of the WebMonitor.

- To see the latest status of your monitored sites and to configure the monitor with
more advanced options, press in the WebMonitor window the 'Management' button.
Your browser should display the management page. If it doesn't, go to 'Troubleshooting,
Managing the monitor' section bellow. 
Now you can navigate and change the monitoring configuration, note that your initial 
login is 'admin' and your password is 'admin' too.

This should be enough information. If you encounter further difficulties, see bellow...


TROUBLESHOOTING
================

1) Java Virtual Machine
-----------------------

If you are not sure about anything concerning Java, we recommend you 
to use the installer with Java VM and to tell the installer to install
Java on your system.

If you have already the Java Virtual Machine (JDK or JRE) installed 
on your machine (version 1.1.6 or better) then proceed to Step 2.
Note: the Microsoft virtual machine (jview) is not supported, but the latest
VM compatible with Sun specifications might work.

* How do I know if I have java on my system?

Open an MS DOS prompt
Type:
c:> java 
or type:
c:> jre
you should see a list of options.


* How do I know if my classpath is correct?

Type:
c:> java java.lang.System
or type:
c:> jre java.lang.System

You should see something like: public static void main(String args[]) is not defined
and you should not see: Class not found: java.lang.System

2) Install with wm111_install.exe
---------------------------------

If you don't have Java installed on your system, download the 
installer with Java VM.

3) Starting the WebMonitor
--------------------------

Use the shortcut in the Start Menu, Programs\Webmonitor1.1\WebMonitor
or go to the bin folder of your WebMonitor installation, and execute
WebMonitor.exe or WebMonitor.bat
A window should appear and your browser should display the wizard or the 
management page.
If the window doesn't appear, it means that the WebMonitor could not start.
You can see what goes wrong in the files WebMonitor1.1\log\out.log and
WebMonitor1.1\log\err.log

The most frequent problems are:
- Java is not properly installed
Download from www.websitewatchers.co.uk the installer for Windows with Java VM.
- Another WebMonitor is running
Only one web monitor can run on the same computer. 
If when you start the monitor the application shows the window but exit immediately,
check if you see WebMonitor in your task manager, or if you see 'Port already in use'
in out.log. If this is the case, then shutdown the other WebMonitor, or kill
the application from the task manager.
- The ports are used by other processes
If you have the message 'Port already in use' in your out.log file, then 
try to add the following properties at the end of bin\WebMonitor.ini with your
values (between 1001 and 59999):

rmiPort=1099
server.port=7070

Avoid the ports that are reported as being used by netstat.

4) Managing the monitor
-----------------------

* From the same computer
WebMonitor can be managed from a web browser only. While this enable you to 
administer the monitor from any computer with only a browser, troubleshooting
may not be easy. In the WebMonitor control window, press on the 'Management'
button. You should see in your browser the management page showing the list
of urls currently monitored and their status.
If your browser doesn't show anything, try to display the url 
http://localhost:7070/monitor/management 
If it still doesn't work, it means that the monitor is not running (check the
list of tasks in the Task Manager by pressing CTRL+ALT+DEL simultaneously,
you should see WebMonitor in the list of tasks).
If the monitor is running but the management page doesn't work, it means that
the internal web server has been disabled or couldn't start. 
Add at the end of bin\WebMonitor.ini the following line:
  useWebManagement=true
and restart the WebMonitor.

* From another computer

You should be able to access the management page by typing in a browser:
  http://<computer>:7070/monitor/management 
where <computer> is the dns name of the computer where the monitor is running.
You can know the name of the computer by typing:
c:>ping localhost


5) Custom installations
-----------------------

* Running the monitor as a servlet
WebMonitor is a Java application that usually starts an internal web server
for its management. If you have already a web server that supports servlets,
you can install WebMonitor as a servlet. Contact us for more information.

* Using a database for logging
WebMonitor can use a relational database for logging and for more advanced
reporting functionalities. Contact us for more information.
 

===========================================================================
SEND ANY FEEDBACK, BUG REPORT OR SUGGESTION TO:
webmonitor1@websitewatchers.co.uk

REPORT ALL BUGS TO:
http://www.bugtracker.com/enter_bug.cgi?product=Webmonitor1
(use a valid email address)

Thanks,
The Team.
