Tags

Berkeley DB XML and OxygenXML on Mac OSX (part 1)

These are the steps to carry out to get Berkeley DBXML and OxygenXML IDE combined to work on Mac OSX.
  1. Install the Apple Developer tools.
  2. Download, compile and test Oracle's Berkeley DBXML
  3. Set MacOS and Oxygen environment variables
  4. Configure OxygenXML to talk to a DBXML data source
  5. Create a DBXML container from within OxygenXML IDE
  6. 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.

Install Disk
Make sure you include the UNIX Dev support during install.

install options
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.

IntelliJ View

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.

Property List Editor

When having the file opened you should add:

  1. the path to the lib folder to environment variable DYLD_LIBRARY_PATH
  2. add the path to folder 'lib' and 'bin' to PATH

Property List editor

On the OxygenXML IDE side


"Show package content" of the file Oxygen.app.

Oxygen.app Package content
Open file "Info.plist".

Add to Java -> Properties the line
key: java.library.path; value: path to dbxml lib folder.
Info.plist

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