external/iiab
1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-02-13 11:42:08 +00:00
Code Issues Releases Wiki Activity

pbx/README.doc — mention cmds like: asterisk -rx "cdr show status" + touchups

Browse source
This commit is contained in:
A Holt 2021-08-13 16:58:24 -04:00 committed by GitHub
parent 21a37e04a7
commit 972693a725
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 32 additions and 26 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

58
roles/pbx/README.adoc
View file

@ -171,44 +171,50 @@ sudo fwconsole reload
. To run an Asterisk command outside of Asterisk's CLI, e.g. for use in a script:
* Run Linux command: `asterisk -rx "pjsip show endpoints"`
* Try Linux commands like:
+
----
asterisk -rx "pjsip show endpoints"
asterisk -rx "cdr show status"
----
=== Additional FreePBX info
. `/etc/freepbx.conf` allows you to override FreePBX settings if necessary. A better way however, is to use http://box.lan:83/freepbx or http://box.lan/freepbx > *Settings* > *Advanced Settings* — or equivalently, run Linux commands like:
. `/etc/freepbx.conf` allows you to override FreePBX's stored settings if necessary.
+
A better way however, is to use http://box.lan:83/freepbx or http://box.lan/freepbx > *Settings* > *Advanced Settings* to modify those stored settings — or equivalently, run Linux commands like:
+
----
sudo fwconsole set -l # View FreePBX settings
sudo fwconsole set -h # Show all settings' raw values.
sudo fwconsole set CHECKREFERER # Show setting's value, in human-readable form.
sudo fwconsole set CHECKREFERER 0 # 0 means false. Or set it to 1, to re-enable FreePBX's default.
sudo fwconsole set -l # Show all FreePBX settings' raw values
sudo fwconsole set CHECKREFERER # Show setting's value, in human-readable form
sudo fwconsole set CHECKREFERER 0 # 0 means false (or set it to 1, to re-enable FreePBX's default)
----
. Also try FreePBX commands like the following, at the Linux command-line:
+
----
sudo fwconsole list # List commands
sudo fwconsole -h
sudo fwconsole restart
sudo fwconsole ma list # ma = Module Administration (e.g. shows ~16 default modules, of ~70 total)
sudo fwconsole ma -h
sudo fwconsole ma showupgrades
sudo fwconsole ma upgradeall # Upgrade your FreePBX modules (as normally happens Saturday 4-8AM)
----
. [[UCP]]*User Control Panel*
* If you'd like to allow users more control over their own settings, and the ability to review their own statistics, install the https://wiki.freepbx.org/pages/viewpage.action?pageId=28180526[User Control Panel] FreePBX module from http://box.lan:83/freepbx or http://box.lan/freepbx > *Admin* > *Module Admin* > *Check Online*.
. If you forget your FreePBX password, you can bypass it using Linux command `sudo fwconsole unlock <Session ID>` and then refresh the web page. To get the Session ID, press `Ctrl + a` which will highlight all the text on the page. The text highlighted in the middle of the page, is the Session ID:
+
image::files/pwdless_login.jpg[]
. Once you've logged in, change your password under *Admin* > *Administrators*. On the right side, you will see the list of available users. You can select the appropriate user and change the password.
+
Once you've logged in, change your password under *Admin* > *Administrators*. On the right side, you will see the list of available users. You can select the appropriate user and change the password.
+
image::files/password_change.jpg[]
. [[UCP]]User Control Panel
* If you'd like to allow users to manage some of their own settings and view their statistics, install the https://wiki.freepbx.org/pages/viewpage.action?pageId=28180526[User Control Panel] FreePBX module from *Admin* > *Module Admin* > *Check Online*.
. Try FreePBX's commands like the following, at the Linux command-line:
+
----
sudo fwconsole list
sudo fwconsole -h
sudo fwconsole restart
sudo fwconsole ma list
sudo fwconsole ma -h
sudo fwconsole ma showupgrades
sudo fwconsole ma upgradeall
----
////
=== Raspberry Pi Known Issues
@ -238,9 +244,9 @@ Node.js applications like Asterisk/FreePBX, Node-RED and Sugarizer won't work on
=== Attribution
In February 2019, This https://github.com/iiab/iiab/tree/master/roles/pbx[pbx] Ansible playbook was originally inspired by Yannik Sembritzki's https://github.com/Yannik/ansible-role-asterisk[Asterisk] and https://github.com/Yannik/ansible-role-freepbx[FreePBX] Ansible work from 2017-2019.
In February 2019, this https://github.com/iiab/iiab/tree/master/roles/pbx[pbx] Ansible playbook was originally inspired by Yannik Sembritzki's https://github.com/Yannik/ansible-role-asterisk[Asterisk] and https://github.com/Yannik/ansible-role-freepbx[FreePBX] Ansible work from 2017-2019.
In August 2021 it was overhauled, with thanks to these 3 especially:
In August 2021 it was overhauled, with thanks to these 3 sources especially:
* "Official" recipe: https://wiki.freepbx.org/display/FOP/Installing+FreePBX+16+on+Debian+10.9
* Comprehensive & recent recipe for Raspberry Pi: http://mghadam.blogspot.com/2021/03/install-asterisk-18-freepbx-15-on.html