Wiki Admin

Upgrading DSS Agent on Windows - DSS 6 | Data Source Solutions Documentation

Export as HTML Export as PDF Export as DOCX
Edit

Documentation: Upgrading DSS Agent on Windows - DSS 6 | Data Source Solutions Documentation

Upgrading DSS Agent on Windows

This section describes the requirements and step-by-step instructions on how to upgrade the DSS Agent on Windows.

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 Windows:

  • Installation file
    New version of DSS Agent installation file for Windows. 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:

  1. Stop and delete the DSS Agent Listener service by using the command dssagentlistener.

    dssagentlistener -ahd <em>port_number</em>

  2. Install the new version of DSS Agent using either of the following methods:

    Install DSS Agent on Windows using Installer

    1. Run the DSS Agent installation file (e.g., datasourcesolutions-6.1.0_21-hub_and_agent-windows-x64-64bit_ga_patch-setup.exe).

    2. Click Next in the installation wizard dialog.

    3. Read the License Agreement, select I accept the agreement and click Next.

    4. Specify the installation directory for DSS_HOME, DSS_CONFIG, and DSS_TMP and click Next.

    5. Click Next to initiate the installation.

    6. After the installation is complete, click Finish.

    Install DSS Agent on Windows using Zip file

    Uncompress (unzip) the DSS Agent installation file (e.g., datasourcesolutions-6.1.0_21-hub_and_agent-windows-x64-64bit_ga_patch.zip) into the DSS_HOME directory.

  3. Create and start the DSS Agent Listener service by using the command dssagentlistener.

    dssagentlistener -acs <em>port_number</em>

  4. 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="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, click **Activate Replication**.

{% /tab %}
  
{% tab label="CLI" %}
  
Run the command [**dssactivate**](/docs/dss6-command-line-interface-command-reference-dssactivate) with option `<b>-i</b>` to capture changes from the beginning of the oldest current (not closed) transaction and emit from now. Use option `<b>-J</b>` to automatically start capture and integrate jobs after replication activation.

```shell
dssactivate -J cap -J integ -i oldest_tx <em>hub channel</em>
```

{% /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 DSS Agent - Remote Certificate Error.