From GEANT2-JRA1 Wiki
0. PREREQUISITES
--------------------------------------------------------------------------------------
a) JAVA 1.5 or higher
b) RRDTool (Ubuntu/Debian users will need devel package of RRDTool as well - librrd2-dev)
1. INSTALL THE SERVICE
--------------------------------------------------------------------------------------
a) Set up JAVA_HOME environment variable - home of Java installation.
example:
export JAVA_HOME=/usr/share/jdk1.5.0_11
b) unpack the service
tar xvfz geant2_java-rrd-ma-[version]-extra.tar.gz
(the directory, called $PERFSONAR-EXTRA in this doc file, will be created)
... and set up execute right on $PERFSONAR-EXTRA/bin/perfsonar-rrdma.sh file
chmod u+x perfsonar-rrdma.sh
c) Run the script $PERFSONAR-EXTRA/bin/perfsonar-rrdma.sh with the parameter 'install'
perfsonar-rrdma.sh install
The script will ask few questions about:
- service port
- OS type
- the directory path of rrd.h
- the directory path of RRDTool libraries
- accepting new measurement data and storing them in rrd files
- LS register functionality
- service description
- contact e-mail
- organization name
(dafault answers are put in square brackets)
2. RUN THE SERVICE
--------------------------------------------------------------------------------------
Run the script $PERFSONAR-EXTRA/bin/perfsonar-rrdma.sh with the parameter 'start'
perfsonar-rrdma.sh start
3. TEST THE SERVICE
--------------------------------------------------------------------------------------
Run the script $PERFSONAR-EXTRA/bin/perfsonar-rrdma.sh with the parameter 'test'
perfsonar-rrdma.sh test
This sends two simple requests to the service in order to check if it is running
(analyze requests and their responses).
(this test does not require presence of metadata configuration in the service)
4. STOP THE SERVICE
--------------------------------------------------------------------------------------
Run the script $PERFSONAR-EXTRA/bin/perfsonar-rrdma.sh with the parameter 'stop'
perfsonar-rrdma.sh stop
5. UNINSTALL THE SERVICE
--------------------------------------------------------------------------------------
Run the script $PERFSONAR-EXTRA/bin/perfsonar-rrdma.sh with the parameter 'uninstall'
perfsonar-rrdma.sh uninstall
(before this action stop the service if it is running)
6. UPLOAD METADATA CONFIGURATION FILE
--------------------------------------------------------------------------------------
a) To upload the metadata configuration file first the service must be running. Use
your web browser to access admin page http://localhost:[port]/exist and select
Admin entry (left sidebar).
b) Provide default user name and password
username: rrdmaservice
password: rrdmaservice
c) Select 'Browse Collections' from the left sidebar and click the existing collection 'rrdmaconfig'
(you should see the message 'Browsing Collection: /db/rrdmaconfig')
d) Use 'Upload' and 'Browse...' buttons to upload the metadata configuration file.
If you don't have your own you may use the test one $PERFSONAR-EXTRA/conf/rrd-database_TEST.xml.
This test file makes use of test rrd file just to present how the service works.
e) Log out the admin page (!)
7. TEST THE SERVICE WITH TEST METADATA CONFIGURATION FILE
--------------------------------------------------------------------------------------
To query the service based on test metadata configuration file (rrd-database_TEST.xm)
run the script $PERFSONAR-EXTRA/bin/perfsonar-rrdma.sh with the parameter 'test-metadata'
perfsonar-rrdma.sh test-metadata
This sends a set of requests and the service responds with data fetched from
the metadata configuration and test rrd file.
8. SECURITY NOTES
--------------------------------------------------------------------------------------
When you have finished the installation and tests it is recommended to change
the passwords of two eXist database users:
a) rrdmaservice
Dafault password for this user is 'rrdmaservice'. Change it using admin web page
http://localhost:[port]/exist and 'Manage Users' menu item.
After the change update one property 'component.ma.xmldb.db_password' in the configuration file
$PERFSONAR-EXTRA/server/jetty-6.1.3/webapps/geant2_java-rrd-ma/WEB-INF/classes/perfsonar/conf/service.properties
and restart (stop, start) the service.
b) admin
This user has no default password so you have to provide it the way described above)
