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

ELOQUENCE B.08.20 - patch PE82-2112010

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

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

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

Severity:
 PE82-2112010: BUG FIX

Superseded patches:
 none


Patch PE82-2112010
------------------

Platforms: All

* Allow to truncate a node block-list in case it is corrupted.

  Related dbfsck messages:
    ulist.tail points to page ... (ulist.head is 0)
    ulist.tail points to page ... (real last page of block-list is ...)
    ulist.num_pages is ... (real number of pages in block-list is ...)
      This problem cannot be fixed by dbfsck.

  Truncating a block-list causes data loss and internal page leaks
  but may be inevitable to recover data when a backup does not exist.


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

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

   PE82-2112010-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/eloquence/8.2
gzip -dc /path/to/PE82-2112010-hpux.tar.gz | tar xf -

Files:

   bin/dbfsck
   share/doc/PE82-2112010-README


Linux:

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

cd /opt/eloquence/8.2
tar xzf /path/to/PE82-2112010-linux.tar.gz

Files:

   bin/dbfsck
   share/doc/PE82-2112010-README


Windows:

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 PE82-2112010-win32.exe. Before installation, please consider
stopping the database server, then 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 PE82-2112010-win32.zip and unpack its contents. Then perform
the following steps:

* Please copy the dbfsck.exe file into the Eloquence bin directory.
  (Default location: C:\Program Files\Eloquence\8.2\bin)

* Please copy the dbfsck64.exe file into the Eloquence bin64 directory.
  (Default location: C:\Program Files\Eloquence\8.2\bin64)

* Please copy the PE82-2112010-README.txt file into the Eloquence
  share\doc directory.
  (Default location: C:\Program Files\Eloquence\8.2\share\doc)

Files:

   dbfsck.exe
   dbfsck64.exe
   PE82-2112010-README.txt