Home
AdministeringIn addition to administering the database server, you can tune performance, replicate data, and archive data.
System administrationThese topics contain concepts, procedures, and reference information for database and database server administrators to use for managing and tuning HCL OneDB™ database servers.
Administrator's ReferenceThe HCL OneDB™ Administrator's Reference includes comprehensive descriptions of HCL OneDB™ configuration parameters, the system-monitoring interface (SMI) tables in the sysmaster database, the syntax of database server utilities such as onmode and onstat, logical-log records, disk structures, event alarms, and unnumbered error messages.
Configuring and monitoring HCL OneDB™
Database configuration parametersThe HCL OneDB™ database server uses a configuration file, which is called the onconfig file, during initialization. This file contains default configuration parameter values. You can modify the parameter values to improve performance and other characteristics of the instance or database.
CONVERSION_GUARD configuration parameterUse 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.

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.

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box.