PerfSONAR Service Installation And Usage:FAQ
From GEANT2-JRA1 Wiki
Contents |
Service Installation and Usage: FAQ
The following section provides answers for frequently asked questions about perfSONAR service installation process and usage. This section is most effective due to contributions. If you think you have encountered (and maybe solved) some situation while installing any of perfSONAR services, please help us by adding your solution.
The FAQs are categorized based on problem domains
Installation failures
Q: Axis Validation page shows missing 'Needed components'
A: Check if tomcat and axis directory values are correct in const.properties
Installation Mistakes
Q: I called on ant to deploy NMS MP for the wrong tomcat directory
A: Correct tomcat directory and axis directory in const.properties - Call on ant to deploy NMS MP again - Restart tomcat
Q: I called on ant to build the service but I had downloaded binaries
A: You do not need to build the binaries - Ant deletes the build files before trying to build a new service. Because of this important files go missing - Please start the installation process as new (with a new download if needed)
Q: The installation commands provided in the installation document do not work
A: The installation commands given above are for unix only. Also please use only the text after the '>' symbol in the commands. - If you are still facing problems, please contact the support personnel
Deployment Problems
Unable to deploy a service
Q: Ant says that its not able to find WSDD files (Example Message: Exception: ../build/org/perfsonar/service/web/wsdd/mp-service-deploy.wsdd (No such file or directory))
A:- If you have downloaded binaries, you might have accidentally asked ant to build, which deleted these files -- See Installation Mistakes section above for more info. You will have to start with a fresh installation. - If you downloaded sources, check in $PERFSONAR/build/org/perfsonar/service/web/wsdd directory to see if there are any files. -- If there are no files, please start with a fresh installation. If problem persists, please contact support
Problems while testing
Q: Service test fails locally
A: There are three error information points -- The response when you run $PERFSONAR/ant> ant test-nms-service -- The perfSONAR log files which are available in $PERFSONAR/log directory -- The tomcat log files which are available in $PERFSONAR_TOMCAT/logs/catalina.out directory
- Match the information from the above three against the ones listed here.
- If no match found, please provide the following information to the support personnel -- Error messages from above three sources -- request message -- the config file
Problems during normal operation
Q: Service fails to return a error-free response
A: Have you tested the service locally? - You can use the example config file and example requests - Or you can use your own config file and your own requests based on the examples given and as described in test section in step 7.1
Q: Clients are not able to get a correct response from the service
A: More information for this section will soon be made available
Q: I changed some entries in service.properties but these changes are not seen by the service
A: Please restart TOMCAT and test. For efficiency purposes the service reads the values from the files only once. Restarting tomcat will make it read them again.
