Modifying Metrics configuration properties
Change the way that the Metrics application behaves by modifying configuration properties.
Before you begin
To edit configuration files, use the IBM® WebSphere® Application Server wsadmin client. See Starting the wsadmin client for information about how to start the wsadmin command-line tool.
About this task
Configuration settings control how and when various Metrics operations take place. Configure Metrics by using scripts that are accessed with the wsadmin client. These scripts use the AdminConfig object in the wsadmin client to modify the Metrics configuration file.
Changes to Metrics configuration settings require node synchronization and a restart of the Metrics server before they take effect.
Procedure
- Start the wsadmin client.
- Start the Metrics Jython script interpreter.
- Optional: To view a list of the valid Metrics
configuration settings and their current values, use the MetricsConfigService.showConfig() command
This is sample output from the MetricsConfigService.showConfig() command:
Metrics configuration properties: cognos.namespace = IBMConnections cognos.secsPerRequest = 1200 communitiesMetricsDateRange.all.enabled = true communitiesMetricsDateRange.last12months.enabled = true communitiesMetricsDateRange.last4weeks.enabled = true communitiesMetricsDateRange.last7days.enabled = false communitiesMetricsDateRange.lastquarter.enabled = true db.dialect = DB2
Note: Only properties that are in the metrics-config.xml file are printed by the MetricsConfigService.showConfig() command. Configurations of custom reports are not listed. - Modify configuration properties by using the appropriate
method:Notes:
- Some Metrics
configuration properties can be edited by using the wsadmin
client:
MetricsConfigService.updateConfig("property", "value")
where property is one of the editable Metrics configuration properties and value is the new value for the property. For example:
MetricsConfigService.updateConfig("communitiesMetricsDateRange.last7days.enabled", "false")
- Properties that are not listed as being editable with the wsadmin client can be edited directly in the configuration file: open the file in a text editor to modify it.
- Some Metrics
configuration properties can be edited by using the wsadmin
client:
- Check in the file: MetricsConfigService.checkInConfig()
- Update the value of the version stamp configuration property
in the LotusConnections-config.xml file. This
setting forces browsers to pick up the changes. For more information, see Required post-customization steps.
- Exit the wsadmin client.
- Restart the server to apply your changes.
What to do next
After you update Metrics properties, you can use the MetricsConfigService.showConfig() command to display the properties and their updated values.