FAQ

From GEANT2-JRA1 Wiki

Contents


General


  • Where can I submit a bug ?
    • A mailing-list was created for user support. Read this page for more information.


perfSONAR Dependency Software


Axis (Apache Axis)

  • Which version of Axis should I use (as basis for the perfSONAR services)?
    • Authored by: Valentin Rosic
    • The one recommended in official howto (1.2.1).
    • NOTE: From perfSONAR-bundle 2.0 onwards, you do not need to install axis separately at all.


  • How do I install Axis on my workstation?
    • Authored by: Valentin Rosic
    • NOTE: From perfSONAR-bundle 2.0 onwards, you do not need to install axis separately at all.
    • Follow the steps below as root
     x@y:/$ cd /usr/local
     x@y:/usr/local/$ wget http://archive.apache.org/dist/ws/axis/1_2_1/axis-bin-1_2_1.tar.gz
     x@y:/usr/local/$ tar -zxf axis-bin-1_2_1.tar.gz
     x@y:/usr/local/$ mv axis-bin-1_2_1 axis

Now, got to tomcat/webapps directory and make logical link to axis

     x@y:/usr/local/$ cd /usr/local/tomcat/webapps
     x@y:/usr/local/tomcat/webapps/$ ln -s ../../axis/webapps/axis axis

To get axis work, restart tomcat

     x@y:/usr/local/tomcat/webapps/$ cd /etc/init.d
     x@y:/etc/init.d/ ./tomcat restart

And check if axis is working by opening this page in your web browser

     http://localhost:8080/axis/happyaxis.jsp

Make sure you define systempaths by editing /etc/profile

     x@y:/etc/init.d/$ pico /etc/profile

Put all .jar's at the end of the file (you can find them in directory /usr/local/tomcat/webapps/axis/WEB-INF/lib)

     export AXIS_LIB=/usr/local/tomcat/webapps/axis/WEB-INF/lib
     export AXISCLASSPATH=$AXIS_LIB/axis-ant.jar
     export AXISCLASSPATH=$AXIS_LIB/axis.jar
     export AXISCLASSPATH=$AXIS_LIB/commons-discovery-0.2.jar
     export AXISCLASSPATH=$AXIS_LIB/commons-logging-1.0.4.jar
     export AXISCLASSPATH=$AXIS_LIB/jaxrpc.jar
     export AXISCLASSPATH=$AXIS_LIB/log4j-1.2.8.jar
     export AXISCLASSPATH=$AXIS_LIB/saaj.jar
     export AXISCLASSPATH=$AXIS_LIB/wsdl4j-1.5.1.jar
     .
     .
     .
     export CLASSPATH=$CLASSPATH:$AXISCLASSPATH

And do this

     x@y:/etc/init.d/$ source /etc/profile


eXist (eXist XML database)

  • Which version of eXist XML DB should I use?
  • How can I install eXist XML DB?
    • Authored by: Valentin Rosic

Make sure you have java installed, download and run .jar file (do all as root). Install it under /usr/local/eXist

     x@y:/home/user/$ wget http://superb-east.dl.sourceforge.net/sourceforge/exist/eXist-snapshot-20060316.jar
     x@y:/home/user/$ java -jar eXist-snapshot-20060316.jar

Since exist, by default, also uses port 8080 (like Tomcat), edit and change its configuration file

     x@y:/usr/local/$ pico /usr/local/eXist/bin/startup.sh

Find this part

     OPTIONS="-Dexist.home=$EXIST_HOME"

And change it to

     OPTIONS="-Dexist.home=$EXIST_HOME -Djetty.port=8680"

Also, find this part (somewhere near end of the file)

     -jar "$EXIST_HOME/start.jar" jetty $*

And change it to

     -jar "$EXIST_HOME/start.jar" jetty $* &

Now, define system paths

     x@y:/usr/local/$ pico /etc/profile

And add this to end of file

     export EXIST_HOME=/usr/local/eXist
     export PATH=$EXIST_HOME/bin:$PATH

