From ed76faec77d81cd1b0a01a1924802126d850df5b Mon Sep 17 00:00:00 2001 From: A Holt Date: Fri, 8 Feb 2019 08:59:12 -0500 Subject: [PATCH] Create README.rst --- roles/network/README.rst | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 roles/network/README.rst diff --git a/roles/network/README.rst b/roles/network/README.rst new file mode 100644 index 000000000..e1969f4f8 --- /dev/null +++ b/roles/network/README.rst @@ -0,0 +1,23 @@ +============== +Network README +============== + +This is run by Ansible after it has installed the core of Internet-in-a-Box (IIAB) and its apps/services. + +Specifically, this 'network' stage is run: + +- automatically during IIAB installation, after /opt/iiab/iiab/iiab-install has run `Stages 0-to-9 <.>`_ (thanks to `iiab-stages.yml <../iiab-stages.yml>`_) +- automatically by IIAB's Admin Console (http://box/admin) if you click ``Configure`` menu -> ``Install Configured Options`` — this is similar to the above, but only runs Stage 0, then Stage 4-to-9, and then finally this 'network' stage (thanks to `iiab-from-console.yml <../iiab-from-console.yml>`_) +- or manually, if you run ``cd /opt/iiab/iiab`` then `./iiab-network <../iiab-network>`_ (which is much the same as running ``./runrole network``) + +For more info, please see: + +- https://github.com/iiab/iiab/wiki/IIAB-Networking +- http://FAQ.IIAB.IO including answers to common questions like: + + - How do I provide Wi-Fi (wireless) to all my kids? + - Can I create a Wi-Fi hotspot using an old laptop? + - How do I change the wireless network name? + - Can I name my server something other than http://BOX.LAN ? + - How do I set a static IP Address? + - Any other networking tips?