Help

Install the App Xchange Agent on a Vista Server

Modified: 16 Jun 2026 App Xchange Workflows Developer / API Help

Installing the App Xchange Agent on the local or cloud server hosting your Vista instance allows it to connect directly to App Xchange services.

Ensure that your local or cloud server meets the minimum requirements for the App Xchange Agent.

If you are a Vista Cloud customer, you must have Vista support access. If you are a Vista on-prem customer, you must be a Vista administrator to complete these steps on your own.

Ensure you have completed the following tasks:
To Install on a Cloud Server:

Sign into Trimble Support and create a case. Enter the following information and leave all other fields blank.

  • Account: Select your account (this is usually auto-populated)
  • Case Type: Select Product Support & Account
  • Product: Select Vista/Vista Web
  • Application: Select Vista
  • Support Category: Select Azure Virtual Desktop
  • Subject: Enter App Xchange Agent Install Request
  • Description:

    Please install the App Xchange Agent onto our D2 server. Here is the required information for the installation.

    Activation Code: [Find your activation code by opening this connector's workspace in App Xchange, selecting the workspace name below the horizontal workspace horizontal menu, and then scrolling down to the Agent Info section]

    Server Name: [Enter the name of the server your Vista instance is hosted on]

    Workspace ID: [Enter your App Xchange workspace ID (for example, 2296 if your workspace URL is https://app.xchange.trimble.com/workspaces/2296/dashboard)]

    Vista Service User name: [Enter the Vista Service User name you previously created (for example, XChangeProjectSight)]

    Thank you.

    Tip: The D1 server hosts your data, while D2 manages access to the web. The Vista team installs the agent on your D2 server, which then makes a connection to the D1 database server you identify in the connection.

Once the App Xchange Agent is installed, follow up with the integration's deployment team so they can ensure the connection is successfully established.

Note: The App Xchange Agent will be hosted free of charge for Viewpoint One or Trimble Construction One customers. You must send them the activation code.
To Install on an On-Prem Server:
  1. Ensure that your server where the ERP is hosted meets the minimum requirements for the App Xchange Agent.
    For more information, see App Xchange Agent.
  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, create a Product Support case through the

        Trimble Support Center.

        Subject: Please split my App Xchange Agent

        Description:

        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.
  4. Once the App Xchange Agent is installed or connected, follow up with the integration's deployment team so they can ensure the connection is successfully established.
The App Xchange Agent is installed.
Step 4 of Connect Vista with App Xchange
Submit
Previous
Next