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

ELOQUENCE B.08.30 - patch PE83-2206091

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

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

Superseded patches:
 PE83-2204051: BUG FIX


Patch PE83-2206091
------------------

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-2206092 or superseding (dbrecover utility) fix a
  related problem and should be installed with this patch.


Patch PE83-2204051
------------------

Platforms: All

* Fixed two potential problems related to creating or resuming on the
  forward-log "bridge" segment during startup recovery or using the
  dblogreset utility (#4341).

  After an abnormal termination, the database server (or the dblogreset
  utility) performs a startup recovery. During this process, a special
  forward-log "bridge" segment is created that allows a dbrecover,
  dbrepl or fwutil process to continue across the previous abnormal
  termination.

  If more than one forward-log segment is created during a checkpoint
  interval, and if the eloqdb then terminates abnormally, a following
  startup recovery (or the dblogreset utility) could choose a wrong
  forward-log segment number for the "bridge" segment.

  As a consequence, the recovery could fail with a log message like:

  failed to restart forward-log file '...': Fwr_SERIAL record expected

  If multiple forward-log "bridge" segment files are created during
  the startup recovery (or by the dblogreset utility) and the recovery
  is interrupted and then repeated it would be unable to handle already
  existing "bridge" segment files.

  In this case, forward-logging could be disabled unexpectedly with
  a log message like:

  unable to create forward-log '...': File exists (errno 17)
  Note: forward-logging has been disabled due to failure

Notes / Related patches:

* Patch PE83-2204050 or superseding (eloqdb database server) fixes a
  related problem and should be installed with this patch.


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

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

   PE83-2206091-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-2206091-hpux.tar.gz | tar xf -

Files:

   bin/dblogreset
   share/doc/PE83-2206091-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-2206091-linux.tar.gz

Files:

   bin/dblogreset
   share/doc/PE83-2206091-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-2206091-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-2206091-win32.zip and unpack its contents. Then perform
the following steps:

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

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

Files:

   dblogreset.exe
   PE83-2206091-README.txt