Environment-Specific Parameters
Additional Provider Library Parameters
About this task
The cluster library has an arbitrary number of additional parameters, see Provider Library Parameters — Codership Documentation. These parameters are read during the startup of the Adabas nucleus and used to initialize the library. The following possibilities are described in this chapter.
Setting an environment variable
The environment variable CLUSTER _OPTIONS is used if specified.
Example:
In the following example, the size of gcache is set to 1024 megabytes:
CLUSTER_OPTIONS=gcache.size=1024M
Setting the DB_PARAMETER topic of the file DBnnn.INI
The entries under the topic CLUSTER_OPTIONS in the DBnnn.INI file are used if set.
Example:
[DB_PARAMETER]
[CLUSTER_OPTIONS]
gcache.size =1024M
gcache.page_size =128M
[CLUSTER_OPTIONS-END]
[DB_PARAMETER-END]
The entries under the topic CLUSTER_EVENT in the DBnnn.INI file are used if set.
When the nucleus detects a lost quorum, the Adabas utility ADANUC submits the executable specified in the ACTION_ROUTINE. The ACTION_ROUTINE is only submitted if ACTION=YES and LOST_QUORUM=YES.
Likewise, in the case of a change of primary node, ADANUC submits the ACTION_ROUTINE if ACTION=YES and PRIMARY_NODE_SWITCH=YES.
The executable can be a script or any other binary file, but it must include the full path.
The item ACTION in the topic NODE_PARAMETER, subtopic ANALYSER must be set to YES in order to activate Adabas extended operation. For information about configuring databases in an AEO environment, refer to Adabas for Linux and Cloud > Adabas Extended Operation > Configuration Files.
Example:
[DB_PARAMETER]
[CLUSTER_EVENT]
ACTION = <YES/NO>
ACTION_ROUTINE = <action routine> ada_clualrt
LOST_QUORUM = <YES/NO>
PRIMARY_NODE_SWITCH = <YES/NO>
[CLUSTER_EVENT-END]
[DB_PARAMETER-END]
Setting in the NUCPARMS section of the file DBnnn.INI
The nucleus parameter CLUSTER_OPTIONS is used if set.
This can be an entry under the topic NUCPARMS in the DBnnn.INI file as well.
Example:
[NUCPARMS]
CLUSTER_OPTIONS=gcache.size=1G
[NUCPARMS-END]
Note:
The ADAINI utility has been extended to understand the topic as well as the item CLUSTER_OPTIONS. This includes allowing a dot (.) in the item name.