Archive:FreePBX Distribution: Difference between revisions

Line 1:

FreeBPX Distribution is a fully fledged VoIP server allowing complete customisation to your needs and works with most setups. It is an appliance, with a complete Linux setup and web manager to allow easy administration.

We have implemented FreePBX 15 (SNG7-PBX-64bit-2011-5) and Asterisk 17. This is the latest version of Asterisk and is a LTS release so will be supported well into the future with fixes (slated to be supported until 2024). This is a complete distribution and so needs to be installed on a machine. We will be setting this up on a separate ~~computer~~ rather than the main server.

We have implemented FreePBX 15 (SNG7-PBX-64bit-2011-5) and Asterisk 17. This is the latest version of Asterisk and is a LTS release so will be supported well into the future with fixes (slated to be supported until 2024). This is a complete distribution and so needs to be installed on its own machine. We will be setting this up on a separate virtual machine rather than the main server.

== Prerequisites ==

Line 29:

# We will configure the time servers to use ones closer to us in the UK. Click the cog icon next to the 'On' switch.

# We will change the CentOS NTP servers to UK servers. Double click on each address and change the <code>centos</code> to <code>uk</code>. For example, change <code>0.centos.pool.ntp.org</code> to <code>0.uk.pool.ntp.org</code>. Do this for servers 0-3.

# We will add the main server IP address as a source too. This is typed in the box and then click '+'.

# We will add the main server IP address as a source too. This is typed in the top box and then click '+'.

# Click 'OK'

# Click 'OK'.

# Click 'Done'

# Click 'Done'.

=== Setting the keyboard layout ===

Line 50:

# Tick 'English (United Kingdom).

#* Unfortunately, we cannot unselect 'English (United States)'.

# Click 'Done'

# Click 'Done'.

=== Setting the hard drive partitioning ===

Line 72:

# Click '''KDUMP'''.

# Untick the 'Enable kdump' box.

# Click 'Done'

# Click 'Done'.

=== Setting the network hostname ===

Line 79:

# Click '''NETWORK AND HOSTNAME'''.

# In the hostname box, replace 'freepbx.sangoma.local' to the hostname of your network ~~- in our case <code>asterisk~~.freddythechick.net~~</code>~~.

# In the hostname box, replace 'freepbx.sangoma.local' to the hostname of your network (for example freepbx.freddythechick.net).

# Click 'Apply'

# Click 'Apply'.

# Click 'Done'

# Click 'Done'.

=== Starting the installation ===

Line 104:

You will now be back at the installation screen - grab a cup of coffee and wait for the installation to finish.

Once the installation is finished, it will say 'SangomaOS 7.8 is now successfully installed and ready to use! Go ahead and reboot to start using it!'. Click the 'Reboot' button and the machine will reboot to the FreePBX terminal.

Once the installation is finished, it will say 'SangomaOS 7.8 is now successfully installed and ready to use! Go ahead and reboot to start using it!'. Click the 'Reboot' button and the machine will reboot to the FreePBX terminal. Remember to remove the DVD/image from the drive!

== First time run of the web interface ==

== Updating the server ==

~~=== Updating the distribution ===~~

~~The latest version of AsteriskNOW! available from the website is not the latest version of the distribution. The distribution must be updated manually to get up to the latest version.~~

We will start off on the 6.12.65 track. As of 31st December 2015, this has reached its End of Life. We will be upgrading to the 10.13.66 track which is the latest. To look for the latest version, the website is http://wiki.freepbx.org/display/PPS/FreePBX-Distro-10.13.66

~~# Login to your system as root with SSH or go to the Virtual Machine Manager, open the machine and login.~~

~~# Type <code>cd ~</code>. This will take you to the home directory where we can download.~~

~~# Type <code>mkdir upgradescripts</code> then <code>cd upgradescripts</code>. This will make a new directory and take you into the new directory.~~

# Type <code>wget https://upgrades.freepbxdistro.org/stable/10.13.66/upgrade-10.13.66-1.sh</code>. This will download the script to update the distribution to the new track. You can also download this from this server by typing <code>wget http://192.168.0.24/hpserver/images/2/24/Upgrade-10.13.66-1.sh</code> then rename it to lowercase by typing <code>mv Upgrade-10.13.66-1.sh upgrade-10.13.66-1.sh</code>.

~~# Type <code>chmod +x upgrade-10.13.66-1.sh</code>. This changes the permissions so we can execute the file.~~

~~# Type <code>./upgrade-10.13.66-1.sh</code> to run the script.~~

~~# While the script is running, you may see some errors. These are normal and as long as the script runs through to the end, you can safely ignore these.~~

