blueprints-ramcloud-graph

A TinkerPop Blueprints implementation for RAMCloud

Setup

  • Copy src/main/java/edu/stanford/ramcloud/JRamCloud.java and src/main/cpp/edu_stanford_ramcloud_JRamCloud.cc to your ramcloud/bindinds/java/edu/stanford/ramcloud directory, overwriting what is already there.

  • Generate the C++ header files containing the function signatures for all the native methods in the Java RamCloud library:

javah -cp ../../../ edu.stanford.ramcloud.JRamCloud
  • Compile the ramcloud C++ library (assuming ramcloud is in your ${HOME} directory and you have already compiled ramcloud):
c++ -Wall -O3 -shared -fPIC -std=c++0x -I/usr/lib/jvm/java-1.7.0-openjdk-1.7.0.9.x86_64/include/ -I/usr/lib/jvm/java-1.7.0-openjdk-1.7.0.9.x86_64/include/linux/ -I${HOME}/ramcloud/src/ -I${HOME}/ramcloud/obj.master/ -I${HOME}/ramcloud/logcabin/ -I${HOME}/ramcloud/gtest/include/ -L${HOME}/ramcloud/obj.master -o libedu_stanford_ramcloud_JRamCloud.so edu_stanford_ramcloud_JRamCloud.cc -lramcloud
  • Update LD_LIBRARY_PATH (assuming ramcloud is in your ${HOME} directory) to include the library and also any other ramcloud libraries:
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${HOME}/ramcloud/bindings/java/edu/stanford/ramcloud:${HOME}/ramcloud/obj.master

  • Startup a ramcloud cluster somewhere and modify RamCloudGraph.java to point to the coordinator.

  • Compile this package (blueprints-ramcloud-graph) using maven and run :)

Using Rexster

  • git clone the rexster repository:
git clone https://github.com/tinkerpop/rexster.git
  • Compile rexster
cd rexster/
mvn compile
  • Compile packaged rexster server
cd rexster-server/
mvn package
  • Edit rexster-server config file
cd target/rexster-server-2.5.0-SNAPSHOT-standalone/
vim config/rexster.xml

  • Change web-root to be your public web-root directory

  • Add a ramcloud graph to the set of graphs to load up:

<graph>
    <graph-enabled>true</graph-enabled>
    <graph-name>ramcloudgraph</graph-name>
    <graph-type>com.tinkerpop.rexster.config.RamCloudGraphConfiguration</graph-type>
</graph>
  • Go back to the blueprints-ramcloud-graph directory and compile jar with depdencies:
mvn assembly:assembly -DdescriptorId=jar-with-dependencies
  • Copy resulting jar file into the compiled rexster-server library directory:
cp blueprints-ramcloud-graph-2.0.0-jar-with-depdencies.jar ~/git/rexster/rexster-server/target/rexster-server-2.5.0-SNAPSHOT-standalone/lib
  • Startup a ramcloud cluster (maybe using the cluster.py script):
./cluster.py --verbose --servers=5 --replicas=3 --backups=1 --masterArgs="--totalMasterMemory 80% --masterServiceThreads 4" --clients=1 --client=../obj.master/client --debug
  • Startup the rexster server:
./bin/rexster.sh -start &
  • Connect to rexster server at:
localhost:8182

Using Gremlin

  • git clone the gremlin repository:
git clone https://github.com/tinkerpop/gremlin.git
  • Compile gremlin
cd rexster/
mvn package
  • Go back to the blueprints-ramcloud-graph directory and compile jar with depdencies:
mvn assembly:assembly -DdescriptorId=jar-with-dependencies
  • Copy resulting jar file into the compiled gremlin-groovy library directory:
cp blueprints-ramcloud-graph-2.0.0-jar-with-depdencies.jar ~/git/gremlin/gremlin-groovy/target/gremlin-groovy-2.5.0-SNAPSHOT-standalone/lib
  • Startup a ramcloud cluster (maybe using the cluster.py script):
./cluster.py --verbose --servers=5 --replicas=3 --backups=1 --masterArgs="--totalMasterMemory 80% --masterServiceThreads 4" --clients=1 --client=../obj.master/client --debug
  • Startup gremlin shell:
./bin/gremlin.sh
  • Import RamCloudGraph java libraries and create RamCloudGraph:
         \,,,/
         (o o)
-----oOOo-(_)-oOOo-----
gremlin> g = new com.tinkerpop.blueprints.impls.ramcloud.RamCloudGraph()
  • Have fun!

Using Furnace

  • See com.tinkerpop.blueprints.impls.ramcloud.FurnaceExamples for some examples of using Furnace

Using JUNG