Installing and connecting HCL Workload Automation dynamic agent at version 10.2.3

You can install agents at HCL Workload Automation to be able to manage all task integrations.

Installing HCL Workload Automation dynamic agent

To install agents at HCL Workload Automation, version 10.2.3, follow the steps described in Agent installation procedure.

To connect agents at HCL Workload Automation, version 10.2.3 to the HCL Universal Orchestrator environment, perform the following high-level steps:

Create an API Key that has the following security roles permissions:
- REGISTERAGENT.
- ADD for the workstation item in the root folder.
  You can manage security roles from the Orchestration CLI. For more information, see: Managing security roles from the Orchestration CLI.
You can find more information about API Keys in Authenticating the command line client using API Keys.
Deploy the dynamic agent. You can find the procedures for both container and on-premises deployment below:
Deploying in a container
If you are deploying in a container, create a secret to store the API Key. You can create a new secret named <namespace>-waagent-secret adding the WA_API_KEY parameter. Ensure you specify a valid API Key as value of the parameter.
See the following example:
```
apiVersion: v1 
kind: Secret 
metadata: 
  name: <namespace>-waagent-secret
  namespace: <namespace>
type: "Opaque"
data:  
  WA_API_KEY: <validApiKey> 
```
Then, configure the Helm chart replacing the host name of the HCL Workload Automation server with the information for connecting to the HCL Universal Orchestrator agentmanager. For more information, see HCL Workload Automation.
Deploying on-premises
If you are installing on-premises, specify the API key with the -apikey parameter when running the twsinst installation command and set the jwt parameter to true. For more information, see Installing agents. You can find the installation command for Windows and UNIX operating systems below.
Windows™ operating system
Run the following command:
cscript twsinst.vbs -new -uname username -password password -jmport port_number -tdwbport agentmanager_port_number -tdwbhostname agentmanager_host_name -inst_dir install_dir -agent dynamic -addjruntime true -acceptlicense yes -apikey apikey -jwt true -gateway local -gweifport gateway_eif_port
UNIX™ and Linux™ operating systems
Run the following command:
twsinst -new -uname username -jmport port_number -tdwbport agentmanager_port_number -tdwbhostname agentmanager_host_name -inst_dir install_dir -agent dynamic -addjruntime true -acceptlicense yes -apikey apikey -jwt true -gateway local -gweifport gateway_eif_port
For more information about the parameters of the twsinst script, see Agent installation parameters - twsinst script

Configuring HCL Workload Automation dynamic agent

You can find the configuration setting of the agent in the JobManager.ini file.

When you install an agent, an agent ID is generated for the first time and automatically configured inside JobManager.ini. Along with the agent ID, a token (JWT) is created and signed by a certificate provided by the server. The token is stored in a file, you can find the path of the file stored in the property jwt_file (section ITA SSL of ita.ini file). After having registered the agent, the JWT is employed for authenticating every request sent from the agent. For more information, see Managing API Keys from the UI.

Note: If you delete the workstation on which the agent is registered, you have to register the agent again.