E2EMon MP
From GEANT2-JRA1 Wiki
Contents |
E2Emon Measurement Point
Responsible: DFN Munich. Matthias Hamm (hamm@dfn.de), Mark Yampolskiy (myy@dfn.de)
Introduction
This MP can be used to provide abstracted monitoring data to the E2E Monitoring System.
More information about E2Emon: [1]
Software Download
21 August 2007 - Version 1.1 - released
* G2_E2Emon_MP_1.1.tar.gz (1.1 MB)
Changelog to 1.1:
- MP is automatically started after installation (deploy.pl)
- test.pl can be used to test communication with MP
10 August 2007 - Version 1.1 - Release Candidate 4:
* G2_E2Emon_MP_1-1RC4.tar.gz (1 MB)
Changelog to 1.1 RC4:
- The service no longer responds with a SOAP fault:
- When the type attribute of the message is missing;
- When there is no id attribute in metadata;
- When the eventType element is empty;
- When the metadataIdRef attribute in the data element is missing;
Older versions:
26 July 2007 - Version 1.1 - Release Candidate 3:
* E2Emon_MP1-1RC3.tar.gz (1 MB)
Changelog to 1.1 RC3:
- Added check for MetadataId and MetadataIdRef;
- Added check to see if a data element actually exists;
19 July 2007 - Version 1.1 - Release Candidate 2:
* E2Emon_MP1-1RC2.tar.gz (1 MB)
Changelog to 1.1 RC2:
- The MP now produces perfSONAR error results;
03 July 2007 - Version 1.1 - Release Candidate 1:
* E2Emon_MP1-1RC1.tar.gz (1 MB)
Changelog to 1.1 RC1:
- Documentation updated;
- Installation scripts corrected;
- Doc.Literal Style supported;
- 25 Jan 2007 - Version 1.0 - Release Candidate 1:
* E2EMON_MP_1.0-RC1.tar.gz (1 MB)
In the test directory you can find example XML files to setup a test version of the MP.
How to install and run a E2Emon MP
- Automatic Installation:
Please run the installation scripts in the following sequence:
1. pre-install.pl: installs prerequisites as far as possible 2. configure.pl: prepares installation 3. deploy.pl: installs software
- Manual Installation:
If the automatic installation doesn`t work for you, the MP can be installed manually as follows:
1. Ensure that all prerequisites are met on your system 2. Copy directory G2_E2E_MP to it's target position in your server's file syste 3. Edit the start script according to your needs (see section Configuration)
Configuration
- This step is usually done during automatic installation. Please follow the instructions below if you want to change the configuration or edit it manually.
- According to your platform, choose a start script (bin/start_2e2_mp_daemon.bat or bin/start_2e2_mp_daemon.bat) in the bin directory. Please edit the following parameters:
perl -I"../src" "../src/G2_E2E_ServerDaemon.pl" -h HOST -p PORT -r XML-Registry-File
-I : If your Perl packages are installed not in the standard path, please add links to the packages
-h HOST : Hostname of MP/MA
-p PORT : Port of MP/MA. This port will be used for communication (please configure your firewall
correspondingly). Recommended Values: 8081-8089
-r XML-Registry-File : location of XML registry file. This file contains the up-to-date monitoring information.
It is delivered to the E2E Monitoring System via the E2E MP
Start
- Start E2E MP via the start script
bin/start_2e2_mp_daemon
- The MP does not daemonize itself. Please ensure that the MP is run a daemon (e.g. start at system startup)
Deinstallation
If you would ever want to get rid of the E2Emon MP - though quite unlikey - you should:
1. Ensure that the MP is not running any more
2. Start the script ./undeploy.pl. Warning: This script delete all files under the path you have installed the E2Emon MP.
As an alternative, you can delete the files manually.
Known Errors
- During operation of the MP, the following message can be displayed if a SOAP request is received:
"Use of uninitialized value in string eq at C:/Programme/Perl/site/lib/SOAP/Transport/HTTP.pm line 314". This message is due to an error in one of the SOAP libraries and can safely be ignored.
- Users report very seldom that the MP stops working after some days/months of operation. Please report this to the authors.