Start exist with

     x@y:/usr/local/$ /usr/local/eXist/bin/./startup.sh


  • How can I install eXist XML DB as a stand-alone application?
  • How can I use a manually downloaded eXist XML database (exist-x.war) during the installation of a service?
    • Authored by: Loukik
    • Please make sure that you have manually downloaded the eXist xml database 'war' file on to the workstation where you are installing the service. Please make sure that you know the complete path/location of this exist war file.
    • In case of the eXist war (Web ARchive) file, during the pre-install step, the installer asks you if you want it to download eXist XML database war file. Choose 'n' at this stage. The installer then asks for the name of the file. Please provide the name of the war file that has been downloaded into your workstation. The installer then asks for the location (folder name) of the war file. Please provide the full path where the file is located. You don't need to include the filename in this full path. For example, if your war file has the name exist-1.0.1.war and has been downloaded into the directory /home/perfsonar/download/, please enter the full path as '/home/perfsonar/download/'
    • In case you decided not to go with the war option (i.e. you said no to the option of Installing/configuring the database as a web application in tomcat), you will not be asked for the location of the war file but instead you will be asked for the URL where eXist database is listening. At this stage please supply the URL where eXist database is available (this is for advanced users).


  • How can I install eXist XML DB as a Tomcat servlet?
  • How can I add or remove users in eXist?
    • Authored by: Valentin Rosic

Open Console and run (as root)

     x@y:/usr/local/$ /usr/local/eXist/bin/./client.sh

Make sure you've entered the right port (8680) and press OK. Click on keys icon to create user.


  • How can I add or remove collections in eXist?
  • How can I add or remove xml files in collections in eXist?


Java

  • Which version of Java should I use (as basis for the perfSONAR services)?
    • Authored by: Valentin Rosic
    • The one recommended in official howto or the newest stable.



  • How can I Install Java (JDK) on FreeBSD?
    • The following steps have worked for some users
    • Authored by: Mukul Sabharwal
  (1) Download JDK 1.4.2 for Linux
      http://java.sun.com/j2se/1.4.2/download.html
      --> j2sdk-1_4_2_13-linux-i586.bin

  (2) Download JDK 1.5.0 sources for Linux
      http://www.sun.com/software/communitysource/j2se/java2/download.xml
      --> SCSL Source (jdk-1_5_0-src.scsl.zip)
      --> SCSL Binaries (jdk-1_5_0-bin.scsl.zip)

  (3) Download patch files for FreeBSD
      http://www.eyesbeyond.com/freebsddom/java/jdk15.html
      --> Patch Level 4 (bsd-jdk15-patches-4.tar.bz2)

  (4) Move these four files to /usr/ports/distfiles
      mv *.zip *.bz2 *.bin /usr/ports/distfiles

  (5) Run the following commands
      sudo kldload linprocfs
      sudo mount -t linprocfs linprocfs /compat/linux/proc
      cd /usr/ports/java/jdk15
      sudo make install clean 


  • How can I install Java (JDK) on Linux?
    • Authored by: Valentin Rosic
    • The easiest way is to use packet manager (eg. for debian apt-get). If you are unsure, follow steps on this page at "How can I install Java (JDK) on Debian?"


  • How can I install Java (JDK) on Mac OS X?
  • How can I install Java (JDK) on Windows XP?
  • How can I install Java (JDK) on Debian?
       x@y:/$ mkdir /usr/java
       x@y:/$ cd /usr/java
       x@y:/usr/java/$ chmod 755 jdk-1_5_0_09-linux-i586-rpm.bin
       x@y:/usr/java/$ ./jdk-1_5_0_09-linux-i586-rpm.bin

After installation, make and run this script.

       x@y:/usr/java$ pico skripta.sh
       #!/bin/sh
       for i in `find /usr/java | grep ^.*\.pack$`
       do
          j=`echo $i | sed -e 's/\.pack/\.jar/'`
          /usr/java/jdk1.5.0_09/bin/unpack200 $i $j
       done	
       x@y:/usr/java$ chmod 755 skripta.sh
       x@y:/usr/javal$ ./skripta.sh

