Introduction to Connectors › Connector Configuration › Configure the IFW Configuration File

Configure the IFW Configuration File

As an administrator, you can change the connector-related settings that are saved in the IFW configuration file (SOI_HOME\resources\Configurations\SSA_IFW_HostName.xml). The settings are applicable to all connectors running under that IFW. You can configure the IFW configuration file to change these settings globally for all connectors on the system. For example, changing the alert filter setting at the IFW level automatically overrides the individual alert filter settings for all the connectors that are installed on that IFW system.

Follow these steps:

1. Open the SOI_HOME\resources\Configurations\SSA_IFW_HostName.xml file on a system with the IFW installed (any system with connectors or the SA Manager).
2. Change the value for the appropriate parameters in the ConnectorConfig section as follows, and save and close the file when finished:

   Important! Use caution when changing these settings, and change documented settings only.

   retryCount

   Defines how many times to retry connecting to the ActiveMQ Server component on the SA Manager when the connection fails. Before changing the default retry settings, consider that the amount of time a connector waits for the ActiveMQ Server connection reflects the amount of queued data that will consume memory in the IFW until the connection is reestablished.

   Default: 5

   retryInterval

   Defines the number of seconds between retrying to connect to the ActiveMQ Server.

   Default: 30

   dns_resolution

   Defines whether to use the DNS lookups for the CI name resolution. The default value of 1 turns on DNS lookups for all connectors on the system. When set to 1, you can also manage DNS lookup settings by connector if you want to use different settings for each connector. Change this value to 0 to disable the DNS lookups for all connectors. When you set this value to 0, you cannot manage DNS lookup settings by connector; DNS is always disabled for all connectors.

   Default: 1

   Note: For more information about managing DNS lookup settings by connector, see Edit Connector Configuration and the Implementation Guide.

   sendAllAlerts

   Defines whether to filter or send alerts that are not associated with a managed service. The default value of 1 sends all alerts from all connectors. Change the value to 0 to let you specify this behavior by connector.

   Default: 1

   Note: For CA SOI r3.1 and later, the IFW no longer requires or uses EVENT_FILTER requests. The IFW now sends the alerts (managed or unmanaged) that the connectors report to the SA Manager. CA SOI ignores the global setting sendAllAlerts (in the IFW configuration file) and the connector-specific setting useAlertFilter (on the Administration tab Connector Configuration page). CA SOI now behaves as if sendAllAlerts=1 and useAlertFilter=0, regardless of the actual settings.

   throttleConnectorStartup

   Defines whether to initialize connectors on the system simultaneously or one after another. The default setting of 0 initializes all connectors simultaneously. You can change this setting to 1 for connectors to initialize sequentially, which can improve the performance. The setting can also prevent memory overuse if there are multiple connectors on the system that manage large amounts of CIs.

   Default: 0

3. Restart the CA SAM Integration Services service.