From f5ef15eaddd1f9b6042b3d86621fa0f864274d76 Mon Sep 17 00:00:00 2001 From: Ashish Jain Date: Mon, 1 Jul 2024 08:26:31 +0530 Subject: [PATCH 1/6] Docs for O1-telnet in OAI --- .../docs/guides/user-guides/exercise-2-oai.md | 287 +++++++++++++++++- 1 file changed, 271 insertions(+), 16 deletions(-) diff --git a/content/en/docs/guides/user-guides/exercise-2-oai.md b/content/en/docs/guides/user-guides/exercise-2-oai.md index edb11cb5..1fcdf7b3 100644 --- a/content/en/docs/guides/user-guides/exercise-2-oai.md +++ b/content/en/docs/guides/user-guides/exercise-2-oai.md @@ -711,21 +711,102 @@ The output is similar to: 9496.571150 [GNB_APP] I [gNB 0] Received NGAP_REGISTER_GNB_CNF: associated AMF 1 ``` +### Check Stats via telnet O1 Module +Make sure you have installed `netcat`. +```bash +sudo apt update && sudo apt install netcat +``` + +```bash +O1_IP=$(kubectl get svc oai-gnb-du-o1-telnet-lb -n oai-ran-du --context edge-admin@edge -o=jsonpath='{.status.loadBalancer.ingress[0].ip}') +echo o1 stats | nc -N $O1_IP 9090 +``` + +
+The output is similar to: + +```console +{ + "o1-config": { + "BWP": { + "dl": [{ + "bwp3gpp:isInitialBwp": true, + "bwp3gpp:numberOfRBs": 51, + "bwp3gpp:startRB": 0, + "bwp3gpp:subCarrierSpacing": 30 + }], + "ul": [{ + "bwp3gpp:isInitialBwp": true, + "bwp3gpp:numberOfRBs": 51, + "bwp3gpp:startRB": 0, + "bwp3gpp:subCarrierSpacing": 30 + }] + }, + "NRCELLDU": { + "nrcelldu3gpp:ssbFrequency": 630048, + "nrcelldu3gpp:arfcnDL": 629436, + "nrcelldu3gpp:bSChannelBwDL": 20, + "nrcelldu3gpp:arfcnUL": 629436, + "nrcelldu3gpp:bSChannelBwUL": 20, + "nrcelldu3gpp:nRPCI": 0, + "nrcelldu3gpp:nRTAC": 1, + "nrcelldu3gpp:mcc": "001", + "nrcelldu3gpp:mnc": "01", + "nrcelldu3gpp:sd": 16777215, + "nrcelldu3gpp:sst": 1 + }, + "device": { + "gnbId": 3584, + "gnbName": "du-rfsim", + "vendor": "OpenAirInterface" + } + }, + "O1-Operational": { + "frame-type": "tdd", + "band-number": 78, + "num-ues": 0, + "ues": [ ], + "load": 0, + "ues-thp": [ + ] + } +} +OK +``` +
+Notice the block `O1-Operational` you will see the number of connected UEs, present load at the gNB and the DL/UL RLC `throughput` in `Kbps`. -## Step 7: Deploy UE +## Step 7: Deploy UE (20 Mhz) If all three links are configured then you can proceed with deploying the UE `PackageVariants` ```bash -kubectl create -f test-infra/e2e/tests/oai/005-ue.yaml +kubectl apply -f - < +The output is similar to: + +```console + { + "o1-config": { + "BWP": { + "dl": [{ + "bwp3gpp:isInitialBwp": true, + "bwp3gpp:numberOfRBs": 106, + "bwp3gpp:startRB": 0, + "bwp3gpp:subCarrierSpacing": 30 + }], + "ul": [{ + "bwp3gpp:isInitialBwp": true, + "bwp3gpp:numberOfRBs": 106, + "bwp3gpp:startRB": 0, + "bwp3gpp:subCarrierSpacing": 30 + }] + }, + "NRCELLDU": { + "nrcelldu3gpp:ssbFrequency": 641280, + "nrcelldu3gpp:arfcnDL": 640008, + "nrcelldu3gpp:bSChannelBwDL": 40, + "nrcelldu3gpp:arfcnUL": 640008, + "nrcelldu3gpp:bSChannelBwUL": 40, + "nrcelldu3gpp:nRPCI": 0, + "nrcelldu3gpp:nRTAC": 1, + "nrcelldu3gpp:mcc": "001", + "nrcelldu3gpp:mnc": "01", + "nrcelldu3gpp:sd": 16777215, + "nrcelldu3gpp:sst": 1 + }, + "device": { + "gnbId": 3584, + "gnbName": "du-rfsim", + "vendor": "OpenAirInterface" + } + }, + "O1-Operational": { + "frame-type": "tdd", + "band-number": 78, + "num-ues": 0, + "ues": [ ], + "load": 0, + "ues-thp": [ + ] + } +} +``` + + +You can see `nrcelldu3gpp:bSChannelBwUL` as 40. + +### Reconnect UE (40 Mhz) +```bash +kubectl apply -f - < Date: Mon, 1 Jul 2024 08:31:22 +0530 Subject: [PATCH 2/6] Update upstream repo for ue in exercise-2-oai.md --- content/en/docs/guides/user-guides/exercise-2-oai.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/docs/guides/user-guides/exercise-2-oai.md b/content/en/docs/guides/user-guides/exercise-2-oai.md index 1fcdf7b3..073e09aa 100644 --- a/content/en/docs/guides/user-guides/exercise-2-oai.md +++ b/content/en/docs/guides/user-guides/exercise-2-oai.md @@ -789,7 +789,7 @@ metadata: name: oai-ue-20mhz spec: upstream: - repo: oai-ran-bp + repo: catalog-workloads-oai-ran package: pkg-example-ue-bp-20MHz revision: v1 # To be updated when catalog is tagged downstream: @@ -966,7 +966,7 @@ metadata: name: oai-ue-40mhz spec: upstream: - repo: oai-ran-bp + repo: catalog-workloads-oai-ran package: pkg-example-ue-bp-40mhz revision: v1 # To be updated when catalog is tagged downstream: From 7a106a18cbe63e97362bf26a383a0733a9c3dd3c Mon Sep 17 00:00:00 2001 From: jain-ashish-sam <145763342+jain-ashish-sam@users.noreply.github.com> Date: Mon, 1 Jul 2024 08:41:09 +0530 Subject: [PATCH 3/6] Update exercise-2-oai.md --- content/en/docs/guides/user-guides/exercise-2-oai.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/guides/user-guides/exercise-2-oai.md b/content/en/docs/guides/user-guides/exercise-2-oai.md index 073e09aa..2e306db7 100644 --- a/content/en/docs/guides/user-guides/exercise-2-oai.md +++ b/content/en/docs/guides/user-guides/exercise-2-oai.md @@ -790,7 +790,7 @@ metadata: spec: upstream: repo: catalog-workloads-oai-ran - package: pkg-example-ue-bp-20MHz + package: pkg-example-ue-bp-20mhz revision: v1 # To be updated when catalog is tagged downstream: repo: edge From 5c46ea1e65841bcb647cac76763aa7de94ff9d18 Mon Sep 17 00:00:00 2001 From: jain-ashish-sam <145763342+jain-ashish-sam@users.noreply.github.com> Date: Mon, 1 Jul 2024 18:04:22 +0530 Subject: [PATCH 4/6] Update exercise-2-oai.md --- content/en/docs/guides/user-guides/exercise-2-oai.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/content/en/docs/guides/user-guides/exercise-2-oai.md b/content/en/docs/guides/user-guides/exercise-2-oai.md index 2e306db7..af8f1666 100644 --- a/content/en/docs/guides/user-guides/exercise-2-oai.md +++ b/content/en/docs/guides/user-guides/exercise-2-oai.md @@ -810,7 +810,7 @@ packagevariant.config.porch.kpt.dev/oai-ue-20mhz created ``` -The UE will be deployed in the Edge cluster. To verify that the UE is deployed you can use the below command +The UE will be deployed in the Edge cluster. It might take 2-3 mins for the ue to get deployed.To verify that the UE is deployed you can use the below command ```bash kubectl get pods -n oai-ue --context edge-admin@edge @@ -850,7 +850,7 @@ To perform the end to end connectivity test you can ping from the UE to the UPF. UE_POD=$(kubectl get pods -n oai-ue --context edge-admin@edge -l app.kubernetes.io/name=oai-nr-ue-20mhz -o jsonpath='{.items[*].metadata.name}') UPF_POD=$(kubectl get pods -n oai-core --context=edge-admin@edge -l workload.nephio.org/oai=upf -o jsonpath='{.items[*].metadata.name}') UPF_tun0_IP_ADDR=$(kubectl exec -it $UPF_POD -n oai-core -c upf-edge --context edge-admin@edge -- ip -f inet addr show tun0 | sed -En -e 's/.*inet ([0-9.]+).*/\1/p') -kubectl exec -it $UE_POD -n oai-ue --context edge-admin@edge -- ping -c 3 $UPF_tun0_IP_ADDR +kubectl exec -it $UE_POD -n oai-ue --context edge-admin@edge -- ping -I oaitun_ue1 -c 3 $UPF_tun0_IP_ADDR ``` @@ -956,6 +956,8 @@ echo o1 stats | nc -N $O1_IP 9090 You can see `nrcelldu3gpp:bSChannelBwUL` as 40. +Note: Sometimes, It might happen that the Bandwidth doesn't reconfigure (to 40) after running the o1-commands. If that's the case, re-run the o1-commands. + ### Reconnect UE (40 Mhz) ```bash @@ -1027,7 +1029,7 @@ To perform the end to end connectivity test you can ping from the UE to the UPF. UE_POD=$(kubectl get pods -n oai-ue --context edge-admin@edge -l app.kubernetes.io/name=oai-nr-ue-40mhz -o jsonpath='{.items[*].metadata.name}') UPF_POD=$(kubectl get pods -n oai-core --context=edge-admin@edge -l workload.nephio.org/oai=upf -o jsonpath='{.items[*].metadata.name}') UPF_tun0_IP_ADDR=$(kubectl exec -it $UPF_POD -n oai-core -c upf-edge --context edge-admin@edge -- ip -f inet addr show tun0 | sed -En -e 's/.*inet ([0-9.]+).*/\1/p') -kubectl exec -it $UE_POD -n oai-ue --context edge-admin@edge -- ping -c 3 $UPF_tun0_IP_ADDR +kubectl exec -it $UE_POD -n oai-ue --context edge-admin@edge -- ping -I oaitun_ue1 -c 3 $UPF_tun0_IP_ADDR ``` From 108ce5713f7bbaa37a4913790c38026ef63fdffa Mon Sep 17 00:00:00 2001 From: jain-ashish-sam <145763342+jain-ashish-sam@users.noreply.github.com> Date: Mon, 1 Jul 2024 18:11:03 +0530 Subject: [PATCH 5/6] Update exercise-2-oai.md --- content/en/docs/guides/user-guides/exercise-2-oai.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/en/docs/guides/user-guides/exercise-2-oai.md b/content/en/docs/guides/user-guides/exercise-2-oai.md index af8f1666..776ce69c 100644 --- a/content/en/docs/guides/user-guides/exercise-2-oai.md +++ b/content/en/docs/guides/user-guides/exercise-2-oai.md @@ -956,6 +956,7 @@ echo o1 stats | nc -N $O1_IP 9090 You can see `nrcelldu3gpp:bSChannelBwUL` as 40. + Note: Sometimes, It might happen that the Bandwidth doesn't reconfigure (to 40) after running the o1-commands. If that's the case, re-run the o1-commands. From 57528867e0b49074d5bed4a94d1f26c6bc0351e6 Mon Sep 17 00:00:00 2001 From: Ashish Jain Date: Tue, 2 Jul 2024 21:22:12 +0530 Subject: [PATCH 6/6] Renaming o1-telnet to telnet --- .../docs/guides/user-guides/exercise-2-oai.md | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/content/en/docs/guides/user-guides/exercise-2-oai.md b/content/en/docs/guides/user-guides/exercise-2-oai.md index 776ce69c..a1a08954 100644 --- a/content/en/docs/guides/user-guides/exercise-2-oai.md +++ b/content/en/docs/guides/user-guides/exercise-2-oai.md @@ -711,15 +711,15 @@ The output is similar to: 9496.571150 [GNB_APP] I [gNB 0] Received NGAP_REGISTER_GNB_CNF: associated AMF 1 ``` -### Check Stats via telnet O1 Module +### Check Stats via telnet Module Make sure you have installed `netcat`. ```bash sudo apt update && sudo apt install netcat ``` ```bash -O1_IP=$(kubectl get svc oai-gnb-du-o1-telnet-lb -n oai-ran-du --context edge-admin@edge -o=jsonpath='{.status.loadBalancer.ingress[0].ip}') -echo o1 stats | nc -N $O1_IP 9090 +TELNET_IP=$(kubectl get svc oai-gnb-du-telnet-lb -n oai-ran-du --context edge-admin@edge -o=jsonpath='{.status.loadBalancer.ingress[0].ip}') +echo o1 stats | nc -N $TELNET_IP 9090 ```
@@ -791,7 +791,7 @@ spec: upstream: repo: catalog-workloads-oai-ran package: pkg-example-ue-bp-20mhz - revision: v1 # To be updated when catalog is tagged + revision: main # To be updated when catalog is tagged to (v3.0.0) downstream: repo: edge package: oai-ran-ue-20mhz @@ -870,10 +870,10 @@ rtt min/avg/max/mdev = 7.572/10.584/14.680/3.001 ms For now the extra interfaces which are created using inter-connectivity script does not perform natting to have internet access. -## Step 9: Reconfiguring Bandwidth using O1-Telnet (20Mhz to 40Mhz) -1. Get the O1-Ip: +## Step 9: Reconfiguring Bandwidth using Telnet-Service (20Mhz to 40Mhz) +1. Get the Telnet-Ip: ```bash -O1_IP=$(kubectl get svc oai-gnb-du-o1-telnet-lb -n oai-ran-du --context edge-admin@edge -o=jsonpath='{.status.loadBalancer.ingress[0].ip}') +TELNET_IP=$(kubectl get svc oai-gnb-du-telnet-lb -n oai-ran-du --context edge-admin@edge -o=jsonpath='{.status.loadBalancer.ingress[0].ip}') ``` 2. Delete the 20Mhz-Ue Package ```bash @@ -888,19 +888,19 @@ done 3. Stop the L1 ```bash -echo o1 stop_modem | nc -N $O1_IP 9090 +echo o1 stop_modem | nc -N $TELNET_IP 9090 ``` 4. Reconfigure bandwidth ```bash -echo o1 bwconfig 40 | nc -N $O1_IP 9090 +echo o1 bwconfig 40 | nc -N $TELNET_IP 9090 ``` 5. Start L1 ```bash -echo o1 start_modem | nc -N $O1_IP 9090 +echo o1 start_modem | nc -N $TELNET_IP 9090 ``` 6. Check the reconfigured bandwidth ```bash -echo o1 stats | nc -N $O1_IP 9090 +echo o1 stats | nc -N $TELNET_IP 9090 ```
@@ -957,7 +957,7 @@ echo o1 stats | nc -N $O1_IP 9090 You can see `nrcelldu3gpp:bSChannelBwUL` as 40. -Note: Sometimes, It might happen that the Bandwidth doesn't reconfigure (to 40) after running the o1-commands. If that's the case, re-run the o1-commands. +Note: Sometimes, It might happen that the Bandwidth doesn't reconfigure (to 40) after running the telnet-commands. If that's the case, re-run the telnet-commands. ### Reconnect UE (40 Mhz) @@ -971,7 +971,7 @@ spec: upstream: repo: catalog-workloads-oai-ran package: pkg-example-ue-bp-40mhz - revision: v1 # To be updated when catalog is tagged + revision: main # To be updated when catalog is tagged to (v3.0.0) downstream: repo: edge package: oai-ran-ue-40mhz