Enterprise Console forwarding configuration

The transport of events to a Enterprise Console Server is configured by specifying values for parameters in the file conf/cbe_adapter.conf. Configuration includes information such as the location of the Enterprise Console server to forward the events, enablement of event buffering etc.Configuration information is specified using the format keyword=value. Each keyword must be present on a separate line.

The configuration file contains the following keywords.

ServerLocation=host

Specifies the name of the host on which the event server or Tivoli Enterprise Console gateway is installed. The value of this field must be hostname or IP_address of the event server.

The ServerLocation keyword can contain up to eight values, separated by commas. The first location is the primary event server, while others are secondary servers to be used in the order specified when the primary server is down.

ServerPort=number
Specifies the port number on which the event server or Tivoli Enterprise Console gateway listens for events. Set this keyword value to 0, the default value, unless the portmapper is not available on the event server, which is the case if the event server is running on a Microsoft Windows system or the event server is a Tivoli Availability Intermediate Manager (see the following note). If the port number is specified as zero (0) or it is not specified, the port number is retrieved using the portmapper.
Note:
Portmapper is not supported for reception of events from non-TME adapters at the Enterprise Console gateway. If your non-TME adapter is sending events to this gateway, then you must code the ServerPort keyword to match the value in the gwr_ReceptionPort keyword in the Enterprise Console gateway configuration file.

The ServerPort keyword can contain up to eight values, separated by commas. For non-TME adapters that send events to a UNIX event server, use the default value of 0 (only one value of 0, even if multiple UNIX event servers are specified with the ServerLocation keyword). For non-TME adapters that send events to a Windows event server or a Tivoli Availability Intermediate Manager, specify one value for each event server defined with the ServerLocation keyword.

The ServerPort keyword is optional when the event server is running on the UNIX operating system, but mandatory when running on Windows operating system. It is not used when the TransportList keyword is specified.

Note:
If the event server is running on Windows operating system: There is no portmapper daemon on a Windows system that allows the adapter to query the reception port at run time. The event server listens on a fixed reception port (tec_recv_agent_port in .tec_config file) for connection and adapter input. Set the ServerPort keyword to the value of the tec_recv_agent_port entry in the .tec_config file in the $BINDIR/TME/TEC directory. The default value is 5529. The Tivoli Availability Intermediate Manager never uses the portmapper; the Tivoli Availability Intermediate Manager server listens on a fixed port set in the Tivoli Availability Intermediate Manager graphical user interface.
BufferEvents=YES | NO
Specifies how event buffering is enabled.
YES
Stores events in the file specified by the BufEvtPath keyword.
NO
Does not store or buffer events.
The value is not case-sensitive. The default value is YES.
BufferFlushRate=events_per_minute
Specifies the number of events that are sent per minute. Once the Web Services has recovered the lost connection, and there are events in the buffer, the events are sent at this rate per minute. The default value is 0 ; consequently all events are sent in one burst.
LogLevel=level
Specifies whether the Java API generates log messages or not. By default, no messages are generated. Specify ALL to generate messages. If you specify any other value or no value, the API does not generate messages.
LogFileName=pathname
Specifies the full path name of the log file for the Java API. The default location for the file is logs/teceif.log.
BufEvtPath=pathname
Specifies the full path name of the adapter cache file.This is a required keyword when the BufferEvents keyword is set to YES.


Parent topic
Administering the Enterprise Console Web Services Adapter

Related topics
Enterprise Console event class definitions
Enterprise Console Adapter ports
Troubleshooting common problems