https://github.com/opennetworkinglab/aether-5gc
https://github.com/opennetworkinglab/aether-5gc
Last synced: 8 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/opennetworkinglab/aether-5gc
- Owner: opennetworkinglab
- License: apache-2.0
- Created: 2023-07-26T15:31:59.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-09-23T23:23:41.000Z (8 months ago)
- Last Synced: 2025-09-24T01:18:49.454Z (8 months ago)
- Language: Makefile
- Size: 223 KB
- Stars: 8
- Watchers: 5
- Forks: 16
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 5gc
The 5gc repository builds a standalone Aether core with a physical RAN setup.
It depends a k8 cluster which can be deployed using k8 repository that can help to create a multi-node cluster.
To set up the 5gc repository, you need to provide the following:
1. Node configurations with IP addresses in the host.ini file.
- You can specify both master and worker nodes.
2. Aether configuration parameters, such as RAN_Interface, in the ./var/main.yaml file.
To download the 5gc repository, use the following command:
```
git clone https://gitlab.com/onf-internship/5gc.git
git clone https://gitlab.com/onf-internship/k8s.git
```
### Step-by-Step Installation
To install the 5g-core, follow these steps:
1. Set the configuration variables in the vars/main.yaml file.
- Set the "standalone" parameter to deploy the core independently from roc.
- Specify the "data_iface" parameter as the network interface name of the machine.
- Set the "values_file" parameter:
- Use "sdcore-5g-values.yaml" for a stateful 5g core.
- Use "hpa-5g-values.yaml" for a stateless 5g core.
- The "custom_ran_subnet" parameter if left empty, core will use the subnet of "data_iface" for UPF.
2. Add the hosts to the init file.
3. Run `make ansible`.
4. In the running Ansible docker terminal:
- Make sure you have dployed a k8 cluster using `k8s-install` from k8s repo.
- run `make 5gc-install`
- It creates networking interfaces for UPF, such as access/core, using `5gc-router-install`.
- Finally, it installs the 5g core using the values specified in `5gc-core-install`.
- The installation process may take up to 3 minutes.
#### One-Step Installation
To install 5gc in one go, run `make 5gc-install`.
#### Uninstall
- run `make 5gc-uninstall`