Help

App Xchange Agent

Modified: 14 May 2026 App Xchange Workflows Help

The Trimble App Xchange Agent is an essential tool that securely moves data between your systems and the App Xchange Platform.

It is a key technical aspect of App Xchange’s integration solutions when working with certain connectors. This lightweight Windows service acts as a broker between the App Xchange cloud platform and a third-party database. It communicates with many kinds of databases, even those on a local server infrastructure, behind a firewall, and without web-based connectivity. It is essential for running many integrations in the Trimble Marketplace network.

The App Xchange Agent communicates with external platforms via private REST APIs and HTTPS web services to ensure all traffic is secure, encrypted, and authorized. Communications are packaged into encrypted packets, which are issued back to the platform via a response stream for efficient processing. It routinely monitors the cloud platform for instructions and automatically updates itself to the latest version. And because processing occurs on the App Xchange platform rather than the local environment, local resources are protected from expanded or inappropriate use.

The App Xchange Agent has modest system requirements and typically takes less than five minutes to install.

On the connectivity icon Connectivity page, you can view v2 agents under the On-Prem Agents tab and installed v1 agents on the Legacy Agents tab.

If you control the machine that hosts your data, create a new on prem agent when you need to connect to App Xchange. Otherwise, follow connector specific documentation to get support from the appropriate cloud services.

When you create a new agent, give it a helpful name such as the intended Vista instance, computer or machine name.

Run powershell as as administrator on the desired machine, paste and run the install script. If you do not have access to the machine, you can click the top right x to exit and leave the agent in awaiting setup.

The validate step will then show the agent online and ready for use in a connection.

Install the App Xchange Agent

Follow these steps to install the App Xchange Agent on a database.

If your database is hosted on a cloud instance, a support member from this service must complete these steps for you. If your database is self-hosted on a local server, you must be a database administrator to complete these steps on your own.
  1. Ensure that your server where the database is hosted meets the minimum requirements for the App Xchange Agent.

    Operating System: Windows Server 2008 or newer

    Architecture: X64 or x86

    .NET Framework: 4.7.2 or newer (Recommended: Download the latest version recommended by Microsoft)

    System Resources: The App Xchange Agent is resource-efficient and lightweight. Any general-purpose application server comparable to AWS EC2 M5 large is sufficient to host it. It just needs a stable connection that is always up.

  2. Check if the App Xchange Agent is already installed on your server.
    1. In the server where the App Xchange Agent is installed, run the Task Manager.
    2. Select the Services tab.
    3. Determine if the Int.Serv.Core.ConnectorService and Int.Serv.Core.ConnectorService.Monitor services are running.
      • If neither service is present, proceed to the next step.
      • If either service is present, do not install the App Xchange Agent. Instead, email xchange_support@trimble.com using the the following template complete with the necessary information.

        Subject: Please split my App Xchange Agent

        Body:

        Hi, I have an App Xchange Agent that needs to be split. Here is the server and new workspace ID.

        Server: [Enter the name of the application server your agent is installed on]

        New integration workspace ID: [Enter the new integration workspace ID]

        Thank you.

  3. Install the App Xchange Agent.
    1. Find your activation code by opening this connector's workspace in App Xchange, selecting the workspace name or icon below the horizontal workspace horizontal menu, and then scrolling down to the Agent Info section. Record it for later.
    2. Download the latest version of the App Xchange Agent here.
    3. Move the .zip file to the server where the ERP is hosted.
    4. Install the App Xchange Agent by following the instructions in the installation wizard. When prompted, enter your activation code.
The App Xchange Agent is installed. It displays on connectivity icon Connectivity > Legacy Agents.
Once the App Xchange Agent is installed, or if you have any issues, follow up with the integration's deployment team so they can ensure the connection is successfully established.

Restart the App Xchange Agent

Follow these steps when App Xchange Support prompts you to restart the App Xchange Agent.

If a cloud service hosts your server, a support assistant from that service must complete these steps for you. If you host your server on-premise, you must be an administrator to complete these steps.
  1. In the server where the App Xchange Agent is installed, run the Task Manager.
  2. Select the Services tab.
  3. Highlight the service named either Int.Serv.Core.ConnectorService or Ryvit Connector.
  4. Select Restart.
  5. Highlight the service named either Int.Serv.Core.ConnectorService.Monitor or Ryvit Monitor.
  6. Select Restart.
The App Xchange Agent is restarted.
Inform your support assistant.

Run the App Xchange Agent as a Local Admin

Follow these steps when App Xchange Support prompts you to elevate the permissions for your App Xchange Agent.

If a cloud service hosts your server, a support assistant from that service must complete these steps for you. If you host your server on-premise, you must be an administrator to complete these steps.
  1. In the Windows server where the App Xchange Agent is installed, run Services.
  2. Scroll down to find the following services:
    • Int.Serv.Core.ConnectorService (or Ryvit Connector)
    • Int.Serv.Core.ConnectorService.Monitor (or Ryvit Monitor)
  3. Repeat the following steps for both services.
    1. Right-click the service and select Properties.
      The service's Properties window displays.
    2. Select the Log On tab and select the This account checkbox.
    3. In the This account field, enter the local administrator username.
      For example: \Administrator or LocalMachineName\Username
    4. In the Password field, enter the local administrator password. Confirm the password.
    5. Select Apply then select OK.
  4. In the Start Menu, open secpol.msc.
    The Local Security Policy window displays.
  5. Select Local Policies > User Rights Assignment.
  6. Select Log on as a service.
  7. Select Add User or Group... and add the local administrator account.
  8. Select OK.
  9. In Services, right click both services and select Restart.

Submit
Previous
Next