Archive:FreePBX Distribution: Difference between revisions

m Updating FreePBX modules: Added not to use back or refresh
Added Upgrade to FreePBX 16 section
Line 123: Line 123:
# Once you have clicked 'Activate', it will then display a deployment number. This means it is successfully deployed. The deployment number can be displayed later if needed.
# Once you have clicked 'Activate', it will then display a deployment number. This means it is successfully deployed. The deployment number can be displayed later if needed.
# Click 'Skip' on the module updates for now as we need to set up the server first.
# Click 'Skip' on the module updates for now as we need to set up the server first.
# In the '''Sound Prompts Language''' drop down menu, select 'English (United Kingdom)'.
# Leave '''Sound Prompts Language''' as 'English (United Kingdom)' or change this from the drop down menu if wrong.
# Leave '''System Language''' as 'English (United States)' as there is no option for United Kingdom.
# Leave '''System Language''' as 'English (United Kingdom)' or change to this from the drop down menu if wrong.
# The '''Timezone''' option should already be correct from our installation. If not, it can be corrected here to 'Europe/London'.
# The '''Timezone''' option should already be correct from our installation. If not, it can be corrected here to 'Europe/London'.
# Click 'Submit' in the bottom left hand corner. It will take a while as it is starting to setup the system - be patient!
# Click 'Submit' in the bottom left hand corner. It will take a while as it is starting to setup the system - be patient!
Line 130: Line 130:
# You may get a few adverts after this - click 'Not Now' to skip them.
# You may get a few adverts after this - click 'Not Now' to skip them.
# Your system is now basically set up - you will be presented with the dashboard.
# Your system is now basically set up - you will be presented with the dashboard.
# If there is a red 'Apply Now' button in the top right hand corner, press this to configure the system with the changes just implemented.


== Updating the server ==
== Updating the server ==
Line 142: Line 143:
# If there are updates offered, type <code>y</code> to accept the changes. The updates will then be downloaded and installed. Some packages take a long time to install and the system will look like it has hung. Be patient, they will eventually install.
# If there are updates offered, type <code>y</code> to accept the changes. The updates will then be downloaded and installed. Some packages take a long time to install and the system will look like it has hung. Be patient, they will eventually install.
# It is recommended that once the update is finished, you reboot the machine so that the updates are applied. Type <code>reboot</code>.
# It is recommended that once the update is finished, you reboot the machine so that the updates are applied. Type <code>reboot</code>.
=== Upgrading to FreePBX 16 ===
At the moment, FreePBX 16 is not available seperately so we need to upgrade to FreePBX 16 through FreePBX 15.


=== Updating FreePBX modules ===
=== Updating FreePBX modules ===
Line 151: Line 148:
# From the dashboard, on the menu bar, go to '''Admin > Module Admin'''.
# From the dashboard, on the menu bar, go to '''Admin > Module Admin'''.
# Click 'Check Online' to check the internet for updated modules.
# Click 'Check Online' to check the internet for updated modules.
# Once done, click 'Upgrade all' on the left-hand side to mark all modules for update.
# Once done, click 'Upgrade all' on the right-hand side to mark all modules for update.
# Click 'Process' to start updating the modules.
# Click 'Process' to start updating the modules.
# You will be presented with a list of modules to be updated. Scroll to the bottom and click 'Confirm'
# You will be presented with a list of modules to be updated. Scroll to the bottom and click 'Confirm'
# Some updates take a very long time to complete, please be patient! Avoid refreshing or going back or the server could be left in an inconsistent state.
# Some updates take a very long time to complete, please be patient! Avoid refreshing or going back or the server could be left in an inconsistent state.
# Once the current updates are complete, press '' to be taken back to the Module Admin screen
# Once the current updates are complete, press 'Return' to be taken back to the Module Admin screen.
# Click the red 'Apply Config' button at the top right of the screen.
# Some updates rely on other packages to be updated first. Keep cycling through these steps until there are no more packages to update.
# Some updates rely on other packages to be updated first. Keep cycling through these steps until there are no more packages to update.
=== Upgrading to FreePBX 16 ===
At the moment, FreePBX 16 is not available seperately so we need to upgrade to FreePBX 16 through FreePBX 15. This can only be done once the system is updated. The biggest change of this upgrade is now supporting the modern PHP 7.4 instead of the now legacy and unsupported PHP 5.6.
# From the dashboard, on the menu bar, go to '''Admin > Module Admin'''.
# Click 'Check Online' to check the internet for updated modules.
# Under the 'Admin' section, look for a module called 'PBX Upgrader'.
# Click the > to expand the entry.
# Change 'No Action' to 'Download and Install'.
# Goto the top of the page and on the right-hand side, click 'Process'.
# Click 'Confirm' to install the module.
# Once it has complted, press 'Return' to be taken back to the Module Admin screen.
# Click the red 'Apply Config' button at the top right of the screen.
# On the menu bar, go to '''Admin > 15 to 16 Upgrade Tool'''.
# Click the 'Check the requirements!' button.
# Once it has checked, if all is well, click the 'Proceed to the upgrade process'. If anything comes back with an error, this will need fixing before proceeding.
# Although you have not changed the system yet, it may complain about not using standard repositories. Under 'Non-standard Repository Servers', leave as 'Reset the repos to the defaults.
# Click 'Next'.
# Fill out any details you would like for the survey (this is optional), or press skip.
# Read the warning message and then press 'OK' when ready to upgrade.
# Please be patient, ignore and error messages and do not think the system has hung, this process can take a long time to complete. If the webpage does fail during the upgrade and you cannot access the progres of the upgrade, goto the terminal and type <code>tails -f /var/log/pbx/freepbx16-upgrade.log</code> which should allow you to follow the update. Once done, return to the dashboard.
# Now is a good time to once again reboot the system to apply all the changes.
# Once rebooted, check for module updates as per previous section.


=== Upgrading to the latest Asterisk version ===
=== Upgrading to the latest Asterisk version ===


Once all the updates have been installed on the distribution, we can upgrade the version of Asterisk to the latest version if desiered.
Once all the updates have been installed on the distribution, we can upgrade the version of Asterisk to the Asterisk 18 which is the latest version as of writing.


# Login to the system at the terminal or SSH as root.
# Login to the system at the terminal or SSH as root.
# From the terminal, type <code>asterisk-version-switch</code>.
# From the terminal, type <code>asterisk-version-switch</code>.
# Select the number next to the version that you would like to install - e.g. <code>6</code> for Asterisk 18 then hit enter.
# Select the number next to the version that you would like to install - e.g. <code>7</code> for Asterisk 18 then hit enter.
# Wait for the script to run through upgrading Asterisk.
# Wait for the script to run through upgrading Asterisk.
# When returned to the terminal, restart the machine to apply the new changes.
# When returned to the terminal, restart the machine to apply the new changes.