The DataPower configuration file

For the DataPower® data collector, the Data Collector Configuration Utility and the KD4configDC command manipulate the contents of a special DataPower configuration file by adding sections to the file when new DataPower monitoring is enabled, and removing sections from the file when monitoring is disabled. Each invocation of the Data Collector Configuration Utility or the KD4configDC command adds, updates, or removes one section of the DataPower configuration file. Each section of the DataPower configuration file might be associated with its own data group, or it might be part of a larger data group to which other sections of the configuration file also belong.

The DataPower data collector uses this configuration file to identify the DataPower SOA appliances that are to be monitored and to specify all of the information needed to communicate with those appliances. Typical information that is stored for each connection includes hostname and port, user ID and password, domains to monitor, and polling interval.

The configuration file is located in the <ITCAM4SOA_Home>/KD4/config directory and is called KD4.dpdcConfig.properties. This file is maintained separately from the existing KD4.dc.properties configuration file. This is a sample DataPower configuration file:

# Sample DataPower data collector configuration file
DataPower.count=3
#
DataPower.host.1=dpbox1
DataPower.port.1=5550
DataPower.path.1=/
DataPower.poll.1=60
DataPower.user.1=admin
DataPower.encpswd.1=#$%*&
DataPower.domainlist.1=default,testdom1
DataPower.displaygroup.1=dpbox1
#
DataPower.host.2=dpbox2
DataPower.port.2=5550
DataPower.path.2=/
DataPower.poll.2=30
DataPower.user.2=user1
DataPower.encpswd.2=&*%$#
DataPower.domainlist.2=userdom1,userdom2,userdom3
DataPower.displaygroup.2=user_doms
#
DataPower.host.3=dpbox2
DataPower.port.3=5550
DataPower.path.3=/
DataPower.poll.3=30
DataPower.user.3=admin
DataPower.encpswd.3=*%$#&
DataPower.displaygroup.3=all_doms

In this example, there are three sections in the configuration file. The properties in each of the three sections provide all of the information needed to establish and manage a single connection or session with each DataPower SOA appliance.

Change the information in this configuration file using either the Data Collector Configuration Utility or the KD4configDC command. Using various combinations of parameters in the Data Collector Configuration Utility input pages or in the KD4configDC command, you can achieve different monitoring configurations to separate or aggregate data among domains and appliances. See Considerations for enabling data collection for DataPower monitoring for more information.

Before configuring your DataPower environment for data collection, consult with your local systems management planners to understand which domains on which DataPower SOA appliances are to be monitored and how the data from these domains and appliances should be separated or aggregated for display in the Tivoli Enterprise Portal.

[ Top of Page | Previous Page | Next Page | Contents | Index ]