If you had some alternative java installed on your server before, make sure to select newly installed java and to define system paths. Run this command and pick your newly installed java.

       x@y:/$ update-alternatives --config java

Define your system paths and add this at the end of file:

       x@y:/$ pico /etc/profile
       export JAVA_HOME=/usr/java/jdk1.5.0_09
       export PATH=$JAVA_HOME/bin:$PATH
        
       export JRE_HOME=/usr/java/jdk1.5.0_09/jre
       export PATH=$JRE_HOME/bin:$PATH	
       	
       export CLASSPATH=.:$CLASSPATH:/usr/java/jdk1.5.0_09/lib

Save file and do this:

       x@y:/$ source /etc/profile


  • What is JAVA_HOME variable?
    • Authored by: Valentin Rosic
    • A line of text which shows where your JAVA is installed.


  • Where is JAVA_HOME variable set?
    • Authored by: Valentin Rosic
    • You can define it in /etc/profile using your text editor (eg. pico)


  • How can I set JAVA_HOME variable on my machine?
    • Authored by: Valentin Rosic
    • You can follow the suggestion below
       x@y:/$ pico /etc/profile

   Put this text at the end (make sure you enter valid location of your java directory):

       export JAVA_HOME=/usr/java/jdk1.5.0_09
       export PATH=$JAVA_HOME/bin:$PATH
       
       export JRE_HOME=/usr/java/jdk1.5.0_09/jre
       export PATH=$JRE_HOME/bin:$PATH	
       	
       export CLASSPATH=.:$CLASSPATH:/usr/java/jdk1.5.0_09/lib


  • How can I find out where Java is installed on my machine?
    • Authored by: Valentin Rosic
    • Just open console and enter:
  (1)  x@y:/$ update-alternatives --config java  (if more than one java is installed)
               or
  (2)  x@y:/$ find / -name \*java\*
               or
  (3)  x@y:/$ locate java
               or 
  (4)  Ask your system administrator to find it out for you


MySQL

  • Which version of MySQL is required by perfSONAR (as basis for the SQL MA service)?
  • How can I install MySQL On freeBSD?
    • The following steps have helped some of our users
    • Authored by: Mukul Sabharwal
cd /usr/ports/databases/mysql50-server
sudo make -DWITH_LINUXTHREADS install clean
sudo mysql_install_db
sudo chown -R mysql /var/db/mysql
sudo chgrp -R mysql /var/db/mysql
echo 'mysql_enable="YES"' > /etc/rc.conf
sudo mysqladmin -u root password OakEsNet


postgreSQL

  • Which version of postgreSQL is required by perfSONAR (as basis for the SQL MA service)?


RRDTool

  • Which version of RRD Tool is required by perfSONAR (as basis for the RRD MA service)?
  • What is RRDTool?
    • Authored by: Valentin Rosic

RRDtool is a round-robin database tool designed to handle time-series data like network bandwidth, temperatures, CPU load etc. The data is stored in round-robin database so that system storage footprint remains constant over time. It also includes tools to extract rrd data in graphical format.

  • How can I install RRDTool on my machine?
    • Authored by: Valentin Rosic

Before downloading and installing rrdtool, be sure to download and install these prerequites from addresses:

     http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/pub/libs/freetype-2.1.10.tar.bz2	
     http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/pub/libs/libpng-1.2.10.tar.gz	
     http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/pub/libs/libart_lgpl-2.3.17.tar.gz	
     http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/pub/libs/zlib-1.2.3.tar.gz

Unpack archive, read README or INSTALL and follow steps (usually just configure, make and make install).

