Backup Netcool/OMNIbus ObjectServer configmap

Learn about the structure of the configmap for the backup IBM® Tivoli® Netcool®/OMNIbus ObjectServer pod, ncobackup-agg-b. Edit this configmap to customize, and add custom automations and triggers to, the backup Netcool/OMNIbus ObjectServer, and to customize the operation of the bidirectional gateway that connects the primary and backup Netcool/OMNIbus ObjectServers.

Contents

Note: If you are migrating from an on-premises deployment to a cloud deployment, tabs in a gateway configmap file might cause errors. To avoid this issue, run the tr command on the customized configmap file to remove tabs before you migrate to a cloud deployment.
The following table lists the data elements that are contained in the backup Netcool/OMNIbus ObjectServer configmap:
Table 1. Data elements in the backup Netcool/OMNIbus ObjectServer configmap
Data elements Description More information

agg-b-props-append

Use this element to append a new property to the end of the Netcool/OMNIbus ObjectServer properties file on pod restart.

Netcool/OMNIbus 8.1 documentation: Using the ObjectServer properties and command-line optionsexternal link

agg-b-sql-extensions

Use this element to add a new SQL extension, such as a trigger or an automation, to the Netcool/OMNIbus ObjectServer on pod restart.

Netcool/OMNIbus 8.1 documentation: ObjectServer SQLexternal link

agg-gate-map-replace

The gateway map definition in this element replaces the definition in the pod (AGG_GATE.map) on pod restart.

Netcool/OMNIbus 8.1 documentation: Failover configurationexternal link

agg-gate-props-append

Properties that are listed in this element are appended to the gateway properties file prior on pod restart.

Netcool/OMNIbus 8.1 documentation: Common gateway properties and command-line optionsexternal link

agg-gate-startup-cmd-replace

The gateway startup command definition in this element replaces the definition in the pod (AGG_GATE.startup.cmd) on pod restart.

Netcool/OMNIbus 8.1 documentation: Startup command fileexternal link

agg-gate-tblrep-def-replace

The gateway table replication definition in this element replaces the definition in the pod (AGG_GATE.tblrep.def) on pod restart.

Netcool/OMNIbus 8.1 documentation: Table replication definition file

external link

Examples of each of the data elements in this configmap are provided.

Data element: agg-b-props-append

The following data element appends a MessageLevel: 'debug' property to the .props file of the backup Netcool/OMNIbus ObjectServer.
agg-b-props-append: |
  MessageLevel: 'debug'

Data element: agg-b-sql-extensions

The following data element adds a custom database containing a single table to the backup Netcool/OMNIbus ObjectServer.
agg-b-sql-extensions: | 
  -- create a custom db
  create database mydb; 
  go

  -- create a custom table        
  create table mydb.mytable persistent
  (
  col1 incr primary key,
  col2 varchar(255)
  );
  go

Data element: agg-gate-map-replace

The following data element replaces the definition in the pod (AGG_GATE.map).
  agg-gate-map-replace: |
    # My test map
    CREATE MAPPING StatusMap
    (
    'Identifier' = '@Identifier' ON INSERT ONLY,
    'Node'       = '@Node' ON INSERT ONLY
    );

Data element: agg-gate-props-append

The following data element is appended to the gateway properties file before startup.
  agg-gate-props-append: |
    MessageLevel: 'debug'
  agg-gate-startup-cmd-replace: |
    SHOW PROPS;

Data element: agg-gate-startup-cmd-replace

The gateway startup command definition in this data element replaces the definition in the pod (AGG_GATE.startup.cmd).
  agg-gate-startup-cmd-replace: |
    SHOW PROPS;

Data element: agg-gate-tblrep-def-replace

The Gateway table replication definition in this data element replaces the definition in the pod (AGG_GATE.tblrep.def).
  agg-gate-tblrep-def-replace: |
    # My test table replication
    REPLICATE ALL FROM TABLE 'alerts.status'
      USING MAP 'StatusMap';