From bf2ad15fe0a311685204d1923520178a3b999102 Mon Sep 17 00:00:00 2001 From: A Holt Date: Wed, 16 Sep 2020 09:44:07 -0400 Subject: [PATCH] Refine roles/network/README.rst --- roles/network/README.rst | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/roles/network/README.rst b/roles/network/README.rst index 38d259d71..d47a03822 100644 --- a/roles/network/README.rst +++ b/roles/network/README.rst @@ -2,19 +2,20 @@ Network README ============== -This is run by Ansible after it has installed the core (`Stages 0-to-9 `_) of Internet-in-a-Box (IIAB) and its apps/services. +This is run by `Ansible `_ after it has installed the core (`Stages 0-to-9 `_) of `Internet-in-a-Box (IIAB) `_ and its apps/services. -Specifically, this 'network' role is run: +Specifically, this 'network' role 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' role/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``) +- ...automatically during IIAB installation, after `/opt/iiab/iiab/iiab-install <../../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' role/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``) Many IIAB networking questions can be answered in these 2 documents: - `IIAB Networking `_ is a high-level summary, that reviews IIAB's 3 modes of operation distinguishing WAN from LAN, `common ports `_, DNS name resolution and some common customizations. - http://FAQ.IIAB.IO includes answers to common questions like: + - What is local_vars.yml and how do I customize it? - 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?