Download and install rrdtool:

     x@y:/home/user/$ wget http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/pub/rrdtool-1.2.13.tar.gz
     x@y:/home/user/$ tar -zxf rrdtool-1.2.13.tar.gz
     x@y:/home/user/$ cd rrdtool-1.2.13 
     x@y:/home/user/rrdtool-1.2.13/$ ./configure --prefix=/usr/local/rrdtool

If all prerequites are installed, complete installation with:

     x@y:/home/user/rrdtool-1.2.13/$ make
     x@y:/home/user/rrdtool-1.2.13/$ install


Define systempahts with

     x@y:/home/user/rrdtool-1.2.13/$ pico /etc/profile

And add this at the end of file

     LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/rrdtool/lib
     export LD_LIBRARY_PATH
     
     PATH=$PATH:/usr/local/rrdtool/bin
     export PATH

Finally, do this

     x@y:/home/user/$ source /etc/profile
  • Where can I find the location of rrd.h file on my machine?
    • Authored by: Valentin Rosic

In your $rrdtool-directory/include. If not, try "locate rrd.h"

  • I can't find rrd.h file on my machine. What do I do?
    • Authored by: Roman Lapacz and Chris Welti
    • rrd.h file might not be present on machines where package management solutions such as apt-get, up-to-date are used to install rrdtool application. If you can't find rrd.h file on your machine, the best solution is to install another instance of rrdtool but this time without using any package management solutions. You can download and install from RRDTool's home page
    • Another solution for Debian which has sometimes worked in the past is to install librrd2-dev package. After installing, the file is usually present in the /usr/include directory.


  • Where can I find the location of rrd libraries on my machine?
  • Which files are part of rrd library directory?
  • I can't find the location of rrd library on my machine. What do I do?


Tomcat (Jakarta Tomcat)

  • Why is Tomcat required by perfSONAR services?
  • Why do some service required Tomcat while others don't?
  • Which version of Tomcat is required for perfSONAR services?
  • How can I Install Tomcat on FreeBSD?
  • How can I install Tomcat on Linux?
    • Authored by: Valentin Rosic

See part on this page called 'How can I install Tomcat on Debian?'

  • How can I install Tomcat on Mac OS X?
  • How can I install Tomcat on Windows XP?
  • How can I install Tomcat on Debian?
    • Authored by: Valentin Rosic

Make sure you do all steps as root. Download and install Tomcat

     x@y:/$ cd /usr/local
     x@y:/usr/local/$ wget http://www.apache.org/dist/tomcat/tomcat-5/v5.0.28/bin/jakarta-tomcat-5.0.28.tar.gz 
     x@y:/usr/local/$ tar -zxf jakarta-tomcat-5.0.28.tar.gz
     x@y:/usr/local/$ mv jakarta-tomcat-5.0.28 tomcat

Make script so you can start-stop-restart Tomcat (make sure that java path is correct!).

     x@y:/$ cd /etc/init.d
     x@y:/etc/init.d/$ pico tomcat
     #!/bin/sh
               # Start/stop the tomcat daemon
     
               case "$1" in
               start)  echo -n "Starting Tomcat "
                       export JAVA_HOME=/usr/java/jdk1.5.0_09
                       export CATALINA_HOME=/usr/local/tomcat
                       /usr/local/tomcat/bin/./startup.sh
                       ;;
               stop)   echo -n "Stopping Tomcat "
                       export JAVA_HOME=/usr/java/jdk1.5.0_09
                       export CATALINA_HOME=/usr/local/tomcat
                       /usr/local/tomcat/bin/./shutdown.sh
                       ;;
               restart) echo -n "Restarting Tomcat "
                       /usr/local/tomcat/bin/./startup.sh
                       /usr/local/tomcat/bin/./shutdown.sh
                       ;;
               *)      echo "Usage: /etc/init.d/tomcat start|stop|restart"
                       exit 1
                       ;;
               esac
               exit 0

Save file and exit. Start Tomcat

     x@y:/etc/init.d/$ chmod 755 tomcat
     x@y:/etc/init.d/$ ./tomcat start

