Upgrading Philter

We recommend reviewing the Philter Release Notes prior to upgrading.

Upgrading from a 2.x Version

Upgrading Philter to the newest version requires moving Philter's configuration to the new version of Philter. To upgrade Philter from a 2.x version, follow the steps below.

Launch a new instance of the newest version of Philter.
Copy your policies from /opt/philter/policies to the new instance.
Copy your /opt/philter/philter.properties to the new instance.
Copy your /opt/philter/philter-ui.properties to the new instance.
Replace the new virtual machine's properties file with your copy from step 1.
Copy your policies from /opt/philter/policies to the new instance.
If you have configured any SSL certificates for Philter, copy those files over to the new instance.
Restart Philter: sudo systemctl restart philter.service && sudo systemctl restart philter-ui.service && sudo systemctl restart philter-ner.service
Test the new Philter virtual machine to make sure it is behaving as expected.
Decommission the old Philter instance.

Upgrading from a 1.x Version

Upgrading Philter to the newest version requires moving Philter's configuration to the new version of Philter. To upgrade Philter from a 1.x version, follow the steps below.

Make local copies of your current Philter's properties files.
1. /opt/philter/philter.properties (prior to 1.10.1 the filename was /opt/philter/application.properties)
2. /opt/philter/philter-ui.properties (not applicable prior to version 1.10)
Launch a new instance of the newest version of Philter.
Replace the new virtual machine's properties file with your copy from step 1.
Restart Philter: sudo systemctl restart philter.service sudo systemctl restart philter-ui.service sudo systemctl restart philter-ner.service
Test the new Philter virtual machine to make sure it is behaving appropriately.
Decommission the old Philter instance.

Last modified: 08 November 2023