You configure the BMC Event Adapters by modifying the parameters that control their behavior. All parameters are recorded in the mcxa.conf file.
The mcxa.conf file contains definitions for all the adapters running on the computer, as follows:
For more information about the structure of the mcxa.conf file, see About the mcxa.conf file.
To configure the global aspects of the adapters environment and the parameters specific to each adapter instance, perform the tasks in the order described in following table.
You can add, remove, or modify global or common parameters, adapter instance definitions, or parser definitions in the mcxa.conf file at any time. If you make a change when the engine manager (the mcxa process) is stopped, your changes will be applied when you restart the engine manager. You can also make changes at run time. To ensure that these changes are recognized, see Applying configuration changes at run time.
Adapter configuration tasks
|Phase||Action||Details||Where to go|
|Accessing the configuration file||Open the mcxa.conf file.||The file is located at installationDirectory\pw\server\etc\mcxa.conf.||About the mcxa.conf file|
|Configuring the adapter environment||Specify values for global parameters.||Some parameters are required and some are optional.||754087541|
|Specify values for common parameters.||Some parameters are required and some are optional.||754087541|
|Configuring adapters||Decide which adapters you want to use.||Determine what you want to accomplish with the adapters and select the adapters appropriate to the task.||Types of IP Adapters|
|Gather the information required to define the adapter instances.||Review the specific parameters associated with each adapter that you want to use. Make a list of values that you want to add or modify for each adapter instance (such as port numbers). You must specify which parser each of your IP Adapter instances will use. Review the types of parsers available. BMC Software recommends that you create a brief planning sheet for each adapter, listing the information that you want to include in the adapter definition.|
|Modify or add adapter definitions.|
The mcxa.conf file contains sample adapter definitions for all supported parameters.
Copy these definitions below the Write your configuration below heading at the end of the mcxa.conf file. Make a copy for each adapter instance that you require.
Add or modify adapter parameters as required for each adapter instance.
|Define any required IP Adapter parsers.|
The mcxa.conf file contains sample parser definitions for all supported parameters.
Copy these definitions below the Write your configuration below heading at the end of the mcxa.conf file. Make a copy for each parser instance that you require.
Add or modify parser parameters as required for each unique parser instance.
|IP Adapter parsers|
|(Optional) Enable adapters.|
You can enable adapters at any time after they have been configured. However, some adapters might require additional preparatory work before they are enabled:
When enabling an IP Adapter, you must also enable the parser that it uses (if that parser is not already enabled).
|Save and close the mcxa.conf file.||Not applicable||Not applicable|
|Configuring the SNMP mib2map utility||Configure the mib2map utility (SNMP Adapter only).|
The mib2map utility specifies how SNMP data is converted to cell events. You must perform some configuration of this utility to ensure that SNMP data is presented correctly in the events.
Perform this task before you enable any SNMP Adapter instances.
|Enabling adapters||Remove or comment out DISABLE in the adapter definitions.|
Removing or commenting out DISABLE in an adapter definition enables it immediately. Do this only when you are ready to collect data.
|Enabling and disabling BMC Event Adapters|