Archive:FreePBX Distribution: Difference between revisions

Line 3:

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 ==

== Installation ==

=== Packages Required ===

To implement the system, the following packages are required:

Line 23:

Line 24:

* Checkout latest revision from http://svn.asterisk.org/svn/asterisk-gui/branches/2.0/ for Web GUI.

== Installing the TFTP server ==

=== Installing the TFTP server ===

The TFTP server is what hard-phones use to download the settings files from the server. This step is not required if your not using hard-phones.

Line 32:

Line 33:

# Files for the hard-phones can then be dropped into <code>/srv/tftpboot/</code>.

== Installing the Asterisk server ==

=== Installing the Asterisk server ===

# From YaST, select Software Management. Once this has started, select from the top menu Configuration and then click Repositories.

Line 41:

Line 42:

# Find the Asterisk 11 repository that you just added from the list and click on it.

# Tick the packages that need to be installed from above in the Packages Required section above.

# '''NOTE: When you try to add <code>asterisk-dahdi</code>, it will currently say that it is unable to find a package to fulfil its requirements. It is safe to ignore this requirement with the bottom toggle box. This package is only needed to make the Web GUI work.'''

# Click Accept to install the packages. This will install the Asterisk server.

# When back in the YaST control panel, under System run System Services (Runlevel).

Line 51:

# If this says 'Cannot find remote Asterisk server', it may not have started or may not have installed properly. Type <code>service asterisk start</code> into the Terminal prompt. If you get no errors, it should have started and you can try the previous step again. If it says it can't find the service, it may not have installed properly and needs reinstalling again.

== Installing the Web GUI ==

NOTE: If you are running openSuSE 12.3, there is a problem with the Runlevel YaST module where it will say the service is enabled but it won't actually enable this. Make sure your system is up to date to solve this problem!

=== Installing the Web GUI ===

The Web GUI allows simple administration of the Asterisk server without fiddling around manually changing the contents of the folder.

Subversion revision 5220 as of writing this article

# Make sure <code>subversion</code> is installed through YaST.

Line 71:

Line 75:

# 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.

# You can now type <code>make checkconfig</code> into the terminal window you left open earlier. This will test the configuration and check that the web service is now running.

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

=== 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.

# It will need to change some of the configuration files so the Web GUI can configure them. Once this is done, it will log out and you'll have to log in again. This should only happen once.

== Troubleshooting ==

=== 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 3: / Line 3: @@
 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 ==
+== Installation ==
+=== Packages Required ===
 To implement the system, the following packages are required:
@@ Line 23: / Line 24: @@
 * Checkout latest revision from http://svn.asterisk.org/svn/asterisk-gui/branches/2.0/ for Web GUI.
-== Installing the TFTP server ==
+=== Installing the TFTP server ===
 The TFTP server is what hard-phones use to download the settings files from the server. This step is not required if your not using hard-phones.
@@ Line 32: / Line 33: @@
 # Files for the hard-phones can then be dropped into <code>/srv/tftpboot/</code>.
-== Installing the Asterisk server ==
+=== Installing the Asterisk server ===
 # From YaST, select Software Management. Once this has started, select from the top menu Configuration and then click Repositories.
@@ Line 41: / Line 42: @@
 # Find the Asterisk 11 repository that you just added from the list and click on it.
 # Tick the packages that need to be installed from above in the Packages Required section above.
-# '''NOTE: When you try to add <code>asterisk-dahdi</code>, it will currently say that it is unable to find a package to fulfil its requirements. It is safe to ignore this requirement with the bottom toggle box. This package is only needed to make the Web GUI work.'''
 # Click Accept to install the packages. This will install the Asterisk server.
 # When back in the YaST control panel, under System run System Services (Runlevel).
@@ Line 51: / Line 51: @@
 # If this says 'Cannot find remote Asterisk server', it may not have started or may not have installed properly. Type <code>service asterisk start</code> into the Terminal prompt. If you get no errors, it should have started and you can try the previous step again. If it says it can't find the service, it may not have installed properly and needs reinstalling again.
-== Installing the Web GUI ==
+NOTE: If you are running openSuSE 12.3, there is a problem with the Runlevel YaST module where it will say the service is enabled but it won't actually enable this. Make sure your system is up to date to solve this problem!
+=== Installing the Web GUI ===
 The Web GUI allows simple administration of the Asterisk server without fiddling around manually changing the contents of the folder.
+Subversion revision 5220 as of writing this article
 # Make sure <code>subversion</code> is installed through YaST.
@@ Line 71: / Line 75: @@
 # 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.
+# You can now type <code>make checkconfig</code> into the terminal window you left open earlier. This will test the configuration and check that the web service is now running.
-== Using the Web GUI for the first time ==
+=== 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.
+# It will need to change some of the configuration files so the Web GUI can configure them. Once this is done, it will log out and you'll have to log in again. This should only happen once.
-== Troubleshooting ==
+=== 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.