----------------------------------------------------------------------
ELOQUENCE B.07.10 - patch PE71-0801241
----------------------------------------------------------------------
This patch adds enhancements or fixes defects of the dblogreset utility
as released with 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-0801241: ENHANCEMENT, BUG FIX
Superseded patches:
PE71-0705301: ENHANCEMENT
PE71-0702081: BUG FIX
PE71-0610131: BUG FIX
PE71-0609121: BUG FIX
PE71-0606291: BUG FIX
PE71-0602281: ENHANCEMENT
Patch PE71-0801241
------------------
Platforms: All
* The dblogreset utility was modified to use a default cache size
of 5 MB (#3499). Previously dblogreset used the cache size
configured in the database configuration file. This could
result in problems on HP-UX if insufficient address space
was available.
* Added a new command line option -b <size> to specify the
buffer cache size (in MB).
Platforms: HP-UX and Linux
* The dblogreset utility was enhanced to support a new configuration
option to enable read access on forward-log files for the group
(GID) specified in the database server configuration file (#3475).
By default the dblogreset utility creates any forward-log files
with restrictive permissions that only allow the configured user
(and the superuser) to access the forward-log files.
The new [forwardlog] GroupReadAccess configuration option may be
used to specify read access for the configured group to the
forward-log files.
# [forwardlog]
# GroupReadAccess = 0|1
If set to a nonzero value forward-log files are created with a
permission that allows group read access (configured with the
[Server] GID option). If set to zero forward log files are created
with a permission to restrict access to the owner (configured
with the [Server] UID option).
The default value is 0 to permit owner access only.
Platforms: Windows
* Changed the Windows file version to "7.1.1.12"
Notes / Related patches:
- The following related patches (or superseding) should be installed
with this patch:
- PE71-0801240 - eloqdb6 server
- PE71-0801242 - dbrecover utility
Patch PE71-0705301
------------------
Platforms: All
* The dblogreset utility was enhanced to retain a forward-log in
case of a recovery after an abnormal termination of the database
server.
Previous releases disabled an existing forward-log in such a
situation so that it became necessary to create a new backup.
* Changed the Windows file version to "7.1.1.11"
Notes / Related patches:
- The following related patches (or superseding) should be installed
with this patch:
- PE71-0705300 - eloqdb6 server
- PE71-0705302 - dbrecover utility
- PE71-0705231 - fwaudit utility
Patch PE71-0702081
------------------
Platforms: All
* Aborting on-line backup mode recovery could result in data
corruption (#3279).
The server process (or the dblogreset utility) performs a recovery
from on-line backup on startup if the server was previously shut down
while in on-line backup. This recovery transfers any changes
temporarily stored in the log volume(s) during the on-line backup
mode to the data volume(s). Depending on the amount of data
that was saved in the log volume(s) and disk performance this
could take some time.
If this recovery was interrupted (or aborted for some reason) in
some cases this recovery could not be re-run afterwards because
the generation count of the data volume would differ from the
log volume(s) generation count.
In this case the data volume is corrupted as the changes were
only partially transferred.
* Changed the Windows file version to "7.1.0.10"
Notes / Related patches:
- The following related patches (or superseding) should be installed
with this patch:
- PE71-0702080 - eloqdb6 server
- PE71-0610132 - dbrecover utility
- PE71-0608010 - fwaudit utility
Patch PE71-0610131
------------------
Platforms: All
* A rare defect was fixed that could result in a crash of the dblogreset
utility while recovering from a previously active on-line backup (#3217).
A message like below is output:
Assertion failed: page_addr < vol->curr_size
file volume.c, line 6183
This problem could happen if during on-line backup the data volume was
virtually extended and the volume list of available blocks had to be
extended as well (this is required around every 500 MB). When on-line
the server was shutdown while on-line backup was active and then the
dblogreset utility was used, the stored free-list information was then
applied in a wrong way.
This problem was introduced with changes to the recovery code in the
previous patch PE71-0609121.
* Changed the Windows file version to "7.1.0.9"
Notes / Related patches:
- The following related patches (or superseding) should be installed
with this patch:
- PE71-0610130 - eloqdb6 server
- PE71-0610132 - dbrecover utility
- PE71-0608010 - fwaudit utility
Patch PE71-0609121
------------------
Platforms: All
* The dblogreset utility was modified to implement the equivalent
recovery procedure of eloqdb6 patch PE71-0609120.
* Changed the Windows file version to "7.1.0.8"
Notes / Related patches:
- The following related patches (or superseding) should be installed
with this patch:
- PE71-0609120 - eloqdb6 server
- PE71-0609122 - dbrecover utility
- PE71-0608010 - fwaudit utility
Patch PE71-0606291
------------------
Platforms: All
* The dblogreset utility was modified to add support for the modified
transaction journal format added with eloqdb6 patch PE71-0606290.
* Changed the Windows file version to "7.1.0.7"
Notes / Related patches:
- The following related patches (or superseding) should be installed
with this patch:
- PE71-0606290 - eloqdb6 server
- PE71-0606292 - dbrecover utility
- PE71-0606293 - fwaudit utility
Patch PE71-0602281
------------------
Platforms: All
* The dblogreset utility was modified to add support for the modified
forward-log file format added with eloqdb6 patch PE71-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.
* Changed the Windows file version to "7.1.0.6"
Notes / Related patches:
- The following related patches (or superseding) should be installed
with this patch:
- PE71-0602280 - eloqdb6 server
- PE71-0602282 - dbrecover utility
- PE71-0602283 - fwaudit utility
Installation:
-------------
Please download the patch archive that corresponds with the installed
release. The patch files follow the conventions below:
PE71-0801241-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-0801241-hpux.tar.gz | tar xf -
Files:
bin/dblogreset
share/doc/PE71-0801241-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-0801241-linux.tar.gz
Files:
bin/dblogreset
share/doc/PE71-0801241-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-0801241-win32.exe file. Before installation, please
consider closing all applications and 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-0801241-win32.zip file and unpack its contents.
Then perform the following steps:
* Please copy the dblogreset.exe file into the bin subdirectory of your
Eloquence installation (for example C:\Programs\Eloquence\bin).
* Please copy the PE71-0801241-README.txt file into the share\doc
subdirectory of your Eloquence installation (for example
C:\Programs\Eloquence\share\doc).
Files:
dblogreset.exe
PE71-0801241-README.txt