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

ELOQUENCE B.08.30 - patch PE83-2302102

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

This patch adds enhancements or fixes defects of the dbrepl 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-2302102: ENHANCEMENT

Superseded patches:
 PE83-2211100: BUG FIX
 PE83-1911200: BUG FIX
 PE83-1908060: ENHANCEMENT


Patch PE83-2302102
------------------

Platforms: All

* Added an emergency recovery option.


Patch PE83-2211100
------------------

Platforms: All

* Fixed a race condition which could cause dbrepl to unexpectedly
  abort with a message like below:

  End-of-file: next forward-log segment ... does not match - aborting

  When encountering end-of-file while reading a forward-log file,
  dbrepl checks whether a subsequent forward-log segment is present.
  Under rare conditions this could impose a race condition, more data
  could be pending in the current forward-log segment.


Patch PE83-1911200
------------------

Platforms: All

* Fixed a problem which could cause dbrepl to endlessly wait for
  new data although no progress can be made.

  For example, a power failure on a master server can cause an
  unexpected truncation of the current forward-log segment so
  that the last checkpoint would be missing. If this happens,
  dbrepl will now abort instead of waiting for that checkpoint
  which will never arrive.

  Also, dbrepl now aborts if an expected forward-log file is
  missing but the next file is present.

* Fixed a problem where setting the Compression item in a
  configuration file had no effect (#4310).

* This patch updates the newconfig/config/repl.cfg configuration
  file template to include the new BufferSize item introduced with
  patch PE83-1908060.


Patch PE83-1908060
------------------

Platforms: All

* The dbrepl communication buffer size is now configurable.
  Previously, the communication buffer size was 32000 bytes.

  A higher buffer size may improve replication throughput in high
  latency network environments. Network latency limits the number
  of client/server transactions per second. For example, a latency
  of 20 ms means a maximum of 50 transactions per seconds, which
  in turn limits replication throughput to 1.6 MB per second given
  the default buffer size (50 * 32000 bytes).

  In such a case, configuring a higher buffer size can help to
  utilize the available network bandwidth.

  The buffer size may be configured using the -B command line option
  or the BufferSize item if a configuration file is used.

  The size is specified in bytes. The k or m suffix may be used to
  specify the size in kilobytes (1024) or megabytes (1048576).
  The default buffer size is 32000 bytes. The maximum buffer size
  is 1048576 bytes (1M).


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

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

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

Files:

   bin/dbrepl
   newconfig/config/repl.cfg
   share/doc/PE83-2302102-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-2302102-linux.tar.gz

Files:

   bin/dbrepl
   newconfig/config/repl.cfg
   share/doc/PE83-2302102-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-2302102-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-2302102-win32.zip and unpack its contents. Then perform
the following steps:

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

* Please copy the repl.cfg file into the Eloquence newconfig\config
  directory.
  (Default location: C:\Program Files\Eloquence\8.3\newconfig\config)

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

Files:

   dbrepl.exe
   repl.cfg
   PE83-2302102-README.txt