Installing Remote Agents

Requirements for installation

  • Operating systems supported: Windows Server 2019, Windows Server 2016, Windows 10.

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

  • EFT computer may need to reboot after installing

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

If prerequisites are not installed (includes installer wizard):

EFTRemoteAgentBundle.exe, a bootstrapper package in ..\ProgramData\Globalscape\EFT Server\RemoteAgent (or the ..\HA\Remote Agent folder on the EFT computer), contains the MSI, verifies/ 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\Remote Agent on the EFT computer.

If prerequisites already installed (silent installation):

EFTRemoteAgent.msi does not contain the prerequisites. EFTRemoteAgent.msi is mainly used for System Center Configuration Manager (SCCM), group policy deployment, 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 /i accepteula="yes" host="localhost" port=443 tid="075a9515-7861-4ecc-b56a-02d1e6c0cd25"

    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).

  5. 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.

  4. Click Install. The installer appears.

  5. Click Next. The End-User License Agreement appears.

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

  7. 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.)

  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