From 066114f1e6030c3575f5b3b24eae07df0f477c0c Mon Sep 17 00:00:00 2001 From: Anish Mangal Date: Mon, 11 Feb 2019 20:50:08 +0530 Subject: [PATCH 1/9] Update README.rst --- roles/pbx/README.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/roles/pbx/README.rst b/roles/pbx/README.rst index b9c7ff800..d3cc023c4 100644 --- a/roles/pbx/README.rst +++ b/roles/pbx/README.rst @@ -25,7 +25,9 @@ Optionally, you may want to enable `chan_dongle Date: Mon, 11 Feb 2019 13:55:37 -0500 Subject: [PATCH 2/9] Update README.rst --- roles/pbx/README.rst | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/roles/pbx/README.rst b/roles/pbx/README.rst index d3cc023c4..2a568154d 100644 --- a/roles/pbx/README.rst +++ b/roles/pbx/README.rst @@ -25,9 +25,7 @@ Optionally, you may want to enable `chan_dongle `_ of your IIAB server). You can monitor the PBX service with command:: From 828a2b46cf914899d7eb21f98aeb956172f35f38 Mon Sep 17 00:00:00 2001 From: A Holt Date: Mon, 11 Feb 2019 13:57:38 -0500 Subject: [PATCH 3/9] Update README.rst --- roles/pbx/README.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/roles/pbx/README.rst b/roles/pbx/README.rst index 2a568154d..09cebeb10 100644 --- a/roles/pbx/README.rst +++ b/roles/pbx/README.rst @@ -25,7 +25,9 @@ Optionally, you may want to enable `chan_dongle `_ of your IIAB server). +After installing PBX as part of IIAB, please visit http://pbx.lan/freepbx and proceed with initial configuration (no login/password is required initially — you will be asked to set this up). + +**CAUTION: it is sometimes necessary to put "[ACTUAL IP ADDRESS] pbx.lan" into the 'hosts' file on the client machine (where the browser is being used) to get http://pbx.lan/freepbx to work.** Typically this is ``/etc/hosts`` or ``c:\Windows\System32\Drivers\etc\hosts`` (conversely, customizing the hosts file is *not* necessary if your browser is accessing the `'LAN' side `_ of your IIAB server). You can monitor the PBX service with command:: From ca6614c6b05f58df0c045c52c592e08f8632a733 Mon Sep 17 00:00:00 2001 From: A Holt Date: Mon, 11 Feb 2019 14:13:10 -0500 Subject: [PATCH 4/9] Update README.rst --- roles/pbx/README.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/roles/pbx/README.rst b/roles/pbx/README.rst index 09cebeb10..d74834b93 100644 --- a/roles/pbx/README.rst +++ b/roles/pbx/README.rst @@ -4,7 +4,7 @@ PBX README This 'pbx' playbook adds `Asterisk `_ and `FreePBX `_ to Internet-in-a-Box (IIAB) for VoIP and SIP functionality e.g. for rural telephony. -This initial release (for IIAB 6.7 in February 2019) supports Ubuntu 18.04 and Debian 9 "Stretch" — in future Raspberry Pi (Raspbian) might also be possible! (`#1467 `_) +This initial release (for IIAB 6.7 in February 2019) supports Ubuntu 18.04, Debian 9 "Stretch" — and experimentally supports for Raspberry Pi: `#1467 `_ Explanation ----------- @@ -27,7 +27,7 @@ Optionally, you may want to enable `chan_dongle `_ of your IIAB server). +**CAUTION: it is sometimes necessary to put "[ACTUAL IP ADDRESS] pbx.lan" into the 'hosts' file on the client machine (where the browser is being used) to get http://pbx.lan/freepbx to work.** This file is ``/etc/hosts`` on Linux and macOS, or ``c:\Windows\System32\Drivers\etc\hosts`` on most Windows machines (conversely, customizing the hosts file is *not* necessary if your browser is able to access the `'LAN' side `_ of your IIAB server). You can monitor the PBX service with command:: From 7e791544d7eb7d5ffa125973fa6bcadddc9b4f1c Mon Sep 17 00:00:00 2001 From: A Holt Date: Mon, 11 Feb 2019 14:13:36 -0500 Subject: [PATCH 5/9] Update README.rst --- roles/pbx/README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/pbx/README.rst b/roles/pbx/README.rst index d74834b93..7154ec1c4 100644 --- a/roles/pbx/README.rst +++ b/roles/pbx/README.rst @@ -4,7 +4,7 @@ PBX README This 'pbx' playbook adds `Asterisk `_ and `FreePBX `_ to Internet-in-a-Box (IIAB) for VoIP and SIP functionality e.g. for rural telephony. -This initial release (for IIAB 6.7 in February 2019) supports Ubuntu 18.04, Debian 9 "Stretch" — and experimentally supports for Raspberry Pi: `#1467 `_ +This initial release (for IIAB 6.7 in February 2019) supports Ubuntu 18.04, Debian 9 "Stretch" — and experimentally supports Raspberry Pi: `#1467 `_ Explanation ----------- From 8fe1cf1b93d0aec8975d2faa35aa187ab5e37977 Mon Sep 17 00:00:00 2001 From: A Holt Date: Mon, 11 Feb 2019 14:14:21 -0500 Subject: [PATCH 6/9] Update README.rst --- roles/pbx/README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/pbx/README.rst b/roles/pbx/README.rst index 7154ec1c4..239e147b0 100644 --- a/roles/pbx/README.rst +++ b/roles/pbx/README.rst @@ -29,7 +29,7 @@ After installing PBX as part of IIAB, please visit http://pbx.lan/freepbx and pr **CAUTION: it is sometimes necessary to put "[ACTUAL IP ADDRESS] pbx.lan" into the 'hosts' file on the client machine (where the browser is being used) to get http://pbx.lan/freepbx to work.** This file is ``/etc/hosts`` on Linux and macOS, or ``c:\Windows\System32\Drivers\etc\hosts`` on most Windows machines (conversely, customizing the hosts file is *not* necessary if your browser is able to access the `'LAN' side `_ of your IIAB server). -You can monitor the PBX service with command:: +You can monitor the FreePBX service with command:: systemctl status freepbx From ad010132537a0482a10ac5f2b1c3e441ae72e249 Mon Sep 17 00:00:00 2001 From: A Holt Date: Mon, 11 Feb 2019 14:30:22 -0500 Subject: [PATCH 7/9] Update README.rst --- roles/minetest/README.rst | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/roles/minetest/README.rst b/roles/minetest/README.rst index 584c4e542..7a8761eff 100644 --- a/roles/minetest/README.rst +++ b/roles/minetest/README.rst @@ -14,7 +14,7 @@ Connecting to the Server To connect to the server, you will also need to download Minetest client software for each of your client devices, e.g. from: https://www.minetest.net/downloads/ -The port is nominally the standard 30000. This can be changed in `/etc/iiab/local_vars.yml `_ using variable: ``minetest_port`` +The port is nominally the standard 30000. If necessary, change the ``minetest_port`` as explained below. The admin user is the usual: ``Admin`` @@ -23,6 +23,8 @@ No password is required. Configurable Parameters ----------------------- +If changes are necessary, please edit `/etc/iiab/local_vars.yml `_ (adding any variables that you need) prior to installation if possible: + - ``minetest_install:`` set Minetest up to install; default is False - ``minetest_enabled:`` set Minetest up to be enabled; default is False - ``minetest_port:`` port on which client should connect; default is 30000 @@ -31,6 +33,10 @@ Configurable Parameters - ``minetest_default_game:`` only carbone-ng and minetest are supported; default is `carbone-ng `_ - ``minetest_flat_world:`` use a flat mapgen engine to lower computation on client; default is False +After installation, you can monitor the 'minetest-server' service with command:: + + systemctl minetest-server freepbx + File Locations -------------- @@ -46,12 +52,14 @@ File Locations on Raspberry Pi File Locations on Other Platforms --------------------------------- + - The server binary is ``/usr/lib/minetest/minetestserver`` - The working directory is ``/usr/share/games/minetest`` - mods are in ``/usr/share/games/minetest/games//mods`` To Do ----- + - Add more mods — currently only the default mods are there in carbone-ng - Add more games - Minetest client software for Windows and Android, included onboard IIAB for offline communities (`#1465 `_) From 29cc465a3eab22a25f542720649266837aa01290 Mon Sep 17 00:00:00 2001 From: A Holt Date: Mon, 11 Feb 2019 14:46:08 -0500 Subject: [PATCH 8/9] display slow compile/install times for RPi --- roles/pbx/tasks/asterisk.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/roles/pbx/tasks/asterisk.yml b/roles/pbx/tasks/asterisk.yml index 20057ab0e..b5c13bc47 100644 --- a/roles/pbx/tasks/asterisk.yml +++ b/roles/pbx/tasks/asterisk.yml @@ -43,7 +43,7 @@ name: aptitude state: latest -- name: Asterisk - Ensure all dependencies are resolved - CAN TAKE 2 MIN OR LONGER! +- name: Asterisk - Ensure all dependencies are resolved - CAN TAKE 5 MIN OR LONGER! shell: export DEBIAN_FRONTEND=noninteractive && ./contrib/scripts/install_prereq install args: chdir: "{{ asterisk_src_dir }}" @@ -68,13 +68,13 @@ args: chdir: "{{ asterisk_src_dir }}" -- name: Asterisk - Run 'make' - CAN TAKE 10 MIN OR LONGER! +- name: Asterisk - Run 'make' - CAN TAKE 30 MIN OR LONGER! command: make args: chdir: "{{ asterisk_src_dir }}" creates: "defaults.h" -- name: Asterisk - Run 'make install' - CAN TAKE 3 MIN OR LONGER! +- name: Asterisk - Run 'make install' - CAN TAKE 2 MIN OR LONGER! command: make install args: chdir: "{{ asterisk_src_dir }}" From c679ae8287742c896ff69711a46d62840d11bf8e Mon Sep 17 00:00:00 2001 From: A Holt Date: Mon, 11 Feb 2019 14:46:56 -0500 Subject: [PATCH 9/9] display slow compile/install time for RPi --- roles/pbx/tasks/freepbx.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/pbx/tasks/freepbx.yml b/roles/pbx/tasks/freepbx.yml index 30f6aa745..ce900461c 100644 --- a/roles/pbx/tasks/freepbx.yml +++ b/roles/pbx/tasks/freepbx.yml @@ -91,7 +91,7 @@ group: asterisk recurse: yes -- name: FreePBX - Install (just run once) - CAN TAKE 2 MIN OR LONGER! +- name: FreePBX - Install (just run once) - CAN TAKE 12 MIN OR LONGER! command: "{{ item }}" args: chdir: "{{ freepbx_src_dir }}"