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

ELOQUENCE B.07.10 - patch PE71-0905120

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

This patch adds enhancements or fixes defects of the Eloquence 
dbfsck utility as released with Eloquence B.07.10. This patch 
will be integrated in the Eloquence B.07.10 release.

Eloquence B.07.10 must be installed before applying this patch.

Severity:
 PE71-0905120: ENHANCEMENT

Superseded patches:
 PE71-0809152: ENHANCEMENT
 PE71-0802121: ENHANCEMENT
 PE71-0705307: ENHANCEMENT


Patch PE71-0905120
------------------

Platforms: All

* The dbfsck memory requirement has been significantly reduced.
  This causes a noticable improvement of the pass 1 runtime and
  allows to use dbfsck on large database environments.

* Progress information has been added which is output when the
  -v command line option is specified. If enabled, progress info
  is output every minute to stdout.

  For example, the command line below redirects dbfsck messages
  to a log file while progress info is output to the terminal:

  dbfsck -v 2>dbfsck.log

  Example output:
  Processed 222437 of 556094 pages (40%)


Patch PE71-0809152
------------------

Platforms: All

* The dbfsck utility was enhanced to detect uninitialized BTREE pages.

  In rare cases, uninitialized BTREE pages may exist due to a previous
  database server crash. These pages do not harm database operation if
  the BTREE is otherwise consistent.

  The dbfsck utility now detects an uninitialized BTREE page as a
  nonfatal condition and outputs an informational message like below:

    Info: page ... has never been initialized.

  In addition, dbfsck enforces a full tree check on the affected BTREE
  to ensure that the index is structurally consistent.

* The dbfsck utility now outputs the number of free records in a data
  set where the corresponding record numbers are not located in the
  free-list. This should help to estimate whether or not it is worth
  the effort to run dbfsck in write-mode and fix the free-list for
  this specific data set.


Patch PE71-0802121
------------------

Platforms: All

* The dbfsck utility was changed to relax the FixRec consistency
  check on the first/last record meta information (#3524).

  Starting with eloqdb6 database server patch PE71-0802120, the
  first/last record meta data are no longer maintained to specify
  an exact record number but to provide a hint on lower/upper 
  record number boundaries.
  Due to this change previous dbfsck version might in some cases
  incorrectly report inconsistencies on the FixRec first/last 
  record meta data.
  dbfsck was relaxed to match the validation of this information
  with the server.


Patch PE71-0705307
------------------

Platforms: All

* The dbfsck utility was changed to retain additional
  status information in the volume files that is used by 
  replication.
  
  Older dbfsck versions did reset this information and 
  therefore could cause a problem when used with replication.


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

Please download the patch archive that corresponds with the installed
release.  The patch files follow the conventions below:

   PE71-0905120-hpux-ia64.tar.gz
        ^       ^    ^
        |       |    Architecture / OS specific build
        |       Operating system
        Patch ID


HP-UX:

In order to install this patch, you need to unpack it with gzip and tar.
Gzip is included with HP-UX. Installation requires root privileges.

cd /opt/eloquence6
gzip -dc /path/to/PE71-0905120-hpux.tar.gz | tar xf -

Files:

   bin/dbfsck
   share/doc/PE71-0905120-README


Linux:

In order to install this patch, you need to unpack it with tar.
Installation requires root privileges.

cd /opt/eloquence6
tar xzf /path/to/PE71-0905120-linux.tar.gz

Files:

   bin/dbfsck
   share/doc/PE71-0905120-README


Windows XP/2000/NT:

This patch should *only* be installed if you previously installed
the Eloquence server components on your system.
Installation requires administrative capabilities.

Two options are available for patch installation. The patch is
available as self extracting archive for automatic installation
and as a zip archive for manual installation. Both patches are
equivalent. Installation requires administrative capabilities.

For automatic installation of this patch, please download the patch
file PE71-0905120-win32.exe file. Before installation, please
consider closing all applications and execute the patch installation
program. Installation does not require a reboot unless the patched
files were active.

For a manual installation of the patch, please download the
patch file PE71-0905120-win32.zip file and unpack its contents.
Then perform the following steps:

* Please copy the dbfsck.exe file into the bin subdirectory of your
  Eloquence installation (for example C:\Programs\Eloquence\bin).

* Please copy the PE71-0905120-README.txt file into the share\doc
  subdirectory of your Eloquence installation (for example
  C:\Programs\Eloquence\share\doc).

Files:

   dbfsck.exe
   PE71-0905120-README.txt