paulmataruso/docker-open5gs-Borjis
1
0
Fork 0
mirror of https://github.com/Borjis131/docker-open5gs.git synced 2025-11-02 12:53:13 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add documentation for the PacketRusher and UERANSIM deployments in FAQs

Browse Source
This commit is contained in:
Borjis131
2024-09-26 14:16:31 +02:00
parent 6f1d4f5289
commit 4d41e07ffb
2 changed files with 39 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
docs/FAQ.md
View File

@@ -82,4 +82,40 @@ docker-compose -f misc/examples/basic-compose-file-v2.x/docker-compose.yaml up -
# Tear down the basic deployment with docker-compose (V1) and Compose file version 2.x
docker-compose -f misc/examples/basic-compose-file-v2.x/docker-compose.yaml down
```
## How to use the UERANSIM container
You can use the emulated UE connection by connecting to the UE container:
```bash
# connect to the UE container
docker exec -it ue bash
# Use the TUN interface to test the UE connection
ping -I uesimtun0 8.8.8.8
```
## How to use the PacketRusher container
You can use the emulated UE connection by using the VRF.
Check the logs of the PacketRusher container to see the VRF identifier:
```bash
docker logs -f packetrusher
...
time="2024-09-26T10:46:32Z" level=info msg="[UE][GTP] Interface val1234567891 has successfully been configured for UE 10.45.0.2"
time="2024-09-26T10:46:32Z" level=info msg="[UE][GTP] You can do traffic for this UE using VRF vrf1234567891, eg:"
time="2024-09-26T10:46:32Z" level=info msg="[UE][GTP] sudo ip vrf exec vrf1234567891 iperf3 -c IPERF_SERVER -p PORT -t 9000"
```
Connect to the PacketRusher container and then to the VRF:
```bash
# connect to the PacketRusher container
docker exec -it packetrusher bash
# Use the VRF inside the PacketRusher container
ip vrf exec vrf1234567891 bash
# Test the UE connection
ping 8.8.8.8
```

4
docs/deployments/internal.md
View File

@@ -12,4 +12,6 @@ The `internal/packetrusher` deployment works with [PacketRusher](https://github.
Check [docker-packetrusher](https://github.com/Borjis131/docker-packetrusher) and follow the section `Important notes` to use this image. This image depends on a kernel module being installed on the host machine, the `free5gc's gtp5g kernel module`.
This deployment connects an emulated UE and gNB to the Open5GS 5G Core.
This deployment connects an emulated UE and gNB to the Open5GS 5G Core.
Check the [FAQ/How to use the UERANSIM container](../FAQ.md) and [FAQ/How to use the PacketRusher container](../FAQ.md) to see how to use the emulated UEs.