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.1 for BMC Helix Operations Management.

Connecting to systems having multiple network cards

If an agent is running on a computer that has multiple network interface cards (perhaps one dedicated to a private network and another dedicated to a public network), you must instruct the agent about which one to use when connecting to consoles and other utilities.

Note

You must create the BindToAddress and PortConnectType variables. They are not created during the installation of the PATROL Agent. For more information about these variables, see Agent-setup-variables

 Specify network card IP address

The /AgentSetup/BindToAddress configuration variable specifies which IP Address, and thus which network card, the PATROL Agent uses to communicate with consoles or other utilities in a system with multiple network cards. You can specify an IPv4 or an IPv6 address.

Note

Before defining the BindToAddress pconfig variable, back up your agent Configuration Change File (user-defined_filename.cfg), which contains any customizations that you made to agent configuration variables. Backing up this file ensures that you can restore the agent to its previous state if your BindToAddress definition produces unexpected or undesirable result.


 


Incorrect IP address

If the IP address is incorrect, the PATROL Agent starts. However, the PATROL Agent cannot listen on any default IP address. It writes error messages, similar to the following ones, to the PATROL Agent Error Log.

Example 1:

Tue Apr 19 20:24:37 2011: ID 102011: E: TCP listener failed err = -14/10049
Tue Apr 19 20:24:37 2011: PatrolAgent-W-EINTERNAL: Sess Init failed: err = -14/10049


Example 2:

Tue Apr 19 19:36:55 2011 PatrolAgent-W-EINTERNAL: Sess Init failed: err = -14/99 (/local-build/Patrol/3.9.00/src/agent/mainloop.c 443)
Tue Apr 19 19:36:55 2011: ID 102011: E: TCP listener failed err = -14/99
Tue Apr 19 19:36:55 2011: PatrolAgent-W-EINTERNAL: Sess Init failed: err = -14/99

Set communication protocol

The /AgentSetup/PortConnectType configuration variable specifies the communication protocol for a connection established through the port specified by the BindToAddress configuration variable.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*