Updates

• Before building JXTA-C, you should read the JXTA-C third-party dependency VERSION DOCUMENT .
• To build JXTA-C on Linux/Unix platforms look at the new LINUX/UNIX BUILD DOCUMENT.

Note: this page is deprecated for Linux/Unix platforms.

For Win32 you do also need the expat-library as described in the readme-file.

• http://download.java.net/jxta/

• Apache Portable Runtime: apr 1.2.1

You will also need to build the following libraries from source (see Building Prerequisite Libraries from Source):

• Apache Portable Runtime: apr-util 1.2.7 with SQLite3 support
  • The apr-util driver for SQLite3 requires a patch for transaction support.
• libxml2: You will apply the patch comes with JXTA-C to enable wildcard search in XPath query
• SQLite3

• libXML2
  • Apply the patch that comes with JXTA-C. Follow the directions in: JXTA-C directory/lib/libxml2/INSTALL

• SQLite
  • Should be built with --enable-threadsafe option
  • When using ephemeral address spaces, there is a problem in SQLite that creates a memory leak. The current CVS repository contains a fix for this problem and should be rebuilt. If ephemeral address spaces are not used the official release 3.3.6 is recommended.

• apr-util
  • Version 1.2.7 of apr-util is required along with a fix for SQL transaction support. You have 2 options for building apr-util.
    • You can download from the SVN repository revision 398048. This revision has been tested.

svn co http://svn.apache.org/repos/asf/apr/apr-util/trunk apr-util -r 398048

• • • A patch can be applied to the current 1.2.7 release. The source can be obtained from http://apr.apache.org/download.cgi. Download the tar ball for your system and extract the files. Create an apr_dbd_fix.patch file in the root directory of apr-util. Copy and paste the following patch into apr_dbd_fix.patch file.

• SQLite
  • Should be built with --enable-threadsafe option
  • When using ephemeral address spaces, there is a problem in SQLite that creates a memory leak. The current CVS repository contains a fix for this problem and should be rebuilt. If ephemeral address spaces are not used the official release 3.3.6 is recommended.

• • A patch is required for transaction support. Version 1.2.7 of apr-util is required. The source can be obtained from http://apr.apache.org/download.cgi. This patch fixes a problem with SQL transactions that JXTA-C now requires. The apr project has a fix but isn't in the current 1.2.7 release. This will only be required for the 1.2.7 version of apr-util. Download the tar ball for your system and extract the files. Create an apr_dbd_fix.patch file in the root directory of apr-util. Copy and paste the following patch into apr_dbd_fix.patch file.

• Apache Portable Runtime: apr 1.2.1, apr-util 1.2.7 with SQLite3 support
  • The apr-util driver for SQLite3 requires a patch for transaction support. (see Building Prerequisite Libraries from Source)

You can always build from source code, refer to those projects for instructions on how to build them on your platform. The following are the considerations for JXTA-C.

• apr-util
  • A patch is required for transaction support. Version 1.2.7 of apr-util is required. The source can be obtained from http://apr.apache.org/download.cgi. Download the tar ball for your system and extract the files. Create an apr_dbd_fix.patch file in the root directory of apr-util. Copy and paste the following patch into apr_dbd_fix.patch file.

Index: dbd/apr_dbd_sqlite3.c
===================================================================
--- dbd/apr_dbd_sqlite3.c   (revision 392824)
+++ dbd/apr_dbd_sqlite3.c   (working copy)

