Magma is an open-source software platform that gives network operators a mobile core network solution. Magma has three major components:
- Access Gateway
- Orchestrator
- Federation Gateway
The Access Gateway (AGW) provides network services and policy enforcement. In an LTE network,
the AGW implements an evolved packet core (EPC), and a combination of an AAA and a PGW. It works
with existing, unmodified commercial radio hardware.
For more information on Magma please visit the official website.
⚠️ Installing this snap will affect your computer's networking configuration. Make sure it is installed on designated hardware (personal computers are strongly discouraged).
- Processor: x86-64 dual-core processor (around 2GHz clock speed or faster)
- Memory: 4GB RAM
- Storage: 32GB or greater SSD
NOTE: For small networks (i.e. 10 eNBs, 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.
- At least two ethernet interfaces (SGi and S1)
- Internet connectivity from SGi interface
- Ubuntu 20.04 LTS (Ubuntu installation guide)
- Linux Kernel version
5.4
⚠️ Some clouds like AWS use newer kernel versions by default. If you want to downgrade your kernel, please refer to the following guide.
All actions in this guide are executed using root account.
Connect to the machine where you want to install Magma Access Gateway and execute the following commands:
snap install magma-access-gateway --classic
magma-access-gateway.installNOTE: To see the list of currently supported installation options, execute:
magma-access-gateway.install --help
NOTE: By default, the installation assumes DHCP for IP allocation. If statically allocated IPs have been explicitly specified in the configuration options, the system will
restart to apply new network configuration. Once the server is restarted, reconnect to the system and usejournalctlto continue monitoring the installation process.
Successful installation will be indicated by the Magma AGW deployment completed successfully! message.
After successful Access Gateway installation, installer will perform automatic system restart. Once the server is restarted, reconnect to the system to perform AGW configuration.
Fetch rootCA.pem certificate from Orchestrator, upload it to the Access Gateway host and execute:
magma-access-gateway.configure --domain <Orc8r domain> --root-ca-pem-path <path to Root CA PEM>Successful Magma AGW configuration will be indicated by the Magma AGW configuration done!
message.
Run the following command:
magma-access-gateway.post-installSuccessful Magma AGW deployment check will be indicated by the Magma AGW post-installation checks finished successfully. message.
Please see CONTRIBUTING.md for developer guidance.