docs: Magma Outbound Roaming support #11690

Arsenii-Oganov · 2022-02-18T16:35:01Z

Signed-off-by: Arsenii Oganov [email protected]

Summary

Magma Outbound Roaming support

Issue - #11689

Arsenii-Oganov · 2022-02-18T16:35:10Z

Issue: #11689

github-actions · 2022-02-18T16:35:21Z

Thanks for opening a PR! 💯

A couple initial guidelines

All commits must be signed off. This is enforced by DCO check.
All PR titles must follow the semantic commits format. This is enforced by Semantic PR.

Howto

Reviews. The "Reviewers" listed for this PR are the Magma maintainers who will shepherd it.
Checks. All required CI checks must pass before merge.
Merge. Once approved and passing CI checks, use the ready2merge label to indicate the maintainers can merge your PR.

More info

Please take a moment to read through the Magma project's

Contributing Conventions for norms around contributed code

If this is your first Magma PR, also consider reading

Developer Onboarding for onboarding as a new Magma developer
Development Workflow for guidance on your first pull request
CI Checks for points of contact for failing or flaky CI checks
GitHub-to-Slack mappings for Magma maintainers for guidance on how to contact maintainers on Slack

docs/readmes/proposals/p027_magma_outbound_roaming_support.md

ekowtaylor · 2022-03-03T16:32:32Z

@Arsenii-Oganov do you still plan to move forward with this change? If yes then rebase and fix any other failing checks

github-actions · 2022-03-07T14:41:56Z

Oops! Looks like you failed the Markdown lint check.

Howto

♻️ Updated: ❌ The check is still failing the Markdown lint check after the last commit.

ardzoht · 2022-03-17T00:35:07Z

@Arsenii-Oganov similar to the CDR availability proposal, this one also needs Testing plan and Roadmap schedule as required from the TSC grant review guidelines

Arsenii-Oganov · 2022-03-17T09:36:04Z

@Arsenii-Oganov similar to the CDR availability proposal, this one also needs Testing plan and Roadmap schedule as required from the TSC grant review guidelines

@ardzoht this was added in magma/grants#23, here focus on technical design

uri200 · 2022-03-28T18:27:04Z

docs/readmes/proposals/p027_magma_outbound_roaming_support.md

+The following existing services will be ported to run in the Roaming Gateway:
+
+- Health
+- S8_proxy


as mentioned on gdocs, S8_proxy is a feg service. You shouldnt be labeling the service with the same name

Lets first fix everything on gdocs, and then complete the PR. Otherwise you will be working twice
https://docs.google.com/document/d/17OYrYw6PMxFEWi_Ubx8eD1Qt3UT2VbchR_FIT5ivxI0/edit#heading=h.8bgsd6xc866i

Neudrino

The markdown lint check is failing and needs to be fixed.

Neudrino · 2022-04-26T10:56:46Z

docs/readmes/proposals/p027_magma_outbound_roaming_support.md

@@ -0,0 +1,136 @@
+# Outbound Roaming
+
+Link to discussed detailed doc <https://docs.google.com/document/d/17OYrYw6PMxFEWi_Ubx8eD1Qt3UT2VbchR_FIT5ivxI0>


Please use proper markdown syntax for links.

Neudrino · 2022-04-26T11:03:51Z

docs/readmes/proposals/p027_magma_outbound_roaming_support.md