~~# When the script is finished, it will say <code>REBOOT YOUR BOX NOW</code>. Follow these instructions and type <code>reboot</code>.~~

#: Once the machine has rebooted, we will need to update to the latest version of the track (At the time of writing, it was 10.12.66-10, we will use this as an example. Use the latest version available at http://wiki.freepbx.org/display/PPS/FreePBX-Distro-10.13.66).

~~# Login in again as root.~~

~~#: We did a lot of the legwork in the last example so it makes it easier this time round.~~

~~# You should already be in the home directory so type <code>cd upgradescripts</code> to move to the <code>upgradescript</code> folder we made earlier.~~

# Look on the FreePBX site, then with the lastest script, type <code>wget https://upgrades.freepbxdistro.org/stable/10.13.66/upgrade-10.13.66-10.sh</code>, changing the last part to whatever the latest version is.

~~# Type <code>chmod +x upgrade-10.13.66-10.sh</code> to make the script executable.~~

~~# Type <code>cd /</code>. This will take us to the root directory. Due to the way this script works, you must run it from the top root directory.~~

~~# Type <code>./root/upgradescripts/upgrade-10.13.66-10.sh</code> to run the script.~~

~~# Once again, errors that don't stop the script are normal and can be ignored.~~

~~# Once you have reached <code>REBOOT YOUR BOX NOW</code>, reboot the machine by typing <code>reboot</code>.~~

~~'''NOTE'''~~

It is a good idea to keep an eye on the FreePBX website for updates from time to time. You can use the second half of the tutorial to do the minor updates at any time, substituting the example script version for the latest.

=== General updates ===

As with any Linux distribution, from time to time there are updates to the system. We will show you how to check these and install them.

As with any Linux distribution, from time to time there are updates to the system. This will show you how to check these and install them.

# Login to the system as root

# Login to the system at the command prompt or SSH as root.

# Type <code>yum update</code>

# Type <code>yum update</code>.

# After downloading from the internet, a list may be shown showing the latest updates available. If <code>No Packages marked for Update</code> is shown, there are no updates available right now and you can continue to the next step.

# After downloading the update lists from the internet, a list may be shown showing the latest updates available. If <code>No Packages marked for Update</code> is shown, there are no updates available right now and you can continue to the next step.

# ~~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 ~~any~~ updates ~~downloaded get used~~. 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>.

=== Updating FreePBX modules ===

@@ Line 1: / Line 1: @@
 FreeBPX Distribution is a fully fledged VoIP server allowing complete customisation to your needs and works with most setups. It is an appliance, with a complete Linux setup and web manager to allow easy administration.
-We have implemented FreePBX 15 (SNG7-PBX-64bit-2011-5) and Asterisk 17. This is the latest version of Asterisk and is a LTS release so will be supported well into the future with fixes (slated to be supported until 2024). This is a complete distribution and so needs to be installed on a machine. We will be setting this up on a separate computer rather than the main server.
+We have implemented FreePBX 15 (SNG7-PBX-64bit-2011-5) and Asterisk 17. This is the latest version of Asterisk and is a LTS release so will be supported well into the future with fixes (slated to be supported until 2024). This is a complete distribution and so needs to be installed on its own machine. We will be setting this up on a separate virtual machine rather than the main server.
 == Prerequisites ==
@@ Line 29: / Line 29: @@
 # We will configure the time servers to use ones closer to us in the UK. Click the cog icon next to the 'On' switch.
 # We will change the CentOS NTP servers to UK servers. Double click on each address and change the <code>centos</code> to <code>uk</code>. For example, change <code>0.centos.pool.ntp.org</code> to <code>0.uk.pool.ntp.org</code>. Do this for servers 0-3.
-# We will add the main server IP address as a source too. This is typed in the box and then click '+'.
+# We will add the main server IP address as a source too. This is typed in the top box and then click '+'.
-# Click 'OK'
+# Click 'OK'.
-# Click 'Done'
+# Click 'Done'.
 === Setting the keyboard layout ===
@@ Line 50: / Line 50: @@
 # Tick 'English (United Kingdom).
 #* Unfortunately, we cannot unselect 'English (United States)'.
-# Click 'Done'
+# Click 'Done'.
 === Setting the hard drive partitioning ===
@@ Line 72: / Line 72: @@
 # Click '''KDUMP'''.
 # Untick the 'Enable kdump' box.
-# Click 'Done'
+# Click 'Done'.
 === Setting the network hostname ===
@@ Line 79: / Line 79: @@
 # Click '''NETWORK AND HOSTNAME'''.
