Version: Next

Build and install a magma package in AGW

Description

The purpose of this document is to describe how to build and install a magma package in AGW.

AGW

Note that the following is supported starting with magma v1.9. For older versions see respective documentation.

Clone or Update your local repository. In any machine (i.e. your computer) clone the magma repo (and switch to the branch you want to build).
```
git clone https://github.com/magma/magma.git
```
Install prerequisites. Make sure you have installed all the tools specified in the prerequisites
Build and create deb package. To build an AGW package spin up a vagrant machine and then build and create a deb package.

From $MAGMA_ROOT/lte/gateway on your host machine run:
```
vagrant up magma
vagrant ssh magma
```
In the VM from $MAGMA_ROOT run:
```
bazel run //lte/gateway/release:release_build --config=production
```
To create a package for development or testing, run
```
bazel run //lte/gateway/release:release_build
```
Omitting the --config=production flag will compile all C++ services with Debug compiler flags and enable ASAN. This is recommended for testing only as it will impact performance. In contrast, the production package has C++ services built with RelWithDebInfo compiler flags.
Locate the packages. Once the above command finished you can find the packages inside the VM:
```
cd /tmp/packages
```
There should be two packages named magma_1.9.XXX and magma-sctpd_1.9.XXX (for v1.9 versions).
Copy the packages to the target machine.
Install the package. In order to install the new deb package in AGW, you can run
```
sudo apt -f install MAGMA_PACKAGE
```

Restart the magma services

sudo service magma@* stop
sudo service magma@magmad restart