Configure a connector instance

The connector instance schedules the frequency of event collection.

Before you begin

Before starting this procedure, locate or define a connector definition. Create the credentials to connect to the event source.

Role required: evt_mgmt_operator

About this task

You can use a connector instance to control the location and manner in which events arrive from external sources. You can run a test to confirm that connector instance parameters let the MID Server receive events from a supported external event source to the Event [em_event] table. The test confirms:
  • The MID Server is running.
  • The host is running on the IP address that is in the Host IP field.
  • Both the MID Server and the host are running in the same domain.
  • The connector instance values fields are valid.

Procedure

  1. Navigate to Event Management > Connectors > Connector Instances.
  2. Click New.
  3. Fill in the fields, as appropriate.
    Table 1. Connector Instance Form
    Field Description
    Name A unique name for the connector instance record, such as the name of event source host.
    Host IP The IP address of the event source host. The system uses this IP address to select the appropriate MID Server for communicating with the event source host.
    Connector definition The vendor and protocol used to gather events from the external event source. Select the connector definition that matches the source of external events. The default options are:
    • HPOM
    • IBM Netcool
    • SCOM
    • SolarWinds
    Credential The record from the Credentials [discovery_credentials] table containing valid credentials to the event source host.
    Schedule (seconds) The frequency in seconds that the system checks for new events from the external event source. This value cannot be lower than the minimum schedule property, which by default is 120 seconds.
    Active The check box to enable pulling events from this external event source.

    Do not select this check box until after you test the connection between the MID server and the connector.

    Last Event Signature The identifier of the last event processed from this external event source. The system uses the event signature to determine what events to import on the next run.
    Last Run Time The date and time of the most recent event import.
    Last Run Status The status of the last import: Success or Error.
    Description Any optional information that the administrator wants to use to identify this record.
    Connector Instance Values The related list containing connection parameters for the event source host. The list of parameters depends on the selected connector definition.
  4. Right-click the form header and select Save.
  5. Click Test connector to verify that the MID Server can communicate with the external server host.
  6. If the test fails, follow the instructions on the page to correct the problem and then do another test.
  7. After a successful test, select the Active check box and then click Update.
  8. Confirm that Event Management processes event via this connector instance by manually creating an event.