*************************************************************
HOWTO: Setting up WP7-edg-udpmon monitoring tool.
*************************************************************


Description
***********

The UDPMon measurement tool sends UDP packets to a target server at regular intervals.

The server can calculate achievable UDP throughput, packet loss, and inter-packet delay variation (jitter), and the results are returned to the client.

The UDPMon monitoring infrastructure has the same functionality as PingER: graphical and data display,PCP integration and the ability to push measurements into R-GMA.


Software Requirements
*********************
Suitable Version: Redhat 7.x to SL3
edg-pinger needs following dependencies:
        - perl5 package
        - wget package
        - tcsh package
        

Building/Installing/configuring
*******************************

Modify: 14 March 2005
Date: 30th November 2004 
Build/Install/configure edg-udpmon from source on Linux

1) Download edg-udpmon-1.3.3.tar.gz in your source directory
	# > cd /usr/local/src
	# > wget http://marianne.in2p3.fr/egee/network/download/edg-udpmon-1.3.3.tar.gz

2) Unpack the tar ball
	# > tar zxf edg-udpmon-1.3.3.tar.gz

3) Enter the edg-udpmon-1.3.3 directory
	# > cd edg-udpmon-1.3.3

4) Add -lm (LIB_MATH) to your environment
	# > export LDFLAGS="-lm"

5) Configure the makefile
	# > ./configure --prefix=/opt/edg 
	
	(/opt/edg will be the installation directory)

6) Build edg-udpmon
	# > make

7) Install edg-udpmon
	# > make install

8) Open to your firewall the port number UDP 14233

9) Send the name of your machine on which you're installing edg-udpmon to: sophie.nicoud@urec.cnrs.fr and wait for reply.

10) After confirmation, you'll be able to download the list of hostnames that your udpmon will monitor directly from the central monitoring server ccwp7.in2p3.fr
	# > /opt/edg/sbin/edg-udpmon-get_config_file.csh ccwp7.in2p3.fr

11) UDPMon SERVER SIDE: To run it as a daemon, download startup-edg-v1.2.tar.gz to install edg-udpmond and follow the instructions. 

*** UDPMon CLIENT SIDE will be run automatically by PCPD through /opt/edg/sbin/edg-udpmon-scripts.pl

12) For scheduling, you need to install the Probes Coordination Protocol (PCP)

13) To publish measurements into RGMA, install the glite-netmon2rgma.


Optionnal
**********

To visualize localy the edg-udpmon monitoring datas through your www server:

*/etc/httpd/conf/httpd must be configured:

	- DocumentRoot "/opt/edg/lib/"
	- Alias /udpmon "/opt/edg/lib/edg-udpmon/html"
	- AddHandler cgi-script .pl
	- ScriptAlias /udpmon-bin/ "/opt/edg/libexec/cgi-bin/edg-udpmon/"
		(to indicate edg-udpmon cgi-script's folder.)

* files living in the cgi-bin directory should be set with the correct file permissions