Upgrading High-Volume Agent on Linux

This section describes the requirements and step-by-step instruction on how to upgrade the High-Volume Agent (HVA) on Linux.

For upgrading the Local Processing Hub System, see .

In the case of a distributed setup, along with the Local Processing Hub installation, there may be one or more HVA installations on the source and target machines. Since Fivetran Local Data Processing versions 6.1.0 and higher are fully compatible with each other, upgrading all installations may not be required.
Each Fivetran Local Data Processing release contains new features and/or fixes for certain bugs. Each feature or fix is only effective if the correct machine is upgraded. Typically, the release notes (available in HVR_HOME/hvr.rel) contain information about which features and fixes have been added, and which machines must be upgraded for each feature and fix to be effective. New features should not be used until all machines that are specified for that feature are upgraded, otherwise, errors may occur.
For example, if a new release fixes an integrate bug, then that release must be installed on the HVA machine(s) which perform integrate. If only the Local Processing Hub System is upgraded using that release, there will be no benefit.

Requirements

Following are the prerequisites for upgrading the HVA on Linux:

Installation file
New version of HVA installation file for Linux (e.g. fivetran-6.1.0_21-agent_only-linux_glibc2.27-ppc64-64bit_ga_patch.tar.gz). The installation file can be downloaded from the tab in the Fivetran . For more information, see .

Create backup
Before upgrading HVA, it is recommended to take a full backup of the HVR_HOME directory.

Upgrade Steps

Perform the following steps to upgrade HVA:

Stop the HVA Listener service by using the command .
```
hvragentlistener -k port_number
content_copy
```
Install the new version of HVA; uncompress the HVA installation file (e.g. fivetran-6.1.0_21-agent_only-linux_glibc2.27-ppc64-64bit_ga_patch.tar.gz) into the HVR_HOME directory.
```
cd $HVR_HOME
content_copy
```
```
tar xzf /tmp/fivetran-6.1.0_21-agent_only-linux_glibc2.27-ppc64-64bit_ga_patch.tar.gz
content_copy
```
Start the HVA Listener service by using the command .
```
hvragentlistener -d port_number
content_copy
```
Reactivate all channel(s) that contain locations which are using this upgraded agent.
In some cases, other replication components should also be reactivated depending on the type of changes contained in the version being installed.
CLIUI
Run the command with option -i to capture changes from the beginning of the oldest current (not closed) transaction and emit from now. Use option -J to automatically start capture and integrate jobs after replication activation.
```
hvractivate -J cap -J integ -i oldest_tx myhub mychannel
content_copy
```

If the error message about agent certificate validation failure is displayed when connecting to a location using the upgraded HVA, follow the steps in section .