Upgrading DSS Agent on Linux - DSS 6 | Data Source Solutions Documentation
Documentation: Upgrading DSS Agent on Linux - DSS 6 | Data Source Solutions Documentation
Upgrading DSS Agent on Linux
This section describes the requirements and step-by-step instructions on how to upgrade the DSS Agent on Linux.
For upgrading the DSS Hub System, see Upgrading DSS Hub.
In the case of a distributed setup, along with the DSS Hub System installation, there may be one or more DSS Agent installations on the source and target machines. Since DSS versions 6.1.0 and higher are fully compatible with each other, upgrading all installations may not be required.
Each DSS 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 (also available in DSS_HOME/dss.rel directory and on the downloads page) 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 DSS Agent machine(s) that performs Integrate. There will be no benefit if only the DSS Hub System is upgraded using that release.
Requirements
Following are the prerequisites for upgrading the DSS Agent on Linux:
-
Installation file
New version of DSS Agent installation file for Linux (e.g., datasourcesolutions-6.1.0_21-agent_only-linux_glibc2.27-ppc64-64bit_ga_patch.tar.gz). The installation file can be downloaded from the Downloads tab in the Data Source Solutions dashboard. For more information, see Downloading DSS. -
Create backup
Before upgrading the DSS Agent, it is recommended to take a full backup of the DSS_HOME directory.
Upgrade Steps
Perform the following steps to upgrade the DSS Agent:
-
Stop the DSS Agent Listener service by using the command dssagentlistener.
dssagentlistener -k <em>port_number</em> -
Install the new version of DSS Agent; uncompress the DSS Agent installation file (e.g., datasourcesolutions-6.1.0_21-agent_only-linux_glibc2.27-ppc64-64bit_ga_patch.tar.gz) into the DSS_HOME directory.
cd $DSS_HOMEtar xzf /tmp/datasourcesolutions-6.1.0_21-agent_only-linux_glibc2.27-ppc64-64bit_ga_patch.tar.gz -
Start the DSS Agent Listener service by using the command dssagentlistener.
dssagentlistener -d <em>port_number</em> -
Reactivate all channel(s) that contain locations that 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.
{% tabs %} {% tab label="CLI" %} Run the [**dssactivate**](/docs/dss6-command-line-interface-command-reference-dssactivate) command with options **-J** and **-oje**. This will update the job scripts, scheduler jobs, job groups and extend the enrollment details for tables. ```shell dssactivate -J cap -J integ -oje <em>hub channel</em> ``` Alternatively, run the [**dssactivate**](/docs/dss6-command-line-interface-command-reference-dssactivate) command with options **-J** and **-ojE**. This will update the job scripts, scheduler jobs, job groups and recreate the enroll file for all tables in the channel. ```shell dssactivate -J cap -J integ -ojE <em>hub channel</em> ``` {% /tab %} {% tab label="UI" %} 1. Go to the [**Channel Details**](/docs/dss6-user-interface-channels-channel-details) page and click [**Activate Replication**](/docs/dss6-user-interface-channels-activating-replication). 2. In the **Activate Replication** dialog, under [**Replication Components**](/docs/dss6-user-interface-channels-activating-replication#replicationcomponents), select options **Jobs**, **Table Enrollment**, and **Force Start Replication Jobs**. This will update the job scripts, scheduler jobs, job groups and extend the enrollment details for tables. Alternatively, in the **Activate Replication** dialog, under [**Replication Components**](/docs/dss6-user-interface-channels-activating-replication#replicationcomponents), select options **Jobs**, **Table Enrollment**, **Replace All Old Enrollment**, and **Force Start Replication Jobs**. This will update the job scripts, scheduler jobs, job groups and recreate the enroll file for all tables in the channel.  {% /tab %} {% /tabs %}If the error message about agent certificate validation failure is displayed when connecting to a location using the upgraded DSS Agent, follow the steps in section Troubleshooting Access to Agents - Remote Certificate Error.