Skip to content

Configurable, emulated environment for providing Network Exposure Function (NEF) APIs

License

Notifications You must be signed in to change notification settings

ATNoG/NEF_emulator

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

NEF_emulator

This is a local implentation of the NEF emulator proposed by EVOLVED-5G.

βš™ Setup locally

Docker Compose

Host prerequisites: docker, docker-compose 1.29.2, build-essential*, jq**

After cloning the repository, there are 4 more steps to do. For convinience, we have created a Makefile that contains a command for each step + several common docker-compose tasks which you may find handy in the future.

  1. create your local .env file
  2. build the container images
  3. run the containers
  4. add some test data (optional)
cd NEF_emulator

# 1.
make prepare-dev-env

# 2.
make build

# 3.
make up

# 4.
make db-init

* πŸ’‘ Info: To use the make command you need to apt install build-essential first. In case you don't want to proceed with this installation, you can head over to the Makefile and copy/paste the shell commands that are being used for every step.

** πŸ’‘ Info: The shell script used at step 4 (for adding test data) uses jq which is a lightweight and flexible command-line JSON processor. You can install it with apt install jq

k8s

Host prerequisites: docker, docker registry*, kubernetes cluster, helm

After cloning the repository, there are more X steps to do. For convinience, we have created a bash script run-helm.sh that automatically builds the docker images, pushes them to the docker registry, and installs the helm chart.

./run-helm.sh -n <namespace> -r <release-name> -d <docker-registry>

docker run -d -p 5000:5000 --name registry registry:2.7

* πŸ’‘ Info: The default docker registry used in the helm values is a local docker registry created using docker run -d -p 5000:5000 --name registry registry:2.7.

Try out your setup

After the containers are up and running:

  • access and start playing with the Swager UI at: localhost:8888/nef/docs
  • login to the admin dashboard at: localhost:8888/login
    • Default credentials: admin@my-email.com / pass
    • they can be found/changed inside your .env file

For more in-depth details about the initial NEF emulator configuration, please visit the original repository medianetlab/NEF_emulator.


5GASP guidelines and extensions

A key part of enmpowering the idea-to-market process in 5G Network Applications (NetApps) is to prove their 5G readinees. In 5GASP we propose the use of NEF to test the interaction between NetApps and 5G functionalies. We have tested and extended some capabilities from the NEF emulator prposed by the EVOLVED-5G project. Some quick guidelines for a local deployment are described next:

1. Create access token login:

Super user credentials

curl --location --request POST 'http://{url}/api/v1/login/access-token' \ 
--header 'Accept: application/json' \ 
--header 'Content-Type: application/x-www-form-urlencoded' \ 
--data-raw 'grant_type=&username=admin%40my-email.com&password=pass&scope=&client_id=&client_secret=' 

please replace {url} with the address where the NEF emulator is running. If the request is successful, you will get an access_token and a token_type.

2. Test access token

curl --location --request POST 'http://{url}/api/v1/login/test-token' \
--header 'Accept: application/json' \ 
--header 'Content-Type: application/x-www-form-urlencoded' \ 
--header 'Authorization: Bearer {access_token}' 

replace access_token with the value obtained in the previous step. If the request is successfull, details about the user will be returned.

3. Get UE info

curl --location --request GET 'http://{url}/api/v1/UEs/{supi}' \ 
--header 'Accept: application/json' \   
--header 'Authorization: Bearer {access_token}' 

Replace supi with the UE ID from the emulator.

4. Get UE serving cell (New)

curl --location --request GET 'http://{url}api/v1/UEs/{supi}/serving_cell' \ 
--header 'Accept: application/json' \ 
--header 'Authorization: Bearer {token}' 

Replace supi with the UE ID from the emulator.

5. Get UE distance to cells (New api)

Based on Haversine formula that determines the great-circle distance between two points on a sphere given their longitudes and latitudes.

curl --location --request GET 'http://{url}api/v1/UEs/{supi}/distances' \ 
--header 'Accept: application/json' \ 
--header 'Authorization: Bearer {token}' 

Replace supi with the UE ID from the emulator.

6. Get UE path loss in reference to cells (New)

Based on the formula: $Path loss =28.0+22*log10⁑(d)+20 log10⁑( fc)$, from the 5G propagation model defined in 3GPP 36.873.

curl --location --request GET 'http://{url}api/v1/UEs/{supi}/path_losses' \ 
--header 'Accept: application/json' \ 
--header 'Authorization: Bearer {token}' 

