---------------------------------------------------------------------- ELOQUENCE B.07.10 - patch PE71-0911091 ---------------------------------------------------------------------- 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-0911091: BUG FIX Superseded patches: PE71-0801241: ENHANCEMENT, BUG FIX PE71-0705301: ENHANCEMENT PE71-0702081: BUG FIX PE71-0610131: BUG FIX PE71-0609121: BUG FIX PE71-0606291: BUG FIX PE71-0602281: ENHANCEMENT Patch PE71-0911091 ------------------ Platforms: All * A forward-log bridge segment was not correctly restarted (#3883). When the dblogreset utility is used after an abnormal termination of the database server, it performs a startup recovery. During this process, a so called forward-log bridge segment is created that allows a dbrecover or dbrepl or fwutil process to continue across the previous abnormal termination. If for any reason the startup recovery is aborted so that the bridge segment is not completely created, the bridge segment should be restarted and completed on the next startup recovery. Due to an internal initialization problem, this did not work as intended. As a consequence, the dblogreset utility failed to start with a message like below if the bridge segment already exists: unable to create forward-log ... File exists (errno 17) Note: failed to restart forward-logging To solve this problem, the existing bridge segment must be manually deleted before starting the dblogreset utility. * Changed the Windows file version to "7.1.1.14" Notes / Related patches: - The following related patches (or superseding) should be installed with this patch: - PE71-0911090 - eloqdb6 server - PE71-0809151 - dbrecover utility 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 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" 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" 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" 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" 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" 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" 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" Installation: ------------- Please download the patch archive that corresponds with the installed release. The patch files follow the conventions below: PE71-0911091-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-0911091-hpux.tar.gz | tar xf - Files: bin/dblogreset share/doc/PE71-0911091-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-0911091-linux.tar.gz Files: bin/dblogreset share/doc/PE71-0911091-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-0911091-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-0911091-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-0911091-README.txt file into the share\doc subdirectory of your Eloquence installation (for example C:\Programs\Eloquence\share\doc). Files: dblogreset.exe PE71-0911091-README.txt