DB2 Remote Windows connection setup
After you have installed the PATROL for IBM DB2, you must configure a monitoring policy. You can use the information in this topic to configure a DB2 Remote Windows connection setup with the TrueSight console.
This topic includes the following information:
Before you begin
You must download and install the PATROL for IBM DB2.
To configure the monitor type
In the Add Monitoring Configuration panel, select the following parameters for the DB2 Remote Windows connection setup monitor type:
Parameter | Selection |
---|---|
Monitoring Solution | IBM DB2 |
Monitoring Profile | IBM DB2 |
Monitor Type | DB2 Remote Windows connection setup |
To add an environment configuration
Click Add and enter the Environment Configuration details.
Field | Description |
---|---|
Environment Name | Enter a unique environment name for monitoring the DB2 instances. A container is created with the environment name. This environment will hold all the DB2 instances. BMC recommends you to provide only alphanumeric characters in environment name. The name cannot include blank spaces or any of the following special characters: $|?\"[]+=&*();!^<>:/ |
Remote PowerShell details | |
Host/IP | Enter a valid remote Hostname or an IP address. BMC recommends you to provide only alphanumeric characters in environment name. Each environment can contain a single unique host name. |
Port | Enter the Power Shell remote port number. The remote port number is a two digit number. Default port number is 5985. |
OS Credentials | |
User name | Enter the name of the remote PowerShell user (this user must exist where the IBM DB2 system is installed) with permission to run:
Note: If the IBM DB2 database user field is left blank, this user needs the minimum SYSMON authority with DATAACCESS privileges. |
Password Confirm password | The password of the remote PowerShell user. |
Authentication | Select an authentication protocol to connect to the remote host:
|
Use HTTPS | Select the protocol that will be used for the connection. By default, HTTP protocol is used for connection or, you can select HTTPS protocol for connection. |
Remote IBM DB2 details | |
IBM DB2 installation home | Enter the path to the installation base directory or the environment variable that contains installation base directory. Files are installed to the following directories under the installation base directory as depicted in the following example: Windows: UNIX: Note If you enter environment variable, ensure that the variable name begins with DB2PATH for example, DB2PATH3. |
IBM DB2 instance list | Enter a comma-separated list of database instance names which you want to monitor. |
Data encryption authentication | Select this option to enable the IBM DB2 authenticated connection. The connection to IBM DB2 databases will be established using data encrypt (DATA_ENCRYPT) security mechanism. Note Use this option when the IBM DB2 databases are configured as data encrypt (DATA_ENCRYPT). |
IBM DB2 database credentials | |
User name | Enter the name of the user with permissions to connect and run SQL queries on all DB2 databases. The user should have minimum SYSMON authority with DATAACCESS privileges. If this field is left blank, then the remote PowerShell connection user and password will be used. |
Password Confirm password | The password of the DB2 user. |
Java collector settings | |
Java path |
|
JVM arguments | Enter JVM arguments for the DB2 JAVA collector. |
Java OS credentials | |
User name | Enter the name of the OS JVM user (this user must exist where the PATROL Agent and DB2 KM are installed) with permission to run the Java process. Note: If this field is left blank, the KM will use the user that is running the PATROL Agent. |
Password Confirm password | The password of the OS JVM user. |
Monitoring data details | |
Monitoring level | Select the monitoring collection details for monitoring the DB2 instance. Availability - Select this option to check the availability of instances, connections, and databases. Full data monitoring - Select this option to collect all the monitored groups. Custom data monitoring - Select this option to collect only the monitored groups selected from the custom data module types. |
Monitoring categories |
|
Filter configuration by monitor types
Click Add and filter the monitor types for monitoring. For more information, see Using filter configuration by monitor types.
Note
You can filter the monitor types at any instance level within the DB2 hierarchy.
Field | Description |
IBM DB2 instance name | Enter the IBM DB2 instance name. Use comma (,) only to separate the instance names. This field is regex enabled. Note All the defined filters are applicable for the specified DB2 instances. |
IBM DB2 database name | Enter the IBM DB2 database name. Use comma (,) only to separate the database names. This field is regex enabled. All the defined filters are applicable for the specified databases. |
Filters by monitor types list | |
Filtering monitor types | Select the DB2 monitor type for monitoring:
|
Filtering options | Based on the monitor types selected in the above field, select the filtering mode:
|
Filtering instances from the selected monitor type | Based on the selection in the filtering options, specify the instances from the selected monitor type for monitoring. This field is regex enabled. Use comma (,) to define multiple instances for the specified monitor type. |
Custom SQL queries configuration list
Click Add and configure the custom SQL queries section.
Field | Description |
IBM DB2 instance name | Enter the IBM DB2 instance name. It supports regex for monitoring multiple instances. Use comma to separate entries. By default, .* is used which monitors all the instances. |
IBM DB2 database name | Enter the IBM DB2 database name. It supports regex for monitoring multiple databases. Use comma to separate entries. By default, .* is used which monitors all the databases. |
Custom SQL query configuation list | |
SQL query name | Enter the name of the SQL query. This is an user-defined field. Note The name cannot include blank spaces or any of the following special characters: |
SQL query | Enter the SQL query that you want to execute in the database. Note The SQL query must not contain the semicolon (;). For example: |
Collection time (min) | Enter the SQL query collection time in minutes. The default collection cycle is 10 minutes. |
Enable number of records annotation | Select this option to display the query result as an annotation on DB2 custom SQL query number of records metric. |
Note
- All the defined Custom SQL query configuration lists are applicable on the instances and databases specified above.
If you configure multiple lists of DB2 instances and DB2 databases with same SQL query name and matches the same DB2 instance and DB2 database, the last entered list will be displayed. You will get an annotation about the same on Configuration status attribute.
DB2 diag log search configuration list
Click Add and configure the DB2 diag log search configuration section.
Note
You can define multiple search configurations for same instance. In case, if there are multiple search results, the DiagLogOK parameter value will set the value with high priority/severity and displays a detailed annotation for the search commands and their results.
Field | Description |
IBM DB2 instance name | Enter the DB2 instance name. It supports regex for monitoring multiple instances. Use comma to separate instances. Note The defined searches are applicable for the specified DB2 instance. |
IBM db2diag log search criteria list | |
DiagLogOK attribute states | Select the state for monitoring:
|
IBM db2diag tool search command | Specify a command that is supported by the IBM db2diag tool. For example: -lastlines 100 -l Warning Note Be cautious while using this feature, it might affect the performance of the environment monitoring in case if the IBM db2diag tool retrieves a huge chunk of data. |
Administration
Click Add and configure the administration details.
Field | Description |
Logging | Select this option to enable debugging operations for configured environment. This enables the PSL and Java logging of the specified environment. The PSL debug file of the environment is located under:
For example: Patrol3/log/PSO_RemoteWin^DB2Env-IL-hhomndf-W1-3181.kmlog The Java debug file of the environment is located under:
For example: Patrol3/pso/logs/java/RemoteWin^DB2Env_3181_JavaCollector.log.0 |
Availability collection interval (min) | Enter the availability collection time in minutes for the DB2 JAVA collector. |
Data collection interval (min) | Enter the data collection time in minutes for the DB2 JAVA collector. |
IBM db2diag log collection interval (min) | Enter the diag log collection time in minutes for the DB2 JAVA collector. |
Long running data collection queries threshold (sec) | Enter the threshold to monitor the data collection SQL queries that run longer than the number of seconds entered. |
Long running data collection commands threshold (sec) | Enter the threshold to monitor the data collection CLP or OS commands that run longer than the number of seconds entered. |
Device mapping | Select this option to enable device mapping for all hosts in this environment. If enabled, all the monitors gets created within a device according to the discovered host name of the monitored system. If disabled, all the monitors gets discovered under the PATROL Agent host device. |
Disable monitoring for IBM DB2 remote databases | Select this option to disable the discovery of IBM DB2 remote databases. |
Disable monitoring configuration
Click Add and configure the disable monitoring details.
Field | Description |
Disable monitoring environment | Select this option to disable the KM from discovering and monitoring the configured environment. |
IBM DB2 instance disable monitoring list | |
Instance name | Enter the IBM DB2 instance name that you want to disable from monitoring. The disable monitoring file location configuration will be applied to this IBM DB2 instance. Regex is not supported |
Disable monitoring file location | Enter the absolute location of the disable monitoring file. The disable monitoring file should be configured on the IBM DB2 host. Note Once you remove the disable monitoring file from the monitoring system, monitoring will be enabled. |
Global monitoring setting
Field | Description |
---|---|
Logging | Select this option to enable main PSL debug logging for global configuration. The log file path:
|
Disable environments monitoring file location | Enter the absolute location of the disable monitoring file. The disable monitoring file should be configured on the PATROL Agent host. Note Once you remove the disable monitoring file from the monitoring system, monitoring will be enabled. |
Comments
Log in or register to comment.