diff --git a/dict.txt b/dict.txt index 277a580..23ecb8b 100644 --- a/dict.txt +++ b/dict.txt @@ -277,6 +277,7 @@ smgmt spgw spgwc splitter +srsRAN starbucks stateful subcomponent diff --git a/onramp/gnb.rst b/onramp/gnb.rst index 2c4096c..9ee05c7 100644 --- a/onramp/gnb.rst +++ b/onramp/gnb.rst @@ -14,11 +14,13 @@ RAN requires the following hardware: * A SIM reader/writer and associated software (e.g., OYEITIMES MCR3516). * A set of programmable SIM cards (blank cards likely included with reader/writer). -There are multiple options for each component, but finding a -combination that works together can be challenging. This section makes -several recommendations based on working end-to-end systems. For -simplicity, we pared the above list back to a single example for each -item, but these should not be interpreted as the only possibility. +There are multiple options for each component, including both +proprietary small cells (such as the MOSO CANOPY) and open source +radios (such as OAI and srsRAN). This section works through the +details of a specific end-to-end solution, where for simplicity, we +pare the above list back to a single example for each item. These +should not be interpreted as the only possibility, where :doc:`Other +Blueprints ` documents other options. Note also that our example relies on the availability of spectrum in the CBRS band, which is available in the United States. Spectrum @@ -26,11 +28,12 @@ options are likely to be different in other countries. .. admonition:: Troubleshooting Hint - We are tracking community experience with different hardware in the + In addition to :doc:`Other Blueprints `, we are + tracking community experience with different hardware in the ``#aether-onramp`` channel of the `ONF Workspace `__, with summaries of different - combinations people have tried reported in the OnRamp - `Troubleshooting Wiki Page + combinations people have tried reported in the OnRamp `Troubleshooting + Wiki Page `__. This blueprint assumes you start with a variant of ``vars/main.yml`` @@ -69,7 +72,7 @@ using. .. code-block:: core: - standalone: "true" + standalone: true data_iface: ens18 values_file: "deps/5gc/roles/core/templates/radio-5g-values.yaml" ran_subnet: "" @@ -220,9 +223,9 @@ Once the SD-Core is up and running, we are ready to bring up the physical gNB. The details of how to do this depend on the specific device you are using, but we identify the main issues you need to address using SERCOMM's 5G femto cell (as distributed by MosoLabs) as -an example. That particular device uses either the n48 or n78 band and -is on the ONF MarketPlace, where you can also find a User's Guide that -gives detailed instructions about configuring the gNB. +an example. That particular device uses either the n48 or n78 band, +where a User's Guide gives detailed instructions about configuring the +gNB. .. _reading_sercomm: .. admonition:: Further Reading diff --git a/onramp/inspect.rst b/onramp/inspect.rst index 24a720c..161a532 100644 --- a/onramp/inspect.rst +++ b/onramp/inspect.rst @@ -44,7 +44,16 @@ The programmatic API underlying the Control Dashboard, which was introduced in `Section 6.4 `__, can be accessed at ``http://10.76.28.113:31194/aether-roc-api/`` in our -example deployment (where Aether runs on host ``10.76.28.113``). +example deployment (where Aether runs on host ``10.76.28.113``). Note +that if you visit that URL from a browser, OpenAPI will show you +example GET, DELETE, and POST requests. Those examples assume the +prefix ``http://10.76.28.113:31194/aether-roc-api/`` (not just +``http://10.76.28.113:31194``), so for example, to GET the resource +corresponding to ``site-1``, you would need to use the following URL: + +.. code-block:: + + http://10.76.28.113:31194/aether-roc-api/aether/v2.1.x/the-enterprise/site/site-1 There is much more to say about the ROC and the Aether API, which we return to in the :doc:`Runtime Control ` section. For diff --git a/onramp/network.rst b/onramp/network.rst index 4ae44ad..0c1c843 100644 --- a/onramp/network.rst +++ b/onramp/network.rst @@ -216,7 +216,7 @@ physical gNBs. .. code-block:: core: - standalone: "true" + standalone: true data_iface: ens18 values_file: "config/sdcore-5g-values.yaml" ran_subnet: "172.20.0.0/16"