8.6 Setting Up Distributed Agent Support

The Agent Container is the CORBA component that manages individual agents within a single host machine and is the source of the actual preprocessed alarm stream.

The Agent Container can send data streams of preprocessed alarms to more than one alarm server process within the Event Manager, to provide configurations that are fault tolerant and increase scalability.

8.6.1 Fulfilling the Prerequisites

Before using the distributed agent support feature:

  1. Define the hosts where servers (other than the default or primary alarm server) are running.

  2. Make sure that all affected alarm servers are up and running.

    The data stream management feature is supported on all Event Manager alarm servers.

8.6.2 Setting Up the Distributed Agent Support Feature

To set up distributed agent support:

  1. In the Explorer pane, expand the Administration root element > Adapters > the Event Manager adapter > Configurations > a configuration profile for the adapter.

  2. Right-click Agents, then select Manage Data Streams to open the Manage Agent Data Streams dialog box:

    In the Manage Agent Data Streams dialog box, the primary host displays in the Agents feed these hosts/servers list.

    The default or primary alarm server is under the Configurations element and usually runs on the same machine as the Event Manager and the Operations Center server.

    Other hosts display in the No data being fed to these hosts/servers list.

    IMPORTANT:The security setting must be the same on the sending server and the receiving server.

  3. Do any of the following:

    • To select a host, click a host in the No data being fed to these hosts/servers list, then click Add.

      The selected host displays in the Agents feed these hosts/servers list.

      If no hosts display in the Agents feed these hosts/servers list, then no data goes to any host or server.

    • To select all hosts, click Add All.

      All hosts display in the Agents feed these hosts/servers list.

    • To remove a host, in the Agents feed these hosts/servers list, select a host, then click Remove.

      The hostname displays in the No data being fed to these hosts/servers list.

      Select any combination of hosts, including the primary host from receiving data.

  4. Do any of the following:

    • To start all agents, click Start All Agents.

    • To start only specific agents as specified by a regular expression, select the With Names Like check box and enter the regular expression in the field, then click Start All Agents.

      Only the agents that meet the expression criteria start.

  5. Do any of the following:

    • To stop all agents, click Stop All Agents.

    • To stop only specific agents as specified by a regular expression, select the With Names Like check box and enter the regular expression in the field, then click Stop All Agents.

      Only the agents that meet the expression criteria stop.

  6. To send data to alarm servers on the selected hosts, click Apply.

    The Agent Container attempts to send data to alarm servers on all hosts displayed in the Agents feed these hosts/servers list.

    If an alarm server is unreachable, a warning message is stored in the eve.trc file and that particular host is ignored. The data is sent to all hosts/servers that are reachable within the set.

    WARNING:As additional hosts are added to receive preprocessed alarms, significant slowing in performance can occur. Moving from a single alarm server to a server and a backup server doubles the amount of time required for a send operation. The Event Manager administrator sets the agent buffering to compensate for this in cases where large data bursts might occur.