See if you installed Tomcat sucessfully by entering this in your browser

     http://localhost:8080 
  • I am required to provide a port number (during installation) where Tomcat is listening/running. Which port number should I give?
    • Authored by: Loukik
    • The default port number that Tomcat uses for listening to http traffic is 8080. You can change this port number by configuring Tomcat to listen on a different port. Although any port number can be given, we suggest the range 8000-9000.
    • Tomcat also uses ports 8005 for shutdown and 8009 for ajp connector. If you are running more than one instance of tomcat on the same workstation, you will need to configure a different port number for shutdown (you can ignore the ajp connector or comment out the lines)
    • Authored by: Valentin Rosic

If you are using Debian hybrids like (K)Ubuntu and packet manager, pay attention! By default, Tomcat via apt-get (or Adept) uses default port 8180 instead 8080.

  • If I supply a port number (during installation of perfSONAR services) where Tomcat is listening, what implications does this have?
    • Authored by: Loukik
    • If you supply a port number where the Tomcat installation will be listening, you have to make sure that firewalls - either on the workstation/PC or on the gateway routers (or other routers) in between, do not block traffic from the entire world originating from or reaching to this port. Contact your System Administrator or Network Manager if you are in doubt.
    • If you want to verify whether a given port is open to the entire world (internet traffic), ask us and we can help you out.


  • Should I supply a different port number (during installation of perfSONAR services) where Tomcat is listening for each perfSONAR service?
    • Authored by: Loukik.
    • If you are installing any of the services that are part of perfSONAR 2.0 (or later), you can give the same port number for each service.
    • If you are installing perfSONAR 1.0, you will need to provide a different port number for each service that you install using the bundle/core.


  • By default, which port does Tomcat listen on?
    • Authored by: Loukik
    • The default port number that Tomcat uses for listening to http traffic is 8080
  • How can I configure Tomcat to listen on a different port?
  • How can I run two Tomcat instances on the same machine?
  • How can I find out the location of Tomcat home directory on my machine?
  • How can I start/stop Tomcat?
    • Authored by: Valentin Rosic

If you installed Tomcat as described above in part 'How can I install Tomcat on Debian?', as root, enter in Console

     x@y:/etc/init.d/$ ./tomcat start
     x@y:/etc/init.d/$ ./tomcat stop

Or

     x@y:/tomcat-directory/bin/$ ./startup.sh
     x@y:/tomcat-directory/bin/$ ./shutdown.sh
  • How can I restart Tomcat?
    • Authored by: Valentin Rosic

If you installed Tomcat as described above in part 'How can I install Tomcat on Debian?', as root, enter in Console

     x@y:/etc/init.d/$ ./tomcat restart

Or

     x@y:/tomcat-directory/bin/$ ./shutdown.sh
     x@y:/tomcat-directory/bin/$ ./startup.sh
  • Where can I find server.xml in my Tomcat installation?
    • Authored by: Valentin Rosic

It should be located in /tomcat-directory/conf/

    eg.
    x@y:/usr/local/tomcat/conf/$


perfSONAR bundle installer


perfSONAR Services

General (Questions related to all perfSONAR Services)

  • How can I control the logs being generated?
  • How can I control (switch on/off) logs of a particular level being generated?
  • The installer asks for a name of the service (during installation of RRD MA for example). What name should I give? What will this name be used for?
    • Authored by Loukik.
    • From 2.0 onwards, the name of the service is used as the 'Web Application' name given to Tomcat. The name that you choose at this stage will appear as part of the URL where the installed service will be available.
    • For example, if your tomcat is running on machine perfsonar.net, port 8080, tomcat is usually available at port http://perfsonar.net:8080. If you provide the name of the service as perfsonar-rrdma-1.1, then your service will be accessible by the outside world at http://perfsonar.net:8080/perfsonar-rrdma-1.1/services/MeasurementArchiveService. Also, service maintenance pages will be accessible at http://perfsonar.net:8080/perfsonar-rrdma-1.1.
    • Note: No two names on the same tomcat can be unique. So, if you are installing two instances of the same service (example two instances of RRD MA), please make sure that you choose unique names.
    • The default name that is usually suggested by the installer has been chosen to be a both easy to use and at the same time provide a good amount of information.


