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

ELOQUENCE B.07.00 - patch PE70-0602281

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

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

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

Severity:
 PE70-0602281: ENHANCEMENT

Superseded patches:
 PE70-0512061: CRITICAL (potential data loss)
 PE70-0408311: BUX FIX
 PE70-0401161: BUX FIX
 PE70-0401131: BUX FIX
 PE70-0307163: BUX FIX


Patch PE70-0602281
------------------

Platforms: All

* The dblogreset utility was modified to add support for the modified
  forward-log file format added with eloqdb6 patch PE70-0602280.
 
  The eloqdb6 server process was enhanced to use a more efficient 
  format to record index and meta data changes. 
  This enhancement results in a substantial reduction in disk space
  for the forward-log file when index entries are changed frequently.
 
  This change required a modification of the forward-log file format.
  While older forward-log files are still supported, related utility
  programs need to be updated to handle the new format.


Notes / Related patches:

- The following related patches (or superseding) should be installed 
  with this patch:
  - PE70-0602280 - eloqdb6 server
  - PE70-0602282 - dbrecover utility


Patch PE70-0512061
------------------

Platforms: All

* A problem was fixed that could potentially result in data loss 
  when the eloqdb6 server was shutdown while in on-line backup 
  mode and forward logging is used (#2936).

  This patch aligns the recovery procedure with the changes in the
  eloqdb6 patch PE70-0512060.


Notes / Related patches:

- This patch (or superseding) should be installed when using the 
  corresponding eloqdb6 patch PE70-0512060.


Patch PE70-0408311
------------------

Platforms: All

* The recovery operations in dblogreset have been aligned with
  the changes in eloqdb6 patch PE70-0408310.

This patch (or newer) should be installed when using the corresponding 
eloqdb6 patch PE70-0408310.


Patch PE70-0401161
------------------

Platforms: All

* dblogreset after a previous abort of the eloqdb6 server process
  could fail to release some disk space (#2048).

  In case the eloqdb6 process has aborted, dblogreset performs a
  recovery operation before resetting the transaction log volume.
  Disk space that was freed during the recovery operation could
  in some cases not be marked as avaialable by dblogreset. The
  dblogreset utility has been fixed accordingly.

* The recovery operations in dblogreset have been aligned with
  the changes in eloqdb6 patch PE70-0401160.

This patch (or newer) should be installed when using the corresponding 
eloqdb6 patch PE70-0401160.


Patch PE70-0401131
------------------

Platforms: All

* dblogreset was fixed to handle a situation where the database server
  has aborted during a dbrestore operation. dblogreset now checks for
  a corner case that could result in a circular page link in the server
  node directory (#2186).

  In case a circular page link in the server node directory is recognized
  an informational message like below is output:
  N1: Node_CommitNodePage(page=0xe396): page is already present - ignored


Patch PE70-0307163
------------------

Platforms: All

* dblogreset was fixed to handle a situation where the database server
  has crashed. In this case dblogreset performs a recovery of recently
  committed transactions.
  A rare corner case could lead to (unused) data blocks linked to a table
  but not marked in use. This could lead to subsequent data corruption.


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

UNIX:

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

cd /opt/eloquence6
gzip -dc /path/to/PE70-0602281-hpux.tar.gz | tar xf -

Files:

   bin/dblogreset
   share/doc/PE70-0602281-README


Windows XP/2000/NT:

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

Download the PE70-0602281-win32.zip file and unpack its contents
with WinZip or PKUNZIP.
Installation requires administrative capabilities.

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

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

Files:

   dblogreset.exe
   PE70-0602281-README.txt