Deploy Charmed Magma Access Gateway

Requirements

The Access Gateway must be installed on an Ubuntu machine with the following specifications:

  • Operating System: Ubuntu 20.04 LTS with Linux Kernel 5.4

  • Processor: x86-64 dual-core processor (around 2GHz clock speed or faster)

  • Memory: 4GB RAM

  • Storage: 32GB or greater SSD

  • Networking: At least two ethernet interfaces using two different subnets (SGi for internet connectivity and S1 for eNodeB connectivity)

Danger

Installing this charm will affect the target computer’s networking configuration. Make sure it is installed on designated hardware (personal computers are strongly discouraged).

Note

Some clouds like AWS use newer kernel versions by default. If you want to downgrade your kernel, please refer to the following guide.

Note

For small networks (i.e. 10 eNodeBs, 10 active subscribers), Magma can produce around 1 GB of logs per week. Most of these logs will go to /var/log/journal. To avoid problems with insufficient disk space, it is recommended to configure log rotation for systemd-journald. For more information please visit Ubuntu manuals.

Install Magma Access Gateway

Deploy Magma Access Gateway:

juju deploy magma-access-gateway-operator --config sgi=enp0s1 --config s1=enp0s2

Note

The interface names will need to be adjusted based on your specific machine.

Create a file called agw_config.yaml that contains the following content:

magma-access-gateway-operator:
  sgi: enp0s1
  sgi-ipv4-address: 192.168.0.2/24
  sgi-ipv4-gateway: 192.168.0.1
  sgi-ipv6-address: fd7d:3797:378b:a502::2/64
  sgi-ipv6-gateway: fd7d:3797:378b:a502::1
  s1: enp0s2
  s1-ipv4-address: 192.168.1.2/24
  s1-ipv6-address: fd7d:3797:378b:a503::2/64
  dns: '["8.8.8.8", "208.67.222.222"]'

Note

The interface names and IP addresses will need to be adjusted based on your specific machine.

Deploy Magma Access Gateway:

juju deploy magma-access-gateway-operator --config agw_config.yaml