+
+When outbound roaming, the standard interfaces are s6a and s8 which allow the VPLMN to authenticate the SIM credentials with the home network and route user traffic back to the home network. See diagram below from 3GPP TS 23.401 V17.3.0 (2021-12).
+
+![arch](https://user-images.githubusercontent.com/93994458/154709583-14f9bb52-486b-4908-b250-e521627b6f04.png)


Mermaid diagrams should be preferred over binary blob includes. They work in Github and DocuSaurus.

Neudrino · 2022-04-26T11:05:55Z

docs/readmes/proposals/p027_magma_outbound_roaming_support.md

+
+The Roaming Gateway diagram shows the services which will run in the Roaming gateway. These services will support the user plane data transport for both inbound roaming GTP aggregation and outbound roaming when traffic is home routed.
+
+![roaming gateway](https://user-images.githubusercontent.com/93994458/154709967-7cd453ba-2070-4733-9e3f-dcc6f38624d2.png)


Mermaid diagrams should be preferred over binary blob includes. They work in Github and DocuSaurus.

Neudrino · 2022-04-26T11:06:21Z

docs/readmes/proposals/p027_magma_outbound_roaming_support.md

+
+Overall, when combined with the orchestrator and federation gateway, the proposed architecture is depicted below showing all key interfaces for inbound and outbound roaming.
+
+![arch](https://user-images.githubusercontent.com/93994458/154710530-f535e6c1-8221-4de4-9e7b-5fc974f2ee3d.png)


Mermaid diagrams should be preferred over binary blob includes. They work in Github and DocuSaurus.

Neudrino · 2022-04-26T11:08:18Z

docs/readmes/proposals/p027_magma_outbound_roaming_support.md

+
+##### 3.2.1.1 Health (modified)
+
+In addition to the health metrics added in the GTP Gateway proposal for inbound roaming, the following health metrics will also be added to health:


to health - This is either an superfluous suffix or there is a word (e.g. endpoint) missing here.

Neudrino · 2022-04-26T11:09:39Z

docs/readmes/proposals/p027_magma_outbound_roaming_support.md

+
+##### 3.2.1.2 PolicyDB + SessionD + PipelineD + MobilityD(modified)
+
+The combination of policyDB, sessiond, and pipelined provide the PCEF functionality to the Roaming gateway for home routed data sessions. This ensures that policy rules, QoS profiles, Rating Groups, and charging can be applied to subscriber sessions while getting services from a VPLMN.


The PCEF acronym should be explained.

Neudrino · 2022-04-26T11:10:52Z

docs/readmes/proposals/p027_magma_outbound_roaming_support.md

+
+![arch](https://user-images.githubusercontent.com/93994458/154709583-14f9bb52-486b-4908-b250-e521627b6f04.png)
+
+Currently, Magma supports only inbound roaming where magma is the VPLMN and another operator/core is the HPLMN. Magma supports the client side of both S6a and S8 interfaces.


The acronyms VPLMN and HPLMN should be explained.

Neudrino · 2022-04-26T11:13:35Z

docs/readmes/proposals/p027_magma_outbound_roaming_support.md

+
+UE IP address allocation will be provided by MobilityD. The UE IP request will be moved from MME function to sessiond to provide consistency across Roaming Gateway and AGW. IP allocation via NAT will be supported with a configurable NAT pool for IPs. Other IP address allocation schemes are out of scope.
+
+In this phase, default bearer and general internet access is provided to home routed sessions. Dedicated bearer and other services are out of scope.


What do you mean by In this phase? Maybe currently was meant? Or is it part to be implemented?
The statement should be made unambiguous.

Neudrino · 2022-04-26T11:17:42Z

docs/readmes/proposals/p027_magma_outbound_roaming_support.md

+
+In the call flow below, red number messages indicate new functionality supported by a Magma element.
+
+![call flow](https://user-images.githubusercontent.com/93994458/154710857-f8f23a91-415a-48b9-ab08-cf58450a21c6.png)


Mermaid diagrams should be preferred over binary blob includes. They work in Github and DocuSaurus.

Neudrino · 2022-04-26T11:18:27Z

docs/readmes/proposals/p027_magma_outbound_roaming_support.md

+
+## 4 Schedule & Commercials
+
+TBD


This content should be added before merge.

new commit force pushed

Signed-off-by: Arsenii Oganov <[email protected]>

stale · 2022-11-01T11:54:52Z

This issue or pull request has been automatically marked as stale because it has not had any recent activity. It will be closed if no further activity occurs in the next 14 days.

stale · 2022-11-15T15:12:51Z

This issue or pull request has exceeded its lifecylce and was automatically closed. Should you wish to continue working on this, please reopen it.

Arsenii-Oganov requested a review from electronjoe as a code owner February 18, 2022 16:35

pull-request-size bot added the size/L Denotes a Pull Request that changes 100-499 lines. label Feb 18, 2022

github-actions bot added the component: docs Documentation-related issue label Feb 18, 2022

This was referenced Feb 18, 2022

Magma Outbound Roaming support #11689

Closed

Magma outbound roaming proposal magma/grants#23

Open

ardzoht reviewed Feb 23, 2022

View reviewed changes

docs/readmes/proposals/p027_magma_outbound_roaming_support.md Show resolved Hide resolved

electronjoe approved these changes Feb 25, 2022

View reviewed changes

Arsenii-Oganov force-pushed the proposal_027 branch from 3701915 to 079bb9b Compare March 7, 2022 14:38

uri200 reviewed Mar 28, 2022

View reviewed changes

Arsenii-Oganov force-pushed the proposal_027 branch from 079bb9b to 1ee4444 Compare April 11, 2022 07:24

Neudrino requested changes Apr 26, 2022

View reviewed changes

docs: Magma Outbound Roaming support

8668e77

Signed-off-by: Arsenii Oganov <[email protected]>

Arsenii-Oganov force-pushed the proposal_027 branch from 1ee4444 to 8668e77 Compare May 5, 2022 08:00

stale bot added the wontfix This will not be worked on label Aug 3, 2022

magma deleted a comment from stale bot Aug 3, 2022

stale bot removed the wontfix This will not be worked on label Aug 3, 2022

stale bot added the wontfix This will not be worked on label Nov 1, 2022

stale bot closed this Nov 15, 2022

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs: Magma Outbound Roaming support #11690

docs: Magma Outbound Roaming support #11690

Arsenii-Oganov commented Feb 18, 2022

Arsenii-Oganov commented Feb 18, 2022

github-actions bot commented Feb 18, 2022

ekowtaylor commented Mar 3, 2022

github-actions bot commented Mar 7, 2022 •

edited

Loading

ardzoht commented Mar 17, 2022

Arsenii-Oganov commented Mar 17, 2022 •

edited

Loading

uri200 Mar 28, 2022

Neudrino left a comment

Neudrino Apr 26, 2022

Neudrino Apr 26, 2022

Neudrino Apr 26, 2022

Neudrino Apr 26, 2022

Neudrino Apr 26, 2022

Neudrino Apr 26, 2022

Neudrino Apr 26, 2022

Neudrino Apr 26, 2022

Neudrino Apr 26, 2022

Neudrino Apr 26, 2022

Arsenii-Oganov May 5, 2022

stale bot commented Nov 1, 2022

stale bot commented Nov 15, 2022

		@@ -0,0 +1,136 @@
		# Outbound Roaming

		Link to discussed detailed doc <https://docs.google.com/document/d/17OYrYw6PMxFEWi_Ubx8eD1Qt3UT2VbchR_FIT5ivxI0>


		When outbound roaming, the standard interfaces are s6a and s8 which allow the VPLMN to authenticate the SIM credentials with the home network and route user traffic back to the home network. See diagram below from 3GPP TS 23.401 V17.3.0 (2021-12).

		![arch](https://user-images.githubusercontent.com/93994458/154709583-14f9bb52-486b-4908-b250-e521627b6f04.png)


		The Roaming Gateway diagram shows the services which will run in the Roaming gateway. These services will support the user plane data transport for both inbound roaming GTP aggregation and outbound roaming when traffic is home routed.

		![roaming gateway](https://user-images.githubusercontent.com/93994458/154709967-7cd453ba-2070-4733-9e3f-dcc6f38624d2.png)


		Overall, when combined with the orchestrator and federation gateway, the proposed architecture is depicted below showing all key interfaces for inbound and outbound roaming.

		![arch](https://user-images.githubusercontent.com/93994458/154710530-f535e6c1-8221-4de4-9e7b-5fc974f2ee3d.png)


		##### 3.2.1.1 Health (modified)

		In addition to the health metrics added in the GTP Gateway proposal for inbound roaming, the following health metrics will also be added to health:


		##### 3.2.1.2 PolicyDB + SessionD + PipelineD + MobilityD(modified)

		The combination of policyDB, sessiond, and pipelined provide the PCEF functionality to the Roaming gateway for home routed data sessions. This ensures that policy rules, QoS profiles, Rating Groups, and charging can be applied to subscriber sessions while getting services from a VPLMN.


		![arch](https://user-images.githubusercontent.com/93994458/154709583-14f9bb52-486b-4908-b250-e521627b6f04.png)

		Currently, Magma supports only inbound roaming where magma is the VPLMN and another operator/core is the HPLMN. Magma supports the client side of both S6a and S8 interfaces.


		UE IP address allocation will be provided by MobilityD. The UE IP request will be moved from MME function to sessiond to provide consistency across Roaming Gateway and AGW. IP allocation via NAT will be supported with a configurable NAT pool for IPs. Other IP address allocation schemes are out of scope.

		In this phase, default bearer and general internet access is provided to home routed sessions. Dedicated bearer and other services are out of scope.


		In the call flow below, red number messages indicate new functionality supported by a Magma element.

		![call flow](https://user-images.githubusercontent.com/93994458/154710857-f8f23a91-415a-48b9-ab08-cf58450a21c6.png)

docs: Magma Outbound Roaming support #11690

docs: Magma Outbound Roaming support #11690

Conversation

Arsenii-Oganov commented Feb 18, 2022

Summary

Arsenii-Oganov commented Feb 18, 2022

github-actions bot commented Feb 18, 2022

Howto

More info

ekowtaylor commented Mar 3, 2022

github-actions bot commented Mar 7, 2022 • edited Loading

Howto

ardzoht commented Mar 17, 2022

Arsenii-Oganov commented Mar 17, 2022 • edited Loading

Choose a reason for hiding this comment

Neudrino left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

stale bot commented Nov 1, 2022

stale bot commented Nov 15, 2022

github-actions bot commented Mar 7, 2022 •

edited

Loading

Arsenii-Oganov commented Mar 17, 2022 •

edited

Loading