Configuring BMC ProactiveNet Report Engine for performance reports

Perform the following configurations for proper operation of the performance reports.

Creating an External Report attribute set

An External Report attribute set enables the following:

• Filtering capabilities — performance data is transferred from BMC ProactiveNet Server to the report engine, and performance reports are generated only on those attributes you have selected.
• Normalization of attributes across platforms — you can group similar attributes across platforms in one attribute set. For example, the "% CPU Utilization In System Mode (%)" attribute is used for UNIX, while the "System CPU Utilization (%)" is used for Windows monitors. You can group both attributes under one "CPU" attribute and generate performance reports using the "CPU" attribute set.

To create an External Report attribute set

1. On the BMC operational console, go to Options > Administration > Attribute Sets > Edit.
2. Click the relevant option:
   • For a new attribute, click Add in the AttributeSet Administration screen.
   • To edit an existing attribute, click Edit. Click Add Attributes to add more attributes.
3. On the Add Attribute Set screen, select the Attribute Set type External Report.
4. Select the Monitor Type. Select all monitor types corresponding to the attributes to be grouped.
   Use the Shift and Ctrl keys to make multiple selections. To locate a specific monitor, use the Search For field.
5. Click Next.
6. Select the attributes to be grouped from under each of the monitor types in the Attributes section.
   Use the Shift and Ctrl keys to make multiple selections. To locate a specific attribute, use the Search For field.
7. Click Next.
8. Specify a name for the attribute set.
9. Select the attributes to be included by selecting the corresponding check boxes in the Select column.
10. Click Finish. The new External Report attribute set is available for use.

Registering the BMC ProactiveNet Server

After you create an attribute set, you must register the BMC ProactiveNet Server.

To register the BMC ProactiveNet Server, enter the following command:

bppmr_config -add serverName

Configuring the properties of the Report Engine

Changing the report engine properties is not required. If you must change the report engine properties, the properties are located in the perfsladatatransfer.properties file, located in the appropriate directory for your operating system:

• (Windows) reportEngineInstallationDirectory\ReportEngine\tools\jboss\server\all\conf\properties
  \perfsladatatransfer
• (Solaris/Linux) ReportEngine/tools/jboss/server/all/conf/properties/perfsladatatransfer

To change the Report Engine properties

1. Open the perfsladatatransfer.properties file using a text editor. The following properties are included in the file:

   Property type	Parameter	Description
   Data transfer schedule	reportengine.datatransfer.schedule.interval	Schedule interval in seconds of the performance data transfer job. Valid values are positive whole numbers. Default value (recommended): 3600
   	reportengine.configjob.schedule.interval	Schedule interval in seconds for configuration job which transfers configuration data. Valid values are positive whole numbers. Default value (recommended): 3600 BMC recommends to set config job schedule to be equal or in multiple of the main data transfer job.
   	reportengine.deleteconfigjob.schedule.interval	Schedule interval for Delete job. Default value (recommended): 3.00 AM UTC/GMT
   	reportengine.datagapfillerjob.schedule.interval	Schedule interval for Delete job. Default value (recommended): 1.00 AM UTC/GMT
   Maximum history	reportengine.datatransfer.maxhistoryretention. statdata.days	Maximum stats history data in days to be transferred from BMC ProactiveNet Performance Management server to report engine. Valid values are positive whole numbers. Default value (recommended): 0
   	reportengine.datatransfer.maxhistoryretention. ratedata.days	Maximum rate history data in days to be transferred from BMC ProactiveNet Performance Management server to report engine. Valid values are positive whole numbers. Default value (recommended): 90
   Chunk size	reportengine.datatransfer.ratestat.chunksize	Stats and rate data in hours that is transferred in one data transfer job cycle. To collect history, the chunk size must be greater than the job schedule interval. Valid values are positive whole numbers. Default value (recommended): 8
   CSV file generation	reportengine.csvfilegeneration.enable	Generates .csv files in case of a data gap. If you do not want the Report Engine to generate .csv files during a data gap, set this parameter to false. Default value: true
   Collection of rate data	reportengine.ratedatatransfer.enable	Collects the rate data. If you do not want the Report Engine to collect rate data, set this parameter to false. Default value: true

   To change the Retention Age property, use the ConfigureRetention CLI command.

2. Save the perfsladatatransfer.properties file.
3. Restart the BMC ProactiveNet Report Engine service. See, Starting and Stopping the Report Engine service.