pbx/README.adoc: Bolder headings

roles/pbx/README.adoc

@@ -14,14 +14,14 @@ _Historical:_ Back in February 2019, IIAB had installed Asterisk 16 and FreePBX
 
 
 
-=== What Asterisk & FreePBX do
+== What Asterisk & FreePBX do
 
 https://en.wikipedia.org/wiki/Asterisk_(PBX)[Asterisk] is a software implementation of a private branch exchange (PBX).  In conjunction with suitable telephony hardware interfaces and network applications, Asterisk is used to establish and control telephone calls between telecommunication endpoints, such as customary telephone sets, destinations on the public switched telephone network (PSTN), and devices or services on Voice over Internet Protocol (VoIP) networks.  Its name comes from the asterisk (*) symbol for a signal used in dual-tone multi-frequency (DTMF) dialing.
 
 https://en.wikipedia.org/wiki/FreePBX[FreePBX] is a web-based open source GUI (graphical user interface) that controls and manages Asterisk (PBX), the open source communications server.
 
 
-=== Install it
+== Install it
 
 . _Before installing,_ make sure your IIAB configuration file (http://wiki.laptop.org/go/IIAB/FAQ#What_is_local_vars.yml_and_how_do_I_customize_it.3F[/etc/iiab/local_vars.yml]) contains:
 +
@@ -62,7 +62,7 @@ If FreePBX is not running well, check the long-form output of `journalctl -u fre
 // After installing PBX as part of IIAB, please visit http://box.lan:83/freepbx (Apache) or http://box.lan/freepbx (NGINX) and proceed with initial configuration (no login/password is required initially — you will be asked to set this up!)
 
 
-=== Try it out with an Android or iPhone softphone (SIP) app
+== Try it out with an Android or iPhone softphone (SIP) app
 // SIP Set up a basic working FreePBX configuration with a PJSIP extension
 
 . Log in to FreePBX
@@ -137,7 +137,7 @@ image::files/linphone_connected.jpg[width='33%']
 ** Please create a https://en.wikipedia.org/wiki/Privacy_policy[Privacy Policy] against abusive surveillance, and explain it to the people in your community.  Strongly consider giving them access to their own statistics with the <<#UCP,User Control Panel>> summarized further below.
 
 
-=== Automatically create extensions, automated test call
+== Automatically create extensions, automated test call
 
 . Try the script link:templates/iiab-asterisk-test[*iiab-asterisk-test*] to:
 
@@ -174,7 +174,7 @@ _Note: This will only work if you've created extension 1000 manually, or using F
 Read more about creating _extensions_ and _dialplans_ https://wiki.asterisk.org/wiki/display/AST/Creating+SIP+Accounts[here].
 
 
-=== Troubleshooting
+== Troubleshooting
 
 . Check if Asterisk is up and running:
 
@@ -198,7 +198,7 @@ sudo fwconsole reload
 ----
 
 
-=== Some useful Asterisk commands
+== Some useful Asterisk commands
 
 . To reach Asterisk's own CLI (command-line interface)
 
@@ -224,7 +224,7 @@ asterisk -rx "cdr show status"
 ----
 
 
-=== Additional FreePBX info
+== Additional FreePBX info
 
 . `/etc/freepbx.conf` allows you to override FreePBX's stored settings if necessary.
 +
@@ -263,16 +263,7 @@ image::files/pwdless_login.jpg[]
 image::files/password_change.jpg[]
 
 
-////
-=== Raspberry Pi Known Issues
-
-As of 2019-02-14, "systemctl restart freepbx" failed more than 50% of the time when run on a http://wiki.laptop.org/go/IIAB/FAQ#What_services_.28IIAB_apps.29_are_suggested_during_installation.3F[BIG-sized] install of IIAB 6.7 on RPi 3 or RPi 3 B+.
-
-It is possible that FreePBX restarts much more reliably when run on a MIN-sized install of IIAB?  Please http://wiki.laptop.org/go/IIAB/FAQ#What_are_the_best_places_for_community_support.3F[contact us] if you can assist here in any way: https://github.com/iiab/iiab/issues/1493[#1493]
-////
-
-
-=== Known Issues
+== Known Issues
 
 Please also check the "Known Issues" at the bottom of https://github.com/iiab/iiab/wiki#our-evolution[IIAB's latest release notes].
 
@@ -291,7 +282,16 @@ See the output of `asterisk -rx "cdr show status"` as mentioned at https://githu
 Node.js applications like Asterisk/FreePBX, Node-RED and Sugarizer won't work on Raspberry Pi Zero W (ARMv6) if you installed Node.js while on RPi 3, 3 B+ (ARMv7) or RPi 4 (ARMv8).  If necessary, run `apt remove nodejs` or `apt purge nodejs` then `rm /etc/apt/sources.list.d/nodesource.list; apt update` then (https://nodered.org/docs/hardware/raspberrypi#swapping-sd-cards[attempt!]) to https://github.com/iiab/iiab/blob/master/roles/nodejs/tasks/main.yml[install Node.js] _on the Raspberry Pi Zero W itself_ (a better approach than "cd /opt/iiab/iiab; ./runrole nodejs" is to try `apt install nodejs` or try installing the tar file mentioned at https://github.com/iiab/iiab/issues/2082#issuecomment-569344617[#2082]).  You might also need `apt install npm`.  Whatever versions of Node.js and npm you install, make sure `/etc/iiab/iiab_state.yml` contains the line `nodejs_installed: True` (add it if nec!)  Finally, proceed to install Asterisk/FreePBX, Node-RED and/or Sugarizer. https://github.com/iiab/iiab/issues/1799[#1799]
 
 
-=== Attribution
+////
+== Raspberry Pi Known Issues
+
+As of 2019-02-14, "systemctl restart freepbx" failed more than 50% of the time when run on a http://wiki.laptop.org/go/IIAB/FAQ#What_services_.28IIAB_apps.29_are_suggested_during_installation.3F[BIG-sized] install of IIAB 6.7 on RPi 3 or RPi 3 B+.
+
+It is possible that FreePBX restarts much more reliably when run on a MIN-sized install of IIAB?  Please http://wiki.laptop.org/go/IIAB/FAQ#What_are_the_best_places_for_community_support.3F[contact us] if you can assist here in any way: https://github.com/iiab/iiab/issues/1493[#1493]
+////
+
+
+== Attribution
 
 In February 2019, this https://github.com/iiab/iiab/tree/master/roles/pbx[roles/pbx] IIAB https://github.com/iiab/iiab/wiki/IIAB-Contributors-Guide#ansible[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.