more expected output
Change-Id: I9d49df59b75f1c8802df705336d654a15d001ed3
diff --git a/index.rst b/index.rst
index 1fcd19a..cef3124 100644
--- a/index.rst
+++ b/index.rst
@@ -51,7 +51,7 @@
.. toctree::
:maxdepth: 3
- :caption: Aether Test Automation
+ :caption: Test Automation
:hidden:
:glob:
diff --git a/intro.rst b/intro.rst
index d26bfcf..4c2cd06 100644
--- a/intro.rst
+++ b/intro.rst
@@ -1,10 +1,10 @@
Introduction
==============
-Aether is an open source 5G edge cloud connectivity service that
-supports enterprise deployments of Private 5G. Information about the
-Aether project can be found on the ONF website, and an introduction to
-the Aether architecture can be found in a companion book:
+Aether is an open source 5G edge cloud platform that supports
+enterprise deployments of Private 5G. Information about the Aether
+project can be found on the ONF website, and an introduction to the
+Aether architecture can be found in a companion book:
.. _reading_private5g:
.. admonition:: Further Reading
@@ -26,26 +26,25 @@
Other Aether guides included on this site include:
-* Learn how to :doc:`operate Aether using the ROC </operations/gui>`.
+* :doc:`Runtime Operations </operations/gui>`: Learn how
+ to operate Aether's 5G connectivity service.
-* Learn how Aether is :doc:`tested </testing/about_system_tests>`.
-
-* Read the most recent :doc:`Release Notes </release/2.1>`.
+* :doc:`tested </testing/about_system_tests>`: Learn how Aether
+ components are tested.
Note that Aether was originally deployed as a centrally-manged,
ONF-operated cloud service, with the expectation that organizations
would participate in Aether by connecting their site to this
-operational deployment of Aether.\ [#]_ That deployment is now being
-deprecated in favor of users bringing up their own Aether sites using
-:doc:`OnRamp </onramp/overview>`, but the guide describing how to
-connect an edge site to Aether (still available in `Version 2.1 of the
-Aether Docs
+operational deployment.\ [#]_ That service is now being deprecated in
+favor of users bringing up their own Aether sites using :doc:`OnRamp
+</onramp/overview>`, but the guide describing how to connect an edge
+site to Aether (still available in `Version 2.1 of the Aether Docs
<https://docs.aetherproject.org/aether-2.1/edge_deployment/overview.html>`__)
is useful because it highlights many of the operational challenges
facing a production deployment of Aether as a managed cloud service.
-Those challenges motivate many of the operational mechanisms still
-available in Aether, but now packaged for others to apply to their
-deployments.
+Those challenges motivate many of the operational mechanisms available
+in the Aether platform today, but now packaged for others to apply to
+their deployments.
.. [#] The original Aether service supported the Pronto research
project, with edge clusters built on top of an SDN-controlled
diff --git a/onramp/start.rst b/onramp/start.rst
index 79ee44e..2e7ce69 100644
--- a/onramp/start.rst
+++ b/onramp/start.rst
@@ -52,6 +52,25 @@
$ pipx ensurepath
$ sudo apt-get install sshpass
+Once installed, displaying the Ansible version number should result in
+output similar to the following:
+
+.. code-block::
+
+ $ ansible --version
+ ansible [core 2.11.12]
+ config file = None
+ configured module search path = ['/home/foo/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
+ ansible python module location = /home/foo/.local/lib/python3.6/site-packages/ansible
+ ansible collection location = /home/foo/.ansible/collections:/usr/share/ansible/collections
+ executable location = /home/foo/.local/bin/ansible
+ python version = 3.6.9 (default, Mar 10 2023, 16:46:00) [GCC 8.4.0]
+ jinja version = 3.0.3
+ libyaml = True
+
+Note that your fresh install of Ubuntu may be missing other packages
+(e.g., ``git``, ``curl``, ``make``), but you will be prompted to
+install them as step through the Quick Start sequence.
Download Aether OnRamp
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -97,7 +116,7 @@
4. File ``hosts.ini`` (host inventory) is Ansible's way of specifying
the set of servers (physical or virtual) that Ansible targets with
- various installation playbooks. The default version of ``host.ini``
+ various installation playbooks. The default version of ``hosts.ini``
included with OnRamp is simplified to run everything on a single
server (the one you've cloned the repo onto), with additional lines
you may eventually need for a multi-node cluster commented out.
@@ -109,7 +128,7 @@
modify two sets of parameters to reflect the specifics of your target
deployment.
-The first set is in file ``host.ini``, where you will need to give the IP
+The first set is in file ``hosts.ini``, where you will need to give the IP
address and login credentials for the server you are working on. At
this stage, we assume the server you downloaded OnRamp onto is the
same server you will be installing Aether on.
@@ -218,6 +237,11 @@
$ make aether-k8s-install
+Note that the Ansible playbooks triggered by this (and other) make
+targets will output red results from time-to-time (indicating an
+exception or failure), but as long as Ansible keeps progressing
+through the playbook, such output can be safely ignored.
+
Once the playbook completes, executing ``kubectl`` will show the
``kube-system`` namespace running, with output looking something like
the following:
@@ -286,7 +310,14 @@
upf-0 5/5 Running 0 6m13s
webui-5894ffd49d-gg2jh 1/1 Running 0 6m13s
-You will recognize Kubernetes pods that correspond to many of the
+If you see problematic pods that are not getting into the ``Running``
+state, a re-install usually corrects the problem. Type:
+
+.. code-block::
+
+ make aether-resetcore
+
+Once running, you will recognize pods that correspond to many of the
microservices discussed is `Chapter 5
<https://5g.systemsapproach.org/core.html>`__. For example,
``amf-5887bbf6c5-pc9g2`` implements the AMF. Note that for historical