PATROL Agent configuration variables
You must set the following Agent configuration variables in the PATROL Agent to connect with the BMC TrueSight IT Data Analytics product.
You can use either the pconfig utility or PATROL Configuration Manager to manage them.
For more information about the default ports used in BMC TruSight IT Data Analytics, see Communication-ports-and-protocols in the BMC TruSight IT Data Analytics online documentation portal.
List of Agent configuration variables
Directory path and variable | Description |
|---|---|
/ConfigData/ITDA/UDC/Collection-Agent-Name1/ | |
agent.name | Sets the name of the Collection Agent that you want to configure. |
jvm_options | (Optional) Specifies the Java Runtime Environment (JRE) options for which you want to change values. For information about the JRE versions supported, see System-requirements. You might want to change these values to perform advanced functions such as changing the Java heap size. For example, if you find the Java Heap OutOfMemory error in the collection.log file located at %PATROL_HOME%\bww\udc\logs, then you need to increase the default value for the Java heap size used for the Collection Agent. For more information about specifying the JRE options, see the following link: You can specify multiple JRE options by specifying a space-separated list. Example: -XX:MaxHeapFreeRatio=70 -XX:MaxPermSize=64m |
stationprotocol | Specifies whether you want to use secure connection between BMC PATROL for IT Data Analytics and the Collection Station component in IT Data Analytics. The following values apply:
Before you specify 1 for using a secured connection, ensure that you have performed the steps described in the topic, Enabling security for the Collection Station available in the IT Data Analytics online documentation portal. |
/ConfigData/ITDA/UDC/Collection-Agent-Name/ | |
serverhost | Provides the host name of the computer where the Collection Station is installed. |
serverport | Provides the port number of the computer where the Collection Station is installed. While installing the BMC TrueSight IT Data Analytics product, by default, the Collection Station port is set to 8080. |
/ConfigData/ITDA/UDC/Collection-Agent-Name/CollectionProfileProp/cp/ | |
collectionprofile | (Optional) Specifies the name of the collection profile that you want to associate with the Collection Agent for creating the data collector in BMC TrueSight IT Data Analytics. |
/ConfigData/ITDA/UDC/Collection-Agent-Name/CollectionProfileProp/cp/CollectionProfilePropMacro/Macro-Number2/ | |
macroname | (Optional) Specifies the name of the macro associated with the collection profile for which you want to override values. After specifying this variable, ensure that you specify the corresponding macro value by adding the macrovalue variable. |
macrovalue | (Optional) Specifies the new value for the macro specified in the macroname variable. |
/ConfigData/ITDA/ | |
java_home | Specifies the location of the JRE used by BMC PATROL. Specifying this variable is necessary only if you installed the JRE in a new location, other than the following PATROL default location:
The value of this field is the absolute path to the JRE. Example: C:\Program Files (x86)\JAVA\jre64 |
The following definitions apply for the user inputs to be specified in the directory paths:
1 Collection-Agent-Name refers to the name of the Collection Agent that you specify. The same value applies to the other variables where this value appears in the directory path.
Related topic
Configuring Collection Agents by using Central Monitoring Administration Console