Upgrading or Removing EDFN
Upgrading or Removing EDFN
This guide provides instructions for maintaining your standalone External Data Feeder for NFO (EDFN) instances, including upgrading to the latest version and complete removal from your system.
If you are using NFO version 2.7 or higher, EDFN is already bundled with the main NFO installation. You only need to follow these steps if you are running a standalone EDFN instance on a separate server.
Upgrading EDFN
You upgrade a standalone instance by installing the latest version over your existing installation. The installer preserves most configurations, but manually changed files are backed up into a conf-backup.<date>.tar.gz archive.
Key Configuration Files
If you have modified these files, you should manually verify and restore settings from the backup after the upgrade:
| File | Purpose |
|---|---|
$EDFN_HOME/conf/updater.properties | NFO URI and core parameters |
$EDFN_HOME/conf/.updater_keystore | Default self-signed certificate for X509 authentication |
$EDFN_HOME/conf/.updater_truststore | Default self-signed NFO tomcat certificate |
$EDFN_HOME/java/jre/lib/security/cacerts | Trusted certificates imported into Java Runtime |
On RHEL 7, you may see "remove failed" warnings for specific .jar files during the cleanup phase. This is normal and these messages should be ignored.
Upgrade Procedures
RPM Installation (Linux)
- Login via SSH and copy the new installation file into the
/optdirectory. - Backup your current configuration files from
/opt/nfi_updater/conf. - Run the upgrade command:
rpm –Uhv <RPM-package> - Restore your configuration files and restart the EDFN service.
TAR Installation (Linux)
- Login via SSH and copy the new installation file into the
/optdirectory. - Backup your configuration files from
/opt/nfi_updater/conf. - Navigate to the existing directory and run the uninstaller:
./setup.sh -u - Uncompress the new installer:
tar zxvf <TAR-package> -C <directory> - Restore your configuration files.
- Run the setup script:
./setup.sh -i
Windows Installation
- Backup configuration files from
C:\Program Files\NetFlow Logic\NFI Updater\conf. - Launch the upgrade installer and click Run, then Next.
- Confirm the default installation location:
C:\Program Files\NetFlow Logic\NFI Updater. - Click Install and follow the prompts. Once finished, click Finish.
- Restore your configuration files and restart the EDFN Windows Service.
If your EDFN was configured for user identity enrichment using Microsoft Active Directory (DCOM/WMI), you must re-perform the Windows Host Configuration steps after the upgrade.
Validation: After upgrading, verify the version (Release number) by navigating to External Data Feeders in the NFO Web UI.
Removing EDFN
If you need to decommission a standalone feeder, follow the instructions for your specific platform below.
RPM Installation
- Open a shell prompt and run:
rpm –e nfi-updater - If a full uninstall is required, manually remove the installation path:
rm -rf <directory>
TAR Installation
- Navigate to the installation directory and run:
./setup.sh -u - Leave the directory:
cd .. - If a full uninstall is required, remove the path:
rm -rf <directory>
Windows Installation
- Navigate to Control Panel > Programs > Programs and Features.
- Select External Data Feeder for NFO from the list.
- Follow the standard Windows prompts to uninstall the program.