RRD Measurement Archive Service (Java)

  • What should I remember while restarting Tomcat?
  • What is LD_LIBRARY_PATH?
  • How can I set/modify LD_LIBRARY_PATH?
  • Why is LD_LIBRARY_PATH required?
  • The installer asks for the location (directory path) of the header file of rrdtool (rrd.h). Where can I find this information?
    • Authored by: Loukik
    • The answer to this question depends on the way rrdtool has been installed on to your machine. There are usually two broad ways in which rrdtool can be installed: either by manually downloading rrdtool software from the website and manually installing it or by using apt-get or fink like package management solutions which will automatically download, extract and install the software/packages. You will need to know which of these two methods have been used for installing rrdtool on your machine.
    • If rrdtool was installed manually, please find out the directory where rrdtool has been installed. if $rrdtool_home is the folder where rrdtool has been installed, rrd.h file can be found in $rrdtool_home/include directory. This is the value that you will need to supply when asked.
    • If rrdtool was installed automatically using apt-get like mechanisms the location of rrd.h file can vary (depending on the OS). The examples below are some possibilities where you may search for the file. If you can't find it, contact your system administrator. The last resort is usually to install rrdtool manually (and use it only for perfSONAR application)
      • In linux, rrd.h might be located in /usr/include
      • In Debian, look under /usr/include
      • In Solaris, rrd.h might be located in /usr/include


  • The installer asks for the location (directory path) of the library files of rrdtool (librrd*). Where can I find this information?
    • Authored by: Loukik
    • The answer to this question (also) depends on the way rrdtool has been installed on to your machine. There are usually two broad ways in which rrdtool can be installed: either by manually downloading rrdtool software from the website and manually installing it or by using apt-get or fink like package management solutions which will automatically download, extract and install the software/packages. You will need to know which of these two methods have been used for installing rrdtool on your machine. The library files of rrdtool usually start with the name 'librrd'.
    • If rrdtool was installed manually, please find out the directory where rrdtool has been installed. if $rrdtool_home is the folder where rrdtool has been installed, rrd libraries can be found in $rrdtool_home/lib directory. This is the value that you will need to supply when asked.
    • If rrdtool was installed automatically using apt-get like mechanisms the location of rrd libraries is mixed with other libraries. The examples below are some possibilities where you maybe able to find the rrd libraries. If you can't find the rrd libraries, please contact your system administrator. The last resort is usually to install rrdtool manually (and use it only for perfSONAR application)
    • In linux, rrd library files maybe located in /usr/lib
    • In Debian, rrd library files maybe located in /usr/lib
    • In Solaris, rrd library fiels maybe located in /usr/lib


  • The perfSONAR bundle installer is not working; installation fails just after starting the install.pl script.
    • Authored by:
    • Make sure you have installed the required version of Ant and included the $ANT_HOME/bin directory into the environment variable PATH.
    • Make sure that the PATH environment variable contains only one entry for ANT bin directory, if you have multiple ANT installtions on your system. Reason being; the multiple ANT installations might conflict and can cause problem.


  • How RRD MA service will synchronize with the .rrd files those are already in place but exist on other server?
    • RRD files have to be on the same server where you installed the web service. Common practice is to copy periodically (rsync, scp) rrd files from the machine where the real data collection happens.


  • When trying to upgrade RRDMA installation from 1.0 to 2.0, build fails with the following error:
     Which installation type do you want?
     1. Basic
     2. Advanced
     Please choose a number [enter to exit]: 1
     Starting installation for service RRD MA...
     [echo] Preparing the installation of RRD MA...
     [echo] Answer to all questions. If you go wrong, cancel (ctrl-c) and start again.
     [input] Enter the name of the service [perfSONAR-RRD-MA-2.2]:
     BUILD FAILED
     /usr/local/perfsonar-bundle-2.0/perfSONAR-RRD-MA-2.2/perfsonar/ant/rrdma/rrdma-pre-install-targets.xml:593: The following error   
     occurred while executing this line:
     /usr/local/perfsonar-bundle-2.0/perfSONAR-RRD-MA-2.2/perfsonar/ant/pre-install-targets.xml:112: Could not create task or type of 
     type: propertyfile.
     Ant could not find the task or a class this task relies upon.
     