do { + int retry_count = 0; + ret = sqlite3_prepare(sql->conn, query, length, &stmt, &tail); if (ret = SQLITE_OK) { sqlite3_finalize(stmt); break; } - ret = sqlite3_step(stmt); + + while(retry_count++ <= MAX_RETRY_COUNT) { + ret = sqlite3_step(stmt); + if (ret = SQLITE_BUSY) + break; + + apr_dbd_mutex_unlock(); + apr_sleep(MAX_RETRY_SLEEP); + apr_dbd_mutex_lock(); + } + *nrows = sqlite3_changes(sql->conn); sqlite3_finalize(stmt); length -= (tail - query);

- ret = dbd_sqlite3_query(handle, &nrows, "BEGIN TRANSACTION;"); + ret = dbd_sqlite3_query(handle, &nrows, "BEGIN"); if (*trans) { *trans = apr_pcalloc(pool, sizeof(apr_dbd_transaction_t)); (*trans)->handle = handle;

if (trans) { - ret = dbd_sqlite3_query(trans->handle, &nrows, "END TRANSACTION;"); if (trans->errnum) { trans->errnum = 0; - ret = dbd_sqlite3_query(trans->handle, &nrows, "ROLLBACK;"); + ret = dbd_sqlite3_query(trans->handle, &nrows, "ROLLBACK"); } else { - ret = dbd_sqlite3_query(trans->handle, &nrows, "COMMIT;"); + ret = dbd_sqlite3_query(trans->handle, &nrows, "COMMIT"); } trans->handle->trans = NULL; }

Execute the following commands to patch and build apr-util.

                patch -p0 -i apr_dbd_fix.patch
                ./configure apr-util --apr=/location --with-sqlite3=/location
                make
                make install

• SQLite

You can always build from source code, refer to those projects for instructions on how to build them on your platform.

For *nices

For Win32

Stefan Lankes maintains the Win32 build environment. Goes to the win32 folder and you will find the jxta.sln file. Here is the instruction as in the README.txt file.

General
=======

Currently, we support only Visual Studio .NET 2003 to build JXTA-C. Therefore, 
the old VC6 project files in the current CVS tree are obsolete.

To create JXTA-C on Windows you need following libraries:

 - APR (http://apr.apache.org/)
 - OpenSSL (http://www.openssl.org/)
 - zlib (http://www.zlib.net/)
 - sqlite3 (http://www.sqlite.org/)
 - xml2 (http://xmlsoft.org/index.html)

Beside XML2 you can use the official distribution of these libraries. The 
XML2 library has been modified in order to provide wild card searching 
of text elements with the Enhanced Discovery Service. Therefore, you need to 
create this custom version of XML2. See INSTALL in lib/xml2 for instructions on 
building this version of XML2.


Check out the sources from CVS
==============================

cvs -d :pserver:guest@cvs.jxta.org:/cvs login
cvs -d :pserver:guest@cvs.jxta.org:/cvs checkout jxta-c 


Configuring the sources
=======================

You have to specify the environment variables (APACHE2, XML2, ZLIB, SQLITE3 and OPENSSL) 
to the location of the necessary libraries. It is assumed that 
the headers are located in the subdirectory "include", the DLLs in the subdirtectory 
"bin" and the link libraries in the subdirectory "lib". For instance, zlib.h is located 
at $(ZLIB)/include.


Building the sources
====================

Open with Visual Studio .NET 2003 the project file jxta.sln in the directory "win32".
Afterwards, press F7 to build the JXTA libraries and all examples. 

• http://download.jxta.org/
• http://rdv.jxtahosts.net/jxta/

• Apache Portable Runtime: apr 1.2.1, apr-util 1.2.1 with SQLite3 support.
• libxml2: You will apply the patch comes with JXTA-C to enable wildcard search in XPath query

You will also need following libraries:

• SQLite3
• zlib
• openssl

Step 3: Build

./configure
make
make install

Step 1: Get the source code

Download a source archive

Check out from CVS

Step 2: Prepare for prerequisite

Create a lib folder in your jxta-c folder and unzip the file.

System without libapr, Berkeley DB or with libapr does not support Berkeley DB

Windows

The jxtalib.dsp can be located in win32/jxta/jxtalib/jxtalib.dsp, I believe you know how to build it from here.

Check out from CVS

Linux

To test if your system have libapr installed and support Berkeley DB,

Next step, make sure that libapr was built with Berkeley DB support.

grep APU_HAVE_DB /usr/include/apr-0/apu.h

#define APU_HAVE_DB     1

System with libapr and Berkely DB isntalled

./autogen --without-apr --with-dbm=db

System without libapr, Berkeley DB or libapr does not support Berkeley DB

./autogen.sh
make
make install

Before we have a nightly tarball, you will have to check out the code from CVS.

Check out from CVS

cvs -d :pserver:guest@cvs.jxta.org:/cvs login
cvs -d :pserver:guest@cvs.jxta.org:/cvs checkout jxta-c 

Build with autotools under *nices

./autogen.sh
make
make install