Installing High-Volume Agent on Windows using Installer

This section describes the requirements and step-by-step instruction on how to install High-Volume Agent (HVA) on Windows using installer and the initial system configuration.

For installing HVA on Windows using zip file, see .

For installing Local Processing Hub on Windows using installer or zip file, see or respectively.

The installation file for Windows is available for download in .exe and .zip format. The compressed file (.zip) distribution is normally used as an alternative for the Windows executable based (.exe) distribution. Also, the installation steps are different on both formats.

Requirements

Following are the prerequisites for installing HVA on Windows:

Sufficient disk space
Ensure sufficient disk space is available on the machine where this installation will be performed. For more information, see .
Compatibility
Check whether the HVA version is compatible with the operating system and DBMS. Refer to the relevant section or read the COMPATIBILITY section in the release notes (available under the tab in the Fivetran ).
Installation file
HVA installation file for Windows (e.g. fivetran-6.1.0_21-hub_and_agent-windows-x64-64bit_ga_patch-setup.exe). This file can be downloaded from the tab in the Fivetran . For more information, see .
Access to source and target locations
For the HVA to access a source or target database directly, the database connectivity (e.g. ODBC drivers) must be installed on the agent machine. For more information, see .
Windows user account privileges:
- Elevated user account privilege is required for running the HVA executable/installer. Normally this means the user must supply an administrator password interactively.
- The user account (e.g. fivetran) which will operate the HVA must have Log on as a service policy enabled.
  User account policies can be managed using the Windows Local Security Policy console (accessible from Control Panel ▶ Administrative Tools). The shortcut command to access this console is secpol.msc. For more information about enabling this policy, refer to the .

Install Steps

Perform the following steps in the user account that will be used for operating the HVA:

Run the HVA installation file (e.g. fivetran-6.1.0_21-hub_and_agent-windows-x64-64bit_ga_patch-setup.exe).
Click Next in the installation wizard dialog.
Read the License Agreement, select I accept the agreement and click Next.
Specify the installation directory for HVR_HOME, HVR_CONFIG, and HVR_TMP and click Next.
Click Next to create program folder for HVA.
Select High-Volume Agent (HVA) and click Next.
Enter a value for High-Volume Agent Listener Port and click Next.
Select the user account for running HVA services.
- If Specified user is selected, enter values for User, Password, Confirm Password and click Next.
- If Local System account is selected, click Next.
Select Add HVR_HOME, HVR_CONFIG and HVR_TMP, if required, and click Next.
This is to set the environment variables HVR_HOME, HVR_CONFIG, and HVR_TMP in your operating system.
Click Next to initiate the installation.
After the installation is complete, click Finish to start the HVA.
Configure the HVA, which requires setting its network security and authentication properties. This can be done from a web browser (UI) while (provided the agent is in 'setup mode') or from the command-line (CLI).
- For configuring HVA from browser, see .
- For configuring HVA from CLI, see .
By default, after starting the HVA for the first time, it will be available in 'setup mode' for the next 60 minutes. In 'setup mode', you can configure the HVA remotely from the hub machine using browser or CLI. When the 'setup mode' expires after 60 minutes, the agent can not be configured remotely. If you want to re-initiate the HVA 'setup mode' later, use the command directly on the agent machine. For example, to enable 'setup mode' for the next 1 hour, execute:
hvragentconfig Setup_Mode_Timed_Until=now+1h

Testing Connection to a High-Volume Agent

To test the connection to the HVA, execute the command on the machine from which you are connecting to the agent. You can also check whether is running by executing the command directly on the HVA machine.

Examples for testing the connection to a High-Volume Agent

Example 1: Check connection to a High-Volume Agent

You can check the connection to the HVA installed/running on a remote machine with username and password authentication enabled. Execute the following command on the hub machine or on the machine from which you are connecting to the HVA:

hvragenttest -L myuser/mypassword mynode 4343
content_copy

Sample output in Linux with successful authentication and also indicating that the agent listener is running:

hvragenttest: Fivetran 6.1.0/21 (windows-x64-64bit)
hvragenttest: Agent version 6.1.0/21.
hvragenttest: Authentication with username and password enabled.
hvragenttest: Authentication successful.
hvragenttest: Finished. (elapsed=0.34s)
content_copy

Example 2: Check whether hvragentlistener is running

After installing and starting the HVA Listener service, you can verify whether the is running on the agent machine. Execute the following command on the agent machine:

hvragenttest mynode 4343
content_copy

Sample output in Windows with successful authentication indicating that the agent listener is running:

hvragenttest: Fivetran 6.1.0/21 (windows-x64-64bit)
hvragenttest: Agent version 6.1.0/21.
hvragenttest: Authentication with username and password enabled.
hvragenttest: Authentication successful.
hvragenttest: Finished. (elapsed=0.18s)
content_copy