<html>
<head>
<base href="https://wiki.asterisk.org/wiki">
<link rel="stylesheet" href="/wiki/s/2042/1/7/_/styles/combined.css?spaceKey=AST&forWysiwyg=true" type="text/css">
</head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
<h2><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+GUI">Asterisk GUI</a></h2>
<h4>Page <b>edited</b> by <a href="https://wiki.asterisk.org/wiki/display/~espiceland">Erin Spiceland</a>
</h4>
<br/>
<h4>Changes (9)</h4>
<div id="page-diffs">
<table class="diff" cellpadding="0" cellspacing="0">
<tr><td class="diff-snipped" >...<br></td></tr>
<tr><td class="diff-unchanged" >You may install sample configuration files by doing "make samples". Also you will need to edit your Asterisk configuration files to enable the GUI properly, specifically: <br> <br></td></tr>
<tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">#In</span> <span class="diff-added-words"style="background-color: #dfd;">h2.</span> http.conf: <br></td></tr>
<tr><td class="diff-added-lines" style="background-color: #dfd;">Enable http. <br></td></tr>
<tr><td class="diff-unchanged" >{code:lang=javascript}[[general] <br>enabled=yes <br></td></tr>
<tr><td class="diff-snipped" >...<br></td></tr>
<tr><td class="diff-unchanged" >bindport=8088{code} <br> <br></td></tr>
<tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">#In</span> <span class="diff-added-words"style="background-color: #dfd;">h2.</span> manager.conf <br></td></tr>
<tr><td class="diff-added-lines" style="background-color: #dfd;">Enable manager access. <br></td></tr>
<tr><td class="diff-unchanged" >{code:lang=javascript}[general] <br>enabled = yes <br>webenabled = yes{code} <br> <br></td></tr>
<tr><td class="diff-changed-lines" ><span class="diff-changed-words"><span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">#</span>Create</span> an appropriate entry in manager.conf for the administrative user (PLEASE READ THE security.txt FILE!) <br></td></tr>
<tr><td class="diff-unchanged" >{code:lang=javascript}[admin] <br>secret = thiswouldbeaninsecurepassword <br></td></tr>
<tr><td class="diff-snipped" >...<br></td></tr>
<tr><td class="diff-unchanged" > <br>h1. Troubleshooting <br></td></tr>
<tr><td class="diff-changed-lines" ><span class="diff-changed-words"><span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">#</span>Check</span> your filesystem permissions: <br></td></tr>
<tr><td class="diff-unchanged" >{code:lang=javascript}$ chown asterisk:asterisk /etc/asterisk/*.conf # if asterisk runs as the user "asterisk" <br>$ chmod 644 /etc/asterisk/*.conf{code} <br> <br></td></tr>
<tr><td class="diff-changed-lines" ><span class="diff-changed-words"><span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">#</span>Check</span> that the bindaddr value in /etc/asterisk/http.conf matches the IP address of the machine you're using to access the GUI. <br></td></tr>
<tr><td class="diff-unchanged" > <br></td></tr>
<tr><td class="diff-changed-lines" ><span class="diff-changed-words"><span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">#</span>Check</span> that the dahdi_genconf script runs correctly. <br></td></tr>
<tr><td class="diff-unchanged" > <br></td></tr>
<tr><td class="diff-changed-lines" ><span class="diff-changed-words"><span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">#</span>Check</span> the existence of /etc/asterisk/guipreferences.conf and inside that file, the existence of the following line: <br></td></tr>
<tr><td class="diff-unchanged" >{code:lang=javascript}config_upgraded = yes{code} <br></td></tr>
</table>
</div> <h4>Full Content</h4>
<div class="notificationGreySide">
<h1><a name="AsteriskGUI-Introduction"></a>Introduction</h1>
<p>Asterisk GUI is a framework for the creation of graphical interfaces for configuring Asterisk. Some sample graphical interfaces for specific vertical markets are included for reference or for actual use and extension.</p>
<h1><a name="AsteriskGUI-SoftwareLicense"></a>Software License</h1>
<p>Asterisk-GUI HTML and Javascript files Copyright (C) 2006-2011 Digium, Inc.</p>
<p>This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2 only. This software is also available under commercial terms from Digium, Inc.</p>
<p>This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.</p>
<p>Please contact Digium for information on alternative licensing arrangements for Asterisk GUI.</p>
<h1><a name="AsteriskGUI-Support"></a>Support</h1>
<p>Please note that the Asterisk GUI is not officially supported, though bugs, patches, and feature requests may be submitted at <a href="http://bugs.digium.com" class="external-link" rel="nofollow">http://bugs.digium.com</a> and should reference the GUI project.</p>
<h1><a name="AsteriskGUI-Installation"></a>Installation</h1>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<script type="syntaxhighlighter" class="toolbar: false; theme: Confluence; brush: javascript; gutter: false"><![CDATA[$ ./configure
$ make
$ make install]]></script>
</div></div>
<h1><a name="AsteriskGUI-Configuration"></a>Configuration</h1>
<p>You may install sample configuration files by doing "make samples". Also you will need to edit your Asterisk configuration files to enable the GUI properly, specifically:</p>
<h2><a name="AsteriskGUI-http.conf%3A"></a>http.conf:</h2>
<p>Enable http.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<script type="syntaxhighlighter" class="toolbar: false; theme: Confluence; brush: javascript; gutter: false"><![CDATA[[[general]
enabled=yes
enablestatic=yes
#bindaddr=0.0.0.0 # allow GUI to be accessible from all IP addresses.
bindaddr=127.0.0.1 # require access from the machine Asterisk is running on
bindport=8088]]></script>
</div></div>
<h2><a name="AsteriskGUI-manager.conf"></a>manager.conf</h2>
<p>Enable manager access.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<script type="syntaxhighlighter" class="toolbar: false; theme: Confluence; brush: javascript; gutter: false"><![CDATA[[general]
enabled = yes
webenabled = yes]]></script>
</div></div>
<p>Create an appropriate entry in manager.conf for the administrative user (PLEASE READ THE security.txt FILE!)</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<script type="syntaxhighlighter" class="toolbar: false; theme: Confluence; brush: javascript; gutter: false"><![CDATA[[admin]
secret = thiswouldbeaninsecurepassword
read = system,call,log,verbose,command,agent,config,read,write,originate
write = system,call,log,verbose,command,agent,config,read,write,originate]]></script>
</div></div>
<h1><a name="AsteriskGUI-Troubleshooting"></a>Troubleshooting</h1>
<p>Check your filesystem permissions:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<script type="syntaxhighlighter" class="toolbar: false; theme: Confluence; brush: javascript; gutter: false"><![CDATA[$ chown asterisk:asterisk /etc/asterisk/*.conf # if asterisk runs as the user "asterisk"
$ chmod 644 /etc/asterisk/*.conf]]></script>
</div></div>
<p>Check that the bindaddr value in /etc/asterisk/http.conf matches the IP address of the machine you're using to access the GUI.</p>
<p>Check that the dahdi_genconf script runs correctly.</p>
<p>Check the existence of /etc/asterisk/guipreferences.conf and inside that file, the existence of the following line:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<script type="syntaxhighlighter" class="toolbar: false; theme: Confluence; brush: javascript; gutter: false"><![CDATA[config_upgraded = yes]]></script>
</div></div>
</div>
<div id="commentsSection" class="wiki-content pageSection">
<div style="float: right;">
<a href="https://wiki.asterisk.org/wiki/users/viewnotifications.action" class="grey">Change Notification Preferences</a>
</div>
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+GUI">View Online</a>
|
<a href="https://wiki.asterisk.org/wiki/pages/diffpagesbyversion.action?pageId=13076491&revisedVersion=2&originalVersion=1">View Changes</a>
|
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+GUI?showComments=true&showCommentArea=true#addcomment">Add Comment</a>
</div>
</div>
</div>
</div>
</div>
</body>
</html>