Skip to content
Snippets Groups Projects
Commit 3d0f0a6e authored by Rohan's avatar Rohan
Browse files

Update tutorial page

parent f2b4f5c9
No related branches found
No related tags found
1 merge request!47My5grantester tutorial
Hide whitespace changes
Inline Side-by-side
docs/DEPLOY_SA5G_WITH_My5g-RANTester.md
+ 32
− 29
View file @ 3d0f0a6e
...@@ -64,8 +64,9 @@ we did for dsTest-host. ...@@ -64,8 +64,9 @@ we did for dsTest-host.
Then we follow deployment procedure as usual. Then we follow deployment procedure as usual.
```bash ```shell
oai-cn5g-fed/docker-compose$ docker-compose -f docker-compose-basic-vpp-nrf.yaml up -d docker-compose-host $: cd oai-cn5g-fed/docker-compose
docker-compose-host $: docker-compose -f docker-compose-basic-vpp-nrf.yaml up -d
Creating mysql ... done Creating mysql ... done
Creating oai-nrf ... done Creating oai-nrf ... done
Creating vpp-upf ... done Creating vpp-upf ... done
...@@ -80,8 +81,8 @@ Creating oai-smf ... done ...@@ -80,8 +81,8 @@ Creating oai-smf ... done
More details in [section 5 of the `basic` vpp tutorial](https://gitlab.eurecom.fr/oai/cn5g/oai-cn5g-fed/-/blob/master/docs/DEPLOY_SA5G_WITH_VPP_UPF.md#5-deploying-oai-5g-core-network). More details in [section 5 of the `basic` vpp tutorial](https://gitlab.eurecom.fr/oai/cn5g/oai-cn5g-fed/-/blob/master/docs/DEPLOY_SA5G_WITH_VPP_UPF.md#5-deploying-oai-5g-core-network).
After deploying core network, make sure all services are healthy. After deploying core network, make sure all services are healthy.
```bash ```shell
oai-cn5g-fed/docker-compose$ docker ps -a docker-compose-host $: docker ps -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
0c0f6920aedf oai-smf:latest "/bin/bash /openair-…" About a minute ago Up About a minute (healthy) 80/tcp, 9090/tcp, 8805/udp oai-smf 0c0f6920aedf oai-smf:latest "/bin/bash /openair-…" About a minute ago Up About a minute (healthy) 80/tcp, 9090/tcp, 8805/udp oai-smf
1eca41c99ceb oai-amf:latest "/bin/bash /openair-…" About a minute ago Up About a minute (healthy) 80/tcp, 9090/tcp, 38412/sctp oai-amf 1eca41c99ceb oai-amf:latest "/bin/bash /openair-…" About a minute ago Up About a minute (healthy) 80/tcp, 9090/tcp, 38412/sctp oai-amf
...@@ -96,18 +97,18 @@ daa71ea02f62 oai-udm:latest "/bin/bash /openair-…" About a minute ag ...@@ -96,18 +97,18 @@ daa71ea02f62 oai-udm:latest "/bin/bash /openair-…" About a minute ag
## 6. Building a `My5g-RANTester` docker image ## ## 6. Building a `My5g-RANTester` docker image ##
* Pull pre-built docker image * Pull pre-built docker image
```bash ```shell
docker pull rohankharade/my5grantester:latest docker-compose-host $: docker pull rohankharade/my5grantester:latest
docker tag rohankharade/my5grantester:latest my5grantester:latest docker-compose-host $: docker tag rohankharade/my5grantester:latest my5grantester:latest
``` ```
OR OR
* Build `My5g-RANTester` docker image * Build `My5g-RANTester` docker image
```bash ```shell
$ git clone https://github.com/my5G/my5G-RANTester docker-compose-host $: git clone https://github.com/my5G/my5G-RANTester
$ cd my5G-RANTester/ docker-compose-host $: cd my5G-RANTester/
$ docker build -f docker/Dockerfile --target my5grantester --tag my5grantester:latest . docker-compose-host $: docker build -f docker/Dockerfile --target my5grantester --tag my5grantester:latest .
``` ```
...@@ -115,21 +116,22 @@ $ docker build -f docker/Dockerfile --target my5grantester --tag my5grantester: ...@@ -115,21 +116,22 @@ $ docker build -f docker/Dockerfile --target my5grantester --tag my5grantester:
* The configuration parameters, are preconfigured in [docker-compose-basic-vpp-nrf.yaml](../docker-compose/docker-compose-basic-vpp-nrf.yaml) and [docker-compose-my5grantester-vpp.yaml](../docker-compose/docker-compose-my5grantester-vpp.yaml) and one can modify it for test. * The configuration parameters, are preconfigured in [docker-compose-basic-vpp-nrf.yaml](../docker-compose/docker-compose-basic-vpp-nrf.yaml) and [docker-compose-my5grantester-vpp.yaml](../docker-compose/docker-compose-my5grantester-vpp.yaml) and one can modify it for test.
* Launch my5G-RANTester docker service * Launch my5G-RANTester docker service
```bash ```shell
oai-cn5g-fed/docker-compose$ docker-compose -f docker-compose-my5grantester-vpp.yaml up -d docker-compose-host $: cd oai-cn5g-fed/docker-compose
docker-compose-host $: docker-compose -f docker-compose-my5grantester-vpp.yaml up -d
Creating my5grantester ... done Creating my5grantester ... done
``` ```
* After launching My5g-RANTester, make sure service status is healthy - * After launching My5g-RANTester, make sure service status is healthy -
```bash ```shell
oai-cn5g-fed/docker-compose$ docker-compose -f docker-compose-my5grantester-vpp.yaml ps -a docker-compose-host $: docker-compose -f docker-compose-my5grantester-vpp.yaml ps -a
Name Command State Ports Name Command State Ports
----------------------------------------------- -----------------------------------------------
my5grantester ./app ue Up (healthy) my5grantester ./app ue Up (healthy)
``` ```
We can verify it using my5grantester container logs as below - We can verify it using my5grantester container logs as below -
```bash ```shell
$ docker logs my5G-RANTester docker-compose-host $: docker logs my5G-RANTester
Creating my5grantester ... done Creating my5grantester ... done
Attaching to my5grantester Attaching to my5grantester
my5grantester | time="2022-05-11T21:59:28Z" level=info msg="my5G-RANTester version 0.1" my5grantester | time="2022-05-11T21:59:28Z" level=info msg="my5G-RANTester version 0.1"
...@@ -207,8 +209,8 @@ my5grantester | time="2022-05-11T21:59:30Z" level=info msg="[UE][DATA] UE is ...@@ -207,8 +209,8 @@ my5grantester | time="2022-05-11T21:59:30Z" level=info msg="[UE][DATA] UE is
## Traffic test ## ## Traffic test ##
UL Test -> UL Test ->
```bash ```shell
$ docker exec -it my5grantester ping -c 3 -I uetun1 192.168.73.135 docker-compose-host $: docker exec -it my5grantester ping -c 3 -I uetun1 192.168.73.135
PING 192.168.73.135 (192.168.73.135) from 12.1.1.2 uetun1: 56(84) bytes of data. PING 192.168.73.135 (192.168.73.135) from 12.1.1.2 uetun1: 56(84) bytes of data.
64 bytes from 192.168.73.135: icmp_seq=1 ttl=63 time=5.35 ms 64 bytes from 192.168.73.135: icmp_seq=1 ttl=63 time=5.35 ms
64 bytes from 192.168.73.135: icmp_seq=2 ttl=63 time=0.456 ms 64 bytes from 192.168.73.135: icmp_seq=2 ttl=63 time=0.456 ms
...@@ -220,8 +222,8 @@ rtt min/avg/max/mdev = 0.456/2.136/5.357/2.278 ms ...@@ -220,8 +222,8 @@ rtt min/avg/max/mdev = 0.456/2.136/5.357/2.278 ms
``` ```
DL Test -> DL Test ->
```bash ```shell
$ docker exec -it oai-ext-dn ping -c 3 12.1.1.2 docker-compose-host $: docker exec -it oai-ext-dn ping -c 3 12.1.1.2
PING 12.1.1.2 (12.1.1.2) 56(84) bytes of data. PING 12.1.1.2 (12.1.1.2) 56(84) bytes of data.
64 bytes from 12.1.1.2: icmp_seq=1 ttl=63 time=1.01 ms 64 bytes from 12.1.1.2: icmp_seq=1 ttl=63 time=1.01 ms
64 bytes from 12.1.1.2: icmp_seq=2 ttl=63 time=0.531 ms 64 bytes from 12.1.1.2: icmp_seq=2 ttl=63 time=0.531 ms
...@@ -234,13 +236,14 @@ rtt min/avg/max/mdev = 0.467/0.670/1.013/0.244 ms ...@@ -234,13 +236,14 @@ rtt min/avg/max/mdev = 0.467/0.670/1.013/0.244 ms
## Multiple UEs registration test ## ## Multiple UEs registration test ##
Load-test with UEs in queue*: Load-test with UEs in queue*:
* Update value in the [docker-compose-my5grantester-vpp.yaml](../docker-compose/docker-compose-my5grantester-vpp.yaml) * Update value in the [docker-compose-my5grantester-vpp.yaml](../docker-compose/docker-compose-my5grantester-vpp.yaml)
<!---
```bash ```shell
NUM_UE: 10 NUM_UE: 10
``` ```
-->
* Verify at AMF logs * Verify at AMF logs
```bash ```shell
$ docker logs oai-amf docker-compose-host $: docker logs oai-amf
[2022-05-11T21:53:21.866098] [AMF] [amf_app] [info ] |----------------------------------------------------------------------------------------------------------------| [2022-05-11T21:53:21.866098] [AMF] [amf_app] [info ] |----------------------------------------------------------------------------------------------------------------|
[2022-05-11T21:53:21.866102] [AMF] [amf_app] [info ] |----------------------------------------------------gNBs' information-------------------------------------------| [2022-05-11T21:53:21.866102] [AMF] [amf_app] [info ] |----------------------------------------------------gNBs' information-------------------------------------------|
[2022-05-11T21:53:21.866105] [AMF] [amf_app] [info ] | Index | Status | Global ID | gNB Name | PLMN | [2022-05-11T21:53:21.866105] [AMF] [amf_app] [info ] | Index | Status | Global ID | gNB Name | PLMN |
...@@ -278,8 +281,8 @@ $ docker logs oai-amf ...@@ -278,8 +281,8 @@ $ docker logs oai-amf
Last thing is to remove all services - <br/> Last thing is to remove all services - <br/>
* Undeploy the My5g-RANTester * Undeploy the My5g-RANTester
```bash ```shell
oai-cn5g-fed/docker-compose$ docker-compose -f docker-compose-my5grantester-vpp.yaml down docker-compose-host $: docker-compose -f docker-compose-my5grantester-vpp.yaml down
Stopping my5grantester ... done Stopping my5grantester ... done
Removing my5grantester ... done Removing my5grantester ... done
Network demo-oai-public-net is external, skipping Network demo-oai-public-net is external, skipping
...@@ -287,8 +290,8 @@ Network oai-public-access is external, skipping ...@@ -287,8 +290,8 @@ Network oai-public-access is external, skipping
``` ```
* Undeploy the core network * Undeploy the core network
```bash ```shell
oai-cn5g-fed/docker-compose$ docker-compose -f docker-compose-basic-vpp-nrf.yaml down docker-compose-host $: docker-compose -f docker-compose-basic-vpp-nrf.yaml down
Stopping oai-smf ... done Stopping oai-smf ... done
Stopping oai-amf ... Stopping oai-amf ...
Stopping oai-ausf ... Stopping oai-ausf ...
......
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment