5gc

The 5gc repository builds a standalone Aether core with a physical RAN setup. It depends on a k8s cluster, which can be deployed using the k8s repository 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 hosts.ini file.
   • You can specify both master and worker nodes.
2. Aether configuration parameters, such as data_iface, in the ./vars/main.yml file.

To download the 5gc repository, use the following command:

git clone https://github.com/omec-project/aether-5gc.git

To download the k8s repository used to provision the cluster, use:

git clone https://github.com/omec-project/aether-k8s.git

Step-by-Step Installation

To install the 5g-core, follow these steps:

1. Set the configuration variables in the vars/main.yml 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 "roles/core/templates/sdcore-5g-values.yaml" for a stateful 5g core.
     • Use "roles/core/templates/radio-5g-values.yaml" or "roles/core/templates/sdcore-5g-sriov-values.yaml" for alternative deployment profiles.
   • If the core.ran_subnet parameter is left empty, the core will use the subnet of "data_iface" for UPF.
2. Add the hosts to hosts.ini.
3. Run make ansible.
4. In the running Ansible docker terminal:
   • Make sure you have deployed a k8s cluster using k8s-install from the 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