# 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.
|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
# 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 Environment="NAME=" EnvironmentFile=/etc/sysconfig/workato 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.