external/iiab
1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-03-09 15:40:17 +00:00
Code Issues Releases Wiki Activity

New default 'asterisk_rpi_patch: True' + documentation

Browse source
This commit is contained in:
root 2023-04-03 10:34:46 -04:00
parent 3636d67a2c
commit 177cf0a5af
8 changed files with 37 additions and 29 deletions
Download patch file Download diff file Expand all files Collapse all files

16
roles/pbx/README.adoc
View file

@ -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:
+
----

8
roles/pbx/defaults/main.yml
View file

@ -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
@ -22,9 +25,6 @@
# If nec, change them by editing /etc/iiab/local_vars.yml prior to installing!
# 2023-04-02: If you want to try EXPERIMENTAL testing on Raspberry Pi:
# asterisk_patch: True
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

4
roles/pbx/tasks/asterisk.yml
View file

@ -54,11 +54,11 @@
# 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_patch: True'"
- 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_patch is defined and asterisk_patch
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

6
vars/default_vars.yml
View file

@ -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

8
vars/local_vars_large.yml
View file

@ -415,13 +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-02: If you want to try EXPERIMENTAL testing on Raspberry Pi:
# asterisk_patch: True
# 2023-04-03: For EXPERIMENTAL testing on Raspberry Pi... (#3489, PR #3523)
asterisk_rpi_patch: True
asterisk_chan_dongle: False

8
vars/local_vars_medium.yml
View file

@ -415,13 +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-02: If you want to try EXPERIMENTAL testing on Raspberry Pi:
# asterisk_patch: True
# 2023-04-03: For EXPERIMENTAL testing on Raspberry Pi... (#3489, PR #3523)
asterisk_rpi_patch: True
asterisk_chan_dongle: False

8
vars/local_vars_small.yml
View file

@ -415,13 +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-02: If you want to try EXPERIMENTAL testing on Raspberry Pi:
# asterisk_patch: True
# 2023-04-03: For EXPERIMENTAL testing on Raspberry Pi... (#3489, PR #3523)
asterisk_rpi_patch: True
asterisk_chan_dongle: False

8
vars/local_vars_unittest.yml
View file

@ -415,13 +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-02: If you want to try EXPERIMENTAL testing on Raspberry Pi:
# asterisk_patch: True
# 2023-04-03: For EXPERIMENTAL testing on Raspberry Pi... (#3489, PR #3523)
asterisk_rpi_patch: True
asterisk_chan_dongle: False