Cloud Platform Agents

In cloud environments, platform agent connections are initiated by the agents connecting to the central instance.

Prerequisites

Cloud RunMyJobs or Redwood Finance Automation environment

Configuration

This mode is called AgentInitiated and is configured automatically when you install an agent.

Advanced Configuration

If you cannot run the Windows agent installer, because it is not digitally signed, for example, use a zip utility to extract the ZIP archive from the self-extracting executable such as WinZIP, 7zip, WinRAR, or GNU zip (on UNIX).

Copy the ZIP archive to the destination server.
Extract the contents to the desired installation directory.
Start servicemanager.exe, choose Install, it will use the provided properties file to create the process server.

TLS Environment Variables

Example Extracting the ZIP Archive using GNU zip

$ zip -FJ platform-agent-windows-x86-2023.2.0-20231002_11-Agent.exe --out agent.zip

Process Server Parameters

The RemoteHostName and Port parameters are unused when AgentInitiated is true.

Platform agent parameters

Set the agent_initiated_url parameter file to the following value:

http[s]://<server>:<port>/<context>/ipi-platformagentservice/BusinessKey/<partition>.<process_server_name>

For example, the following will connect to an application server named server running at the port <port>, <context> and <partition> and process server name MSLN_UNIXS1 using an encrypted connection:

https://dublin.runmyjobs.cloud/example-inc/test/ipi-platformagentservice/BusinessKey/GLOBAL.MSLN_UNIXS1

If you have configured fail-over for the central Redwood Server, you can specify the URL of the fail-over host in /configuration/jcs/security/FailoverContextURLregistry entry; this is useful if the DNS entry for the central Redwood Server is not switched. This value will be copied to the agent_initiated_url parameter file when both the connection to the primary node consistently fails multiple times and the connection to the fail-over host was successful. The value of the registry entry will be used to compute the failover_url file which will hold the equivalent agent_initiated_url of the fail-over host.

Auto-Update

AgentInitiated platform agents must be configured for auto-update. The administrator can control whether auto-update should be performed by creating or removing the ${InstallDir}/etc/startup/${instance}/autoupdate directory.

Product Documentation