A simple scenario used to showcase platform capabilities.
This scenario is composed of three applications (iperf-server, iperf-proxy & _demo-server) deployed across multiple tiers of the network (fog/edge/cloud).
- The iperf-server is the standard open-source iperf-server that is containerized; it runs in the AdvantEDGE platform. It is used to generate traffic between the internal & external UE. The demo scenario contains multiple instances of the iperf-server deployed across various tiers of the network. The iperf-server image form the public iperf registry is used in this demo.
- iperf-proxy is a small server application runs on the host machine. It allows to control the local host iperf-client from the demo web-client. The demo scenario runs a single instance of the iperf-proxy. Source code is available in this repo; iperf-proxy is built as part of this demo.
- demo-server is an edge application that is containerized; it runs in the AdvantEDGE platform. It has been developed to demonstrate AdvantEDGE capabilities. The demo scenario contains multiple instances of demo-server deployed across various tiers of the network. Source code is available in this repo;demo-server is built as part of this demo.
It has two clients (internal & external) that communicate with the servers. Internal client traffic is iperf only and has no GUI. External client accesses both iperf and demo servers and has a GUI.
The platform capabilities demonstrated with this scenario are:
- Scenario deployment (dynamic charts)
- Network tiering
- Internal & external clients
- Network characteristics
- Edge-application deployment model: one-to many relationship
- UE mobility
- Applciation state transfer (demo server)
- Monitoring (demo specific dashboards)
The scenario is composed of the following components:
- 2 distant cloud application: iperf server and demo server
- 1 MNO that has 2 Zones
- Zone1 has 2 PoAs & 1 Edge node
- Zone2 has 1 PoA & 1 Edge node
- PoA1 in Zone1 is equipped with a Fog node
- Each Fog/Edge node runs 2 Edge servers (iperf and demo)
- 2 UEs
- 1 internal UE that runs an iperf client
- 1 external UE that runs a Demo client
Upon scenario startup, internal UE application (an iperf client) connects automatically to the closest iperf server and starts transferring traffic.
As the UE moves around the network, edge node instance will change.
To start the application, load the following page in the browser
The application shows details about the connection, allows to start a state counter and iperf traffic and presents an image. See Iperf & Demo server sub-sections for more details.
This is a standard iperf server that will terminate iperf client connections.
There is an iperf client running in the internal UE and another one in the external UE.
Demo server is a web server that maintains a UE state and also stores unique data. Only the external UE accesses the demo server.
Unique data is an image that is different for each location; therefore depending on the UE location in the network, the external UE GUI will show a different image. This image provides a visual indication that the UE is connected to a different network location.
UE state is in the form of a counter incremented on the server every second. Counter lives on the server side and UE can only start/reset the counter and display its value. On the UE GUI, the counter is started by pressing the button.
When the external UE moves in the network and transitions from one edge instance to another, the “UE state” (e.g. the counter value) is transferred using the application state transfer. On the UE GUI, the counter continue incrementing (e.g. not reset to zero) when the UE moves in the network.
The following steps need to be done prior to using this scenario
To build iperf-proxy & demo-server binaries from source code:
cd ~/AdvantEDGE/examples/demo1/ ./build-demo1.sh
NOTE: Binary files are created in ./bin/ folder
# Get bin folder tarball from desired release cd ~/AdvantEDGE/examples/demo1 tar -zxvf demo1.<version>.linux-amd64.tar.gz
Demo Application binaries must be dockerized (containerized) as container images in the Docker registry. This step is necessary every time the demo binaries are updated.
NOTE: Make sure you have deployed the AdvantEDGE dependencies (e.g. docker registry) before dockerizing the demo binaries.
To generate docker images from demo binary files:
cd ~/AdvantEDGE/examples/demo1/ ./dockerize.sh
Do it everytime you start using the demo when the iperf-proxy is not running
This demo scenario requires iperf installed on the AdvantEDGE host and the iperf proxy running.
which iperf returns nothing, install iperf
sudo apt-get install iperf # the following should now return /usr/bin/iperf which iperf
Start iperf proxy, in a command line shell
cd ~/AdvantEDGE/examples/demo1/bin/iperf-proxy ./iperf-proxy