| Ankur Upadhyaya | 678a365 | 2021-12-08 11:56:25 +0530 | [diff] [blame] | 1 | TestPod |
| ajay | 60fd69f | 2021-11-23 22:38:10 -0800 | [diff] [blame] | 2 | ======== |
| 3 | |
| Ankur Upadhyaya | d860531 | 2021-12-03 12:38:35 +0530 | [diff] [blame] | 4 | Description |
| 5 | ----------- |
| 6 | Testpod is developer tool to simulate 5G NFs and control NF behaviour as |
| 7 | per test case requirement. Currently, it simulates AMF, NRF, PCF, UDM and UPF. |
| 8 | While all other NFs run virtually on single pod, SMF runs on actual image on another pod. |
| 9 | |
| 10 | The Testpod can be run locally on any environment having miniKube via helm test package |
| 11 | file present in repository OR locally as in binary mode. |
| 12 | |
| Ankur Upadhyaya | 678a365 | 2021-12-08 11:56:25 +0530 | [diff] [blame] | 13 | How to use TestPod |
| ajay | 60fd69f | 2021-11-23 22:38:10 -0800 | [diff] [blame] | 14 | ------------------ |
| Ankur Upadhyaya | d860531 | 2021-12-03 12:38:35 +0530 | [diff] [blame] | 15 | |
| Ankur Upadhyaya | 678a365 | 2021-12-08 11:56:25 +0530 | [diff] [blame] | 16 | * Repository |
| 17 | * `https://github.com/omec-project/testpod5G.git` |
| Ankur Upadhyaya | d860531 | 2021-12-03 12:38:35 +0530 | [diff] [blame] | 18 | |
| Ankur Upadhyaya | 678a365 | 2021-12-08 11:56:25 +0530 | [diff] [blame] | 19 | * Execution |
| 20 | * Binary mode |
| 21 | * SMF (NF to be tested) |
| 22 | * Make SMF clone (`git clone --branch onf-release3.0.5 https://github.com/omec-project/smf.git --recursive`) |
| 23 | * Change SMF PFCP port to 8806 (lib/pfcp/pfcpUdp/udp.go PFCP_PORT = 8806) |
| 24 | * Compile SMF (go build) |
| 25 | * Run SMF image(./smf -smfcfg ../../config/smfcfg.yaml -uerouting ../../config/uerouting.yaml) |
| 26 | * UPF (Only PFCP layer) |
| 27 | * Make UPF clone (`git clone https://github.com/badhrinathpa/upf-epc.git`) |
| 28 | * git checkout "sim_fast_path" branch |
| 29 | * cd pfcpiface and do "go build" |
| 30 | * Run UPF pfcp image (./pfcpiface -config ../conf/upf.json) |
| 31 | * TestPod App |
| 32 | * Make Testpod clone (`git clone https://github.com/omec-project/testpod5G.git`) |
| 33 | * Compile Testpod image(go build) |
| 34 | * Run Testpod image as AMF to test SMF ( ./testpod amf ) |
| 35 | * Update local DNS table as following (/etc/hosts) |
| 36 | * # Testpod specific |
| 37 | * 127.0.0.1 upf |
| 38 | * 127.0.0.1 smf |
| 39 | * 127.0.0.1 nrf |
| 40 | * 127.0.0.1 pcf |
| 41 | * 127.0.0.1 amf |
| 42 | * 127.0.0.1 udm |
| 43 | |
| 44 | * Minikube mode |
| 45 | * Install minikube using Homebrew (brew install minikube) |
| 46 | * Make Testpod clone (`git clone https://github.com/omec-project/testpod5G.git`) |
| 47 | * To test SMF(precondition- UPF should be running) |
| 48 | * helm install smftest ./helm/smf/ |