Configuring Docker using PATROL consoles

After you install PATROL for Docker, you must load the Knowledge Module (KM) into the PATROL consoles and then configure the product. The following sections describe the tasks that you must complete before you can start using the KM:


Related topics

Configuring Docker Host

In either the Desktop tree tab or the work area, right-click a computer or application icon and select KM Commands from the pop-up menu. PATROL displays a pop-up menu that lists KM-specific commands. 

Use the Configure Docker dialog box to add a Docker host for monitoring. Read through the prerequisites before you start with the KM configuration process. This dialog box contains the following items:

FieldsDescription
Monitoring ModeSelect the entity that you want to monitor. You can either monitor a Docker Swarm or a Docker Host.
Docker host name

If you are monitoring a Docker host, enter the host name or the IP address of the Docker engine.

If you are monitoring a Docker Swarm, enter the host name or the IP address of the Manager node.

Note: The IP address must be entered in square brackets.

Port number

If you are monitoring a Docker host, enter the port number of the docker daemon configured for remote connections.

If you are monitoring a Docker Swarm, enter the same port number for all the daemons of all nodes.

Protocol

Select one of the following protocols for connection:

  • Http
  • Https
Client Certificate File Path (.pfx)

Enter the path (along with the file name and .pfx extension) where the certificate file is located.

Note:

Certificate Based Authentication is required when the connection protocol is set to HTTPS.

The password certificate file must reside on the host where the PATROL Agent is running.

BMC PATROL default account must have read permission on the directory where the client certificate file is located.

Client Certificate Password

Enter the password used for exporting the client certificate file.

Container Name Filter

Specify a regular expression to filter containers that you want to include or exclude from monitoring.

  • A pipe-separated (|-separated) list of containers that you want to include or exclude from monitoring
  • A regular expression to filter containers that you want to include or exclude from monitoring
IncludeSelect to include only those containers that satisfy the regular expression.
Exclude

Select to exclude only those containers that satisfy the regular expression.

 
AddClick to add the host to the configured hosts list.
RemoveClick to remove the configured host or swarm. No confirmation dialog box appears. After you select Remove and Apply, the selected account is removed.
Configured NodesDisplays a list of configured Docker nodes.
ApplyClick to apply the configuration.
CloseClick to exit without saving any changes.

Configuring JAVA Runtime Environment 

By default, BMC PATROL for Docker uses Java Runtime Environment (JRE) that is installed with the PATROL Agent. However, you can configure BMC PATROL for Docker to use your own JRE. Use this dialog box to specify a different Java home directory.

This dialog box contains the following item:

Item
Description
Specify JRE Version

Enter the complete path for the Java home directory if you are not using the JRE that is installed with the PATROL Agent.

For example, if your Java executable exists in the /usr/java/jdk1.8.0_45/jre/bin/java path, specify /usr/java/jdk1.8.0_45/jre as the value of this field.

Note

If you have specified a different path in this field, restart the BMC PATROL Agent to apply the changes.

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

Comments