Skip to content
  • There are no suggestions because the search field is empty.

Remote Agent Installation Guide

This article covers how to install the BUCS Remote Agent for continuous refresh of on-premises data sources

The BUCS Remote Agent allows BUCS to access and continually refresh the on-premises data sources needed for reporting in the BUCS platform. 

System Requirements & Pre-Installation Details

  • 16 GB of RAM
  • 4 CPUs
  • Install on a dedicated server, not a personal computer. The agent must run continuously; installing it on a user's workstation would cause it to stop whenever the computer is turned off or disconnected
  • Ensure your BUCS user has the Agent Manager or Connection Manager role enabled so you can generate the Authorization Key needed for setup. You will also need administrator access to do the following:
    • Access the server where the data source is located
    • Install the BUCS Remote Agent
    • Authorize setup of a new user with read-only access to the data source

🗒️ IMPORTANT

You can install multiple agents, but you can only install one agent per server or host. The agent must be installed where the data source you want to import is accessible. 


1. Click the download link provided by the BUCS team from the machine where it will be installed.

OR 

Click here to access the BUCS agent download link. Use the 64-bit Installer unless BUCS has specified you need the 32-bit Installer.

2. Double-click the installer to initiate the installation process. 

image

3. Click Next to proceed with the setup wizard.

bucs-remote-agent-installation-guide-02-3-proceed-within-the-setup-wizard

 

4. Read the BUCS Terms of Service. Select I accept... and then click Next. 

bucs-upgrade-your-bucs-remote-agent-05-proceed-through-the-setup-wizard

5. Click Install to start the process. 

bucs-remote-agent-installation-guide-04-5-install-the-agent

6. If prompted, click Yes when asked if you are sure you want to allow the BUCS Agent to make changes. This is required to install the program. 

bucs-remote-agent-installation-guide-05-5-install-the-agent

7. In the BUCS Customer Portal, go to Connection Management > Agent Management and click Generate New Key. 

bucs-remote-agent-installation-guide-06-6-obtain-authorization-information

8. Follow the prompts and copy the Authorization Key and Customer Code. You will enter these values in the Remote Agent Configurer App in Step 10. 

💡 NOTE

The Customer Code will always be formatted as "BC_" followed by a string of capitalized letters. 

bucs-remote-agent-installation-guide-07-6-obtain-authorization-information

bucs-remote-agent-installation-guide-08-6-obtain-authorization-information

9. If prompted, click Yes when asked if you are sure you want to allow the BUCS Agent to make changes. This is required to install the program. 

bucs-remote-agent-installation-guide-09-7-provide-authorization-information

10. Enter or paste the values for Authorization Key, Customer Code, and Location Name in the Configurer window that appears. Click Save and then Quit. 

bucs-remote-agent-installation-guide-10-7-provide-authorization-information

11. Click Finish from the setup wizard. 

bucs-remote-agent-installation-guide-11-8-finish-install

🗒️ NOTE

Notify the BUCS team when the BUCS Remote Agent installation is complete.