Setting configuration parameters

You set configuration parameters that control database server behavior in the onconfig file. The onconfig file is a text file that you create based on a template file. The onconfig file contains many configuration parameters, but most have default values and can be set while the database server is running.

About this task

Use the template configuration file, onconfig.std, as a basis for your configuration file. The onconfig.std file contains most configuration parameters set to default values. The onconfig.std file is in the $ONEDB_HOME/etc directory (UNIX, Linux) or %ONEDB_HOME%\etc (Windows) directory.

Important: Do not modify or delete the onconfig.std file, which is a template and not a functional configuration.


To create an onconfig file and set the mandatory configuration parameters:
  1. Copy the onconfig.std template file and save the file with a unique name, such as onconfig.servername, in the $ONEDB_HOME/etc directory (UNIX, Linux) or %ONEDB_HOME%\etc (Windows) directory.
  2. Modify your onconfig file.
    You can use several different methods to edit the onconfig file, including using a text editor.

    At minimum, set the following configuration parameters:

    • DBSERVERNAME: Set to the name of the database server.
    • ROOTPATH: Set to the location of the root dbspace, which contains control and tracking information for the database server.
    • SERVERNUM: Set to a unique number for the database server. If you do not have another database server on the same computer, you can leave the default value of 0.
    • LICENSE_SERVER: Set to the License Server URL used to obtain the necessary licenses to run Informix


When you set environment variables, set the ONCONFIG environment variable to the name of your customized configuration file.

If you omit a parameter value in your copy of the configuration file, the database server either uses default values from the onconfig.std template file or calculates values based on other parameter values.