With the release of Enhance v12, cPFence has been updated to ensure full compatibility. To upgrade smoothly, follow the steps below.
Step 1: Backup Your cPFence Settings
Before uninstalling the old version, create a backup of your current cPFence settings to ensure a smooth transition.
cpfence --backup-cpf-settingsMove the backup to a safe location:
cp /tmp/cpfence_backup_* /root/Step 2: Uninstall the Old Version of cPFence
Run the following command to uninstall the existing version:
cpfence --uninstallStep 3: Upgrade to Enhance v12
Ensure your Enhance installation is upgraded to the latest v12 release before reinstalling cPFence.
Step 4: Install the Latest Version of cPFence
Once Enhance v12 is installed, reinstall cPFence using the install command available in your client area. Example:
bash <(curl -ks https://api.cpfence.app/install.sh) -k Your-KeyThis will ensure you have the latest version of cPFence, fully optimized for Enhance v12.
Step 5: Restore Your cPFence Settings
Move your backup file back to the correct location and restore your settings:
cp /root/cpfence_backup_* /tmp
cpfence --restore-cpf-settingsStep 6: Restart cPFence
Finally, restart cPFence to apply the restored settings:
cpfence --restartStep 7: Whitelist your Server IPs
Since cPFence now fully protects your server against IPv6 attacks, it's crucial to whitelist your cluster's IPs to prevent firewall blocks that could interfere with essential server communication. Please follow this guide:
How to Whitelist Your Enhance Cluster's IPs in cPFence (Important)
Congratulations! Your cPFence installation is now fully updated and compatible with Enhance v12.
Already Upgraded to Enhance v12 but Forgot to Uninstall cPFence?
No worries! If you have already upgraded to Enhance v12 but forgot to uninstall cPFence before the upgrade, you can still update it safely without losing your settings.
How to Fix It
Simply run the installation command again:
bash <( curl -ks https://api.cpfence.app/install.sh) -k cPFence-XXXXXXXXXXXXXXXXMake sure to replace cPFence-XXXXXXXXXXXXXXXX with your actual license key.
When Prompted, Select Option 1
During the installation, you will see the following prompt:
1- Backup settings and continueSelect option 1, and cPFence will take care of the update for you while preserving all your settings.
Need Further Assistance?
If you encounter any issues or need additional help, feel free to reach out to our support team via your client portal.
