Upgrade Guide

Upgrade Guide to Netify Version 5

Upgrading from Version 4

Generally, the version 5 Netify Agent is a drop-in replacement with a few exceptions.

  • Renaming of default configuration directory from /etc/netify.d to /etc/netifyd
  • Migration of a few important configuration files
  • Setting up, as required, free plugins that now perform some of the tasks the agent used to handle

Step 1 - Perform a Backup

It's never a bad idea to have a fallback set of files just in case things go South. 

tar -czvf ~/netify-backup.tar.gz /etc/netifyd.conf /etc/netify.d

Step 2 - Stop the Netify Agent Daemon

Stopping the agent will ensure nothing is being written to or in use that might overlap with the new version. 

sudo service netifyd stop

The above command is an example for environments using SystemV. Please take a look at the stop command for your operating system found here.

Step 3 - Move Directory

Netify version 3 and 4 stored persistent data in the folder /etc/netify.d. The configuration files in this folder are largely in the same format but are located in /etc/netifyd. Move the folder name by running: 

sudo mv /etc/netify.d /etc/netifyd

Step 4 - Move Netify's Configuration File

Netify's main configuration file, /etc/netifyd.conf is named the same in versions 3, 4 and 5, but there are different options depending on what version you're running. It is best to start with the package installer's version of the config file, and then diff these files to see what might need to come over. 

mv /etc/netifyd.conf /etc/netifyd.conf.old

Step 5 - Uninstall the Old Package

Remove the old package by running:

Systems using apt (Debian, Ubuntu etc.)
apt remove netifyd
Systems using pkg (BSD, pfSense, OPNsense etc.)
pkg remove netifyd
Systems using opkg (OpenWRT)
opkg remove netifyd

Step 5 - Install the Netify Version 5 Package

Install Netify Version 5 according to your Operating System/Architecture

Step 6 - Socket Programming (optional)

If you were using sockets to extract metadata from real-time flow classifications, install and configure the following packages:

Step 7 - Netify Informatics (optional)

If you were subscribed to Netify Informatics, install and configure the following packages:

Next, run: 

sudo netifyd --enable-informatics

Step 8 - Restart the Agent

sudo service netifyd start

The above command is an example of environments using SystemV. Please take a look at the start command for your operating system found here.

If you have installed additional packages dependent on the older version of Netify, you may need to include them in the remove command.

Upgrading from Version 3

Follow instructions for version 4 to Version 5 upgrades.

Documentation


Netify DPI Agent


Technical Support

Haven't found the answers you're looking for?

Contact Us