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 |
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 nfi-updater-*-linux.x86_64.rpm - 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 nfi-updater-*-linux-x86_64.tar.gz -C <directory> - Restore your configuration files.
- Run the setup script:
./setup.sh -i
Windows Installation
- Backup configuration files from
C:\Program Files\NetFlow Logic\NetFlow Integrator Updater\conf. - Launch the upgrade installer and click Run, then Next.
- Confirm the default installation location:
C:\Program Files\NetFlow Logic\NetFlow Integrator 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.
Reapply the Non-Root Configuration
Skip this if EDFN runs as root.
An upgrade reinstalls the packaged files, which restores the packaged file ownership and replaces the daemon script. After the upgrade completes and before starting the service:
- Transfer ownership of the installation directory back to the service account:
chown --recursive nfo:nfo-group /opt/nfi-updater
- In
/opt/nfi-updater/bin/nfiu_daemon, change the--tomcat-userargument fromrootback tonfo.
Start the service, then confirm the JVM worker process is running as the nfo account:
ps -eo user,pid,args | grep '[j]svc'
For the full procedure, see Security Hardening: Running as Non-Root.
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 <installation_dir>/nfi-updater
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 <installation_dir>/nfi-updater
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.