Native XML Database (NXD) Support

Native XML databases have an XML-based internal model and their fundamental unit of storage is XML. <oXygen/> offers support for: Berkeley DB XML, eXist, MarkLogic, Software AG Tamino, Raining Data TigerLogic, X-Hive/DB and Oracle XML DB.

Configuring Database Data Sources

This section presents a set of procedures describing how to configure NXD data sources.

How to configure a Berkeley DB XML datasource

The latest instructions on how to configure Berkeley DB XML support in <oXygen/> can be found on our website .

<oXygen/> supports Berkeley DB XML versions 2.3.10 & 2.4.11. The following directory definitions shall apply:

  • OXY_DIR - oXygen installation root directory. (for example on Windows C:\Program Files\Oxygen 9.3)

  • DBXML_DIR - Berkeley DB XML database root directory. (for example on Windows C:\Program Files\Sleepycat Software\Berkeley DB XML <version>)

  • DBXML_LIBRARY_DIR (usually on Mac and Unix is DBXML_DIR/lib and on Windows is DBXML_DIR/bin)

  1. Go to Preferences -> Data Sources. In the Data Sources panel click the New button.

  2. Enter a unique name for this data source and select Berkeley DBXML from the driver type combo box.

    Figure 14.12. Data Source Drivers Configuration Dialog

    Data Source Drivers Configuration Dialog


  3. Press the Add button to add the following Berkeley DB specific files:

    • db.jar (check for it into DBXML_DIR/lib or DBXML_DIR/jar)

    • dbxml.jar (check for it into DBXML_DIR/lib or DBXML_DIR/jar)

  4. Click OK to finish the data source configuration.

How to configure an eXist datasource

The latest instructions on how to configure eXist support in <oXygen/> can be found on our website .

The eXist database server versions supported by <oXygen/> are 1.0, 1.1 and 1.2.2.

  1. Go to Preferences -> Data Sources. In the Data Sources panel click the New button.

  2. Enter a unique name for this data source and select eXist from the driver type combo box.

  3. Press the Add button to add the following eXist specific files:

    • exist.jar (check for it into your eXist installation root directory)

    • xmldb.jar (check for it into /lib/core subdirectory of your eXist installation root directory)

    • xmlrpc-1.2-patched.jar (check for it into /lib/core subdirectory of your eXist installation root directory)

  4. Click OK to finish the data source configuration.

How to configure a MarkLogic datasource

The latest instructions on how to configure MarkLogic support in <oXygen/> can be found on our website .

  1. Go to Preferences -> Data Sources. In the Data Sources panel click the New button.

  2. Enter a unique name for this data source and select MarkLogic from the driver type combo box.

  3. Add the following MarkLogic specific file:

    • xcc.jar

    In the Download links for database drivers section there are listed the URLs from where to download the drivers necessary for accessing MarkLogic databases in <oXygen/>.

  4. Click OK to finish the data source configuration.

How to configure a Software AG Tamino datasource

The latest instructions on how to configure Software AG Tamino support in <oXygen/> can be found on our website .

  1. Go to Preferences -> Data Sources. In the Data Sources panel click the New button.

  2. Enter a unique name for this data source and select Tamino from the driver type combo box.

  3. Using the Add button add the following jar files available in the SDK\TaminoAPI4J\lib subdirectory of the Tamino 4.4.1 database install directory:

    • TaminoAPI4J.jar

    • TaminoAPI4J-l10n.jar

    • TaminoJCA.jar

    Note

    You must use the jar files from the version 4.4.1 of the Tamino database.

  4. Click OK to finish the data source configuration.

How to configure a Raining Data TigerLogic datasource

The latest instructions on how to configure TigerLogic support in <oXygen/> can be found on our website .

  1. Go to Preferences -> Data Sources. In the Data Sources panel click the New button.

  2. Enter a unique name for this data source and select TigerLogic from the driver type combo box.

  3. Add the following TigerLogic specific files (found in the TigerLogic JDK lib directory from the server side):

    • connector.jar

    • jca-connector.jar

    • tlapi.jar

    • tlerror.jar

    • utility.jar

    • xmlparser.jar

    • xmltypes.jar

  4. Click OK to finish the data source configuration.

How to configure an X-Hive/DB datasource

The latest instructions on how to configure X-Hive/DB support in <oXygen/> can be found on our website .

  1. Go to Preferences -> Data Sources. In the Data Sources panel click the New button.

  2. Enter a unique name for this data source and select X-Hive from the driver type combo box.

  3. Add the following X-Hive/DB specific files (found in the X-Hive/DB lib directory from the server side):

    • antlr.jar

    • icu4j.jar

    • retroweaver-rt.jar

    • xhive.jar

    If you like to use a bootstrap file when connecting to the database you need to additionally add the following JAR files found in the same place:

    • fop.jar

    • jsr173_api.jar

    • lucene.jar

    • mx4j.jar

    • serializer.jar

    • w3c.jar

    • xalan.jar

    • xbean.jar

    • xercesImpl.jar

    • xml-apis.jar

  4. Click OK to finish the data source configuration.