Merge pull request #42 from sureshmarikkannu/multihop

Add documentation for Multihop GNB's deployment

Author: llpeterson

dict.txt

@@ -47,6 +47,7 @@ Mbps
 Microservices
 Mininet
 Moto
+Multihop
 Multipass
 NAV
 Netbox
@@ -322,6 +323,7 @@ upf
 uplink
 uptime
 url
+usecase
 vfio
 virtualenv
 vpn

onramp/blueprints.rst

@@ -849,6 +849,49 @@ To deploy the srsRAN blueprint in simulation mode, run the following:
    $ make srsran-gnb-install
    $ make srsran-uesim-start
 
+Multihop gNBs
+~~~~~~~~~~~~~~~~~~~~~~
+
+By default OnRamp uses isolated networks for the N3(i.e., 192.168.252.x) and
+N6(i.e., 192.168.250.x) interfaces. This prevents gNB, which is on different
+subnet and located multiple hops away, connecting to the UPF on N3 interface.
+
+In order to support such deployment OnRamp provides an option to configure
+N3 IP from the same subnet as DATA_IFACE. It can be enabled by setting
+``core.upf.multihop_gnb: true``
+
+For example, let's say the DATA_IFACE subnet is 10.21.61.0/24 and gNB subnet
+is 10.202.1.0/24. Configure the parameters as follows,
+
+.. code-block::
+
+   data_iface: ens18
+   ran_subnet: "10.202.1.0/24"
+   upf:
+      access_subnet: "10.21.61.1/24"	# access subnet & gateway
+      core_subnet: "192.168.250.1/24"	# core subnet & gateway
+      multihop_gnb: true
+      default_upf:
+        ip:
+          access: "10.21.61.12" # when multihop_gnb set to true, make sure to assign IP from same subnet of data_iface
+          core:   "192.168.250.3"
+        ue_ip_pool: "172.250.0.0/16"
+
+In case we need to connect multiple gNBs (gNB2 subnet: 10.203.1.0/24)
+from different subnet then add routes as follows
+in ``deps/5gc/roles/core/templates/sdcore-5g-values.yaml`` ``(if core.upf.mode: af_packet)``, or
+in ``deps/5gc/roles/core/templates/sdcore-5g-sriov-values.yaml`` ``(if core.upf.mode: dpdk)``:
+
+.. code-block::
+
+   config:
+     upf:
+       routes:
+         - to: {{ ansible_default_ipv4.address }}
+           via: 169.254.1.1
+         - to: 10.203.1.0/24
+           via: 10.203.1.1
+
 Guidelines for Blueprints
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~