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

ELOQUENCE B.08.20 - patch PE82-2206092

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

This patch adds enhancements or fixes defects of the dbrecover
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-2206092: BUG FIX

Superseded patches:
 PE82-1906241: BUG FIX


Patch PE82-2206092
------------------

Platforms: All

* Fixed a problem which in rare cases could cause a recovery or
  replication to fail after database restructuring (#4345).

  When a data set has been restructured, its meta data was not
  updated immediately. Under certain conditions this could cause
  a subsequent panic during recovery or on a slave server:

  D0: server panic: Fatal problem detected in FixRec_FinalCommitUpdateRange
  D0: Assertion failed: range_offset + range_size < (int)meta->rec_size

Notes / Related patches:

* Patches PE82-2206090 or superseding (eloqdb database server)
  and PE82-2206091 or superseding (dblogreset utility) fix a
  related problem and should be installed with this patch.


Patch PE82-1906241
------------------

Platforms: All

* Fixed a problem where under rare conditions dbrecover could abort
  with a message like below while processing a large transaction (#4292):

  Fwr_PageHashAdd() failed: key ... already present ...
  server panic: Fatal problem detected in Fwr_PageHash__Add
  Assertion failed: Fwr_PageHashAdd() failed: key already present


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

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

   PE82-2206092-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-2206092-hpux.tar.gz | tar xf -

Files:

   bin/dbrecover
   share/doc/PE82-2206092-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-2206092-linux.tar.gz

Files:

   bin/dbrecover
   share/doc/PE82-2206092-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-2206092-win32.exe. Before installation, please consider
closing all applications, 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-2206092-win32.zip and unpack its contents. Then perform
the following steps:

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

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

Files:

   dbrecover.exe
   PE82-2206092-README.txt