1.7.0

S1AP Federated Integration Test

The S1AP Integration Test only tests the AGW. The objective of the S1AP Federated Integration Test is to provide a test platform to run Magma with all of its components. That is, an end-to-end test with all components of Magma: AGW, Orc8r and FeG.

Currently, this test is in an experimental phase, so we are only testing the connectivity of AGW - Orc8r - FeG, and we are able to run an attach/detach test using the S1AP tester and our mock HSS.

Architecture

As the diagram indicates, this test spins up AGW, FeG, and Orc8r and uses S1AP and magma_trfserver as an eNb and SGi emulator to run tests.

graph LR; A[[S1AP]] --- AGW ---|control| Orc8r --- FeG --- HSS[(HSS)]; AGW ---|data| Z[[magma_trfserver]];

The services will run either on Vagrant VMs or on Docker:

ServicesVagrant VMDocker
AGWmagma
FeG✓
Orc8r✓
Traffic servermagma_trfserver
S1AP testermagma_test
HSS✓

Running the tests

Below there are three different ways to run the tests. These will help you debug any intermediate step should the automation fail.

Automated test run

The fab script mentioned below will do everything for you. In case it fails, try one of the other two methods: semiautomatic or manual.

This script will

  • Build AGW, Orc8r and FeG
  • Start AGW, Orc8r and FeG
  • Configure Orc8r with AGW and FeG
  • Run connectivity tests between all three components
  • Run a basic attach/detach test

To execute the script, run:

cd magma/lte/gateway
fab federated_integ_test:build_all=True

# to run it again, you can skip the build_all
# however, if you change code in Magma, you will need to build_all again
fab federated_integ_test

You can access Orc8r adding to your keychain the admin_operator.pfx cert you will find at /magma/.cache/test_certs. Then you can check your provisioned gateways using swagger interface that will be running on your Orc8r

Please, for more detail, check the following sections which provide more insight about this process.

Semiautomatic test run

Build environment

Using this method, you will build the environment step by step but still using certain automation. If you want to build the environment manually instead, go to Manual build.

On your host machine, execute these commands to build, start and configure the AGW, FeG and Orc8r:

cd magma/lte/gateway/python/integ_tests/federated_tests
fab build_all_and_configure

After this has run, you can check whether your gateways have been bootstrapped using the magmad logs on the AGW and FeG. The command below will try to reach Orc8r from AGW and FeG, and FeG from AGW:

cd magma/lte/gateway/python/integ_tests/federated_tests
fab test_connectivity

Once it has been built, start the magma_trfserver and magma_test VMs:

cd magma/lte/gateway
vagrant up magma_test
vagrant up magma_trfserver

You can then run the test manually.

Manual build

If you want to build the environment manually, you can carry out the following steps.

Note that commands for the AGW have to be run inside the Vagrant VM. For this reason, all such commands include the vagrant ssh magma command first. To leave Vagrant, just type exit. FeG and Orc8r will need to be run on the host itself (no Vagrant involved).

  • AGW:
cd magma/lte/gateway
vagrant up magma
vagrant ssh magma

# inside vagrant vm
cd magma/lte/gateway
make run

# exit from vagrant vm
exit
  • FeG:
cd magma/lte/gateway/python/integ_tests/federated_tests/docker
docker-compose build
docker-compose up -d
  • Orc8r:
cd magma/orc8r/cloud/docker
./build.py -a
./run.py

# return to agw folder
cd magma/lte/gateway
# register gateways
fab --fabfile=dev_tools.py register_federated_vm
fab --fabfile=dev_tools.py register_feg_gw
  • Test VM:
cd magma/lte/gateway
vagrant up magma_test
vagrant ssh magma_test

# inside vagrant vm
cd magma/lte/gateway/python
make

# exit from vagrant vm
exit
  • Traffic VM:
cd magma/lte/gateway
vagrant up magma_trfserver

Run test manually

Once you have built all of the VMs, you can try to run the test from the magma_test VM. It is a simple attach-detach test:

cd magma/lte/gateway
vagrant ssh magma_test

# inside vagrant vm
cd magma/lte/gateway/python/integ_tests
make integ_test TESTS=federated_tests/s1aptests/test_attach_detach.py

# once the test is done, you can exit the vagrant vm
exit
← FeG Docker SetupTest CWAG →