Configuring the properties file

Before running the gateway for the first time, you must configure the installed properties file.

Note: You can configure the gateway to operate in one of two modes of operation: standard mode or IBM Operations Analytics - Log Analysis (LA) mode.

To configure the properties file on UNIX and Linux® operating systems, follow these steps:

  1. Copy the appropriate properties file as follows:
    1. If you are running the gateway in standard mode, copy the properties file $OMNIHOME/gates/xml/G_XML.props to $OMNIHOME/etc.
    2. If you are running the gateway in LA mode, copy the properties file $OMNIHOME/gates/xml/scala/G_SCALA.props to $OMNIHOME/etc.
  2. Make a backup copy of the G_XML.props or G_SCALA.props properties file before making any edits.
  3. Edit the properties in the G_XML.props or G_SCALA.props properties file to suit your operating environment.

To configure the properties file on Windows operating systems, follow these steps:

  1. Copy the appropriate properties file as follows:
    1. If you are running the gateway in standard mode, copy the properties file %OMNIHOME%\gates\xml\G_XML.props to %OMNIHOME%\etc.
    2. If you are running the gateway in LA mode, copy the properties file %OMNIHOME%\gates\xml\scala\G_SCALA.props to %OMNIHOME%\etc.
  2. Make a backup copy of the G_XML.props or G_SCALA.props properties file before making any edits.
  3. Edit the properties in the G_XML.props or G_SCALA.props properties file to suit your operating environment.
Note: If you are running the gateway in standard mode, pay particular attention to the Gate.XMLGateway.MessageID property defined in the $OMNIHOME/gates/xml/G_XML.props file. The default value for this property is netcoolEvents, which causes all events from the ObjectServer to be sent using the transformer named netcoolEvents in the transformer definition file. You can set the Gate.XMLGateway.MessageID property to either the name of another transformer (and therefore to always use that transformer definition file to transform and send the events), or to the name of an ObjectServer field which will contain the identifier to be used in the transformer definition file. This is done using the following notation: @FieldName.