Prerequisite
If the upgrade fails, it may not be possible to recover your data. Therefore, it is highly recommended to take a snapshot/backup of your server before performing the upgrade.
What Is Being Upgraded?
Tomcat - from Tomcat 9 to Tomcat 10
Java - for all Faddom installs, we are upgrading to Java 21, except for AWS, which is Java 17
PostgreSQL - this is being upgraded to PostgreSQL 16
How To Upgrade
Tomcat & Java
Upgrading Tomcat & Java can be achieved by following our standard upgrade guide. Upgrading the Faddom Server
How To Upgrade PostgreSQL
PostgreSQL requires an upgrade to be performed manually after the main upgrade script completes. While Faddom will still work, it is highly recommended to upgrade PostgreSQL, as the version currently installed is End of Life and Support.
Depending on the size of the database, it may take time, so please let it run. During this process, Faddom will not be accesible.
Linux
Connect to the server via SSH
If you have a separate database server (split-installation) you will need to
Copy the script to the database server
scp /cd /opt/FaddomServerUpgrade/upgrade_to_postgresql16.shscript.sh faddom@<DBIP>:/tmp
Run the script
On a single-instance server of Faddom
sudo ./opt/FaddomServerUpgrade/upgrade_to_postgresql16.shOn a split installation
SSH to the database server
cd /tmpsudo ./upgrade_to_postgresql16.sh
Windows
Connect to the Faddom server via RDP
Open File Manager and navigate to
C:\Program Files\Faddom\SetupLocate the file
upgradeToPostgresql16.batRight-click the file and select Run as Administrator
How To Upgrade a Remote Proxy
The Faddom proxy will automatically upgrade and will remain on Tomcat 9 and Java 11. If you wish to upgrade Tomcat and Java on the proxy, you will need to redeploy the proxy.
Windows
Connect to the Faddom server via RDP
Open
Control Panel > Add or Remove ProgramsUninstall the
Faddom ProxyOpen Windows services and confirm the
Faddom Apache ProxyThe service is deleted. If not, do the followingOpen CMD as Administrator
Run the command
sc delete FaddomProxy
Install the proxy according to the guide How to Set Up the Faddom Proxy
Linux
Delete the Faddom Proxy VM
Redeploy the VM using the same IP to ensure the firewall rules do not need further changes
