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

roles/pbx/README.adoc

@@ -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 -l                # Show all FreePBX settings' raw values
-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      # 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 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