gluster / libgfapi-jni

Java Native Interface (JNI) bindings for libgfapi (the GlusterFS client API)

libgfapi-jni

Java Native Interface (JNI) bindings for libgfapi, the GlusterFS client API.

Usage

This project provides a low level binding from Java to the C language GlusterFS API library.

It was developed as part of glusterfs-java-filesystem. Use that project to enable GlusterFS support in your Java applications.

Development Instructions

Prerequisites

• glusterfs 3.4 or newer - installed from source or a gluster development package installed.
• maven 3.0.3 or newer
• auto tool chain
• Ubuntu packages: build-essential libtool pkg-config automake
• Ubuntu glusterfs PPAs: https://launchpad.net/~gluster (the glusterfs-common package is required to build this project)

Compiling without tests

If you have installed gluster to non-standard location then you export GLFS_HOME so we know where it's at:

export GLFS_HOME=/path/to/gluster/prefix

Building without tests is simple. Just run:

mvn -Dmaven.test.skip=true install

Compiling and Testing

The test suite is configured by default to run against the glusterfs server configured in the vagrant box provided by glusterfs-java-filesystem. Run vagrant up in that project's root directory to launch the server, then run the tests in this project.

Once that server is up, you can run the tests with:

mvn test

Project License

Until further notice (made here and in LICENSE.txt) this project is licensed under the terms of the 3-clause BSD license, as written in LICENSE.txt (and copied in several source files).

The licensing is likely to change in the near future as the project matures.

libgfapi-jni's Issues

Test fails : Fedora16 / java 1.6 / gluster 3.3.0

The build appears to have one failing test in my environment:

Here are the system details:

[root@fedoravm libgfapi-jni]# uname -a

Linux fedoravm 3.1.0-7.fc16.x86_64 #1 SMP Tue Nov 1 21:10:48 UTC 2011 x86_64 x86_64 x86_64 GNU/Linux

[root@fedoravm libgfapi-jni]# java -version

java version "1.6.0_24"
OpenJDK Runtime Environment (IcedTea6 1.11.6) (fedora-71.1.11.6.fc16-x86_64)
OpenJDK 64-Bit Server VM (build 20.0-b12, mixed mode)

[root@fedoravm libgfapi-jni]# gluster --version

glusterfs 3git built on Mar 27 2013 20:39:59
Repository revision: git://git.gluster.com/glusterfs.git
Copyright (c) 2006-2011 Gluster Inc. http://www.gluster.com
GlusterFS comes with ABSOLUTELY NO WARRANTY.
You may redistribute copies of GlusterFS under the terms of the GNU General Public License.

Here are the other details:

[root@fedoravm libgfapi-jni]# more /root/Development/libgfapi-jni/glfsjni-linux64/target/surefire-reports/TestSuite-output.txt
NEW: 139945135510768
SETLOG: 0
SERVER: 0
INIT: -1
[root@fedoravm libgfapi-jni]# more /root/Development/libgfapi-jni/glfsjni-linux64/target/surefire-reports/testng-failed.xml

suite verbose="0" name="Failed suite [Command line suite]"
test name="Command line test(failed)"
class name="org.fusesource.glfsjni.internal.GLFSTest"
methods


















org.fusesource.glfsjni.internal.GLFSTest
Command line test(failed)
Failed suite [Command line suite]

Benchmarking tests (examples/ add args to args[])

It would be great to add a java file buffer to the write test, + a configurable byte argument to the args[], so that we can benchmark the throughput of the library into libgfapi for a first pass of prototyping ...

Can someone upload the latest target jar conatining a x86_64 so library

hi, semiosis
can you give the latest target jar conatining a x86_64 so library ? I have tried a long time but just can not get the target jar.
Thanks very much !

where the libgfapi-jni.so come from？