-# In the hostname box, replace 'freepbx.sangoma.local' to the hostname of your network - in our case <code>asterisk.freddythechick.net</code>.
+# In the hostname box, replace 'freepbx.sangoma.local' to the hostname of your network (for example freepbx.freddythechick.net).
-# Click 'Apply'
+# Click 'Apply'.
-# Click 'Done'
+# Click 'Done'.
 === Starting the installation ===
@@ Line 104: / Line 104: @@
 You will now be back at the installation screen - grab a cup of coffee and wait for the installation to finish.
-Once the installation is finished, it will say 'SangomaOS 7.8 is now successfully installed and ready to use! Go ahead and reboot to start using it!'. Click the 'Reboot' button and the machine will reboot to the FreePBX terminal.
+Once the installation is finished, it will say 'SangomaOS 7.8 is now successfully installed and ready to use! Go ahead and reboot to start using it!'. Click the 'Reboot' button and the machine will reboot to the FreePBX terminal. Remember to remove the DVD/image from the drive!
 == First time run of the web interface ==
 == Updating the server ==
-=== Updating the distribution ===
-The latest version of AsteriskNOW! available from the website is not the latest version of the distribution. The distribution must be updated manually to get up to the latest version.
-We will start off on the 6.12.65 track. As of 31st December 2015, this has reached its End of Life. We will be upgrading to the 10.13.66 track which is the latest. To look for the latest version, the website is http://wiki.freepbx.org/display/PPS/FreePBX-Distro-10.13.66
-# Login to your system as root with SSH or go to the Virtual Machine Manager, open the machine and login.
-# Type <code>cd ~</code>. This will take you to the home directory where we can download.
-# Type <code>mkdir upgradescripts</code> then <code>cd upgradescripts</code>. This will make a new directory and take you into the new directory.
-# Type <code>wget https://upgrades.freepbxdistro.org/stable/10.13.66/upgrade-10.13.66-1.sh</code>. This will download the script to update the distribution to the new track. You can also download this from this server by typing <code>wget http://192.168.0.24/hpserver/images/2/24/Upgrade-10.13.66-1.sh</code> then rename it to lowercase by typing <code>mv Upgrade-10.13.66-1.sh upgrade-10.13.66-1.sh</code>.
-# Type <code>chmod +x upgrade-10.13.66-1.sh</code>. This changes the permissions so we can execute the file.
-# Type <code>./upgrade-10.13.66-1.sh</code> to run the script.
-# While the script is running, you may see some errors. These are normal and as long as the script runs through to the end, you can safely ignore these.
-# When the script is finished, it will say <code>REBOOT YOUR BOX NOW</code>. Follow these instructions and type <code>reboot</code>.
-#: Once the machine has rebooted, we will need to update to the latest version of the track (At the time of writing, it was 10.12.66-10, we will use this as an example. Use the latest version available at http://wiki.freepbx.org/display/PPS/FreePBX-Distro-10.13.66).
-# Login in again as root.
-#: We did a lot of the legwork in the last example so it makes it easier this time round.
-# You should already be in the home directory so type <code>cd upgradescripts</code> to move to the <code>upgradescript</code> folder we made earlier.
-# Look on the FreePBX site, then with the lastest script, type <code>wget https://upgrades.freepbxdistro.org/stable/10.13.66/upgrade-10.13.66-10.sh</code>, changing the last part to whatever the latest version is.
-# Type <code>chmod +x upgrade-10.13.66-10.sh</code> to make the script executable.
-# Type <code>cd /</code>. This will take us to the root directory. Due to the way this script works, you must run it from the top root directory.
-# Type <code>./root/upgradescripts/upgrade-10.13.66-10.sh</code> to run the script.
-# Once again, errors that don't stop the script are normal and can be ignored.
-# Once you have reached <code>REBOOT YOUR BOX NOW</code>, reboot the machine by typing <code>reboot</code>.
-'''NOTE'''
-It is a good idea to keep an eye on the FreePBX website for updates from time to time. You can use the second half of the tutorial to do the minor updates at any time, substituting the example script version for the latest.
 === General updates ===
-As with any Linux distribution, from time to time there are updates to the system. We will show you how to check these and install them.
+As with any Linux distribution, from time to time there are updates to the system. This will show you how to check these and install them.
-# Login to the system as root
+# Login to the system at the command prompt or SSH as root.
-# Type <code>yum update</code>
+# Type <code>yum update</code>.
-# After downloading from the internet, a list may be shown showing the latest updates available. If <code>No Packages marked for Update</code> is shown, there are no updates available right now and you can continue to the next step.
+# After downloading the update lists from the internet, a list may be shown showing the latest updates available. If <code>No Packages marked for Update</code> is shown, there are no updates available right now and you can continue to the next step.
-# 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 any updates downloaded get used. 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>.
 === Updating FreePBX modules ===