3.3 Experience Manager Adapter Properties

Table 3-1 provides a description of Experience Manager Adapter properties.

Table 3-1 Experience Manager Adapter Properties

Property	Description
Accept events from unmanaged monitors?	Specifies if events are accepted from unmanaged monitors. Default is false.
AlarmColumns	A comma-separated list that determines which alarm columns display and the order in which the alarm items display (date/time, rule, etc.) in the Alarms window. A suggested list: status, Class, eventOccurrences, responseTime, responseTimeAvg, responseTimeLow, responseTimeHigh
Cluster sync interval (seconds)	The frequency in seconds that cluster members poll the database for changes to test configuration. This setting does not impact alarms. Defalut is 30.
Clustered Database?	Indicates there is more than one Experience Manager adapter sharing the database in a clustered Operations Center environment. Set to true when there are multiple adapters running.
DB Host	The hostname on which the database resides. Usage information from Experience Manager Monitors resides in this database. If multiple Experience Manager adapters use the same database server, each should have a unique set of Experience Manager tables.
DB Name	The database name.
DB Password	The password used to access the database. If using Microsoft SQL Server with domain authentication, specify the password of the Windows user account, or leave blank (on Windows) to attempt to use the credentials of the currently active Windows user account.
DB Port	The port number on which the database host listens.
DB Purge Period (days)	The age of performance data to purge from the database. For example, specify 21 to purge all information older than 21 days. Performance data is deleted from APM_EVENT_EXTENSIONS_TAB. A value of never prevents the purge from occurring.
DB Purge Time (24HH:MM)	The time of day to purge the database. Use the 24‑hour format of hours:minutes. For example, 17:00 starts the purge at 5:00 p.m.
DB Type	The type of database. Specify db2, oracle, mssql, postgres, or sybase. Note the following database specific configurations necessary for Experience Manager: For DB2, modify the bemschema.dbscript file to associate APM_EVENTS_TAB with a tablespace that has a buffer page size of 32 KB. For Sybase, verify that Sybase is configured with a minimum page size of 8K.
DB User	The user ID for accessing the database. If using Microsoft SQL Server with domain authentication, specify the username of the Windows user account, or leave blank (on Windows) to attempt to use the credentials of the currently active Windows user account.
DB Windows Domain	The domain to use for domain authentication with single sign on (used when defining a Microsoft SQL Server database).
Days to Retain Metrics (default)	All bulk metric data has an expiration date after which it is purged from the Experience Manager database. Specify the default number of days that HVMetricsbulk metric data is kept. Note that specific metrics data can be configured for a different retention period in the monitor-side script.
Event Queue Max	The maximum number of events allowed in the queue. The default is 50,000.
HierarchyFile	A file in the /OperationsCenter_install_path/database/examples directory that contains an XML description of the hierarchy of elements that is built beneath the element that represents the adapter. The default is bemHierarchy.xml. Before modifying the hierarchy file, copy the example file to the /OperationsCenter_install_path/database directory and change the location reference. This protects changes from being overwritten during software updates. For information, see Using the HierarchyFile in the Operations Center 5.6 Adapter and Integration Guide. The bemHierarchy.xml file no longer handles the setting of response time thresholds for scenarios. This functionality is now defined in scenario definitions.
Script.onError	Specify a script that executes if the adapter fails for any reason. The script can print the reason for the failure as a msg; for example: log.info(msg).
Script.onInitialized	A script that executes when the adapter is first initialized. All the Script. properties are optional.
Script.onStarted	A script that executes whenever the adapter starts, either manually or automatically when the Operations Center server starts.
Script.onStopped	A script that executes after manually stopping the adapter.
Secure Communications (SSL)	If True, encrypts communications traffic between the adapter and Experience Manager Monitors using SSL. If False, does not encrypt communications. This value must be the same as the setting for Monitor.SecureCommunications in the monitor’s /OperationsCenter_ExperienceManager_install_path/config/monitor.properties file. Both default to false.
Server Listener Port	The port on which the adapter listens for events from the monitors. The default is 6790.
Socket Timeout (seconds)	The number of seconds of unresponsive connection time on monitors before timed out. Default is 30.
StylesheetFile	The style sheet file applies against the HierarchyFile as a style markup and produces the final output. It is located in the /OperationsCenter_install_path/database directory.
Use Alarm Times for Cond Changes	Specifies the date/time stamp to use for any alarm data stored by the data warehouse. If True, takes the date/time information directly from the alarm information. If False, uses the date/time when the Operations Center server receives the alarm.