Upgrading Berkeley DB XML Applications to 2.1

Upgrading existing containers

The database format has changed in Berkeley DB XML release 2.1 and existing containers created in a 2.0-based application must be upgraded. In addition, applications must be recompiled in order to work with Berkeley DB XML release 2.1.

Upgrading existing containers

Existing containers can be upgraded in one of two ways. Using the dbxml shell facility, or using the XmlManager::upgradeContainer() method. The shell program method is simpler.

Once the installation is built, these steps can be used to perform the upgrade:

  1. Make a backup copy of your container.

  2. Assuming the dbxml program is in your PATH, type dbxml.

  3. dbxml> upgradeContainer <pathToContainer>

  4. dbxml> quit

The upgrade may take a few minutes, depending on the size of your container. You can check to see if the upgrade was successful by opening the container with the openContainer sub-command in dbxml.