Skip to main content

Manage relays

In briefA relay is the software you install on your own network so that legacy LSAM machines, and OpCon MFT, OpCon RPA and EASE agents, can run jobs Continuum dispatches from the cloud. It connects outbound only and authenticates with a credentials.json file. You download it and register it on Agents › Relays, install it on a Linux or Windows host, and then register the agents behind it on the Agents tab.

Notes
  • Download Relay creates nothing and issues no credential, so you can fetch the software first.
  • The installers take the connection details as arguments; re-running one to upgrade or change a setting keeps every option you don't pass.
  • A newly registered relay reads Offline until it is installed and first checks in.
  • The Relays tab and each of its actions need their Relays permission.
  • GET http://localhost:8080/health returns 200 once the relay is ready and 503 while it starts.
  • A relay started twice serves from one process; the other waits as a standby and takes over if the first stops. The Relays tab badges a relay running as more than one process, and shows No Standby on an online relay running as one.
  • Hand Over, in Edit Relay, moves a relay to a ready standby before planned maintenance. It needs Relays Edit and cannot be cancelled once it starts.
  • A clean stop shows in about a second and raises an Agent Offline for each of its legacy agents; an abrupt loss takes about two minutes, and the agents read Unknown, then Offline if the relay is still gone after an hour.
Watch out
  • The Client Secret is shown once. If it is lost, rotate the credentials rather than re-registering.
  • Deleting a relay that still has jobs ends them: they fail and are not retried. Stop the relay and wait a minute first.
  • A legacy agent with no Default event environment loses every event its machine raises.
  • An out-of-date relay can fail or quietly drop newer features; upgrade it with each platform release, and check its Version on the Relays tab afterwards.
  • On Windows, let the installer stop and restart the relay during an upgrade; a relay you stopped first stays stopped.