Skip to content
forked from open5gs/open5gs

Open5GS is a C-language Open Source implementation for 5G Core and EPC, i.e. the core network of LTE/NR network (Release-16)

License

Notifications You must be signed in to change notification settings

althea-net/open5gs

 
 

Repository files navigation

What Is This Repo?

This is our (Althea's) branch of open5gs. Our team is firmly committed to open-sourcing and upstreaming all our contributions to open5gs whenever possible and desired by the community; this repo only holds commits that are either (a) still under active testing/development or (b) not desired by the greater open5gs community. Every change from upstream open5gs will be explained/listed below.

Branches

The main (default) branch contains our most stable version of open5gs, and is generally in active deployment by our team. dev and hotfix are sometimes used for rapid testing and deployment, but come with no guarantees w.r.t code stability or branch consistency (i.e. they could deleted).

Tagged releases (e.g. v2.4.7) come straight from plain vanilla open5gs and can be considered a "starting off point" for our modifications. The corresponding branch with _althea at the end (e.g. v2.4.7_althea) is a tightly-curated (and sometimes rebased) branch that is designed to be easy for the open5gs community to read/follow. Whereas main might have multiple commits for a given feature as we expand utility over time and find/catch bugs, the _althea branch will have just one commit for a given issue.

Number of Served TAC/TAI

open5gs has a limit of 16 different served TAIs hard-coded in OGS_MAX_NUM_OF_SERVED_TAI. Althea's KeyLTE architecture relies on many more than that: each edge KeyLTE router has its own TAC/TAI. We have currently set OGS_MAX_NUM_OF_SERVED_TAI to 256; this might increase again in the future.

PFCP Send_ASR Option

When configuring a node's PFCP connection to another node, you now have the option of adding send_asr: false to the configuration yaml. This bool (which defaults to true) indicates whether the node should send PFCP AssociationSetupRequests or not.

The reason we need this bool/option is to turn it off for the CPS side. To allow KeyLTE routers to be seamlessly added to the existing CPS without requiring a reboot, we have to define all 256 served TAIs in the CPS configuration. Without this option, the CPS logs are full of errors trying to send ASR messages to KeyLTE routers that don't yet exist.

Metrics Exported

We export metrics the same basic way the Linux Kernel exposes information in /proc: by writing variables as named files under the directory /tmp/open5gs/, and overwriting/updating the files as these values change over time. Reading the content of these files should always give you the most up-to-date value of the variable in question.

The files {service}_start_time (e.g. /tmp/open5gs/mme_start_time) are comprised of two lines. The first line is the date-time parsed for human readibility (e.g. Mon Jul 12 16:32:00 2021) and the second line is the raw seconds since the Unix epoch (e.g. 1626107520).

Each service also has its own subdirectory (e.g. /tmp/open5gs/mme/) that contains exports other information/values. The files with a num in the front (e.g. /tmp/open5gs/mme/num_enbs) contain a single number that indicates how many of that item the service is connected to. The files with a list in front (e.g. /tmp/open5gs/mme/list_enbs) contains more information about each of those connected items. Each item has its own line (i.e. the number of lines in list_enbs should equal num_enbs), and each line has a series of key-value information separated by spaces (e.g. ip:10.0.0.2 tac:2).

The reason I chose to use files is beacuse it's Unix-esque, it's completely agnostic to any specific network monitoring platform, and it should be easy to write a shim for whatever platform you want to integrate against. If you or your org have specific metrics you would like to see exposed, please reach out to me (or just issue a PR) and I will add them.

Crash-Proof PFCP

In our specific deployment context, we lean heavily on the CUPS split and locate the user-plane-server (sgwc and upf) far from the rest of the core (mme, sgwc, and smf). We often see UPS nodes crash, drop messages, or lose communication for extended periods of time, and as a result we needed to substantially harden the PFCP interface against these conditions. This hardening takes two main forms, detailed below:

Idempotent PFCP Operations:

Wherever possible, we have changed PFCP messages/operations from an action-based model to a state-based one, with the understanding/assumption that the CPS is always authoritative/correct over the UPS. In this design, the UPS should use messages to infer the state that the CPS wants, and silently recover into this state if able. For Session Establishment messages, this means that if the UPS already has an existing session for the given SEID, it should simply wipe out the preexisting session, create a new one according to the CPS details, and return OGS_PFCP_CAUSE_REQUEST_ACCEPTED. Similarly, for Session Delete messages where the SEID does not exist, the UPS can return OGS_PFCP_CAUSE_REQUEST_ACCEPTED without doing anything.

PFCP Session Re-Establishment:

When a UPS re-associates itself with the CPS after a period of disconnectivity, their respective states may have diverged substantially. We handle this using a reassociation process wherein (1) the CPS sends a Session-Set-Delete message, effectively instructing the UPS to delete any/all current sessions, and then (2) the CPS re-sends a Session Establishment message for each active session. This creates a bit more chatter over the wire than you might expect, but works incredibly well in our context.

Fine-Grained Timers

Stock open5gs has one configurable parameter (message.duration) which sets the timeout value for all messages sent or received by the program in question. We turned this parameter into several different ones pertaining to each message protocol to allow us to have finer-grained control over these timers, which is highly recommended by the 3GPP. Specifically, message.duration has been replaced by message.sbi_duration, message.gtp_duration, message.pfcp_duration and message.diameter_timeout.

Stability Fixes

We have caught and fixed a large number of small bugs that threaten stability, generally asserts() that are not always true. Our team is firmly committed to contributing all such fixes to the main open5gs project, and these commits are either already upstreamed or will be soon.

About

Open5GS is a C-language Open Source implementation for 5G Core and EPC, i.e. the core network of LTE/NR network (Release-16)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 97.8%
  • JavaScript 0.6%
  • Meson 0.6%
  • Python 0.5%
  • Mustache 0.4%
  • Shell 0.1%