IBM Business Automation Workflow V 19.0.0.2

MeteringConfig command-line utility

Use the MeteringConfig command-line utility to enable or disable WebSphere® Application Server security auditing and the ability to generate the audit logs used to capture concurrent user metrics and number of activities. Concurrent user metrics are used to monitor usage for the IBM® Business Automation Workflow Concurrent User license option.

To measure the number of activities that are running, the MeteringConfig command also creates a dynamic event framework (DEF) listener to capture the execution events.

The concurrent user and activity metrics logs are analyzed by the metering agent. See the MeteringAgent command.

For more information about the Auditing Facility, see Auditing the security infrastructure in the WebSphere Application Server documentation.

Prerequisites

The following conditions must be met:
  • The deployment environment must be stopped.

Location

The MeteringConfig command-line utility is in the install_root_/bin directory.

The command log is in install_root_/logs/metering/MeteringConfig.timestamp.log.

Concurrent user metrics are tracked in the following audit logs:
dmgr_profile/logs/metering/BinaryAudit_cell_name_dmgr_name_dmgr.log
node_profile/logs/metering/BinaryAudit__cell_name_node_name_nodeagent.log
node_profile/logs/metering/BinaryAudit__cell_name_node_name_app_server_name.log

When the DEF listener is enabled, the activity metrics log is created in install_root_/logs/metering/ActivityMetricLog.server_name.log.

Syntax

install_root_/bin/MeteringConfig
[-enableConcurrentUserMetrics | -disableConcurrentUserMetrics]|
[-enableActivityMetrics | -disableActivityMetrics] |
[-enableAllMetrics | -disableAllMetrics]
-profile deployment_manager_profile

Parameters

-enableConcurrentUserMetrics | -disableConcurrentUserMetrics
Start or stop measuring concurrent user metrics.
-enableActivityMetrics | -disableActivityMetrics
Start or stop measuring activity metrics.
-enableAllMetrics | -disableAllMetrics
Start or stop measuring all metrics.
-profile
Required parameter that specifies the name of the deployment manager profile.

Examples

To enable monitoring of concurrent user metrics:
MeteringConfig -enableConcurrentUserMetrics -profile dmgr_profile
To disable monitoring of all metrics:
MeteringConfig -disableAllMetrics -profile dmgr_profile

What to do next

After running this command, run the MeteringAgent command.