The error shows that the task propertyfile (used in RRDMA 2.0) is unknown for the Ant being used. It means that your Ant installation doesn't contain the required library. As propertyfile task belongs to Optional tasks of Ant, which typically requires an external library to function.

The external libraries required by each of the optional tasks is detailed in the Library Dependencies section available on the following link: <http://ant.apache.org/manual/install.html#librarydependencies>

These external libraries must be added to Ant's classpath, in any of the following ways:

  * In ANT_HOME/lib. This makes the JAR files available to all Ant
    users and builds
  * In ${user.home}/.ant/lib . This is a new feature since Ant1.6, and
    allows different users to add new libraries to Ant. All JAR files
    added to this directory are available to command-line Ant.
  * On the command line with a |-lib| parameter. This lets you add new
    JAR files on a case-by-case basis.
  * In the CLASSPATH environment variable. Avoid this; it makes the
    JAR files visible to /all/ Java applications, and causes no end of
    support calls.


  • I am using the perfSONAR bundle installer (version 2.0) to install RRD-MA. Installation script didn't produce any error but its not compiling librrd.so

It is a bug in the installation script. The temporary work around for this problem is edit the Makefile.linux. The file can be found at the follwoing location: {RRDMA_installation_directory}/perfsonar/contrib/rrdjtool/native/Makefile.linux.

Change the lines beginning with RRD_PATH and JDK_PATH to point to the correct locations. Although you might have provided values for these parameters during the installation but the script didn't perform the changes automatically so you have to do them manually.

SQL Measurement Archive Service (Java)

  • What is ibatis?


Command Line Measurement Point Service (Java)


Telnet/SSH Measurement Point Service (Java)

  • When I install SSH/Telnet MP and try to test it, I get the following error:
Apparently the installation was successful. 
Would you like to test the service? (y, n): y 
Buildfile: build.xml 
test: 
   [java] creator started ... 
   [java] java.lang.NullPointerException 
   [java]     at org.apache.tools.ant.taskdefs.ExecuteJava.execute(ExecuteJava.java:180) 
   [java]     at org.apache.tools.ant.taskdefs.Java.run(Java.java:710) 
   [java]     at org.apache.tools.ant.taskdefs.Java.executeJava(Java.java:178) 
   [java]     at org.apache.tools.ant.taskdefs.Java.execute(Java.java:84) 
   [java]     at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:275) 
   [java]     at org.apache.tools.ant.Task.perform(Task.java:364) 
   [java]     at org.apache.tools.ant.Target.execute(Target.java:341) 
   [java]     at org.apache.tools.ant.Target.performTasks(Target.java:369) 
   [java]     at org.apache.tools.ant.Project.executeSortedTargets(Project.java:1216) 
   [java]     at org.apache.tools.ant.Project.executeTarget(Project.java:1185)
   ……….
   [java]     at java.lang.reflect.Method.invoke(Method.java:585) 
   [java]     at org.apache.tools.ant.taskdefs.ExecuteJava.run(ExecuteJava.java:202) 
   [java]     at org.apache.tools.ant.taskdefs.ExecuteJava.execute(ExecuteJava.java:134) 
   [java]     at org.apache.tools.ant.taskdefs.Java.run(Java.java:710) 
   [java]     at org.apache.tools.ant.taskdefs.Java.executeJava(Java.java:178) 
   [java]     at org.apache.tools.ant.taskdefs.Java.execute(Java.java:84) 
   [java]     at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:275) 
   [java]     at org.apache.tools.ant.Task.perform(Task.java:364) 
   [java]     at org.apache.tools.ant.Target.execute(Target.java:341) 
   [java]     at org.apache.tools.ant.Target.performTasks(Target.java:369) 
   [java]     at org.apache.tools.ant.Project.executeSortedTargets(Project.java:1216) 
   [java]     at org.apache.tools.ant.Project.executeTarget(Project.java:1185) 
   [java]     at org.apache.tools.ant.helper.DefaultExecutor.executeTargets(DefaultExecutor.java:40) 
   [java]     at org.apache.tools.ant.Project.executeTargets(Project.java:1068) 
   [java]     at org.apache.tools.ant.Main.runBuild(Main.java:668) 
   [java]     at org.apache.tools.ant.Main.startAnt(Main.java:187) 
   [java]     at org.apache.tools.ant.launch.Launcher.run(Launcher.java:246) 
   [java]     at org.apache.tools.ant.launch.Launcher.main(Launcher.java:67)
    • Authored by:
    • If no 'routers' or 'network equipments' are provided during the configuration steps in installation script then the testing fails and the error is noticed as a Null Pointer Exception. Make sure that the ‘service.properties’ file contains the entries for routers or network equipments.


