⚠️ Disclaimer:
The steps below are provided as guidance to existing 20tele customers for PBXact 16 or FreePBX 16 on CentOS 7 only. Always ensure you have recent backups when performing any significant changes. This guide is based solely on what worked for us following substantial testing on the date of publication, and assumes you are securely connected via PuTTY on Windows and logged in as root over SSH. If in doubt, please email [email protected] before proceeding.
Tested with PBXact UC 16.0.40.13 and FreePBX 16.0.40.13 on 24th May 2025.
1. Update system packages
yum update -y
2. Install needs-restarting (if not already installed)
yum install -y yum-utils
3. Check if reboot is required
needs-restarting -r
4. Reboot if required
reboot
5. Check if the system has finished rebooting
systemctl is-system-running
-
running = system is ready
-
starting = wait
-
degraded = troubleshoot before continuing with
systemctl --failed
6. Confirm mirror access and repository selection
fwconsole ma listonline | head -n 1
You should see:
No repos specified, using: [standard,commercial] from last GUI settings
This confirms:
-
Mirror access is working
-
Stable and Commercial modules are enabled
⚠️ Commercial modules are important. They include key features such as SysAdmin Pro, Endpoint Manager, and more. If Commercial is not selected, these modules may be skipped or left outdated. -
Edge is not enabled
⚠️ Edge mode is not recommended for production systems. It enables beta or development versions of modules that may cause instability.
If the output only shows [standard], or includes [edge], update your settings as follows:
-
Log in to the PBXact or FreePBX Admin GUI
-
Go to Admin > Module Admin or Updates
-
Click Module Updates
-
Enable Standard
-
Enable Commercial
-
Disable Extended
-
Click Check Online to refresh the module list
Then return to the terminal and check again:
fwconsole ma listonline | head -n 1
You should now see:
No repos specified, using: [standard,commercial] from last GUI settings
If it still shows [standard] only, or includes [edge], repeat the steps and ensure your settings were saved.
If the list command fails or returns an error, resolve any mirror, DNS, or SSL issues before continuing.
7. Update PBXact or FreePBX modules
fwconsole ma upgradeall
8. Fix file ownership and permissions
fwconsole chown
9. Reload Asterisk
fwconsole reload
10. Restart PBXact or FreePBX services
fwconsole restart