From dc98b73c512cb23b8bc485f27f119e46b3aa23eb Mon Sep 17 00:00:00 2001 From: Aidan Fitzgerald Date: Mon, 8 Jul 2019 20:33:12 -0700 Subject: [PATCH 1/4] Add OPWEN_SIM_TYPE env variable Signed-off-by: Aidan Fitzgerald --- roles/lokole/templates/webapp_secrets.sh.j2 | 1 + 1 file changed, 1 insertion(+) diff --git a/roles/lokole/templates/webapp_secrets.sh.j2 b/roles/lokole/templates/webapp_secrets.sh.j2 index 5bab658f5..1f3c38566 100644 --- a/roles/lokole/templates/webapp_secrets.sh.j2 +++ b/roles/lokole/templates/webapp_secrets.sh.j2 @@ -1,3 +1,4 @@ +export OPWEN_SIM_TYPE='LocalOnly' export OPWEN_STATE_DIRECTORY='{{lokole_run_directory}}' export OPWEN_SESSION_KEY='{{ lookup('password', '/dev/null chars=ascii_letters,digits,_ length=32') }}' export OPWEN_PASSWORD_SALT='{{ lookup('password', '/dev/null chars=ascii_letters,digits,_ length=16') }}' From 36fab29f280e30eb63b2857046cd3b389d5f8bdc Mon Sep 17 00:00:00 2001 From: Aidan Fitzgerald Date: Sun, 14 Jul 2019 21:20:01 -0700 Subject: [PATCH 2/4] Add section on connecting Lokole to the Internet Signed-off-by: Aidan Fitzgerald --- roles/lokole/README.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/roles/lokole/README.rst b/roles/lokole/README.rst index bbea859f9..1fa1a8056 100644 --- a/roles/lokole/README.rst +++ b/roles/lokole/README.rst @@ -68,6 +68,15 @@ To reset the database, run the following command:: This command will remove all users and all emails from the system. +Connecting to the Internet +-------------------------- + +The Lokole software can be configured to access the Internet via USB modem, SIM card, or Ethernet, by setting the environment variable ``OPWEN_SIM_TYPE`` in the configuration file ``/etc/apache2/sites-enabled/lokole.conf``. By default, this installation of Lokole is set to local-only (offline) mode, in which users can only send emails to other users on the same installation and cannot send emails over the Internet. This has been done by setting ``OPWEN_SIM_TYPE`` to ``LocalOnly``. + +If configured to work with a USB modem or other Internet connection, Lokole will sync with the cloud server (operated by Ascoderu) on a nightly basis to deliver and receive emails globally. However, arranging this is extremely complicated. You would need a compatible form of connection and an Internet expert familiar with modem protocols, MX records, etc. Ask that person to read the `Lokole software README `_ in its entirety, to help you understand whether this is realistic for your organization. + +Lokole and Internet-in-a-Box would welcome a business plan (whether volunteer-based, grant-based or for-profit) from someone willing to operationalize this — making it relatively hassle-free for schools, clinics, libraries and orphanages around the world — that generally do not have access to technical experts. Please `contact us `_ if you have the capacity to help make such a social enterprise happen. + Troubleshooting --------------- From c9260c3d6b36ca8762ccb792a180031ffde72678 Mon Sep 17 00:00:00 2001 From: Aidan Fitzgerald Date: Sun, 14 Jul 2019 21:23:17 -0700 Subject: [PATCH 3/4] +"form of" Signed-off-by: Aidan Fitzgerald --- roles/lokole/README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/roles/lokole/README.rst b/roles/lokole/README.rst index 1fa1a8056..74f3f4f77 100644 --- a/roles/lokole/README.rst +++ b/roles/lokole/README.rst @@ -73,7 +73,7 @@ Connecting to the Internet The Lokole software can be configured to access the Internet via USB modem, SIM card, or Ethernet, by setting the environment variable ``OPWEN_SIM_TYPE`` in the configuration file ``/etc/apache2/sites-enabled/lokole.conf``. By default, this installation of Lokole is set to local-only (offline) mode, in which users can only send emails to other users on the same installation and cannot send emails over the Internet. This has been done by setting ``OPWEN_SIM_TYPE`` to ``LocalOnly``. -If configured to work with a USB modem or other Internet connection, Lokole will sync with the cloud server (operated by Ascoderu) on a nightly basis to deliver and receive emails globally. However, arranging this is extremely complicated. You would need a compatible form of connection and an Internet expert familiar with modem protocols, MX records, etc. Ask that person to read the `Lokole software README `_ in its entirety, to help you understand whether this is realistic for your organization. +If configured to work with a USB modem or other form of Internet connection, Lokole will sync with the cloud server (operated by Ascoderu) on a nightly basis to deliver and receive emails globally. However, arranging this is extremely complicated. You would need a compatible form of connection and an Internet expert familiar with modem protocols, MX records, etc. Ask that person to read the `Lokole software README `_ in its entirety, to help you understand whether this is realistic for your organization. Lokole and Internet-in-a-Box would welcome a business plan (whether volunteer-based, grant-based or for-profit) from someone willing to operationalize this — making it relatively hassle-free for schools, clinics, libraries and orphanages around the world — that generally do not have access to technical experts. Please `contact us `_ if you have the capacity to help make such a social enterprise happen. From cf83b5306628dd45b170f71e3da4894f07879483 Mon Sep 17 00:00:00 2001 From: A Holt Date: Mon, 15 Jul 2019 07:30:07 -0400 Subject: [PATCH 4/4] Nightly Internet Email Sync (Not Easy!) --- roles/lokole/README.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/roles/lokole/README.rst b/roles/lokole/README.rst index 74f3f4f77..f1f0d2779 100644 --- a/roles/lokole/README.rst +++ b/roles/lokole/README.rst @@ -68,8 +68,8 @@ To reset the database, run the following command:: This command will remove all users and all emails from the system. -Connecting to the Internet --------------------------- +Nightly Internet Email Sync (Not Easy!) +--------------------------------------- The Lokole software can be configured to access the Internet via USB modem, SIM card, or Ethernet, by setting the environment variable ``OPWEN_SIM_TYPE`` in the configuration file ``/etc/apache2/sites-enabled/lokole.conf``. By default, this installation of Lokole is set to local-only (offline) mode, in which users can only send emails to other users on the same installation and cannot send emails over the Internet. This has been done by setting ``OPWEN_SIM_TYPE`` to ``LocalOnly``.