Upgrade Guide to Netify Version 5

If you are upgrading from version 3, please review the Version 4 upgrade

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

• Renaming the 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

Creating a backup before upgrading is strongly recommended as a precaution against unexpected issues.

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

Step 2 - Stop the Netify Agent

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. Refer to the stop command for your operating system in the Init and Start/Stop documentation.

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 the available options differ between versions. It is recommended to begin with the package installer's version of the configuration file, then compare the two files to identify any settings that should be migrated.

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 6 - Install the Netify Version 5 Package

Install Netify Version 5 according to your Operating System/Architecture.

Step 7 - Socket Programming (optional)

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

• Netify Core Processor
• Netify Sink Socket

Step 8 - Netify Informatics (optional)

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

• Netify Core Processor
• Netify Sink HTTP

Next, run:

sudo netifyd --enable-informatics

Step 9 - Restart the Agent

sudo service netifyd start

The above command is an example for environments using SystemV. Refer to the start command for your operating system in the Init and Start/Stop documentation.