Configuring the gateway

After installing the gateway you need to make various configuration settings to suit your environment.

Table 1 lists gateway configuration tasks. For each configuration task, the table lists the properties you use with that task, and the section in this guide that shows you how to complete the configuration task.

Some configuration tasks are mandatory for all installations. For those configuration tasks set the properties to the correct values or verify that their default values are suitable for your environment. The remaining configuration tasks are optional depending on which ones you want to use.

Note: The table references the following categories of properties that are defined in the G_SERVICENOW.props properties file:
  • Gateway Framework properties
  • ServiceNow gateway specific properties

For reference information and command line options on these properties, see Properties and command line options.

Table 1. Configuring the gateway
Configuration tasks Properties See
Required configuration tasks:
Authentication configuration tasks

Authenticate the gateway with ServiceNow.

Gate.ServiceNow.Username

Gate.ServiceNow.Password

Authenticating the gateway with ServiceNow

Authenticate the gateway with the ObjectServer.

Note: The gateway needs to authenticate with the ObjectServer only when the ObjectServer runs in secure mode.

Gate.RdrWtr.Password

Gate.RdrWtr.Username

Authenticating the gateway with the ObjectServer

Connection Configuration Tasks

Enabling the gateway to read alerts from the ObjectServer

Gate.RdrWtr.Server

Enabling the gateway to read alerts from the ObjectServer

Connect the gateway to the ServiceNow server by establishing the connection to ServiceNow.

Gate.ServiceNow.Host

Gate.ServiceNow.Username

Gate.ServiceNow.Password

Connecting to ServiceNow

Optional configuration tasks:
Table replication configuration task

Define the tables and event types that are replicated between the ObjectServer and ServiceNow.

Gate.RdrWtr.TblReplicate
DefFile

Table Replication

Data mapping configuration task

Define how fields in ObjectServer tables map to fields in ServiceNow.

Gate.Mapfile

Mapping

Improve gateway performance configuration task

Specify the number of simultaneous connections the gateway makes to ServiceNow.

Gate.ServiceNow.
Connections

Improving the performance of the gateway

Journal updates configuration task

Specify whether the gateway forwards historic journal information.

Gate.HistoricResync

Historic journal forwarding

Store and forward configuration task

Controls the operation of the store and forward functionality.

None

Store and forward capability