Archive:FreePBX Distribution: Difference between revisions

Line 1:

Asterisk VoIP server is a fully fledged VoIP allowing complete customisation to your needs and works with most setups. It has a web GUI that is slowly being developed to make implementation even easier for people.

On the server, we have implemented Asterisk 11.x series. This is a very new version of Asterisk but is also a LTS release so will be supported well into the future with fixes. We are also using the Web GUI from the Subversion repository to make sure it is up to date.

On the server, we have implemented Asterisk 11.x series. This is a very new version of Asterisk but is also a LTS release so will be supported well into the future with fixes (slated to be supported until 2016). We are also using the Web GUI from the Subversion repository to make sure it is up to date.

== Packages Required ==

Line 62:

# Run from the terminal <code>make</code>. This will only take a moment, this step builds the packages for your computer.

# Run from the terminal <code>make install</code> This step actually installs the packages on the computer. Keep this Terminal window open as we will need this later to check the configuration.

# Open File Manager - Super User Mode. Then ~~goto~~ <code>/etc/asterisk</code> and open <code>http.conf</code> with KWrite.

# Open File Manager - Super User Mode. Then go to <code>/etc/asterisk</code> and open <code>http.conf</code> with KWrite.

# Comments in Asterisk configurations are marked with <code>;</code>. Make sure <code>enabled = yes</code>, <code>bindaddr = 127.0.0.1</code>, <code>bindport = 8088</code> and <code>enablestatic = yes</code> are uncommented. <code>bindaddr = 127.0.0.1</code> can be adjusted to the IP address you'd like to access the GUI from. By default this is only the server itself for security. To allow access from any IP, you can change this to <code>bindaddr = 0.0.0.0</code>. <code>bindport</code> can be change to your preference too. Once you have finished, save the file.

# Open from the File Manager <code>manager.conf</code> with KWrite. Make sure that <code>enabled = no</code> is changed to <code>enabled = yes</code>. Uncomment <code>webenabled = yes</code>, <code>port = 5038</code> and <code>bindaddr = 0.0.0.0</code>.

# We need to add a user to this file. This is the admin user to the Web GUI. Add the following to the bottom of the file. <> denotes a field to change to your preference: <code>[<admin>]</code> <code>secret = <your-password-here></code> <code>read = all</code> <code>write = all</code> Once you have added your user, save the file.

# We need to add a user to this file. This is the admin user to the Web GUI. Add the following to the bottom of the file. <> denotes a field to change to your preference: <code>[<admin>]</code> (This is the admin username) <code>secret = <your-password-here></code> <code>read = all</code> <code>write = all</code> Once you have added your user, save the file.

# For the Web GUI to access the files, we need to give the permissions to Asterisk. Select all the files in the folder with Ctrl+A. Right click on any file and click Properties. On the permissions tab, change the user to <code>asterisk</code> and the group to <code>asterisk</code> then click OK. This will need to be done to the asterisk folder in <code>/etc</code> too.

# In the File Manager, goto <code>/usr/share/asterisk</code>. There should be a folder called <code>static-http</code>. Delete this folder as this is no longer needed.

# Right click in a space in the folder. Goto Create New > then Basic link to file or directory... In the File name:, type <code>static-http</code>. In the Enter path to file or directory:, type or find <code>/var/lib/asterisk/static-http/</code>.

# In the File Manager, goto <code>/var/lib/asterisk/</code>. Right-click on the folder and change the permissions to asterisk once again. Tick the Apply changes to all ~~subfolders~~ and their contents. check box and click OK.

# In the File Manager, goto <code>/var/lib/asterisk/</code>. Right-click on the folder and change the permissions to asterisk once again. Tick the Apply changes to all sub-folders and their contents. check box and click OK.

# Now go back to the Terminal prompt left open. Run <code>service asterisk restart</code> to restart Asterisk and enable the Web GUI. Run <code>make checkconfig</code>. This will check all your settings you have changed and make sure it is all working. If it says there are any problems, follow what it says to find the problem.

== Using the Web GUI for the first time ==

# Once it has all been installed and Asterisk restarted, it can be accessed from http://127.0.0.1:8088/static/config/index.html in your web browser. Type in the user name and password you added to <code>manager.conf</code> earlier. You should now be presented with Asterisk's status page.

== Troubleshooting ==

* If after logging in, the browser loops checking Extensions.conf, this means there is a permissions problem somewhere. Double check you have made all the files accessible to the asterisk user and group.

* If after logging in, the browser stops at Checking write permissions for GUI folder, the basic link was not created properly during the installation. Make sure the basic link is created properly and pointing to the right place.

