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

ELOQUENCE B.08.30 - patch PE83-2206092

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

This patch adds enhancements or fixes defects of the dbrecover utility
as released with Eloquence B.08.30-1810. This patch will be integrated
in the Eloquence B.08.30 release.

Eloquence B.08.30-1810 must be installed before applying this patch.

Severity:
 PE83-2206092: BUG FIX

Superseded patches:
 PE83-2010201: BUG FIX
 PE83-1909131: BUG FIX
 PE83-1906241: BUG FIX


Patch PE83-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 PE83-2206090 or superseding (eloqdb database server)
  and PE83-2206091 or superseding (dblogreset utility) fix a
  related problem and should be installed with this patch.


Patch PE83-2010201
------------------

Platforms: All

* Fixed a potential panic which could occur when a data set is being
  restructured (#4324).

  dbrecover could abort with a message like below or similar:

  panic: Fatal problem detected in FixRec_FinalCommitUpdatePut
  Assertion failed: *flag_ptr == FixRec_USED || *flag_ptr == FixRec_DELETED


Patch PE83-1909131
------------------

Platforms: All

* Fixed a problem with consecutive point-in-time recovery (-T option).
  A point-in-time recovery updated the volume generation number and
  a subsequent recovery did not work correctly (#4304).


Patch PE83-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:

   PE83-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.3
gzip -dc /path/to/PE83-2206092-hpux.tar.gz | tar xf -

Files:

   bin/dbrecover
   share/doc/PE83-2206092-README


Linux:

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

cd /opt/eloquence/8.3
tar xzf /path/to/PE83-2206092-linux.tar.gz

Files:

   bin/dbrecover
   share/doc/PE83-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 PE83-2206092-win32.exe. Installation does not require a reboot
unless the patched files were active.

For a manual installation of the patch, please download the patch
file PE83-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.3\bin)

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

Files:

   dbrecover.exe
   PE83-2206092-README.txt