1.5.X

For Installing AGW on Ubuntu refer to : deploy_on_ubuntu

Install Access Gateway (Bare Metal)

Prerequisites

To setup a Magma Access Gateway, you will need a machine that satisfies the following requirements:

  • AGW_HOST: 64bit-X86 machine, hardware strongly recommended (not virtualized). You will need two ethernet ports. We use enp1s0 and enp2s0 in this guide. They might have different names on your hardware so just replace enp1s0 and enp2s0 with your current interfaces name in this guideline. One port is for the SGi interface (default: enp1s0) and one for the S1 interface (default: enp2s0). Note that the agw_install.sh script will rename the enp1s0 interface to eth0.

Deployment

1. Create boot USB stick and install Debian on your AGW host

  • Download .iso image from Debian mirror
  • Create bootable usb using etcher tutorial here
  • Boot your AGW host from USB (Press F11 to select boot sequence, :warning: This might be different for your machine). If you see 2 options to boot from USB, select the non-UEFI option.
  • Install and configure you access gateway according to your network defaults.
    • Make sure to enable ssh server and utilities (untick every other)
  • Connect your SGi interface to the internet and select this port during the installation process to get an IP using DHCP.

2. Deploy magma on the AGW_HOST

Run AGW installation

su
wget https://raw.githubusercontent.com/magma/magma/v1.5.3/lte/gateway/deploy/agw_install.sh
bash agw_install.sh

The script will run a pre-check script that will prompt you what will change on your machine. If you're okay with those changes reply yes and magma will be installed. If no is replied It will stop the installation.

  - Check if Debian is installed
  Debian is installed
  - Check for correct Linux Headers
  New Linux Headers will be Installed
  - Check for magma user
  magma user is not Installed
  - Check if both interfaces are named eth0 and eth1
  Interfaces will be renamed to eth0 and eth1
  eth0 will be set to dhcp and eth1 10.0.2.1
  Do you accept those modifications and want to proceed with magma installation?(y/n)
  Please answer yes or no.

The machine will reboot but It's not finished yet, the script is still running in the background. You can follow the output there

journalctl -fu agw_installation

When you see "AGW installation is done." It means that your AGW installation is done, you can make sure magma is running by executing:

service magma@* status

Post Install Check

cd ~/magma/lte/gateway/deploy
./agw_post_install.sh
← OverviewNext →