Agent Setup and Testing
  • 03 Aug 2022
  • 2 Minutes to read
  • Dark
    Light

Agent Setup and Testing

  • Dark
    Light

The Agent server must install the ASP.NET Core Runtime 6.0.5 Hosting Bundle specifically.
Without this, the Agent will fail to communicate or connect with the server by not responding in a timely manner. Other Core Runtime versions do not contain the required DLLs. Please check the server has this installed before proceeding. 

Configuration requires adding and registering an Agent, installing it to a machine, and implementing it into the Decisions environment. Protocol Agents are directly affiliated with network security as well as other aspects. 

Prerequisites

  • Users should have, at minimum, Can Use permissions on a Designer element to use its function with Agents.
  • When registering an Agent, the Decisions instance Portal Base URL can not be localhost. To adjust the Portal Base URL, refer to Changing the Portal Base URL. 

Setup

  1. Navigate to System > Designers > Agents and click ADD/REGISTER AGENT.
  2. Provide a Title and optionally a Description, then click REGISTER AGENT.
  3. Right-click the newly added Agent from the Agents Folder and select Download Agent
  4. Extract the contents of the .zip file. 
  5. As an Administrator, click Install from the download location to create the Decisions Management Agent. 
  6. After the Agent installs, copy over AgentSettings.xml and PortalPublicKey.key to C:\Program Files(x86)\Decisions Management Agent.
  7. On the local machine, search for and open Services.
  8. Locate the Decisions Management Agent Service, right-click and select Start

Testing 

The Agent Dashboard at System > Designers > Agents displays all Deployed Agents and Recent Agent Actions. The Any Unknown Client entity suggests the client is not yet identified.

  1. Navigate to System > Designers > Agents > Test Agent. Ensure that the STATE of the Agent is Complete. A Complete status indicates the client has been identified and is ready for communication.
  2. Under Deployed Agents, right-click the Agent and select Ping Agent. Pinging the Agent checks to see if the Agent is available. 

  3. After the notification displays, refresh the Recent Agent Actions to ensure that the Ping action is executed.
  4. Right-click the Ping Action and click View Results. If applicable, the resulting data from the Agent Action will display.


Confirming if an Agent is in Polling Mode

Agents can enter polling mode if no ports are available, leading to performance issues.

  1. Right-click on a Deployed Agent and select View Last Status. If the agent is properly configured, View Last Status will display Live Connection: True. If this message is not shown, the Agent is currently in polling mode.

Uninstalling and Removing an Agent 

If a user needs to remove an Agent or the Agent needs to be updated and replaced with a new version, Agents in Decisions can be uninstalled from the File System.

  1.  From the File System, open the Control Panel. Under Programs, select Uninstall a Program.
  2.  From the Programs and Features window, locate Decisions Management Agent Bootstrapper, select it, then click Uninstall.
  3. Confirm the uninstall by selecting Yes.
  4. Confirm that the Agent has been uninstalled by navigating to System > Designers > Agents.

For further information on Integrations, visit the Decisions Forum.

Was this article helpful?