HP Eloquence A.06.20 / Release Notes

HP Eloquence database off-line utilities

This document provides a detailed description on enhancements and changes related to the HP Eloquence database (off-line) utilities.

dbvolextend
dbvolchange

dbvolextend

If your log volumes are lost (e.g. due to a disk failure) and your database was shut down cleanly or you are recovering from an on-line backup dbvolextend can now be used to re-create any missing log volume(s). Execute dbvolextend -t log /path/to/logvol for each missing log volume file.

Suppose your database environment was configured to use two log volumes named /db/log/log01.vol and /db/log/log02.vol. The following commands can be used to re-create the log volumes.

 dbvolextend -t log /db/log/log01.vol
 dbvolextend -t log /db/log/log02.vol

Since all log volume properties (like min. or max. size) are not recovered you may need to specify additional options to dbvolextend or use dbvolchange to modify volume properties. You can use dbvoldump to display volume information.

After the log volume(s) are re-created, you can start the eloqdb6 server process.

Please note: If your database was not shut down cleanly and your log volume is lost, you are loosing data and your database may be damaged.

On-line backup

Database utilities which modify the data volume can not be used immediately if the eloqdb6 server was shut down or crashed while in on-line backup mode. The log information (all committed transactions since entering on-line backup mode) have been temporarily stored in the log volume and must be recovered before database utilities may be allowed to modify the data volume. Otherwise all transactions pending since starting the on-line backup would be lost.

In this specific case the following message is output:

 NOTE: Database environment has been shutdown during 
       on-line backup. Please restart the database server 
       once in order to recover from on-line backup mode, 
       then reapply this command.

To recover the information from the log volume, please either run dblogreset or start the eloqdb6 server. Afterwards you can use the dbvolextend utility program as planned.

A detailed description how to backup your HP Eloquence database is available in the Database backup document.

dbvolchange

The database by default now operates in (the more reliable) sync mode which provides additional protections against a system failure. Previous versions used (the faster) async write mode by default. Given sufficient disk performance, the performance improvements with the A.06.20 eloqdb6 made it possible to use the sync mode by default.

Changes

The -f flags option to dbvolchange is no longer present. The eloqdb6 write mode can now be configured in the eloqdb6.cfg configuration file.

Usage

usage: dbvolchange/dbvolchange [options] volume_file_name
options:
 -v        - verbose
 -d flags  - debug flags
 -c cfg    - configuration file name
 -e sz     - Extension size
 -m sz     - Max volume size