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

ELOQUENCE B.08.20 - patch PE82-1911200

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

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

Superseded patches:
 PE82-1908060: ENHANCEMENT
 PE82-1408210: BUG FIX (Windows)


Patch PE82-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.

* This patch updates the configuration file template (repl.cfg,
  Windows: repl.cfg.sam) to include the new BufferSize item
  introduced with patch PE82-1908060.


Patch PE82-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).


Patch PE82-1408210
------------------

Platforms: Windows

* Fixed an internal initialization problem where dbrepl could abort
  with a message like below if started on the command line (#4182):

  Assertion failed: win32_agg.allocated == -1, file gdebug.c, line 804


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

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

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

Files:

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

Files:

   bin/dbrepl
   newconfig/config/repl.cfg
   share/doc/PE82-1911200-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 autmatic installation of this patch, please download the patch
file PE82-1911200-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-1911200-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.2\bin)

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

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

Files:

   dbrepl.exe
   repl.cfg.sam
   PE82-1911200-README.txt