PerfSONAR v1.0
From GEANT2-JRA1 Wiki
Contents |
Introduction
This is the first production release of perfSONAR.
Included Functionality
Included in this release is:
- Java RRD MA
- Java LS (single domain only)
Pre-Installation Tasks
A working copy of Java, Tomcat/Axis, eXist, and rrdtool is expected. The appropriate settings (path changes, permissions) is also expected. The installation CLASSPATH settings will not cause problems for the axis deployer or client tests; a working CLASSPATH will be provided. The installation scripts will construct a path to do most tasks, but the changes STILL must be made. Please see the [README] in the distribution for more information. The most common problems the release team has seen while testing the installation is improperly configured LD_LIBRARY_PATH and CLASSPATH environmental variables.
Tomcat/Axis/eXist must be running in the background as the installers to aide in the deployment process.
Downloading
- v1.0 Installation jar
- This is a graphical installer, X access is needed (through the console or by ssh -X).
- To install, run 'java -jar PerfSONAR-1.0.jar'
- v1.0 Installation Archive
- This is a text based installer, X access is NOT needed.
- To install, unpack in the location you wish to install (/usr/local/ for example).
- Change into the unpacked directory and run './install.pl' or 'perl install.pl'
Testing
Once installed, the services may be tested via the client test scripts found in the 'scripts' directory of the installation (test-ls.sh or test-ma.sh). These script will run a number of tests using XML request files from the 'xml' directory.
The actual java client is located in the package 'org.perfsonar.client.testHarness.SOAPClient' which is in the 'perfSONAR-generic.jar' file that is placed in your axis home directory. As long as this ends up in your CLASSPATH, it should be possible to use the client application:
java org.perfsonar.client.testHarness.SOAPClient URL INFILE.xml OUTFILE.xml
An additional client written in perl is available in the 'contrib' package (as well as [here]) which can be optionally installed. To invoke this client:
$PERFSONAR/contrib/client/./client.pl URL INFILE.XML
Extra Installation Notes
Please read the README (the README is also packaged in the release) before installing to be sure all pre-installation tasks are taken care of. At this time there are no extra notes needed. In the event of problems occurring in between minor releases, extra instructions will appear here.
Graphical Installer
- A headless install (via telnet or SSH) is only possible if the machine in question has access to common X Windows libraries. If for some reason you are having trouble, please switch to the command line installer.
Text Installer
- Please read all prompts before answering, there is not a way to go 'back'.
- After the installation adjust any ENV variables being sure to logout/source the results. You will ALSO need to do this for all supporting windows you may be using (running tomcat, etc.).
Common Issues
- Note the LS and the MA cannot share a tomcat installation.
- Make sure permissions are adjusted as you install, or unknown errors may occur.
- Remember your usernames/passwords for eXist.
- Be sure your hostname used in the installation process matches what is in the '/etc/hosts' file. If there is not a match, axis/tomcat will give you an '(401)Unauthorized' when tyring to deploy the service. If this is the case, the installation is still a success, but it will ne necessary to run the manual deploy scripts to launch the service.
- The CLASSPATH is a sensitive environmental variable. Be sure all required jars as well as the current directory ('.') are included in it or any java based application (tomcat, axis, perfSONAR) will fail to work properly.
Filing Bugs
If you encounter problems with either the installation procedure, or the components of perfSONAR itself we need your help! Please file a bug with us so we can make our product better:
Upon loading the page there are only a few options are necessary to get the bug reporting process going.
- Select a version
- At this point we are in version 1.0 of the perfSONAR release, in the future there will be more choices here.
- Select a component
- There are two component choices, one for the graphical installer (.jar) and one for the textual installer (.tar.gz)
- After selecting a component the appropriate contacts will be filled in automatically
- Please fill in a Summary
- Please fill in a Description
- Attach any files (if relevant)
For more hints on bug reporting you can consult the Bugzilla details article.
