From 03436cd809ea8b4633d343ae0eafee4f3b4b5be3 Mon Sep 17 00:00:00 2001 From: "Marikkannu, Suresh" Date: Wed, 5 Mar 2025 06:43:44 -0800 Subject: [PATCH 1/5] Add documentation for Multihop GNB's deployment Signed-off-by: Marikkannu, Suresh --- dict.txt | 3 +++ index.rst | 1 + onramp/deployments.rst | 48 ++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 52 insertions(+) create mode 100644 onramp/deployments.rst diff --git a/dict.txt b/dict.txt index e2071ee..19f6fa3 100644 --- a/dict.txt +++ b/dict.txt @@ -25,6 +25,7 @@ GiB GigE GitOps Github +GNB Grafana Haswell IPMI @@ -47,6 +48,7 @@ Mbps Microservices Mininet Moto +Multihop Multipass NAV Netbox @@ -322,6 +324,7 @@ upf uplink uptime url +usecase vfio virtualenv vpn diff --git a/index.rst b/index.rst index e775fce..b1a40d2 100644 --- a/index.rst +++ b/index.rst @@ -24,6 +24,7 @@ onramp/roc onramp/devel onramp/blueprints + onramp/deployments .. toctree:: :maxdepth: 3 diff --git a/onramp/deployments.rst b/onramp/deployments.rst new file mode 100644 index 0000000..030d257 --- /dev/null +++ b/onramp/deployments.rst @@ -0,0 +1,48 @@ +Deployment usecase's +----------------------- + +This section documents various onramp deployment usecase's. + +Multihop GNB +~~~~~~~~~~~~~~~~~~~~~~ + +By default onramp uses isolated networks for the N3(ex: 192.168.252.x) and +N6(ex: 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 ex, lets 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 if we need to connect multiple GNB's (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)``: +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 + From 5b25658b5d5f7bf0d1f86035768e4f62d4cd9e0e Mon Sep 17 00:00:00 2001 From: "Marikkannu, Suresh" Date: Wed, 5 Mar 2025 21:37:34 -0800 Subject: [PATCH 2/5] Update Multihop GNB procedure under Other Blueprints section Signed-off-by: Marikkannu, Suresh --- index.rst | 1 - onramp/blueprints.rst | 43 +++++++++++++++++++++++++++++++++++++ onramp/deployments.rst | 48 ------------------------------------------ 3 files changed, 43 insertions(+), 49 deletions(-) delete mode 100644 onramp/deployments.rst diff --git a/index.rst b/index.rst index b1a40d2..e775fce 100644 --- a/index.rst +++ b/index.rst @@ -24,7 +24,6 @@ onramp/roc onramp/devel onramp/blueprints - onramp/deployments .. toctree:: :maxdepth: 3 diff --git a/onramp/blueprints.rst b/onramp/blueprints.rst index ccac4d6..a093792 100644 --- a/onramp/blueprints.rst +++ b/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 GNB +~~~~~~~~~~~~~~~~~~~~~~ + +By default onramp uses isolated networks for the N3(ex: 192.168.252.x) and +N6(ex: 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 ex, lets 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 if we need to connect multiple GNB's (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)``: +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 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/onramp/deployments.rst b/onramp/deployments.rst deleted file mode 100644 index 030d257..0000000 --- a/onramp/deployments.rst +++ /dev/null @@ -1,48 +0,0 @@ -Deployment usecase's ------------------------ - -This section documents various onramp deployment usecase's. - -Multihop GNB -~~~~~~~~~~~~~~~~~~~~~~ - -By default onramp uses isolated networks for the N3(ex: 192.168.252.x) and -N6(ex: 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 ex, lets 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 if we need to connect multiple GNB's (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)``: -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 - From 868db5a52ad7094475870f122d3c7637b7d9c878 Mon Sep 17 00:00:00 2001 From: "Marikkannu, Suresh" Date: Thu, 6 Mar 2025 08:29:25 -0800 Subject: [PATCH 3/5] Resolve sorting issue in dict.txt Signed-off-by: Marikkannu, Suresh --- dict.txt | 1 - onramp/blueprints.rst | 8 ++++---- 2 files changed, 4 insertions(+), 5 deletions(-) diff --git a/dict.txt b/dict.txt index 19f6fa3..f19a7d0 100644 --- a/dict.txt +++ b/dict.txt @@ -25,7 +25,6 @@ GiB GigE GitOps Github -GNB Grafana Haswell IPMI diff --git a/onramp/blueprints.rst b/onramp/blueprints.rst index a093792..997e90e 100644 --- a/onramp/blueprints.rst +++ b/onramp/blueprints.rst @@ -849,18 +849,18 @@ To deploy the srsRAN blueprint in simulation mode, run the following: $ make srsran-gnb-install $ make srsran-uesim-start -Multihop GNB +Multihop gNB's ~~~~~~~~~~~~~~~~~~~~~~ By default onramp uses isolated networks for the N3(ex: 192.168.252.x) and -N6(ex: 192.168.250.x) interfaces. This prevents GNB(which is on different +N6(ex: 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 ex, lets say the DATA_IFACE subnet is 10.21.61.0/24 and GNB subnet +For ex, lets 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:: @@ -877,7 +877,7 @@ is 10.202.1.0/24. Configure the parameters as follows, core: "192.168.250.3" ue_ip_pool: "172.250.0.0/16" -In case if we need to connect multiple GNB's (GNB2 subnet: 10.203.1.0/24) +In case if we need to connect multiple gNB's (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)``: in ``deps/5gc/roles/core/templates/sdcore-5g-sriov-values.yaml`` ``(if core.upf.mode: dpdk)``: From 95f9bf541cb52563dee86e298d2438040067e811 Mon Sep 17 00:00:00 2001 From: "Marikkannu, Suresh" Date: Thu, 6 Mar 2025 08:36:16 -0800 Subject: [PATCH 4/5] Fix OnRamp dict issue Signed-off-by: Marikkannu, Suresh --- onramp/blueprints.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/onramp/blueprints.rst b/onramp/blueprints.rst index 997e90e..89e9d00 100644 --- a/onramp/blueprints.rst +++ b/onramp/blueprints.rst @@ -852,11 +852,11 @@ To deploy the srsRAN blueprint in simulation mode, run the following: Multihop gNB's ~~~~~~~~~~~~~~~~~~~~~~ -By default onramp uses isolated networks for the N3(ex: 192.168.252.x) and +By default OnRamp uses isolated networks for the N3(ex: 192.168.252.x) and N6(ex: 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 +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`` From ec09b421acbdfee39e10cac4a4c06167135b8653 Mon Sep 17 00:00:00 2001 From: "Marikkannu, Suresh" Date: Thu, 6 Mar 2025 09:07:51 -0800 Subject: [PATCH 5/5] Addressed review comments Signed-off-by: Marikkannu, Suresh --- onramp/blueprints.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/onramp/blueprints.rst b/onramp/blueprints.rst index 89e9d00..a0ee074 100644 --- a/onramp/blueprints.rst +++ b/onramp/blueprints.rst @@ -849,18 +849,18 @@ To deploy the srsRAN blueprint in simulation mode, run the following: $ make srsran-gnb-install $ make srsran-uesim-start -Multihop gNB's +Multihop gNBs ~~~~~~~~~~~~~~~~~~~~~~ -By default OnRamp uses isolated networks for the N3(ex: 192.168.252.x) and -N6(ex: 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. +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 ex, lets say the DATA_IFACE subnet is 10.21.61.0/24 and gNB subnet +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:: @@ -877,9 +877,9 @@ is 10.202.1.0/24. Configure the parameters as follows, core: "192.168.250.3" ue_ip_pool: "172.250.0.0/16" -In case if we need to connect multiple gNB's (gNB2 subnet: 10.203.1.0/24) +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)``: +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::