PATROL Agent configuration variables
You can now configure local and remote web server applications, including HTTP and HTTPs pages, using the PATROL Configuration Manager.
The following table lists the agent configuration variables that you can use for the configuration.
For more information on how to use the PATROL Configuration Manager (PCM) or the wpconfig utility, see BMC PATROL Configuration Manager User Guide.
Note
The host name or server name that you use to configure web server applications must not contain periods. Use underscores (_) instead of periods (.). For example: Instead of bmc.com, use bmc_com. The host name of the INET web server must be the same as defined for the INET server instance.
List of agent configuration variables
| Directory path and variable | Description | Value |
|---|---|---|
| /InetSetup/INET_Servers/ hostName(or serverName) | ||
| discovery | Controls the discovery of the specific server, whether discovered (OK) or offline. | OK (the default) or OFFLINE |
| ipAddress | Defines the IP address of the host machine. | IP address |
| name | Defines the fully qualified name of the monitored server. | Fully qualified name |
| type | Defines the type of connection with the monitored server (local or remote). | REMOTE or LOCAL Note: Configuration through PATROL Configuration Manager or the wpconfig utility supports only a REMOTE connection. The LOCAL value is set automatically for auto-discovered web servers. |
| /InetSetup/INET_Web_Server | ||
| DisableInvalidConfiguration | Disables the Invalid Configuration warning that is issued during configuration verification. | 0 -- (the default) False (warning issued)1 --True (warning not issued) |
| /InetSetup/INET_Web_Server/ hostName(or serverName)_portNumber | ||
| discovery | Controls the discovery of the specific web server, whether discovered (OK) or offline. | OK (the default) or OFFLINE |
| host | Defines the fully qualified name of the host machine on which the web server resides. | Fully qualified host name |
| hostInstance | Defines the pconfig instance of the host name. | /INET_Servers/hostName Example:/INET_Servers/bmc_com |
| parentInstance | Defines the parent pconfig instance of the host name. Note: The parent instance should be the same as the host instance. | /INET_Servers/hostName Example:/INET_Servers/bmc_com |
| port | Defines the port number of the web server that you want to monitor | Port number |
| protocol | Defines the protocol used by the web server, depending on whether or not it is a secured server. | HTTP or HTTPS (secured server) |
| type | Defines the type of web server to monitor. | One of the following:
|
| /InetSetup/INET_Web_Server/ hostName(or serverName)_portNumber /Url/Home (for Home page) | ||
| URL | Specifies the relative URL of the Home page, as appended to the base URL (which contains the server name). | Example:/index.html For the home directory:/ |
| sort_order | Controls the sorting order of the monitored URL for the Home page.Note: The sorting order of the Home page should be lower than all other HTML pages. | Example:1314275348 |
| url_label | Specifies the label of the monitored URL. | Example:Home |
| /InetSetup/INET_Web_Server/ hostName(or serverName)_portNumber /Url/ page_sort_order | ||
| AutoHomeURLDetectionDisabled | Prevents the KM from detecting the home URL of web servers, which are configured after you enable this variable. | 1 - enabled remove the variable to allow the KM to detect the home URL of a web server.Note: To enable the detection of the home URL of a web server once again after you disabled it, restart the PATROL Agent. |
| method | Specifies the HTTP request method used by the specific HTML page (either GET or HEAD ).Note:Configuration through PATROL Configuration Manager does not support the POST method. | GET or HEAD |
| sort_order | Controls the sorting order of the monitored URL for the specific HTML page. | Example:1314278849 |
| URL | Specifies the relative URL for the specific page, as appended to the base URL (which contains the server name). | Example:/solutions |
| /InetSetup/INET_Web_Server/ hostName(or serverName) | ||
| destroy_time | Specifies the waiting time before an inactive virtual host is removed from the list of monitored virtual hosts. | 1 - one hour |
AutoHomeUrlDetectionDisabled pconfig variable
The AutoHomeUrlDetection pconfig variable prevents the KM from detecting the home page of the web servers that you configure.
By setting the value of AutoHomeUrlDetection variable to 1, you can prevent the KM from detecting the home URL of the web servers. If you want the KM to detect the home URL of the web servers configured, set the pconfig variable value to 0.
Deleting this pconfig variable requires PATROL Agent restart inorder to discover the home URL within the configured variable.
Comments
Log in or register to comment.