These are the steps to carry out to get Berkeley DBXML and OxygenXML IDE combined to work on Mac OSX.
- Install the Apple Developer tools.
- Download, compile and test Oracle's Berkeley DBXML
- Set MacOS and Oxygen environment variables
- Configure OxygenXML to talk to a DBXML data source
- Create a DBXML container from within OxygenXML IDE
- Connect from OxygenXML IDE to an existing DBXML container
Install the Apple Developer tools
You find these as a separate install named Xcode.mpkg on the MacOS installer DVD.

Make sure you include the UNIX Dev support during install.

You can also find the latest version at
http://developer.apple.com/technology/xcode.html.
Download and compile Berkeley DBXML
The file dbxml-2.5.13.tar.gz can be found at http://www.oracle.com/technology/software/products/berkeley-db/xml/index.html.
Download and expand to folder dbxml-2.5.13.
>cd dbxml-2.5.13
>sh ./buildall.sh --enable-java
The option --enable-java is needed to build the Java API which OxygenXML is using.
The resulting .jar files are created in the install/lib directory.
Java examples are also built, and put in dbxml-2.5.13/dbxml/build_unix/dbxmlexamples.jar.
You can test if the Java API is working by running one of the samples in dbxmlexamples.jar.

Set environment variables
On the OS side
Open ~/.MacOSX/environment.plist with the application "Property List Editor".
This file is placed in a hidden directory which can be revealed in several ways.
The Application can be found in the Developer install.

When having the file opened you should add:
- the path to the lib folder to environment variable DYLD_LIBRARY_PATH
- add the path to folder 'lib' and 'bin' to PATH

On the OxygenXML IDE side
"Show package content" of the file Oxygen.app.

Open file "Info.plist".
Add to Java -> Properties the line
key: java.library.path; value: path to dbxml lib folder.
Configure OxygenXML to talk to a DBXML data source
This is perfectly documented at the
Oxygen XML website itself.
Now that everything has been set up, we will elaborate in a next post how to work with the integration:
Comments