Configuring dynamic agent communications through a gateway

In some complex network topologies, the master domain manager or the dynamic domain manager are prevented from directly communicating with the dynamic agent.

Before you begin

In a simple configuration, dynamic agents connect directly to the master domain manager or to the dynamic domain manager. However, in more complex network topologies, if the network configuration prevents the master domain manager or the dynamic domain manager from directly communicating with the dynamic agent, for example, if the agents are behind a firewall and need to communicate through the internet, or if they need to communicate with a Network Address Translation (NAT) process, then you can configure your dynamic agents to use a local or remote gateway.

About this task

You can set up your dynamic agents to use a gateway for communication with the master domain manager or to the dynamic domain manager when you install a dynamic agent, or you can configure a gateway subsequent to the installation.

For information about the gateway parameters available with the installation of a dynamic agent, see Agent installation parameters - twsinst script.

To configure an existing HCL Workload Automation version 9.2 or later dynamic agent to communicate to its master domain manager or dynamic domain manager through a local gateway, perform the following configuration steps:

Procedure

  1. Edit the JobManager.ini file on the dynamic agent workstation that you want to configure to communicate through a gateway. Edit the [ResourceAdvisorAgent] section so that the value of the ResourceAdvisorURL parameter is https://$(tdwb_server):$(tdwb_port)/ita/JobManagerGW/JobManagerRESTWeb/JobScheduler/resource , where, $(tdwb_server) and $(tdwb_port) correspond to the host name and port of the gateway that you want to use for communication with the master domain manager or the dynamic domain manager.
  2. Stop and start the dynamic agent to implement the changes.

Results

The master domain manager or dynamic domain manager can now communicate with the dynamic agent workstation through the gateway.
Note:
  • If you have more than 100 dynamic agents that communicate through one single gateway to the master domain manager or dynamic domain manager, in the JobManagerGW.ini file on the dynamic agent workstation where the gateway resides, set the ActionPollers parameter as described in Configuring general properties [ITA].
  • Only for version 9.5 Fix Pack 4, if you install your agents so that they communicate with the master through a remote gateway, ensure that they can reach the master directly at installation time. For more information, see Dynamic agent gateway installation examples

Example

The following diagram depicts a network topology where the master domain manager communicates to the dynamic agents, located behind a firewall, through a gateway configured on one of the dynamic agents.

Network topology showing three dynamic agents: Dynamic agent 1, 2, and 3 behind a firewall, where Dynamic agent 1 and 3 communicate with the master domain manager through a local gateway, and Dynamic agent 2 communicates through the remote gateway on Dynamic agent 1.
The following are the configuration settings used in the network topology depicted in the figure:
Table 1. Configuration settings
Dynamic Agent Configuration File Parameter Value
Dynamic Agent 1 - Local gateway JobManager.ini

Section
[ResourceAdvisorAgent]
ResourceAdvisorUrl

https://
$(tdwb_server):
$(tdwb_port)/ita/
JobManagerGW/
JobManagerRESTWeb/
JobScheduler/resource
where,
$(tdwb_server)
The host name of the Dynamic Agent 1 workstation.
$(tdwb_port)
The port number of the Dynamic Agent 1 workstation.
Dynamic Agent 2 - Remote gateway JobManager.ini

Section
[ResourceAdvisorAgent]
ResourceAdvisorUrl

https://
$(tdwb_server):
$(tdwb_port)/ita/
JobManagerGW/
JobManagerRESTWeb/
JobScheduler/resource
where,
$(tdwb_server)
The host name of the Dynamic Agent 1 workstation.
$(tdwb_port)
The port number of the Dynamic Agent 1 workstation.
Dynamic Agent 3 - Local gateway JobManager.ini

Section
[ResourceAdvisorAgent]
ResourceAdvisorUrl

https://
$(tdwb_server):
$(tdwb_port)/ita/
JobManagerGW/
JobManagerRESTWeb/
JobScheduler/resource
where,
$(tdwb_server)
The host name of the Dynamic Agent 3 workstation.
$(tdwb_port)
The port number of the Dynamic Agent 3 workstation.

What to do next

For more information about the parameters in the JobManager.ini and JobManagerGW.ini files, see Configuring the agent.

To see an example of the installation parameters that must be specified to configure a gateway when installing a dynamic agent, see Example installations and Dynamic agent gateway installation examples.