Important This documentation space contains information about PATROL Agents when deployed in a TrueSight Operations Management environment. If you are a BMC Helix Operations Management user, see PATROL Agent 22.4 for BMC Helix Operations Management.

Support for IPv6


PATROL Agent supports IPv6 along with IPv4. PATROL Agent communicates with its Client or Server services through the Internet protocol. The following table shows the combination of the communication that happens between IPv6, IPv4, and DUAL configuration environments.

BindToAddress pconfig variable

You can set the value of the BindToAddress pconfig variable to an IPv4 address and IPv6 address, as per your requirement. If PATROL Agent is installed in a DUAL environment, by default, it starts listening on IPv4 (0.0.0.0) and IPv6 ([::]). If you want PATROL Agent to listen to a specific IPv6 address, you can set the value in the BindToAddress pconfig variable. 

For example, "/AgentSetup/BindToAddress" = { REPLACE = "2001:500:100:1100:5993:180e:8da5:78ec"} 

You can specify more than one address separated by commas. PATROL Agent considers valid values only from the first two entries and ignores the other entries. If you provide first two values as IPv4 address, then only first valid value is considered, that means PATROL Agent gets one IPv4 address to bind with. The same is applicable for the IPv6 address too. 

For more information about the BindToAddress pconfig variable, see Specify network card IP address.

Communication with PatrolCli

PATROL command-line interface (PatrolCli) now supports communication with the IPv6 PATROL Agent. The ping command uses TCP/IP protocol to ping a host. 

You can set the connection preference for communication between the PatrolCli and PATROL Agent in the patrol.conf file. 

The values for ippreference can be set as follows:

  • IPv4: Connect only with IPv4 PATROL Agents
  • IPv6: Connect only with IPv6 PATROL Agents
  • IPv4,IPv6: Preferably, connect to IPv4. If connection with IPv4 fails, connect to IPv6. This is the default preference set.
  • IPv6,IPv4: Preferably, connect to IPv6. If connection with IPv6 fails, connect to IPv4.
Example

[PEM]
clientsetting
port =
ippreference = IPv6,IPv4
end

Communication with pconfig utility

The pconfig utility now supports communication with the IPv6 PATROL Agent. The pconfig utility uses TCP/IP protocol to communicate with the PATROL Agent. 

You can now set the connection preference for communication between the pconfig utility and PATROL Agent in the patrol.conf file. 

The values for ippreference can be set as:

  • IPv4: Connect only with IPv4 PATROL Agents
  • IPv6: Connect only with IPv6 PATROL Agents
  • IPv4,IPv6: Preferably connect to IPv4. If connection with IPv4 fails, connect to IPv6. This is the default preference set.
  • IPv6,IPv4: Preferably connect to IPv6. If connection with IPv6 fails, connect to IPv4.
Example

[PCONFIG]
clientsetting
port =
ippreference = IPv6,IPv4
end

Access Control List

The /AgentSetup/accessControlList variable controls which users are authorized to connect to an agent in which modes from which hosts. 

For each access control list (ACL), the format is a comma-separated list of entries. Each entry has the following format: 

UserName/HostName/Mode 

In the HostName, you can specify an IPv6 address as the host name from which users are authorized to connect to the PATROL Agent. For more information about defining access control lists using IPv6 address, see HostName.

PSL functions

The following PSL functions support IPv6, in PATROL Agent:

For more information about the PSL functions, see PSL-Built-in-Functions.

Related topics

Planning

Installing