Installing and Upgrading dsFilter

General Information

 

Before proceeding, determine the type of Linux system you are using: Debian or RPM.

 

dsFilter is currently supported on the following 64-bit Linux operating systems:

 

   - Red Hat Enterprise Linux 9

   - Ubuntu Server 22.04 LTS or Server 20.04 LTS 

Please verify that you have one of the listed Linux OS versions before proceeding with the dsFilter installation.

dsTest checks for compatibility with dsFilter during startup. If dsTest determines that it is incompatible with the installed dsFilter, you may be required to update dsTest before you can start dsTest. See the section on installing dsTest.

Download dsFilter from our secure website: https://dstest.info/loads/

Login using the user name and password supplied by our Support Team.

Click on the desired software package depending upon your Linux distribution, or as instructed by Support:

RHEL: devsol-dsFilterModule_<release>.<build date>-1.x86_64.rpm

Ubuntu (64-bit): devsol-dsFilter_<release>.<build date>_amd64.deb

dsFilter captures traffic on all addresses used by the configured nodes. When using dsFilter, the IP addresses used to configure the dsTest nodes should be different from dsTest's Control Interface - the IP address that dsClient Terminal and dsClient Desktop use to communicate with dsTest. Failure to maintain separate IP addresses for these functions may result in disruption of communications to and from the dsTest server, and/or disruption of testing. The addresses can be on the same or different interfaces.

Follow the instructions in the next section to install or upgrade dsFilter in a Debian system. RPM instructions are below.

Debian Installations and Upgrades

Copy the dsFilter package to the dsTest platform.

This procedure will perform an update/upgrade on your Linux system before installing or upgrading the dsFilter module. Root permission is required.

Ensure that the platform OS is up-to-date.

          >apt-get update

          >apt-get upgrade

Reboot the platform.

          >reboot

Once the platform is back in service, terminate dsTest if it is running and attempt to install or upgrade the dsFilter package with the dpkg command.

New installations might fail, due to dependencies. However, the package will be added to the package database.

          >dpkg -i <devsol-dsFilter-package file>

If the event dependent packages are missing, they should be manually installed using the apt-get install -y command. 

          > apt-get install -y <package>

Use the lsmod command to confirm that the dsFilter module is loaded. 

          > lsmod | grep ds_filter 

Exit root or log out and log back in using an account from the devsol group and launch dsTest. 

 

RPM-based Installations and Upgrades

Copy the dsFilter package to the dsTest platform.

This procedure will perform an update/upgrade on your Linux system before installing or upgrading the dsFilter module. Root permission is required.

Ensure that the platform OS is up-to-date.

          >yum update

Download and install the GNU Compiler Collection and Kernel Development packages.

          >yum install gcc kernel-headers

          >yum install gcc kernel-devel

Reboot the platform.

          >reboot  

Once the platform is back in service, terminate dsTest if it is running and then either install the dsFilter package with the rpm -ivh command or upgrade dsFilter with the rpm -U command.

          >rpm -ivh <devsol-dsFilter-package file>

          >rpm -U <devsol-dsFilter-package file>

Exit root or log out and log back in using an account from the devsol group and launch dsTest.