ran_subnet note

Signed-off-by: Larry Peterson <[email protected]>

Author: llpeterson

onramp/blueprints.rst

@@ -34,11 +34,12 @@ Ansible components:
   pipelines are defined by Groovy scripts, and can be found in the
   ``aether-jenkins`` repo.
 
-The goal of establishing a well-defined procedure for adding new
-blueprints to OnRamp is to encourage the community to contribute (and
+The above list also establishes the requirements for adding new
+blueprints to OnRamp. The community is to encourage to contribute (and
 maintain) new Aether configurations and deployment scenarios.\ [#]_
 The rest of this section documents community-contributed blueprints
-to-date.
+to-date; the concluding subsection gives a set of guidelines for
+creating new blueprints.
 
 .. [#] Not all possible configurations of Aether require a
        blueprint. There are other ways to add variability, for
@@ -72,7 +73,7 @@ The Multi-UPF blueprint includes the following:
   :doc:`Emulated RAN </onramp/gnbsim>` section.  Minimally,
   SD-Core runs on one server and gNBsim runs on a second server.
   (The Quick Start deployment, with both SD-Core and gNBsim running
-  in the same server, also works.)
+  in the same server, may also work, but is not actively maintained.)
 
 * New make targets, ``5gc-upf-install`` and ``5gc-upf-uninstall``, to
   be executed after the standard SD-Core installation. The blueprint
@@ -186,7 +187,7 @@ the emulation, type:
 
 .. code-block::
 
-   $ make gnbsim-simulator-run
+   $ make gnbsim-run
 
 To verify that both UPFs were functional, you will need to look at the
 ``summary.log`` file from both instances of gNBsim:

onramp/ref.rst

@@ -91,7 +91,7 @@ the list is not comprehensive.
      - Description
    * - `core.ran_subnet`
      - `172.20.0.0/16`
-     - Subnet connecting Core to RAN when gNBs run in a container; set to empty string ("") when gNBs are directly connected via `core.data_iface`.
+     - Overlay subnet connecting Core to RAN when gNBs run in a container; set to empty string ("") when gNBs are directly connected via `core.data_iface`.
    * - `core.standalone`
      - `true`
      - Core to run standalone, initialized from values file; set to `false` when Core is to be initialized by ROC.
@@ -305,10 +305,10 @@ do not need to be modified for an initial deployment of a blueprint.
      - Description
    * - `172.20.0.0/16`
      - ``aether.ran_subnet``
-     - Assigned to container-based gNBs connecting to the Core. Other
-       gNB implementations connect to the Core over the subnet
-       assigned to the server's physical interface (as defined by
-       ``core.data_iface``).
+     - Assigned to container-based gNBs connecting to the Core via an
+       overlay subnet. Other gNB implementations connect to the Core
+       over the subnet assigned to the server's physical interface (as
+       defined by ``core.data_iface``).
    * - `192.168.250.0/24`
      - ``core.upf.core_subnet``
      - Assigned to `core` bridge that connects UPF(s) to the Internet.