How to Upgrade High-Volume Agentlink
Updated 13 days ago
Follow the instructions below to upgrade your High-Volume Agent installation.
NOTE: A new version of HVA can be downloaded from your HVA connector's setup form.
Upgrading HVA on Linuxlink
Expand for instructions
This section describes the requirements and step-by-step instructions for upgrading HVA on Linux.
Requirementslink
- HVA installation file
- Before upgrading HVA, it is recommended to take a full backup of the
HVR_HOMEdirectory.
Upgrade stepslink
Pause the connector from the Fivetran dashboard. On the connector dashboard, set the connector status toggle to PAUSED, ensuring that a sync is not taking place.
Stop the Agent Listener service:
If you configured the agent using
systemd, stop the socket.sudo systemctl stop hvr.socketcontent_copyIf you configured the agent to run as a daemon process, stop the service using command
hvragentlistener.hvragentlistener -k <agent_port_number>content_copy
Install the new version of HVA; uncompress the HVA installation file into the
HVR_HOMEdirectory.cd $HVR_HOME tar -zxzf <hva_installation_file>.tar.gzcontent_copyStart the Agent Listener service:
If you configured the agent using
systemd, start the socket.sudo systemctl start hvr.socketcontent_copyIf you configured the agent to run as a daemon process, start the service using command
hvragentlistener.hvragentlistener -d <agent_port_number>content_copy
Upgrading HVA on Windowslink
Expand for instructions
This section describes the requirements and step-by-step instructions for upgrading HVA on Windows.
Requirementslink
- HVA installation file
- Before upgrading HVA, it is recommended to take a full backup of the
HVR_HOMEdirectory.
Upgrade stepslink
Pause the connector from the Fivetran dashboard. On the connector dashboard, set the connector status toggle to PAUSED, ensuring that a sync is not taking place.
Stop the Agent Listener service (refer to Microsoft Windows documentation for steps to configure services).
Install the new version of the agent using either of the following methods:
Install HVA on Windows using EXE file
Perform the following steps as the user that runs the HVA. We recommend running the HVA as an Administrator user or a user that has permissions to access the
.ldfand.mdffiles generated by your SQL Server database.Windows user account permissions:
NOTE: HVA's installation file for Windows is available in the
.exeand.zipformats. The compressed file (.zip) distribution is normally used as an alternative for the Windows executable based (.exe) distribution. The steps to install HVA are also different for both formats.Run the downloaded
.exefile (for example,hvr-6.1.0_10-hub_and_agent-windows-x64-64bit_ga_patch-setup.exe).In the setup wizard dialog, click Next.
Read the License Agreement, select I accept the agreement and then click Next.
Specify the HVA installation directories and click Next.
Click Next to create a program folder for HVA.
Select High-Volume Agent (HVA) and click Next.
Enter a value for Agent Listener Port and click Next.
Select the user account to run the HVA service.
If you select Specified user, enter the values for User, Password, Confirm Password and click Next.
NOTE: For user with Windows authentication (if applicable), specify your Active Directory domain and username in the format
<domain>\<username>.
If you select Local System account, 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, andHVR_TMPin your operating system. These variables point to the corresponding directories created in step 4 above.
Click Next to initiate the installation.
Click Finish to start the HVA service.
Once the installation is complete, the HVA and all required components are installed into the
$HVR_HOMEdirectory (C:\hvr\hvr_home).NOTE: The size of the installation is less than 150 MB. After installing (extracting), you can delete the installation file as it is no longer required.
Install HVA on Windows using ZIP file
Uncompress (unzip) the HVA installation file into the
HVR_HOMEdirectory.Start the Agent Listener service (refer to Microsoft Windows documentation for steps to configure services).
Upgrading HVA on Unixlink
Expand for instructions
This section describes the requirements and step-by-step instructions for upgrading HVA on Unix (Solaris, AIX, HP-UX).
Requirementslink
- HVA installation file
- Before upgrading HVA, it is recommended to take a full backup of the
HVR_HOMEdirectory.
Upgrade stepslink
Pause the connector from the Fivetran dashboard. On the connector dashboard, set the connector status toggle to PAUSED, ensuring that a sync is not taking place.
Stop the Agent Listener service:
- If you configured the agent using
inetd, stop theinetdservice (refer to the OS instructions).
NOTE: If you are on Solaris and used Service Management Facility (SMF), run the following command to refresh the service:
svcadm refresh inetdcontent_copyIf you configured the agent to run as a daemon process, stop the service using command
hvragentlistener.hvragentlistener -k <agent_port_number>content_copy
- If you configured the agent using
Install the new version of HVA; uncompress the HVA installation file into the
HVR_HOMEdirectory.cd $HVR_HOME gzip -dc <hva_installation_file>.tar.gz | tar xf -content_copyStart the Agent Listener service:
If you configured the agent using
inetd, reload theinetdservice to apply the changes (refer to the OS instructions).If you configured the agent to run as a daemon process, start the service using command
hvragentlistener.hvragentlistener -d <agent_port_number>content_copy