BWCTL and OWAMP Measurement Point Service (Perl)


e2eMon Measurement Point (Perl)


XML Lookup Service (Java)

  • Is eXist installation mandatory for Lookup Service?
    • Authored by: Maciej Glowiak
    • Yes. For the XML (eXist DB based) lookup service, installation of eXist DB is mandatory


  • I am getting the following exception while testing the Lookup Service (version 2.0): org.apache.cocoon.ResourceNotFoundException: Resource not found.: org.apache.excalibur.source.SourceNotFoundException: file:/home/ps00/jakarta-tomcat-5.0.28/webapps/exist/db/sitemap.xmap doesn't exist. How to get rid of it?
    • Authored by:
    • The problem could be with the eXist XML database configuration. Make sure that the location of the XML database collection is correct. It should be [Protocol]://[Hostname]:[Port Number]/exist/rest/db/ls.


perfSONAR visualization tools

perfsonarUI

  • Where can I get more information about the perfsonarUI features and usage?
    • Authored by: Andreas
    • Please visit the Wiki page about perfsonarUI
  • I cannot install perfsonarUI
  • When launching perfsonarUI, I got the following message: unable to launch the application
    • Authored by: Nicolas
    • On windows XP SP2, after having updated from java 1.5 to java 1.6.
    • Go to "Control Panel" > "Java" > "General" tab > "Temporary Internet Files" > "Settings" > click on "Delete Files" > tick "Applications and Applets". Launch perfsonarUI.

DFN CNM

  • What kind of Java/Java Web Start version do I need to use the CNM?
    • Authored by: Andreas
    • You can use any Java version later than Java 1.3. Any Java Web Start version is supported. Since the release of Java 1.5. Java Web Start is part of the Java distribution. Java can be downloaded from java.sun.com. See also the Java section on this page
  • Where can I get more information about the CNM features and usage?
    • Authored by: Andreas
    • Please visit the Wiki page about the CNM

Tracefile Capture Measurement Point UI [TCMP-UI] (Java - Web Application)

  • What is TCMP
    • Authored by: Uros
    • Please visit the Wiki page about [TCMP]
  • What is TCMP-UI
    • Authored by: Uros
    • TCMP-UI is an user friendly Web based User Interface to TCMP Services.
  • Are there any limitations to the demo system?
    • Authored by: Uros
    • Due to privacy reasons (and the absence of AA) the capture scope is limited to the traffic going to and coming from jra1test.arnes.si . This is unless you specify your more restrictive filtering or sampling rules.
    • Data capture: is limited to 112 bytes per packet starting with IP header.
    • There is only one TCMP instance running, thus there is no possibility to capture the trace from multiple sites.
Personal tools