Replace supi with the UE ID from the emulator.

7. Get UE RSRP in reference to cells (New)

Based on the simplified formula: $RSRP = AntennaPower - Path Loss$, from the 3GPP TS 38.133.

curl --location --request GET 'http://{url}api/v1/UEs/{supi}/rsrps' \ 
--header 'Accept: application/json' \ 
--header 'Authorization: Bearer {token}' 

Replace supi with the UE ID from the emulator.


↔️ NetApp communication options

Below, you may find different options for establishing a bi-directional communication over HTTP between the NetApp and the NEF_emulator (for example to be used for callbacks).

1. via host.docker.internal

If you develop your NetApp directly on the host, for example a Flask app running on port 9999:

  • you will be able to connect to the NEF_emulator at: http://localhost:8888
  • the NEF_emulator will not be able to connect to http://localhost:9999 because "localhost" for a container is itself, not the host.
  • to overcome the above problem, Docker provides host.docker.internal
  • the NEF_emulator will be able to connect to http://host.docker.internal:9999
  • ⚠ make sure you bind your NetApp on 0.0.0.0:[port] and not only on 127.0.0.1:[port]
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                          HOST                                 β”‚
β”‚                                                               β”‚
β”‚                        β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”      β”‚
β”‚      NetApp            β”‚    docker-compose network     β”‚      β”‚
β”‚         β”‚              β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€      β”‚
β”‚         β”‚              β”‚    NEF_emulator containers    β”‚      β”‚
β”‚         β”‚              β”‚           live here           β”‚      β”‚
β”‚         β”‚              └── :80 ────────────── :5050 β”€β”€β”€β”˜      β”‚
β”‚         β”‚                   β”‚                   β”‚             β”‚
β”‚         β”‚                   β”‚                   β”‚             β”‚
└────── :9999 ───────────── :8888 ───────────── :5050 β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
          β”‚                   β”‚ 
          └─< communication >β”€β”˜

2. via the same docker bridge network

If you develop your NetApp as a container, the easiest way to establish a bi-directional communication would be to attach it to the pre-existing bridge network that the NEF_emulator containers use:

  • this bridge network is automatically created whenever you docker-compose up a project, in our case that would probably be named as nef_emulator_default
  • Docker will provide automatic DNS resolution between these containers names
  • your NetApp will be able to connect to the NEF_emulator at http://backend
  • the NEF_emulator will be able to connect to your NetApp at http://your_netapp_container_name:9999
  • ⚠ make sure you use the container ports directly, not the published ones
  • ⚠ make sure you first docker-compose up the NEF_emulator and then attach your NetApp container
  • more details at Docker docs: Use bridge networks and Networking in Compose
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                          HOST                                 β”‚
β”‚                                                               β”‚
β”‚    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”      β”‚
β”‚    β”‚               docker-compose network              β”‚      β”‚
β”‚    β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€      β”‚
β”‚    β”‚                                                   β”‚      β”‚
β”‚    β”‚  NetApp                NEF_emulator containers    β”‚      β”‚
β”‚    β”‚ also lives here               live here           β”‚      β”‚
β”‚    β”‚                                                   β”‚      β”‚
β”‚    └─── :9999 ──────────── :80 ────────────── :5050 β”€β”€β”€β”˜      β”‚
β”‚         β”‚                   β”‚                   β”‚             β”‚
β”‚         β”œβ”€< communication >──                   β”‚             β”‚
β”‚         β”‚                   β”‚                   β”‚             β”‚
β”‚         β”‚                   β”‚                   β”‚             β”‚
└────── :9999 ───────────── :8888 ───────────── :5050 β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Three possible ways to achieve the above approach:

  1. with docker, try the --net=... option and provide the bridge name that you want to attach to:

    docker container run --net=nef_emulator_default ...
    
  2. with docker-compose, try adding the bridge as an external network, something like:

    services:
    ....
        netapp:
        ....
            networks:
               - nef_emulator_default
    networks:
      nef_emulator_default:
        external: true
    
  3. with docker network connect, try adding your container to the bridge network:

    docker network connect BRIDGE_NAME NETAPP_NAME
    

About

Configurable, emulated environment for providing Network Exposure Function (NEF) APIs

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 55.4%
  • Python 15.2%
  • CSS 13.1%
  • Shell 11.8%
  • HTML 4.4%
  • Makefile 0.1%