----------------------------------------------------------------------

HP ELOQUENCE A.06.01 - patch 980331

----------------------------------------------------------------------

This patch provides the dbfsck utility for HP Eloquence. 
It can be installed with HP Eloquence release to A.06.01 and A.06.00.

The dbfsck utility checks a database volume for internal consistency
and provides a fix for trivial problems. It can be used to check the
consistency of your data base environment in case of a system 
failure. This can be used to recover your data if the data base server 
crashes during transaction log recovery (you have a current backup, no?)

Checks performed:

 * PASS 1 - Block allocation integrity
    - Are all blocks associated with a node (equivalent to a file
      or index) marked in use
    - Are blocks only associated with one node

 * PASS 2 - Node integrity
    - Check Btree pages for corruption
    - Check Fixrec pages for possible corruption
    - Check consistency of Fixrec Free list and meta data
 
Problems fixed:

 * Mark block in use
 * Fix Fixrec Free Record list and FixRec meta data


Usage: 

dbfsck runs in Read-Only mode by default. Unless a eloqdb6.cfg 
file is specified on the commandline, the default one is used.
the eloqdb6 data base server may not be active when using the
dbfsck utility.

After a data base server process failure or a system failure
inconsistencies may be detected, because the transaction log 
has not been recovered. This is not unusual. After applying the
transaction logs, e.g. by restarting the data base server or
using the dblogreset utility, no inconsistencies should be detected.

It is neither recommended nor supported to use the dbfsk utility
in write mode.

usage: dbfsck [options]
options:
 -d flags   - Debug flags
 -c cfg     - Configuration file name
 -b size    - Buffer cache size (MB)
 -v         - Provide additional run-time information

write options:
 -w         - Allow write
 -a         - Automatically fix minor inconsistencies
 -y         - Answer yes to all questions

Please Note: Enabling write and answering 'yes' to non-trivial
questions may cause data loss and could even result in additional
data corruption. Unless you know what you're doing, you should 
consider to recover the database from the backup in this case.


Installation:
-------------

UNIX:

In order to install the patch, you need to unpack it with gzip.
Gzip is included with Linux and HP-UX 10.x and can be obtained
for HP-UX 9.x from this ftp server in the /pub directory.
Installation requires root privileges.

cd /opt/eloquence6
gzip -dc hpux-980331.tar.gz | tar xf -

Files:

   bin/dbfsck
   share/doc/README-980331

Windows:

The dbfsck.exe file should *only* be installed, if you previously
installed the HP Eloquence server components on your system.

Download the win32-980331.zip file and unpack with WINZIP or PKZIP.
Installation requires administrative capabilities. Copy the dbfsck.exe
file to the bin subdirectory of the HP Eloquence installation directory,
e.g. C:\Program Files\Hewlett Packard\HP Eloquence\bin.

Files:

   dbfsck.exe
   README-980331.txt