Add Agent to Group

New on-prem group

After you select an on-prem group or create a new group, Workato prompts you to create an agent.

Operating systems

We support the following operating systems:

• Windows
• Linux
  • .tar.gz archive installer
  • DEB package
  • RPM package
• Mac

Click Add on-prem agent to start an agent-creation wizard that sets up, runs, and verifies that your agent is active.

On-premise agent setup wizard

For this example, we set up an on-prem agent on a Windows OS.

Step 1: Choose OS

Provide a meaningful agent name, and select the OS for the agent installation.
Choose OS

Step 2: Accept ToS

Read and accept the End User License Agreement.
Accept ToS

Step 3: Install

Download the installer file to the on-prem system. The wizard provides OS-specific installation insttructions.
Install

Step 4: Add key

Download the agent key, and move it to the appropriate folder in the agent directory, according to the instructions.
Add key

Step 5: Run agent

Follow the instructions to set up and run the agent.
Run agent

Step 6: Test

After the agent becomes active, click Test to verify that the connection is successful.
Test setup

Optional settings on Linux

In the following setting examples, the contents of Workato OPA are in the /opt/workato directory.

Set up Workato user

Create a non-privileged user to run Workato OPA.

$ groupadd -r workato
$ useradd -c "Workato On-Premise Agent" -g workato -s /sbin/nologin -r -d /opt/workato workato

Set up systemd service

Create a systemd service that starts Workato OPA automatically. This prevents disruptions to your critical workflows after the system reboots.

1. Create a systemd service.

$ sudo cat > /lib/systemd/system/workato.service <<EOF
# Systemd unit file for default Workato On-Premise Agent
#
# To create clones of this service:
# DO NOTHING, use workato@.service instead.

[Unit]
Description=Workato On-Premise Agent
After=syslog.target network.target

[Service]
Type=simple
WorkingDirectory=/opt/workato
ExecStart=/usr/bin/java -Djava.security.egd=file:/dev/urandom -cp "/opt/workato/lib/*" com.workato.agent.Main
User=workato

[Install]
WantedBy=multi-user.target
EOF

2. Launch Workato OPA and set it to autostart.

$ systemctl start workato
$ systemctl enable workato

Learn more about Setting up On-prem Agent.