Getting the Source

The Asterisk GUI is now split into branches/1.0 and branches/2.0.

Note: The gui currently work with Asterisk 1.6.x, but there are a couple of bugs being worked on now.
Please report bugs to the Bugtracker

Those Are:
Branches/1.0 (Formerly Trunk, no longer maintained) Note! This used to be Trunk
Branches/2.0 (New Gui!)

Installation

To checkout the branch you must have subversion installed (command: svn) Example SVN Checkout Command of Trunk / Configuring / Installation

1. svn co http://svn.digium.com/svn/asterisk-gui/branches/2.0 asterisk-gui
2. cd asterisk-gui
3. sh configure && make && make install

If there were no errors, everything went perfectly. An example you can use here is: (type this into console)
IMPORTANT! Watch the output of the command:
'make checkconfig'
as it will test your asterisk configuration files to make sure the GUI is ready for use. 
Note! You can also type 'make update' in the GUI source directory to update your SVN checkout.

 

Patching

Here we will apply a patch, make a patch, and revert to whats in svn if we mess something up.
There are many reasons you want to know how to patch. These reasons include:

1. A developer wants you to test some code that could fix your bug!
2. After making a change yourself, submit your fixes to the project.
3. Be able to test and change other peoples code submission.

To apply your own patch, you must first obtain one, for the example, we will use this.

Index: config/cfgbasic.html =================================================================== --- config/cfgbasic.html (revision 1464) +++ config/cfgbasic.html (working copy) @@ -273,6 +273,7 @@  } function registerajax() { + alert("our patch worked!"); showdiv_statusmessage(); fit_toScreen(); ASTGUI.events.add( window , 'resize', fit_toScreen ); 

Save that file to ourpatch.patch in the GUI source directory we just checked out. 
(ast-gui, if you followed the instructions directly) To apply the patch, we will issue the command:
patch -p0 < outpatch.patch
You will see the patch results, such as:

# patch -p0 < ourpatch.patch patching file config/cfgbasic.html 

You will also see your change by typing: svn diff (to diff against the public repository, of which is not changed)

#svn diff  Index: config/cfgbasic.html =================================================================== --- config/cfgbasic.html (revision 1464) +++ config/cfgbasic.html (working copy) @@ -273,6 +273,7 @@  } function registerajax() { + alert("our patch worked!"); showdiv_statusmessage(); fit_toScreen(); ASTGUI.events.add( window , 'resize', fit_toScreen ); 

 

Making your own patch.

Now that we have made our own patch, lets go ahead and save it for others to use!

bkruse~# svn diff > ournewchange.patch bkruse~# cat ournewchange.patch Index: config/cfgbasic.html =================================================================== --- config/cfgbasic.html (revision 1464) +++ config/cfgbasic.html (working copy) @@ -273,6 +273,7 @@  } function registerajax() { + alert("our patch worked!"); showdiv_statusmessage(); fit_toScreen(); ASTGUI.events.add( window , 'resize', fit_toScreen ); 

Now we can submit our patches to the bug tracker, individuals, or keep them for future use!

 

Reverting our changes.

Now we have this annoying alert box every time we load the asterisk GUI. 
Luckily, SVN can save us from this trouble, we can simply: svn revert filename eg:

bkruse:~# svn revert config/cfgbasic.html Reverted 'config/cfgbasic.html'  bkruse:~# svn diff bkruse:~# 

There are now no local modifications, you are good to go!

 

404/Config File Mess/Cannot Login.

Here are my default config files I use

http.conf:

[general] enabled=yes bindaddr=0.0.0.0 bindport=8088 prefix=gui enablestatic=yes 

manager.conf:

[general] enabled=yes webenabled=yes port=5038 bindaddr=0.0.0.0 [bkruse] secret=blah read=system,call,log,verbose,command,agent,user,config,originate,read,write write=system,call,log,verbose,command,agent,user,config,originate,read,write 

With this configuration, you can access the gui from: http://ip:8088/gui/static/config/cfgbasic.html

(Note: This is the most insecure settings, but if you are having problems, will
help you get something working. Don't forget to harden down!)

Conclusion

Thanks for reading and learning the right way to Configure/Install/Update/Patch the Asterisk GUI. -bk