CONVERSION_GUARD configuration parameter

Use the CONVERSION_GUARD configuration parameter to specify whether HCL OneDB™ stops or continues an upgrade to a new version of the server if an error occurs during the upgrade process.

onconfig.std value
CONVERSION_GUARD 2
values
0 = Disabled.

1 = Enable a restore point as part of the upgrade process, and stop the upgrade if an error related to capturing restore point data occurs.

2 = Enable a restore point as part of the upgrade process, and continue the upgrade even if an error related to capturing restore point data occurs.

units
Integer
takes effect
When the database server is restarted

Usage

By default:
  • The CONVERSION_GUARD configuration parameter is on (set to 2). If an upgrade to the new version of the server fails, you can use the onrestorept utility to restore your data.
  • The server stores the restore point data in the $ONEDB_HOME/tmp directory.

If the CONVERSION_GUARD configuration parameter is set to 1 or 2 and the upgrade to the new version of the server fails, you can use the onrestorept utility to restore your data.

If the CONVERSION_GUARD configuration parameter is set to 2 and conversion guard operations fail (for example, because the server has insufficient space to store restore point data), and the upgrade fails, you cannot use the onrestorept utility to restore your data.

You can change the value of the CONVERSION_GUARD configuration parameter or change the directory specified in the RESTORE_POINT_DIR configuration parameter before starting the server that initiates an upgrade to a new version of the server. You cannot change the CONVERSION_GUARD or RESTORE_POINT_DIR values during an upgrade.