= !NetKarma Evaluation =
The GENI Provenance Registry !NetKarma version 2.5 was evaluated for this effort. This !NetKarma version introduces the Provenance Adaptor for GUSH and the Provenance Visualization plug-in for Cytoscape.  The software evaluated was downloaded from the [http://groups.geni.net/geni/wiki/netKarma NetKarma] GENI project page in the [http://groups.geni.net/geni/wiki/netKarma#Software Software downloads] section:
    * NetKarma Version 2.5 [http://pti.iu.edu/sites/default/files/netkarma_version2.5_quick_start_guide.pdf Quick Start Guide].
    * NetKarma [http://pti.iu.edu/sites/default/files/karma-adaptor-2.5.tar.gz GUSH Adaptor Version 2.5]
    * NetKarma [http://pti.iu.edu/sites/default/files/netkarma-gush-adaptor_v2.5_user_manual.pdf GUSH Adaptor Manual]
    * NetKarma [http://pti.iu.edu/sites/default/files/netkarmavisplugin-1.1.0.tar.gz Cytoscape Visualization Plug-In Version 1.1.0].
    * NetKarma [http://pti.iu.edu/sites/default/files/netkarma_provenance_retrieval_and_visualization_plug-in_for_cytoscape_user_manual_v1.1.0.pdf Cytoscape Visualization Plug-In Manual].
    * NetKarma [http://pti.iu.edu/sites/default/files/netkarmagmocadaptor-1.0.0.tar.gz GMOC Adaptor Version 1.0.0].
    * NetKarma [http://pti.iu.edu/sites/default/files/netkarma_gmoc_adaptor_user_manual_v1.0.0.pdf GMOC Adaptor Manual].

Evaluation Time Frame: October 12, 2011

= !NetKarma Findings =
Various issues were found in the initial evaluation.  Feedback captured in [attachment: NetKarma-Feedback-20111012.txt]
Send additional feedback captured in [attachment: NetKarma-Feedback-20111021.txt]. Some responses in [attachment: NetKarma-response-20111028.txt]


= !NetKarma How-to =

Using the instructions in the NetKarma Version 2.5 [http://pti.iu.edu/sites/default/files/netkarma_version2.5_quick_start_guide.pdf Quick Start Guide], proceeded to download the only prerequisite tool the third-party Cytoscape visualization tool, which is available at: http://www.cytoscape.org. The download is one file a script named ''Cytoscape_2_8_2_unix.sh''.  Running the Cytoscape script which brings up an installation wizard.

Proceeded to unpack the NetKarma [http://pti.iu.edu/sites/default/files/karma-adaptor-2.5.tar.gz GUSH Adaptor Version 2.5]. Found additional prerequisites for ANT, JDK and RabbitMQ server.  For RabbitMQ used the instructions found the [http://www.rabbitmq.com/debian.html#apt Debian APT repository] page.

{{{
 $ tar xvzf karma-adaptor-2.5.tar.gz 
 $ cd Karma-Adaptor
}}}
As instructed modified the adaptor_stdenvs.cfg file to set the ADAPTOR_HOME and the JAVA_HOME variables.  File looks as follows:

{{{
#
# Copyright 2007 The Trustees of Indiana University
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# -----------------------------------------------------------------
#
# Project:  Karma-adaptor
# File:  adaptor_stdenvs.cfg
# Description:  config-file for the shell-scripts
# -----------------------------------------------------------------
export ADAPTOR_HOME=/home/netkarma/rc2/Karma-Adaptor
export JAVA_HOME=/usr/local/jdk1.6.0_03
export JAVA_HOME=/usr/lib/jvm/java-6-openjdk

export CLASSPATH=$ADAPTOR_HOME/lib/commons-cli-1.1.jar:$ADAPTOR_HOME/lib/commons-collections-3.2.1.jar:$ADAPTOR_HOME/lib/netk
arma-adaptor-types.jar:$ADAPTOR_HOME/lib/opm-core-1.1.1.jar:$ADAPTOR_HOME/lib/commons-io-1.2.jar:$ADAPTOR_HOME/lib/opm-elmo-1
.1.1.jar:$ADAPTOR_HOME/lib/commons-logging-1.1.1.jar:$ADAPTOR_HOME/lib/rabbitmq-client.jar:$ADAPTOR_HOME/lib/karma-messaging.
jar:$ADAPTOR_HOME/lib/xbean.jar:$ADAPTOR_HOME/lib/karma-types.jar:$ADAPTOR_HOME/bin
}}}

Build the Karma adaptor:
{{{

$ ant karma-adaptor 
Buildfile: build.xml

clean:

compile:
    [mkdir] Created dir: /home/lnevers/netkarma/rc2/Karma-Adaptor/bin
    [javac] Compiling 15 source files to /home/lnevers/netkarma/rc2/Karma-Adaptor/bin
    [javac] Note: Some input files use or override a deprecated API.
    [javac] Note: Recompile with -Xlint:deprecation for details.
    [javac] Note: Some input files use unchecked or unsafe operations.
    [javac] Note: Recompile with -Xlint:unchecked for details.
karma-adaptor:

BUILD SUCCESSFUL
Total time: 2 seconds
}}}
Need to figure out latest failure:
{{{
$ ./provenance_collector.sh sample/logfile-peng-virtual-machine-10708-1309964193.txt 
Exception in thread "main" java.lang.NoClassDefFoundError: edu/indiana/d2i/adaptor/client/KarmaAdaptor
Caused by: java.lang.ClassNotFoundException: edu.indiana.d2i.adaptor.client.KarmaAdaptor
        at java.net.URLClassLoader$1.run(URLClassLoader.java:217)
        at java.security.AccessController.doPrivileged(Native Method)
        at java.net.URLClassLoader.findClass(URLClassLoader.java:205)
        at java.lang.ClassLoader.loadClass(ClassLoader.java:321)
        at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:294)
        at java.lang.ClassLoader.loadClass(ClassLoader.java:266)
Could not find the main class: edu.indiana.d2i.adaptor.client.KarmaAdaptor. Program will exit.
}}}


--------------
{{{
#!html
<a href="mailto:luisa.nevers@bbn.com">Email us</a> with any questions and feedback on this page!
}}}