[Proposal]: Magma integration test framework

[Lkishor123]

Project: Magma 5G ngap integration test framework

Elevator Pitch:

Magma 5G SA is in continuous development, hence new features addition and refactoring are recurring. There is a need to have an integration framework to ensure that existing features/functionalities are working as expected.

This proposal presents a framework similar to the s1ap test framework in Magma LTE, which will empower developers for smooth integration with 5G SA functionality.

 

Contact information:

Laawanya Kishor

Email: laawanya.kishor@wavelabs.ai

 

Project Details:

Implementation Approach:

magma_test VM will be used to compile and run 5G test simulator.

 

NGAP Test Framework architecture

 

Fig: Representation of architecture

 

NGAP Test Framework Components

 

Fig: Representation of Project Components

 

The framework will have five primary Components.

1. UE Application: It will have functions and placeholders for UE procedures.
2. Gnb Application: It will have functions and placeholders related to N2, N3 interfaces, SCTP association and other gnodeb processes.
3. Test Controller Framework: It will contain placeholders for managing all other components.
4. Traffic Generator: It will contain placeholders to generate traffic packets.
5. Test Controller Stub: It will contain a placeholder for all the test scenarios. These scenarios are grouped into the following categories:
   1. Attach Detach Scenario
   2. Mobility Management Scenario
   3. Session Management Scenario
   4. Session Modification Scenario
   5. Traffic Management Scenarios

 

Milestone Overview

The project will be delivered in 5 Milestones. 4 of these milestones are focused on development, while the fifth will include regressive testing and evaluation. Each milestone is further divided into sub milestones as follows:

 

Milestone 1:
This milestone will have deliverables in the following functional areas:

Basic Framework

1. Framework (Test Controller Framework)
2. Gnb placeholders (Gnodeb Application)
3. Ue placeholders (Ue Application)
4. NGAP encoding/decoding (NGAP Module)
5. NAS encoding/decoding (NAS Module)
6. sctp placeholder (SCTP)
7. gtp placeholder (GTPU)

Basic registration procedures
Each scenario will contain multiple test cases (ranging from 5-15).

1. SCTP Scenarios
2. Plmn verification scenarios
3. Registration Deregistration

 

Milestone 2:
This milestone will have deliverables in the following functional areas:

Mobility Management:
Each scenario will contain multiple test cases (ranging from 5-15).

1. Identification scenarios (SUCI/GUTI etc)
2. Authentication scenarios
3. Security mode scenarios
4. Registration complete and ICS handler

Session Management:
Each scenario will contain multiple test cases (ranging from 5-15).

1. PDU Session Scenarios (Establishment Request, Accept)
2. Timer-based

 

Milestone 3:
This milestone will have deliverables in the following functional areas:

Additional Test Cases for Mobility and Session Management:
Each scenario will contain multiple test cases (ranging from 5-15).

1. Session Modification Scenarios
2. Paging Scenarios
3. Idle mode Scenarios

Traffic Scenarios:
Each scenario will contain multiple test cases (ranging from 5-15).

1. Mobility (Ip allocation related test cases for v4, v6 etc)
2. Traffic scenarios(Traffice Generator)

 

Milestone 4:
This milestone will have deliverables in the following functional areas:

Negative Scenarios

1. Negative Scenarios for all the above covered test cases.
2. Multi Session Scenarios for all the above covered test cases.

 

Milestone 5:
This milestone will have deliverables in the following functional areas:

Evaluation

1. Overall Integration
2. Bug fixes
3. Documentation
4. Minor Enhancements

 

Roadmap

The project will be delivered in 5 Milestones timelines as indicated.

---

Milestone	Deliverable Summary
MS1	Basic Framework, Encoding and Decoding of IEs and basic registration procedures
MS2	Mobility Management and Session Management basic test cases
MS3	Additional Test Cases for Mobility and Session Management including traffic cases
MS4	Negative and timeout scenarios with multi session test cases
MS5	Overall Integration, Bug fixes and minor enhancements

---

References

1. s1ap integration test