Configuration using PATROL Configuration Manager

This section provides information about using PATROL Configuration Manager to perform various configuration tasks in PATROL for Entuity Server.

Before you begin

Before using PATROL Configuration Manager to change the configuration of a Knowledge Module (KM), BMC recommends that you ensure that PATROL Configuration Manager is set up to save or backup the configuration.

 To enable backups in PATROL Configuration Manager, perform the following steps:

  1. From the main menu, select File > Configure > Application.
  2. In the Configure: Application dialog box, select the Archives tab to open the Backup Settings.
  3. Ensure that the Save Backup Before Apply option is selected.
  4. Click OK to save the settings.

This section describes how to create and configure custom monitors using PATROL Configuration Manager (PCM).

If you do not want to use native monitors to monitor the network devices, you can create and configure custom monitors using PCM.

You can configure the custom monitors using the following template: 

PATROL_CONFIG
"/AgentSetup/preloadedKMs" = {MERGE = "ZXC.kml"},
"/ZXC/Default/DeviceMapping" = {REPLACE = "<<Devices=1;Entuityserver=2;Disable=0>>"},
"/ZXC/Default/JAVA_HOME" = {REPLACE = "<<%JAVA_HOME%>>"},
"/ZXC/Default/Debug/debugEnabled" = {REPLACE = "<<1(Yes) or 0(No)>>"},
"/ZXC/Default/Filters/DeviceTypesToMonitor" = {REPLACE = "|138|148|158|168|1058|1070|1073|1102|1124|"},
"/ZXC/Default/Filters/RegEx" = {REPLACE = "<<".*">>"},
"/ZXC/Default/Thresholds/ImportAllThresholds" = {REPLACE = "false"},
"/ZXC/Default/ExternalCollectorSetting/CommandTimeout" = {REPLACE = "60"},
"/ZXC/Default/ExternalCollectorSetting/ConnectionTimeout" = {REPLACE = "60"},
"/ZXC/Servers/<<Entuity server name>>_<<Entuity user name>>/hostName" = {REPLACE = "<<Entuity server name>>"},
"/ZXC/Servers/<<Entuity server name>>_<<Entuity user name>>/userName" = {REPLACE = "<<Entuity user name>>"},
"/ZXC/Servers/<<Entuity server name>>_<<Entuity user name>>/port" = {REPLACE = "<<Entuity server port>>"},
"/ZXC/Servers/<<Entuity server name>>_<<Entuity user name>>/view" = {REPLACE = "<<Entuity user view>>"},
"/ZXC/Servers/<<Entuity server name>>_<<Entuity user name>>/template" = {REPLACE = "<<Data access template name(specify the template name only if you are using Entuity V16.5 patch 4 and later). TSOM template name will be used by leaving it empty for all of the configured Entuity Entuity servers version 16.5 patch 4 and later.>>"},
"/ZXC/Servers/<<Entuity server name>>_<<Entuity user name>>/protocol" = {REPLACE = "<<1(http) or 2(https)>>"},  
"/SecureStore/ZXC_Root/<<Entuity server name>>_<<Entuity user name>>_Pass" = {REPLACE = "ZXC_Root;ZXC_Server_Account/<<Password>>"},
"/ZXC/Servers/<<Entuity server name>>_<<Entuity user name>>/Filters/RegEx" = {REPLACE = "<<java regular expression>>"},
"/ZXC/Servers/<<Entuity server name>>_<<Entuity user name>>/Filters/DeviceTypesToMonitor" = {REPLACE = "<<Device types numbers from the following list separated by pipe |
(-3)Only Network Devices
(-2)All
(-1)None
(1102)Aruba Wireless Controller
(158)ATM Switch
(1046)Autonomous WAP
(1001)Blade Center
(148)Ethernet Switch
(1049)Firewall
(10)Hub
(1077)Load Balancer
(1059Managed Host
(1124)Matrix Switch
(1200)Multiplexer
(1062)Non-SNMP Device
(1070)PoE Midspan Injector
(168)Router
(1079)SSL Proxy
(138)Token Ring Switch
(1088)Unclassified
(1069)Unclassified (Full)
(1104)Uninterruptible Power Supply
(1144)VM Platform
(1058)VPN
(1128)Wide Area Application Service
(1073)Wireless Controller
(0)Unknown
>>"}

Agent configuration variables

The following table provides information about the configuration variables for creating and configuring custom monitors. You can use PATROL Configuration Manager to add values to the configuration variable for configuring custom monitors. 

Agent configuration variables are the means by which the characteristics of a PATROL Agent are defined. To configure an Entuity host for monitoring by using PATROL Configuration Manager, add the following set of agent configuration variables, and apply it on the PATROL Agent that runs PATROL for Entuity Server.

Variable

Description

Value

/ZXC/Default/DeviceMapping
Monitored instances are created and mapped according to their device that is discovered by the Entuity server
  • 0 - disabled
  • 1 - device
  • 2 - Entuity server
/ZXC/Default/JAVA_HOME

Environment variable Java home or Patrol Agent JRE will be used by leaving this field empty. Full path of JRE directory on the PATROL Agent server. 

For Example:
Windows: c:\java\jre8

UNIX: /usr/local/java8

 
/ZXC/Default/Debug/debugEnabled

After enabling debugging, log files get created in the logs directory.

For example: $PATROL_HOME/ZXC/logs directory

  • 1 (Yes)
  • 0 (No)
/ZXC/Default/Filters/DeviceTypesToMonitor

Select the device types for monitoring and enter the device type numbers separated by pipe |. The following are the device types that can be monitored:

  • Only Network Devices
  • All
  • None
  • Aruba Wireless Controller
  • ATM Switch
  • Autonomous WAP
  • Blade Center
  • Ethernet Switch
  • Firewall
  • Hub
  • Load Balancer
  • Managed Host
  • Matrix Switch
  • Multiplexer
  • Non-SNMP Device
  • PoE Midspan Injector
  • Router
  • SSL Proxy
  • Token Ring Switch
  • Unclassified
  • Unclassified (full)
  • Uninterruptible Power Supply
  • VM Platform
  • VPN
  • Wide Area Application Service
  • Wireless Controller
  • Unknown

/ZXC/Default/Filters/RegEx

Enter the device name matching Regex. Default regex is .* which refer to ALL

 
/ZXC/Default/Thresholds/ImportAllThresholds
Import Entuity Server Dynamic Thresholds 
/ZXC/Default/ExternalCollectorSetting/CommandTimeout
Enter the command timeout. 
/ZXC/Default/ExternalCollectorSetting/ConnectionTimeout
Enter the connection timeout. 
/ZXC/Servers/<<Entuity server name>>_<<Entuity user name>>/hostName
Enter the hostname of the Entuity server. 
/ZXC/Servers/<<Entuity server name>>_<<Entuity user name>>/userName
Enter the username of the Entuity server. 
/ZXC/Servers/<<Entuity server name>>_<<Entuity user name>>/port
Enter the port number of the Entuity server. By default, the port will be 443. 
/ZXC/Servers/<<Entuity server name>>_<<Entuity user name>>/view

Enter the view. Default views should be added in the following format: username::My Network.

For example: To configure My Network(admin), the view should be admin::My Network.

 
/ZXC/Servers/<<Entuity server name>>_<<Entuity user name>>/templateData access template name(specify the template name only if you are using Entuity V16.5 patch 4 and later). TSOM template name will be used by leaving it empty for all of the configured Entuity Entuity servers version 16.5 patch 4 and later.
/ZXC/Servers/<<Entuity server name>>_<<Entuity user name>>/protocol
Enable data collection from the Entuity server through secured HTTPs connection. 
  • 1=(http)
  • 2=(https)
/SecureStore/ZXC_Root/<<Entuity server name>>_<<Entuity user name>>_Pass
Enter the password of the Entuity server. 
/ZXC/Servers/<<Entuity server name>>_<<Entuity user name>>/Filters/RegEx

Specify the device name matching regex that you want to include in monitoring. Regex can be used to specify the device name.

For example: *.bmc.com, ^someprefix.bmc.com, my servers[0-9][0-9].org

 
/ZXC/Servers/<<Entuity server name>>_<<Entuity user name>>/Filters/DeviceTypesToMonitor
Enter the device types for monitoring and enter the device type numbers separated by pipe |.

(-3)Only Network Devices
(-2)All
(-1)None
(1102)Aruba Wireless Controller
(158)ATM Switch
(1046)Autonomous WAP
(1001)Blade Center
(148)Ethernet Switch
(1049)Firewall
(10)Hub
(1077)Load Balancer
(1059Managed Host
(1124)Matrix Switch
(1200)Multiplexer
(1062)Non-SNMP Device
(1070)PoE Midspan Injector
(168)Router
(1079)SSL Proxy
(138)Token Ring Switch
(1088)Unclassified
(1069)Unclassified (Full)
(1104)Uninterruptible Power Supply
(1144)VM Platform
(1058)VPN
(1128)Wide Area Application Service
(1073)Wireless Controller
(0)Unknown

Was this page helpful? Yes No Submitting... Thank you

Comments