@@ Line 1: / Line 1: @@
 Asterisk VoIP server is a fully fledged VoIP allowing complete customisation to your needs and works with most setups. It has a web GUI that is slowly being developed to make implementation even easier for people.
-On the server, we have implemented Asterisk 11.x series. This is a very new version of Asterisk but is also a LTS release so will be supported well into the future with fixes. We are also using the Web GUI from the Subversion repository to make sure it is up to date.
+On the server, we have implemented Asterisk 11.x series. This is a very new version of Asterisk but is also a LTS release so will be supported well into the future with fixes (slated to be supported until 2016). We are also using the Web GUI from the Subversion repository to make sure it is up to date.
 == Packages Required ==
@@ Line 62: / Line 62: @@
 # Run from the terminal <code>make</code>. This will only take a moment, this step builds the packages for your computer.
 # Run from the terminal <code>make install</code> This step actually installs the packages on the computer. Keep this Terminal window open as we will need this later to check the configuration.
-# Open File Manager - Super User Mode. Then goto <code>/etc/asterisk</code> and open <code>http.conf</code> with KWrite.
+# Open File Manager - Super User Mode. Then go to <code>/etc/asterisk</code> and open <code>http.conf</code> with KWrite.
 # Comments in Asterisk configurations are marked with <code>;</code>. Make sure <code>enabled = yes</code>, <code>bindaddr = 127.0.0.1</code>, <code>bindport = 8088</code> and <code>enablestatic = yes</code> are uncommented. <code>bindaddr = 127.0.0.1</code> can be adjusted to the IP address you'd like to access the GUI from. By default this is only the server itself for security. To allow access from any IP, you can change this to <code>bindaddr = 0.0.0.0</code>. <code>bindport</code> can be change to your preference too. Once you have finished, save the file.
 # Open from the File Manager <code>manager.conf</code> with KWrite. Make sure that <code>enabled = no</code> is changed to <code>enabled = yes</code>. Uncomment <code>webenabled = yes</code>, <code>port = 5038</code> and <code>bindaddr = 0.0.0.0</code>.
-# We need to add a user to this file. This is the admin user to the Web GUI. Add the following to the bottom of the file. <> denotes a field to change to your preference:<br><code>[<admin>]</code><br><code>secret = <your-password-here></code><br><code>read = all</code><br><code>write = all</code><br>Once you have added your user, save the file.
+# We need to add a user to this file. This is the admin user to the Web GUI. Add the following to the bottom of the file. <> denotes a field to change to your preference:<br><code>[<admin>]</code> (This is the admin username)<br><code>secret = <your-password-here></code><br><code>read = all</code><br><code>write = all</code><br>Once you have added your user, save the file.
 # For the Web GUI to access the files, we need to give the permissions to Asterisk. Select all the files in the folder with Ctrl+A. Right click on any file and click Properties. On the permissions tab, change the user to <code>asterisk</code> and the group to <code>asterisk</code> then click OK. This will need to be done to the asterisk folder in <code>/etc</code> too.
 # In the File Manager, goto <code>/usr/share/asterisk</code>. There should be a folder called <code>static-http</code>. Delete this folder as this is no longer needed.
 # Right click in a space in the folder. Goto Create New > then Basic link to file or directory... In the File name:, type <code>static-http</code>. In the Enter path to file or directory:, type or find <code>/var/lib/asterisk/static-http/</code>.
-# In the File Manager, goto <code>/var/lib/asterisk/</code>. Right-click on the folder and change the permissions to asterisk once again. Tick the Apply changes to all subfolders and their contents. check box and click OK.
+# In the File Manager, goto <code>/var/lib/asterisk/</code>. Right-click on the folder and change the permissions to asterisk once again. Tick the Apply changes to all sub-folders and their contents. check box and click OK.
 # Now go back to the Terminal prompt left open. Run <code>service asterisk restart</code> to restart Asterisk and enable the Web GUI. Run <code>make checkconfig</code>. This will check all your settings you have changed and make sure it is all working. If it says there are any problems, follow what it says to find the problem.
+== Using the Web GUI for the first time ==
+# Once it has all been installed and Asterisk restarted, it can be accessed from http://127.0.0.1:8088/static/config/index.html in your web browser. Type in the user name and password you added to <code>manager.conf</code> earlier. You should now be presented with Asterisk's status page.
+== Troubleshooting ==
+* If after logging in, the browser loops checking Extensions.conf, this means there is a permissions problem somewhere. Double check you have made all the files accessible to the asterisk user and group.
+* If after logging in, the browser stops at Checking write permissions for GUI folder, the basic link was not created properly during the installation. Make sure the basic link is created properly and pointing to the right place.