*************************************************************
HOWTO: Setting up WP7-Probes Coordination Protocol (PCP)
*************************************************************


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


The PCP control topology is based on a named ring that is traversed by a token. It solves scalability issues by creating a hierarchical structure of measurements.

The main principles of the protocol are as follows:

You are a clique member for the central monitoring machine. clique members have a position on the ring, and each member can receive the token or pass it on. 

The token definition contains the specification of the ring and the action that will be actived on receipt of the token by each site agent.


Software Requirements
*********************

Suitable Version: Redhat 7.x to SL3
edg-pcpd needs following dependencies:
        - perl5 package
        - wget package

        

Building/Installing/Configuring
*******************************

Date: 30 November 2004 
Build/Install/configure edg-pcpd from source on Linux

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

2) Unpack the tar ball
	# > tar zxf edg-pcpd-2.0.9.tar.gz

3) Enter the edg-pcpd-2.0.9 directory
	# > cd edg-pcpd-2.0.9

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

4) Build edg-pcpd
	# > make

5) Install edg-pcpd
	# > make install

6) Open to your firewall, the port number TCP 50500, in order to run pcpd

7) Start the edg-pcpd daemon


	To do so,

	Set the correct file permissions:
		# > chmod ug+x /opt/edg/sbin/edg-pcpd.pl
		# > chmod ug+x /etc/rc.d/init.d/edg-pcpd
	
	Then you can start the edg-pcpd daemon
		# > /etc/rc.d/init.d/edg-pcpd start

8) Get list of registered tokens on the node
		# > /opt/edg/bin/edg-pcpd-admin -L localhost