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
apt remove netifyd
pkg
(BSD, pfSense, OPNsense etc.)
pkg remove netifyd
Systems using opkg
(OpenWRT)
opkg remove netifyd
Step 5 - Install the Netify Version 5 Package
opkg remove netifyd
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.
remove
command.