• Chapter 1: Getting Started with Stylus Studio®
• Chapter 2: Editing and Querying XML
• Chapter 3: Converting Non-XML Files to XML
• Chapter 4: Working with XSLT
• Chapter 5: Creating XSLT Using the XSLT Mapper
• Chapter 6: Debugging Stylesheets
• Chapter 7: Defining XML Schemas
• Chapter 8: Defining Document Type Definitions
• Chapter 9: Writing XPath Expressions
• Chapter 10: Working with XQuery in Stylus Studio
• Chapter 11: Composing Web Service Calls
• Chapter 12: Accessing Relational Data as XML
• Chapter 13: Integrating with Third-Party File Systems
  • Using Stylus Studio with Berkeley DB XML
    • Overview
    • Prerequisites
    • Configuring the BerkeleyDBXML.xml File
      • The Berkeley Database Environment
      • The BerkeleyDBXML.xml Configuration File
      • How to Configure BerkeleyDBXML.xml
      • Open the Output Window
    • Naming Files
    • Opening a File Stored on Berkeley DB XML
    • Saving a File Back to Berkeley DB XML
    • Creating Containers with Stylus Studio
    • Usage Tips
  • Using Stylus Studio with TigerLogic XDMS
• Chapter 14: Extending Stylus Studio
• Chapter 15: Stylus Studio GUI Reference

Home > Online Product Documentation > Table of Contents > Configuring the BerkeleyDBXML.xml File

Configuring the BerkeleyDBXML.xml File

You need to configure the BerkeleyDBXML.xml file in order to be able to save XML documents back to a Berkeley DB XML container. Until you configure the BerkeleyDBXML.xml file as described in this section, any files you read from Berkeley DB XML are marked read-only and cannot be written back to Berkeley DB XML.

The Berkeley Database Environment

The Berkeley database has the concept of a database environment. The database environment is typically a directory that contains the log and lock files that provide support for transaction processing. This directory may also contain databases - files that contain user data. The containers in which Berkeley DB XML stores XML documents are examples of Berkeley databases and typically, though not always, have a .dbxml extension.

To be able to determine what database environments exist in Berkeley DB XML, and which ones are associated with which containers, you need to

These files are installed in the \bin\lib\sleepycat directory where you installed Stylus Studio ( c:\Program Files\Stylus Studio XML Professional Edition\bin\lib\sleepycat, for example).

The BerkeleyDBXML.xml Configuration File

The BerkeleyDBXML.xml configuration file contains elements that allow you to specify Berkeley DB XML database environments and directories:

A finished BerkeleyDBXML.xml configuration file might look like this:

<dbxml>
               
   <dbenv path="c:\dbenv1">
               
      <dbdir path="d:\datadir1"/>
               
      <dbdir path="e:\datadir2"/>
               
   </dbenv>
               
   <dbenv path="c:\testenv">
               
      <dbdir path="c:\testdata"/>
               
   </dbenv>
               
   <dbenv path="c:\testenv2"/>
               
</dbxml>
               

            

Omitting <dbdir> and <dbenv> elements

In some cases, it is not necessary do have any <dbdir> elements, as is illustrated by the <dbenv path="c:\testenv2"/> element in the example BerkeleyDBXML.xml configuration file. You can omit the <dbdir> element

If you use the DB_HOME environment variable to locate your database environment and all its data directories are listed in the DB_CONFIG file for that database environment, you can omit that database environment from the BerkeleyDBXML.xml configuration file. Indeed, if that is your only database environment, you do not need the BerkeleyDBXML.xml configuration file at all.

Specifying <dbdir> pathnames

Pathnames you specify for <dbdir> elements can be absolute or relative. Relative pathnames are relative to the enclosing <dbenv> pathname, not to your current working directory.

The validate attribute

In Berkeley DB XML Version 2.0.7 and 2.0.9, the <dbxml>, <dbenv>, and <dbdir> elements have a validate attribute that allows Sleepycat to validate XML documents before saving them to the Berkeley DB XML file system. See Validating Documents for more information on this topic.

How to Configure BerkeleyDBXML.xml

To configure BerkeleyDBXML.xml:

3. Click Validate Document .

You are ready to use Berkeley DB XML with Stylus Studio.

Open the Output Window

The first time you perform an operation on the Berkeley DB XML, Stylus Studio tries to process the BerkeleyDBML.xml file. As the file is processed, messages are written to the Stylus Studio Output window. These messages identify which database environments and directories are being processed. This can be a useful way to verify which directories Stylus Studio is associating with which database environment and identify when you might need to make a change in the BerkeleyDBXML.xml file.