Skip to content
This repository has been archived by the owner on Nov 3, 2023. It is now read-only.

canonical/magma-access-gateway-snap

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

72 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

access gateway badge


Magma Access Gateway Snap

Get it from the Snap Store

Don't have snapd installed?

Description

Magma is an open-source software platform that gives network operators a mobile core network solution. Magma has three major components:

  1. Access Gateway
  2. Orchestrator
  3. 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).

System requirements

Hardware (baremetal strongly recommended)

  • 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.

Networking

  • At least two ethernet interfaces (SGi and S1)
  • Internet connectivity from SGi interface

Operating System

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

Usage

All actions in this guide are executed using root account.

1. Install

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.install

NOTE: 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 use journalctl to 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.

2. Configure

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.

3. Verify the deployment

Run the following command:

magma-access-gateway.post-install

Successful Magma AGW deployment check will be indicated by the Magma AGW post-installation checks finished successfully. message.

Contributing

Please see CONTRIBUTING.md for developer guidance.

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •