DbEnv Descriptor Element

A dbenv element causes an IceGrid node to generate Freeze configuration properties for the server or service in which it is defined. The IceGrid node also creates a directory for the Berkeley DB database environment if needed.

This element may contain dbproperty elements.This element may only appear as a child of a server or service element.

The following attributes are supported:

Attribute

Description

Required

home

Specifies the directory to use as the database environment. If not defined, a sub-directory in the node's data directory is used.

No

name

The name of the Berkeley DB database environment.

Yes

The values of the name and home attributes are used to define the Freeze.DbEnv.env-name.DbHome property as shown below:

Freeze.DbEnv.name.DbHome=home

An optional nested description element provides free-form descriptive text.

Here is an example to demonstrate the use of this element:

XML
<dbenv name="MyEnv" home="/opt/data/db">
    <description>A description of the Freeze/BDB database environment.</description>
    ...
</dbenv>

See Also