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

ELOQUENCE B.07.10 - patch PE71-0903300

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

This patch adds enhancements or fixes defects of the dbrepl utility
for Eloquence B.07.10. This patch will be integrated in the 
Eloquence B.07.10 release.

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

Severity:
 PE71-0903300: ENHANCEMENT

Superseded patches:
 PE71-0705303: ENHANCEMENT


Patch PE71-0903300
------------------

Platforms: All

* The dbrepl utility now issues an additional exit code 3 in case
  a connection problem is detected, for example if the replication
  slave server is temporarily unavailable.

  The exit codes issued by dbrepl are:
  
  0 - successful execution, graceful exit

      (will only be issued if the -S or -G command line option is
      used and dbrepl executed normally until the existing log or
      the current generation has been processed) 

  1 - failure, typically requires manual intervention

      (for example, a configuration problem on the replication
      master or slave servers)

  2 - invalid or -help command line option

      (the command line usage was output)

  3 - connection problem

      (could not connect or lost the connection to the replication
      slave server)

  Exit code 3 may be used in a script to retry the dbrepl invocation.
  Preferably, repeated invocations should be appropriately delayed,
  for example by sleeping 60 seconds between two invocations.

* The dbrepl utility could not easily be used through a SSH tunnel
  because the underlying Eloquence database client library would
  always establish an IPC connection to the database server whenever
  the localhost address is used.

  However, since an IPC connection uses shared memory to communicate
  with the database server, it would not work through a SSH tunnel.

  To solve this, the EQ_DBENABLEIPC environment variable may be set
  to zero (EQ_DBENABLEIPC=0), which will enforce a TCP network
  connection even if the localhost address is used.

* The dbrepl utility did not recognize some configuration items that
  were recently added to the database server configuration.

  If an unknown configuration item was encountered, a warning message
  could be issued, for example:

  Unknown configuration entry, ignored: "TRANSACTIONSIZELIMIT"

* If the -v command line option is specified, this now implies the
  log flag R1. Therefore it is no longer necessary to use the -d
  command line option in addition to -v to set the R1 log flag.


Patch PE71-0705303
------------------

Platforms: All

* This patch adds the dbrepl utility to Eloquence B.07.10 that
  is used to replicate database transactions to other database 
  environments.

  For documentation please refer to the Eloquence web site:
  http://www.marxmeier.com/eloquence/support/B0710/doc/repl/


Notes / Related patches:

- The following related patches (or superseding) should be installed 
  with this patch:
  - PE71-0705300 - eloqdb6 server
  - PE71-0705301 - dblogreset utility
  - PE71-0705231 - fwaudit utility


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

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

   PE71-0903300-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/eloquence6
gzip -dc /path/to/PE71-0903300-hpux.tar.gz | tar xf -

Files:

   bin/dbrepl
   share/doc/PE71-0903300-README


Linux:

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

cd /opt/eloquence6
tar xzf /path/to/PE71-0903300-linux.tar.gz

Files:

   bin/dbrepl
   share/doc/PE71-0903300-README


Windows XP/2000/NT:

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

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 PE71-0903300-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 PE71-0903300-win32.zip and unpack its contents.
Then perform the following steps:

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

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

Files:

   dbrepl.exe
   PE71-0903300-README.txt