Installing Remote Agents

Requirements for installation

  • To install Agents you must have sufficient administrator privileges to the Agent’s installation and configuration folders.

  • Operating systems supported on RAM computers: Windows Server 2022, 2019, and 2016, Windows 10/ 11.

  • HTTP/HTTPS module

  • SSL must enabled and available on port 443

  • Visual C++ and Redistributable for Visual Studio (for installation).

  • EFT server must be registered

  • After installation, the computer may require a reboot.

If prerequisites are not installed (includes installer wizard):

EFTRemoteAgentBundle.exe, a bootstrapper package in ..\ProgramData\Globalscape\EFT Server\RemoteAgent (or the ..\<HA_share>\Remote Agent folder on the EFT computer), contains the MSI file, verifies and installs the prerequisites and the application. You can run the EFTRemoteAgentBundle.exe and manually input the host, port, and template ID. The EXE file has an installer wizard in which you input the host, port, and Template ID. You can still use the EFTRemoteAgentBundle.exe if the prerequisites are installed.

NOTE: The script URL for downloading EFTRemoteAgentBundle.exe can be found in the Remote Agent Template interface in EFT, ..\ProgramData\Globalscape\EFT Server\RemoteAgent, and ..\<HA_share>\Remote Agent on the EFT computer.

If prerequisites already installed (silent installation):

The EFTRemoteAgent.msi file does not contain the prerequisites. The EFTRemoteAgent.msi is mainly used for System Center Configuration Manager (SCCM), group policy deployment, or if you want a silent installation.

To install the Remote Agent

  1. The EFT administrator should make the EXE available to download via WTC or a shared Workspace by creating a Remote Agent Template.

  2. On the Remote computer, log in to the WTC and download EFTRemoteAgentBundle.exe.

  3. The Remote Agent can be installed at command line using the default script in the folder in which you downloaded the EXE. Ensure that the EXE is in the same directory as you run the script.

    4. EFTRemoteAgentBundle.exe /s acceptEula="yes" host="localhost" port=443 tid="075a9515-7861-4ecc-b56a-02d1e6c0cd25" AUTODETECTPROXY=false

    The script completes the host, port, and agent template ID (tid) fields (as shown in the script and in the Remote Agent Template in EFT).

  4. After the Agent is installed, you will need to create at least one Agent rule.

Manual Installation

For manual installations (below), the EFT administrator will have to provide the EFT host address, port, and Template ID so that you can enter the information manually.

USE THE PROCEDURE BELOW FOR MANUAL INSTALLATION IF YOU CAN'T USE THE SCRIPT DESCRIBED ABOVE

To install the Remote Agent Bundle

  1. Before beginning installation, be sure you have the host address, port number, and agent template ID (tid) shown in the Remote Agent Template in EFT.

  2. On the computer on which the Remote Agent is to be installed, run the installer in \ProgramData\Globalscape\EFT Server\RemoteAgent. The Remote Agent Bootstrapper installer wizard appears.

    3. The bootstrapper checks for and installs prerequisites, if not already installed, then launches the Remote Agent installer wizard.

  3. Click Install. The installer appears.

  4. Click Next. The End-User License Agreement page appears.

  5. Select the check box, then click Next. The Configuration screen appears.

  6. If you are running the installer manually (not from a script) you must provide the EFT server host address, EFT server port, and Remote agent template ID. (The EFT administrator can provide you these from the Remote Agent Template as show in the script procedure above.)

  7. Select the Use network connection proxy settings from Internet Explorer check box to use the system's default proxy settings (that is, the configuration in Internet Explorer under Internet Options > Connections tab > LAN settings for proxy, which is used by all apps that require Internet access).

    8. NOTE: Event rules configured with a proxy will use that proxy even if autodetect is enabled when Remote Agent is installed (can be changed if needed). The "Silent install" URL is:
    EFTRemoteAgentBundle.exe /s accepteula=yes host="localhost" port=443 tid="a247515e-396c-4932-a67a-d342363fc45c" AUTODETECTPROXY=false

  8. Click Next. The Destination Folder screen appears.

  9. By default, the Remote Agent is installed in C:\Program Files\Globalscape\EFT Remote Agent. If you want to install in a different location, click Change.

  10. Click Next. The Ready to install screen appears.

  11. Click Install. The Finished screen appears.

  12. Click Finish.

  13. Click Close to exit the installer.

On the EFT computer, under the Remote Agents node, you will see the Remote Agent connect to EFT. If manual enrollment is specified, you will need to click the Remote Agent in the list, then click Approve. You may have to wait for the next update to see a change in status.

Next step: Create a Remote Agent Event Rule