# 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.
- 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
- 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.