Add Agent to Group

New on-prem group

Once you have selected an on-prem group or created a new one, you will then be prompted to create an agent.

Clicking on Add on-prem agent will bring you through an agent creation wizard to setup, run and verify that your agent is active. The wizard will take you through the following steps.

On-premise agent setup wizard

For this example, we will setup an on-prem agent on a Windows OS.

Step	Description
Choose OS	Provide a meaningful agent name and select the OS in which the agent will be installed.
Accept ToS	Read and accept the End User License Agreement.
Install	Download the installer file on the on-prem system. Instructions specific to your OS will be displayed.
Add key	Download agent key and move it into the appropriate folder in the agent directory according to the instructions provided.
Run agent	Follow the instructions to setup and run the agent.
Test	Once the agent is active, click Test to verify that the connection is successful.

Optional settings on Linux

The following settings assume that the contents of Workato OPA is in /opt/workato

Setup Workato user

You can to 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

Setup systemd service

You can create a systemd service that starts Workato OPA automatically. This prevents disruptions to your critical workflows after 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 how to setup an on-prem agent here.