Cloud Platform Agents

cloud-related topic

In SaaS environments, Platform Agent connections are initiated by the Platform Agents connecting to the central instance. This mode is called AgentInitiated, and is configured automatically when you install a Platform Agent.

Process Server Parameters

The RemoteHostName and Port Process Server parameters are unused when the AgentInitiated Process Server parameter is true.

Platform Agent Parameters

Set the Platform Agent's 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>, <partition>, and Process Server name MSLN_UNIXS1 using an encrypted connection.

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

Tip: If you have configured fail-over for the central RunMyJobs Server, you can specify the URL of the fail-over host in /configuration/jcs/security/FailoverContextURL.

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.

Circumventing Digital Signature Verification (Windows only)

If you cannot run the Windows Platform Agent installer (for example, because it is not digitally signed), you can use any ZIP utility (for example, WinZip, 7-Zip, or WinRAR) to extract the archive from the self-extracting executable. Use the following procedure.

  1. Copy the ZIP archive to the destination server.

  2. Extract the contents to the desired installation directory. The decompressed archive will contain a folder with the name of the installer and a file named register.properties. This file contains the configuration information you entered when you created the Platform Agent installer in the Process Server wizard.

  3. Start servicemanager.exe and choose Install. The installer will use the provided properties file to create the Platform Agent.

See Also