Merge pull request #3523 from holta/asterisk-patch

EXPERIMENTAL: 'asterisk_rpi_patch: True' option for Raspberry Pi + preliminary path to FreePBX on PHP 8

roles/pbx/README.adoc

@@ -6,7 +6,7 @@ https://internet-in-a-box.org[Internet-in-a-Box (IIAB)] can install https://aste
 
 As of March 2023, IIAB installs https://wiki.asterisk.org/wiki/display/AST/Asterisk+20+Documentation[Asterisk 20] and https://www.freepbx.org/freepbx-16-is-now-released-for-general-availability/[FreePBX 16].
 
-*PHP 7.4 is REQUIRED (https://github.com/iiab/iiab/pull/2899[PR #2899]) and PHP 8.x does not yet work (https://github.com/iiab/iiab/pull/3019#issuecomment-962469346[PR #3109]) — this remains true in 2023, and will likely remain true until https://github.com/FreePBX/framework/tree/release/17.0[FreePBX 17] is eventually released — so please consider installing on https://github.com/iiab/iiab/wiki/IIAB-Platforms#operating-systems[Debian 11 "Bullseye", or 64-bit Raspberry Pi OS versions based on "Bullseye"] (https://github.com/iiab/iiab/wiki/IIAB-8.1-Release-Notes#known-issues[WARNING]).*
+*PHP 7.4 is REQUIRED (https://github.com/iiab/iiab/pull/2899[PR #2899]) and PHP 8.x does not yet work (https://github.com/iiab/iiab/pull/3019#issuecomment-962469346[PR #3109]) — this remains true in 2023, and will likely remain true until https://github.com/FreePBX/framework/tree/release/17.0[FreePBX 17] is eventually released — so please consider installing on https://github.com/iiab/iiab/wiki/IIAB-Platforms#operating-systems[Debian 11 "Bullseye", or 64-bit Raspberry Pi OS versions based on "Bullseye"] (https://github.com/iiab/iiab/pull/3523[PR #3523]).*
 
 ////
 As of August 2021, IIAB installs https://wiki.asterisk.org/wiki/display/AST/Asterisk+18+Documentation[Asterisk 18] and https://www.freepbx.org/freepbx-16-beta-is-here/[FreePBX 16 Beta], as required by the latest PHP 7.4 Linux OS's (https://github.com/iiab/iiab/pull/2899[PR #2899]).  Please consider installing this on https://github.com/iiab/iiab/wiki/IIAB-Platforms#operating-systems[Ubuntu 20.04+, Debian 11 — or the imminent Raspberry Pi OS 11 "Bullseye"].
@@ -41,15 +41,15 @@ pbx_install: True
 pbx_enabled: True
 ----
 +
-FreePBX can be used with either or both web servers, NGINX on port 80 (as is new) and/or Apache on port 83 (as is traditional).
+FreePBX can be used with either or both web servers — NGINX on port 80 (http://box/freepbx) and/or using the old approach with Apache on port 83 (http://box:83/freepbx).
 +
-If you don't want Apache installed on your IIAB, and you prefer NGINX's shorter URL (http://box/freepbx), optionally set this line in your https://wiki.iiab.io/go/FAQ#What_is_local_vars.yml_and_how_do_I_customize_it%3F[/etc/iiab/local_vars.yml] prior to installing IIAB:
+If you still want the older Apache approach, set this line in your https://wiki.iiab.io/go/FAQ#What_is_local_vars.yml_and_how_do_I_customize_it%3F[/etc/iiab/local_vars.yml] prior to installing IIAB:
 +
 ----
-pbx_use_apache: False
+pbx_use_apache: True
 ----
 +
-Or, if you want to use FreePBX with Apache alone (http://box:83/freepbx), optionally set this line in your /etc/iiab/local_vars.yml:
+If you want to disable to new NGINX approach, set this line in your /etc/iiab/local_vars.yml:
 +
 ----
 pbx_use_nginx: False
@@ -61,6 +61,12 @@ If using PBX intensively, please adjust `/etc/php/X.Y/apache2/php.ini`, `/etc/ph
 nginx_high_php_limits: True
 ----
 +
+As of April 2023 (https://github.com/iiab/iiab/pull/3523[PR #3523]) IIAB will patch Asterisk automatically (https://github.com/asterisk/asterisk/pull/32[PR asterisk/asterisk#32]) so it can be run experimentally on Raspberry Pi, so long as you keep this default settings:
++
+----
+asterisk_rpi_patch: True
+----
++
 Optionally, you may want to enable https://github.com/wdoekes/asterisk-chan-dongle[chan_dongle], which is a channel driver for Huawei UMTS cards (e.g. 3G USB dongles) allowing regular voice calls over GSM mobile networks.  You will need to configure a dongle post-install, for it to be recognized properly:
 +
 ----

roles/pbx/defaults/main.yml

@@ -8,9 +8,12 @@
 # pbx_install: False
 # pbx_enabled: False
 
-# pbx_use_apache: True    # 2021-08-17: Set either to 'False' if nec -- please
+# pbx_use_apache: False   # 2023-04-03: Set to 'True' if nec -- please also
 # pbx_use_nginx: True     # read github.com/iiab/iiab/issues/2914 & #2916, THX!
 
+# 2023-04-03: For EXPERIMENTAL testing on Raspberry Pi... (#3489, PR #3523)
+# asterisk_rpi_patch: True
+
 # asterisk_chan_dongle: False
 
 # pbx_signaling_ports_chan_sip: 5160:5161
@@ -21,6 +24,7 @@
 # All above are set in: github.com/iiab/iiab/blob/master/vars/default_vars.yml
 # If nec, change them by editing /etc/iiab/local_vars.yml prior to installing!
 
+
 asterisk_url: https://downloads.asterisk.org/pub/telephony/asterisk
 asterisk_src_file: asterisk-20-current.tar.gz
 asterisk_src_dir: "{{ iiab_base }}/asterisk"    # /opt/iiab

roles/pbx/files/install_prereq.diff

@@ -0,0 +1,17 @@
+--- install_prereq.orig	2023-04-01 01:41:56.859545082 -0500
++++ install_prereq	2023-04-01 01:44:28.744269701 -0500
+@@ -193,8 +193,13 @@
+ 		tocheck="${tocheck} ^${pack}$ ~P^${pack}$"
+ 	done
+ 	pkgs=$(aptitude -F '%c %p' search ${tocheck} 2>/dev/null | awk '/^p/{print $2}')
++	arch=$(uname -m)
+ 	if [ ${#pkgs} -ne 0 ]; then
+-		echo $pkgs | sed -r -e "s/ ?[^ :]+:i386//g"
++		if [ "$arch" = "x86_64" ]; then
++			echo $pkgs | sed -r -e "s/ ?[^ :]+:i386//g"
++		elif [ "$arch" = "aarch64" ]; then
++			echo $pkgs | sed -r -e "s/ ?[^ :]+:armhf//g"
++		fi
+ 	fi
+ }
+ 

roles/pbx/tasks/apache.yml

@@ -39,3 +39,14 @@
     dest: /etc/{{ apache_service }}/sites-available/freepbx.conf    # apache2
     owner: "{{ apache_user }}"    # www-data
     group: "{{ apache_user }}"
+
+
+- name: "Set 'apache_installed: True'"
+  set_fact:
+    apache_installed: True
+
+- name: "Add 'apache_installed: True' to {{ iiab_state_file }}"
+  lineinfile:
+    path: "{{ iiab_state_file }}"    # /etc/iiab/iiab_state.yml
+    regexp: '^apache_installed'
+    line: 'apache_installed: True'

roles/pbx/tasks/asterisk.yml

@@ -40,8 +40,6 @@
   unarchive:
     src: "{{ downloads_dir }}/{{ asterisk_src_file }}"
     dest: "{{ asterisk_src_dir }}"
-    # owner: root
-    # group: root
     extra_opts: [--strip-components=1]
     creates: "{{ asterisk_src_dir }}/Makefile"
 
@@ -55,6 +53,13 @@
 #     name: aptitude
 #     state: latest
 
+# https://github.com/iiab/iiab/issues/3489
+- name: "Asterisk - Apply patch to {{ asterisk_src_dir }}/contrib/scripts/install_prereq for Raspberry Pi (#3489) if 'asterisk_rpi_patch: True'"
+  ansible.posix.patch:
+    src: install_prereq.diff
+    dest: "{{ asterisk_src_dir }}/contrib/scripts/install_prereq"
+  when: asterisk_rpi_patch
+
 - name: Asterisk - Run 'install_prereq install' for dependencies - CAN TAKE 2-5 MIN OR LONGER!
   shell: export DEBIAN_FRONTEND=noninteractive && ./contrib/scripts/install_prereq install
   args:

roles/pbx/tasks/enable-or-disable.yml

@@ -1,43 +1,42 @@
 - name: JUST 1 SETTING TO TURN ON/OFF FOR APACHE - whereas NGINX below has 4...
   meta: noop
 
-- name: EITHER - Create symlink /etc/{{ apache_service }}/sites-enabled/freepbx.conf to enable Apache's http://box:{{ pbx_http_port }}/freepbx - if pbx_use_apache and pbx_enabled    # http://box:83/freepbx
+- name: EITHER - Create symlink /etc/{{ apache_service }}/sites-enabled/freepbx.conf to enable Apache's http://box:{{ pbx_http_port }}/freepbx - if apache_installed is defined and pbx_use_apache and pbx_enabled    # http://box:83/freepbx
   command: a2ensite freepbx.conf
-  when: pbx_use_apache and pbx_enabled
+  when: apache_installed is defined and pbx_use_apache and pbx_enabled
 
-- name: OR ELSE - Delete symlink /etc/{{ apache_service }}/sites-enabled/freepbx.conf to disable Apache's http://box:{{ pbx_http_port }}/freepbx - if not (pbx_use_apache and pbx_enabled)
+- name: OR ELSE - Delete symlink /etc/{{ apache_service }}/sites-enabled/freepbx.conf to disable Apache's http://box:{{ pbx_http_port }}/freepbx - if not (apache_installed is defined and pbx_use_apache and pbx_enabled)
   file:    # As 'a2dissite freepbx.conf' might not be installed
     path: /etc/{{ apache_service }}/sites-enabled/freepbx.conf    # apache2
     state: absent
-  when: not (pbx_use_apache and pbx_enabled)
+  when: not (apache_installed is defined and pbx_use_apache and pbx_enabled)
 
 
 - name: "ENACT ABOVE SETTING FOR APACHE - 'pbx_use_apache: False' might arise later, so best ALWAYS run..."
   meta: noop
 
-- name: EITHER - Restart & Enable '{{ apache_service }}' systemd service - if pbx_use_apache and pbx_enabled
+- name: EITHER - Restart & Enable '{{ apache_service }}' systemd service - if apache_installed is defined and pbx_use_apache and pbx_enabled
   systemd:
     daemon_reload: yes
     name: "{{ apache_service }}"    # apache2
     state: restarted
     enabled: yes
-  when: pbx_use_apache and pbx_enabled
+  when: apache_installed is defined and pbx_use_apache and pbx_enabled
-  ignore_errors: yes    # In case Apache not installed
 
-- name: OR ELSE - Stop & Disable '{{ apache_service }}' systemd service - if not (pbx_use_apache and pbx_enabled)
+- name: OR ELSE - Stop & Disable '{{ apache_service }}' systemd service - if not (apache_installed is defined and pbx_use_apache and pbx_enabled)
   systemd:
     daemon_reload: yes
     name: "{{ apache_service }}"
     state: stopped
     enabled: no
-  when: not (pbx_use_apache and pbx_enabled)
+  when: not (apache_installed is defined and pbx_use_apache and pbx_enabled)
-  ignore_errors: yes    # In case Apache not installed
+  ignore_errors: yes    # If Apache not installed, HIGHLIGHT IN RED FOR IMPLEMENTER/OPERATOR
 
 - name: Open-or-Close Asterix ports (including Apache port {{ pbx_http_port }}) in iptables firewall, depending on pbx_enabled [{{ pbx_enabled }}] in local_vars.yml - in support of './runrole pbx'
   command: /usr/bin/iiab-gen-iptables
-  ignore_errors: yes    # iptables installed in 2-common, but iiab-gen-tables may not be set up until roles/network runs later
+  when: iiab_stage|int == 9 and network_enabled
-
+# iptables installed in 1-prep via roles/network/tasks/install.yml, but
-
+# iiab-gen-tables may not be set up, until/if roles/network runs later.
 
 
 - block:

roles/pbx/tasks/freepbx.yml

@@ -11,6 +11,9 @@
 # 2021-08-12: Let's try to track the "official" init.d / update-rc.d
 # instructions ('update-rc.d -f asterisk remove') but using systemd instead,
 # to be more future-proof?
+# 2023-04-02: Disagreement remains the same as 2 years ago:
+# @jvonau wants to stop service asterisk (from the asterisk install).
+# @holta prefers we track Asterisk/FreePBX community's mainline/consensus.
 - name: "FreePBX - Disable 'asterisk' systemd service, giving FreePBX full control during boot - similar to officially recommended 'update-rc.d -f asterisk remove' at: https://wiki.freepbx.org/display/FOP/Installing+FreePBX+16+on+Debian+10.9"
   systemd:
     daemon_reload: yes
@@ -62,13 +65,13 @@
 #     state: present
 #   when: php_version is version('8.0', '<')
 
-- name: "Run roles/www_options/tasks/php-settings.yml with 'nginx_high_php_limits: False' by default"
+- name: "FreePBX - Run roles/www_options/tasks/php-settings.yml with 'nginx_high_php_limits: False' by default"
   include_tasks: roles/www_options/tasks/php-settings.yml
   when: php_settings_done is undefined
 
 - name: FreePBX - Install and configure Apache - if pbx_use_apache
   include_tasks: apache.yml
-  when: pbx_use_apache
+  when: pbx_use_apache and apache_installed is undefined
 
 
 # - name: FreePBX - Download {{ freepbx_url }}/{{ freepbx_src_file }} to {{ downloads_dir }}

roles/pbx/tasks/main.yml

@@ -21,6 +21,12 @@
 
 - block:
 
+  - name: If PHP >= 8 is detected, loudly warn that FreePBX does not support PHP 8+ (as of April 2023)
+    fail:    # FORCE IT RED, allowing adventurous/testing people to proceed at their own risk!
+      msg: 'FreePBX DOES NOT SUPPORT PHP 8+ AS OF APRIL 2023.  YOU ARE PROCEEDING ENTIRELY AT YOUR OWN RISK.'
+    when: php_version is version('8.0', '>=')
+    ignore_errors: yes
+
   - name: Install PBX if pbx_installed is not defined, e.g. in {{ iiab_state_file }}    # /etc/iiab/iiab_state.yml
     include_tasks: install.yml
     when: pbx_installed is undefined
@@ -47,6 +53,10 @@
         value: "{{ pbx_install }}"
       - option: pbx_enabled
         value: "{{ pbx_enabled }}"
+      - option: pbx_use_apache
+        value: "{{ pbx_use_apache }}"
+      - option: pbx_use_nginx
+        value: "{{ pbx_use_nginx }}"
 
   rescue:
 

scripts/ansible

@@ -25,9 +25,9 @@ GOOD_VER=2.14.4       # Orig for 'yum install [rpm]' & XO laptops (pip install)
 
 # 'lsb_release -sc' gives Mint 20 codename 'ulyana' etc: (TOO FINE-GRAINED)
 ###if grep -q buster /etc/os-release /etc/debian_version; then
-###    CODENAME=bionic    # Debian 10, RaspiOS 10 & Buster-like distros
+###    CODENAME=bionic    # Debian 10, RasPiOS 10 & Buster-like distros
 ###else
-###    CODENAME=focal     # Debian 11+, RaspiOS 11+, Ubuntu 20.04+, Mint 20+ (ETC)
+###    CODENAME=focal     # Debian 11+, RasPiOS 11+, Ubuntu 20.04+, Mint 20+ (ETC)
 ###fi
 
 # APRIL 2021 - ansible-base (2.10) was renamed to ansible-core (2.11+):
@@ -109,7 +109,7 @@ echo -e "(Internet-in-a-Box requests ansible-core $GOOD_VER or higher)\n"
 
 # Code above designed to work on all Linux distributions, to preserve options,
 # in support of any volunteer(s) wanting to port IIAB to a new Linux/distro.
-if [ ! -f /etc/debian_version ]; then    # e.g. RaspiOS, Ubuntu, Mint & Debian
+if [ ! -f /etc/debian_version ]; then    # e.g. RasPiOS, Ubuntu, Mint & Debian
     echo -e "\nEXITING: /etc/debian_version FILE NOT FOUND.  Linux OS support info here:"
     echo -e "           https://github.com/iiab/iiab/wiki/IIAB-Platforms\n"
     exit 1
@@ -140,7 +140,7 @@ fi
 
 # 2020-08-20: TEMP WORKAROUND (REVERT TO ANSIBLE 2.9.6) MITIGATING
 # iiab/iiab#2481 (Ansible 2.9.12 and 2.10.0's 666-TO-600 file permissions
-# problem).  This workaround installs 2.9.6-1ppa~disco onto RaspiOS, from
+# problem).  This workaround installs 2.9.6-1ppa~disco onto RasPiOS, from
 # https://launchpad.net/~ansible/+archive/ubuntu/ansible
 #echo "deb http://ppa.launchpad.net/ansible/ansible/ubuntu disco main" \
 #    > /etc/apt/sources.list.d/iiab-ansible.list

vars/default_vars.yml

@@ -170,7 +170,7 @@ wan_netmask:       # wan_netmask: 255.255.255.0
 wan_gateway:       # wan_gateway: 192.168.1.254
 # If nec wan_nameserver can override ISP-provided DNS servers via dnsmasq:
 # /etc/resolv.conf dictates which backend is used for the machine itself, so
-# 127.0.0.1 means you get dnsmasq (so it works right away on RaspiOS) while
+# 127.0.0.1 means you get dnsmasq (so it works right away on RasPiOS) while
 # 127.0.0.53 gives you systemd-networkd (so Ubuntu itself does NOT use this
 # dnsmasq-specified upstream DNS [e.g. wan_nameserver] but its LAN clients do!)
 wan_nameserver:    # wan_nameserver: 192.168.1.254 or 8.8.8.8 or 1.1.1.1
@@ -682,13 +682,15 @@ calibre_web_path: calibre  #NEEDS WORK: https://github.com/iiab/iiab/issues/529
 # Avoid URL collisions w/ calibreweb_url1, calibreweb_url2, calibreweb_url3 below!
 
 # A full-featured PBX (for rural telephony, etc) based on Asterisk and FreePBX.
-# REQUIRES PHP 7.4 e.g. Debian 11 Bullseye.  64-bit RaspiOS MIGHT work: #3489
+# REQUIRES PHP 7.4 e.g. Debian 11 Bullseye or 64-bit RasPiOS IF Bullseye-based.
 # INSTRUCTIONS: https://github.com/iiab/iiab/tree/master/roles/pbx#readme
 # If using PBX intensively, investigate nginx_high_php_limits further above.
 pbx_install: False
 pbx_enabled: False
-pbx_use_apache: True    # 2021-08-17: Set either to 'False' if nec -- please
+pbx_use_apache: False   # 2023-04-03: Set to 'True' if nec -- please also
 pbx_use_nginx: True     # read github.com/iiab/iiab/issues/2914 & #2916, THX!
+# 2023-04-03: For EXPERIMENTAL testing on Raspberry Pi... (#3489, PR #3523)
+asterisk_rpi_patch: True
 asterisk_chan_dongle: False
 pbx_signaling_ports_chan_sip: 5160:5161
 pbx_signaling_ports_chan_pjsip: 5060

vars/local_vars_large.yml

@@ -104,7 +104,7 @@ wan_netmask:       # wan_netmask: 255.255.255.0
 wan_gateway:       # wan_gateway: 192.168.1.254
 # If nec wan_nameserver can override ISP-provided DNS servers via dnsmasq:
 # /etc/resolv.conf dictates which backend is used for the machine itself, so
-# 127.0.0.1 means you get dnsmasq (so it works right away on RaspiOS) while
+# 127.0.0.1 means you get dnsmasq (so it works right away on RasPiOS) while
 # 127.0.0.53 gives you systemd-networkd (so Ubuntu itself does NOT use this
 # dnsmasq-specified upstream DNS [e.g. wan_nameserver] but its LAN clients do!)
 wan_nameserver:    # wan_nameserver: 192.168.1.254 or 8.8.8.8 or 1.1.1.1
@@ -415,11 +415,13 @@ calibre_web_path: calibre  #NEEDS WORK: https://github.com/iiab/iiab/issues/529
 # Avoid URL collisions w/ calibreweb_url1, calibreweb_url2, calibreweb_url3 below!
 
 # A full-featured PBX (for rural telephony, etc) based on Asterisk and FreePBX.
-# REQUIRES PHP 7.4 e.g. Debian 11 Bullseye.  64-bit RaspiOS MIGHT work: #3489
+# REQUIRES PHP 7.4 e.g. Debian 11 Bullseye or 64-bit RasPiOS IF Bullseye-based.
 # INSTRUCTIONS: https://github.com/iiab/iiab/tree/master/roles/pbx#readme
 # If using PBX intensively, investigate nginx_high_php_limits further above.
 pbx_install: False
 pbx_enabled: False
-pbx_use_apache: True    # 2021-08-17: Set either to 'False' if nec -- please
+pbx_use_apache: False   # 2023-04-03: Set to 'True' if nec -- please also
 pbx_use_nginx: True     # read github.com/iiab/iiab/issues/2914 & #2916, THX!
+# 2023-04-03: For EXPERIMENTAL testing on Raspberry Pi... (#3489, PR #3523)
+asterisk_rpi_patch: True
 asterisk_chan_dongle: False

vars/local_vars_medium.yml

@@ -104,7 +104,7 @@ wan_netmask:       # wan_netmask: 255.255.255.0
 wan_gateway:       # wan_gateway: 192.168.1.254
 # If nec wan_nameserver can override ISP-provided DNS servers via dnsmasq:
 # /etc/resolv.conf dictates which backend is used for the machine itself, so
-# 127.0.0.1 means you get dnsmasq (so it works right away on RaspiOS) while
+# 127.0.0.1 means you get dnsmasq (so it works right away on RasPiOS) while
 # 127.0.0.53 gives you systemd-networkd (so Ubuntu itself does NOT use this
 # dnsmasq-specified upstream DNS [e.g. wan_nameserver] but its LAN clients do!)
 wan_nameserver:    # wan_nameserver: 192.168.1.254 or 8.8.8.8 or 1.1.1.1
@@ -415,11 +415,13 @@ calibre_web_path: calibre  #NEEDS WORK: https://github.com/iiab/iiab/issues/529
 # Avoid URL collisions w/ calibreweb_url1, calibreweb_url2, calibreweb_url3 below!
 
 # A full-featured PBX (for rural telephony, etc) based on Asterisk and FreePBX.
-# REQUIRES PHP 7.4 e.g. Debian 11 Bullseye.  64-bit RaspiOS MIGHT work: #3489
+# REQUIRES PHP 7.4 e.g. Debian 11 Bullseye or 64-bit RasPiOS IF Bullseye-based.
 # INSTRUCTIONS: https://github.com/iiab/iiab/tree/master/roles/pbx#readme
 # If using PBX intensively, investigate nginx_high_php_limits further above.
 pbx_install: False
 pbx_enabled: False
-pbx_use_apache: True    # 2021-08-17: Set either to 'False' if nec -- please
+pbx_use_apache: False   # 2023-04-03: Set to 'True' if nec -- please also
 pbx_use_nginx: True     # read github.com/iiab/iiab/issues/2914 & #2916, THX!
+# 2023-04-03: For EXPERIMENTAL testing on Raspberry Pi... (#3489, PR #3523)
+asterisk_rpi_patch: True
 asterisk_chan_dongle: False

vars/local_vars_small.yml

@@ -104,7 +104,7 @@ wan_netmask:       # wan_netmask: 255.255.255.0
 wan_gateway:       # wan_gateway: 192.168.1.254
 # If nec wan_nameserver can override ISP-provided DNS servers via dnsmasq:
 # /etc/resolv.conf dictates which backend is used for the machine itself, so
-# 127.0.0.1 means you get dnsmasq (so it works right away on RaspiOS) while
+# 127.0.0.1 means you get dnsmasq (so it works right away on RasPiOS) while
 # 127.0.0.53 gives you systemd-networkd (so Ubuntu itself does NOT use this
 # dnsmasq-specified upstream DNS [e.g. wan_nameserver] but its LAN clients do!)
 wan_nameserver:    # wan_nameserver: 192.168.1.254 or 8.8.8.8 or 1.1.1.1
@@ -415,11 +415,13 @@ calibre_web_path: calibre  #NEEDS WORK: https://github.com/iiab/iiab/issues/529
 # Avoid URL collisions w/ calibreweb_url1, calibreweb_url2, calibreweb_url3 below!
 
 # A full-featured PBX (for rural telephony, etc) based on Asterisk and FreePBX.
-# REQUIRES PHP 7.4 e.g. Debian 11 Bullseye.  64-bit RaspiOS MIGHT work: #3489
+# REQUIRES PHP 7.4 e.g. Debian 11 Bullseye or 64-bit RasPiOS IF Bullseye-based.
 # INSTRUCTIONS: https://github.com/iiab/iiab/tree/master/roles/pbx#readme
 # If using PBX intensively, investigate nginx_high_php_limits further above.
 pbx_install: False
 pbx_enabled: False
-pbx_use_apache: True    # 2021-08-17: Set either to 'False' if nec -- please
+pbx_use_apache: False   # 2023-04-03: Set to 'True' if nec -- please also
 pbx_use_nginx: True     # read github.com/iiab/iiab/issues/2914 & #2916, THX!
+# 2023-04-03: For EXPERIMENTAL testing on Raspberry Pi... (#3489, PR #3523)
+asterisk_rpi_patch: True
 asterisk_chan_dongle: False

vars/local_vars_unittest.yml

@@ -104,7 +104,7 @@ wan_netmask:       # wan_netmask: 255.255.255.0
 wan_gateway:       # wan_gateway: 192.168.1.254
 # If nec wan_nameserver can override ISP-provided DNS servers via dnsmasq:
 # /etc/resolv.conf dictates which backend is used for the machine itself, so
-# 127.0.0.1 means you get dnsmasq (so it works right away on RaspiOS) while
+# 127.0.0.1 means you get dnsmasq (so it works right away on RasPiOS) while
 # 127.0.0.53 gives you systemd-networkd (so Ubuntu itself does NOT use this
 # dnsmasq-specified upstream DNS [e.g. wan_nameserver] but its LAN clients do!)
 wan_nameserver:    # wan_nameserver: 192.168.1.254 or 8.8.8.8 or 1.1.1.1
@@ -415,11 +415,13 @@ calibre_web_path: calibre  #NEEDS WORK: https://github.com/iiab/iiab/issues/529
 # Avoid URL collisions w/ calibreweb_url1, calibreweb_url2, calibreweb_url3 below!
 
 # A full-featured PBX (for rural telephony, etc) based on Asterisk and FreePBX.
-# REQUIRES PHP 7.4 e.g. Debian 11 Bullseye.  64-bit RaspiOS MIGHT work: #3489
+# REQUIRES PHP 7.4 e.g. Debian 11 Bullseye or 64-bit RasPiOS IF Bullseye-based.
 # INSTRUCTIONS: https://github.com/iiab/iiab/tree/master/roles/pbx#readme
 # If using PBX intensively, investigate nginx_high_php_limits further above.
 pbx_install: False
 pbx_enabled: False
-pbx_use_apache: True    # 2021-08-17: Set either to 'False' if nec -- please
+pbx_use_apache: False   # 2023-04-03: Set to 'True' if nec -- please also
 pbx_use_nginx: True     # read github.com/iiab/iiab/issues/2914 & #2916, THX!
+# 2023-04-03: For EXPERIMENTAL testing on Raspberry Pi... (#3489, PR #3523)
+asterisk_rpi_patch: True
 asterisk_chan_dongle: False