Faddom Help Center

Migrating the Faddom OVA from CentOS 7 to Oracle Linux 9

As the Faddom OVA is based on CentOS 7 we are migrating to Oracle Linux 9 as CentOS 7 is nearing End-of-Life (see End dates are coming for CentOS Stream 8 and CentOS Linux 7). Faddom will still provide updates for our product for those customers who choose not to migrate at this time.

To ease the migration process, we have included a script to migrate the database. Before undertaking the migration it is highly recommended that you create a snapshot/backup of your existing Faddom installation.

  1. Upgrade the existing CentOS Faddom to 2023.5 by following Upgrading the Faddom Server
  2. Import the Oracle Linux OVA (or if you have a split installation, two OVAs, each with its own IP address)
  3. Optional: Change the IP address of the existing Faddom server to a temporary address and give that address to the newly deployed OVA. This way all existing firewall rules and Netflow settings will be retained.
  4. Connect via SSH to the Oracle Linux Faddom instance with the username faddom and the password you set during import. This should be the one you wish to use as the UI in the case of a split installation
  5. Run
    sudo /etc/illuminit/migrateDatabase.sh
  6. Follow the instructions on screen with the following parameters - 
    1. Choose remoteserver as you are migrating from the CentOS server
    2. Enter the username which by default is root
    3. Enter the IP address of the CentOS instance. This should be the one that hosts the database in the case of a split installation
    4. Enter the SSH password. If you have forgotten it, you can follow How To Reset The Root Password of the Faddom OVA
    5. At the next step, if you are migrating to a single instance, choose localhost. If you have a split installation or wish to move to a split installation choose remotehost which is the server that will host the database
    6. For split installation only - if asked for a username and password, use the username faddom and IP address of the database server
    7. Enter the password you set during the import process. 
    8. Let the migration run. Once done, connect to the UI and confirm your data has migrated succesfully


A successful migration will have an output that looks like the below


Post-Migration Steps

As the migration script will only migrate the database, the following steps may need to be taken

  1. If you are using LDAP integration you will need to re-edit the Tomcat file. To do this, you can copy the text of the file on the old server and use sudo nano or sudo vi to edit the file and paste the appropriate text. You can see our guide Connecting Faddom to LDAP On Linux for further guides

  2. If you have installed a custom SSL certificate, you will need to reimport it by following our guide Changing the Faddom server SSL certificate

  3. If you have provided a different IP address for the new Faddom server you may need to reconfigure Netflow or update the firewall rules. You can follow our guide How to Enable Traffic Collection in VMware and What ports need to be open for Faddom to function? for details.
  4. If you have deployed sensors or proxy servers, you may want to re-deploy them as well as they were also based on CentOS 7. The new proxy OVA is based on Oracle Linux 9 and the sensor OVA is based on Photon OS 5. Since these servers do not store any data, you can simply delete them and redeploy them. See the guides How to Setup the Faddom Proxy and How to Enable Traffic Collection in VMware for details.


If you encounter any issues or have any questions please reach out to support@faddom.com for further assistance.

Was this article helpful?
0 out of 0 found this helpful