> For the complete documentation index, see [llms.txt](https://docs.unimarket.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.unimarket.com/documentation/unimarket-integration-middleware/workato-on-premise-agent-opa.md). # Workato On-Premise Agent (OPA) Unimarket integrations use Workato as a SaaS-based middleware for establishing connections between Unimarket and a customer's Finance/ERP and other third-party systems. Workato can establish direct connections for Web Services and REST APIs, and has multiple prebuilt Connectors. When a direct connection between Unimarket and a customer's systems cannot be established, and a database connection is needed from behind the firewall, Workato's On-Premise Agent (OPA) allows Workato to establish a secure connection and poll from the Agent back to Workato — reducing the need for inbound firewall rules and exposure. Details can be found on the [Workato help documentation site](https://docs.workato.com/on-prem.html#how-it-works). {% hint style="info" %} The Workato On-Premise Agent is replacing the legacy [Unimarket Connector Platform (UCP)](/documentation/unimarket-integration-middleware/unimarket-connector-platform.md) for all customer integrations. {% endhint %} ## How It Works Workato on-prem connectivity has two core components: * Tunneling * Database, file system, and application access. The on-prem agent runs within the customer's server, typically behind a firewall, and establishes a TLS WebSocket tunnel to connect out to Workato. Because the on-prem agent is within the same network as systems behind the firewall, it can safely access the customer's systems and act as the agent to communicate securely out to Workato. ## Supported Operating Systems The on-prem agent runs on the following systems: * Linux (64-bit) * Windows 7, 10, 11 (64-bit) * Mac OS X * Windows Server 2008 and newer (before OPA [v2.8.0](https://docs.workato.com/on-prem/agents/versions.html#v2-8)) * Windows Server 2012 R2 and newer (OPA [v2.8.0](https://docs.workato.com/on-prem/agents/versions.html#v2-8) onwards) Minimum hardware requirements are: * 8 GB of RAM * 768 MB of disk space * 800 MHz 64-bit CPU (Intel/AMD) {% hint style="info" %} Unimarket provides a Demo/Test and a Production environment. Each environment connects to a separate Workato Agent, which needs to be hosted on a separate server or VM. {% endhint %} ## Installing the Workato On-Premise Agent (OPA) Installing the On-Premise Agent (OPA) is quick and easy on Linux or Windows host environments. Installation and confirming the connection can take as little as 15 minutes, using a Linux DEB or RPM package, a Windows package, or a Docker image. Unimarket provides a secure activation key that connects the On-Premise Agent to the customer's instance. ### Installation Details * [Linux DEB Package](https://docs.workato.com/on-prem/groups/add-agent/linux-deb.html) * [Linux RPM Package](https://docs.workato.com/on-prem/groups/add-agent/linux-rpm.html) * [Windows Package](https://docs.workato.com/on-prem/groups/add-agent/windows.html) * A `config.yaml` file may be required to set up certain connections, such as Oracle JDBC connections, to contain the host, port, DB instance, and user credentials. See the [config.yaml article](https://docs.workato.com/on-prem/agents/connection/profile.html#basics) for examples of Connection Profiles. * [Docker Image](https://docs.workato.com/on-prem/groups/add-agent/docker.html) * [macOS Package](https://docs.workato.com/on-prem/groups/add-agent/macos.html) ## Maintaining and Updating the On-Premise Agent (OPA) Maintaining and updating the On-Premise Agent (OPA) is easy and recommended during regular server maintenance cycles. Workato releases regular patches and updates, listed on their [Release Version site](https://docs.workato.com/on-prem/agents/versions.html). For security purposes, the Workato OPA certificates are set to renew annually — see [Renew the Workato OPA Certificate](/documentation/unimarket-integration-middleware/renew-workato-opa-certificate.md). ### Linux RPM Package Update Upgrade the agent using the following command: ```bash sudo yum upgrade workato-agent.x86_64 ``` The service should automatically stop, upgrade, and restart for systemd-based distributions. If that doesn't happen, do it manually. ### Linux DEB Package Update Upgrade the agent using the following command: ```bash sudo apt upgrade workato-agent ``` The service should automatically stop, upgrade, and restart for systemd-based distributions. If that doesn't happen, do it manually. ### Windows Package Update Upgrading on Windows requires uninstalling the existing agent service before installing the new version. Full steps and details are on the [Workato Windows OPA Upgrade site](https://docs.workato.com/on-prem/agents/upgrade.html#upgrade-the-existing-agent-by-replacing-the-old-one). Unimarket can provide the upgraded package directly from Workato — create a support ticket by emailing to request the latest Windows OPA install package. ## Roles and Responsibilities ### Customer Is Responsible For * Providing and maintaining the host environment and OS. * Applying OS security patches/updates. * Installing the On-Premise Agent (OPA) using the provided install packages. * Maintaining OPA updates using the provided update packages, recommended during regular server maintenance cycles. * Annually renewing the OPA certificate. ### Unimarket Is Responsible For * Establishing the Workato Workspace for each customer and provisioning the TEST and PROD environments. * Establishing the On-Premise Agent (OPA) Group within each provisioned environment (TEST/PROD). * Providing the install packages based on the host environment OS. * Providing the Activation Key for all On-Premise Agents. * Assisting with troubleshooting connection or On-Premise Agent issues. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.unimarket.com/documentation/unimarket-integration-middleware/workato-on-premise-agent-opa.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.