Section 2. Installing Radiator 3GPP AAA Server

2. Installing Radiator 3GPP AAA Server

This section describes how to install Radiator 3GPP AAA Server.

For installing Radiator 3GPP AAA Server, you need a database with sample tables created from goodies/3gpp-aaa-server-mysql.sql. Other types of databases and alternative database schemas are also supported.

2.1. Prerequisites

To be able to install Radiator 3GPP AAA Server, your system must meet these prerequisites:

Radiator 4.26 or later.
Radiator Carrier module 1.7 or later.
Radius::UtilXS 2.2 or later is recommended.
SCTP multihoming requires Radiator Radius::UtilXS module.
IMSI encryption requires Radiator Radius::UtilXS module 2.0 or later.
The following Perl modules:
- DBI
- Digest::SHA - Typically already installed with system Perl

2.2. Installing and upgrading

This section provides instructions for installing and upgrading Radiator 3GPP AAA Server, which is part of the Radiator SIM Module.

2.2.1. Installing and upgrading on Linux: Red Hat Enterprise Linux, CentOS, Oracle Linux, AlmaLinux and Rocky Linux

These packages have been tested on Red Hat Enterprise Linux 7, 8 and 9, and compatible systems such as CentOS, Oracle Linux, AlmaLinux and Rocky Linux.

To install Radiator SIM Module:

Download the distribution package for your operating system from Radiator downloads
Install the package. On RHEL 7 and compatible systems use package that ends with el7.noarch.rpm:
```
sudo yum install ./radiator-sim-x.yy-nn.el7.noarch.rpm
```
On RHEL 8 and compatible systems use package that ends with el8.noarch.rpm:
```
sudo yum install ./radiator-sim-x.yy-nn.el8.noarch.rpm
```
On RHEL 9 and compatible systems use package that ends with el9.noarch.rpm:
```
sudo yum install ./radiator-sim-x.yy-nn.el9.noarch.rpm
```
Build a Radiator configuration file based on /opt/radiator/radiator-sim/goodies/3gpp-aaa-server.cfg.
Configure Radiator HSS (Home Subscriber Server) emulator file (/opt/radiator/radiator-sim/goodies/server_hss.cfg) or connect to the HSS over SWx.
Run Radiator with the configuration file developed in the step 3.
Test and refine the configuration file. For more information, see Testing Radiator 3GPP AAA Server.
Restart Radiator:
```
sudo systemctl restart radiator
```
Set Radiator to start automatically when booting. For more information, see Radiator reference manual .

See /opt/radiator/radiator-sim/goodies/ for more Radiator SIM Module configuration samples.

Upgrading from an el7, el8 or el9 RPM

Upgrades between el7 and el8 and el8 and el9 packages do not require any special commands. Use yum install or any other commands that you typically use to upgrade packages. Note: remember to restart radiator after each upgrade.

2.2.2. Installing and upgrading on Linux: Ubuntu and Debian

These packages have been tested on Ubuntu 16.04, 18.04, 20.04, 22.04 and Debian 9, 10, 11 and 12.

To install Radiator SIM Module:

Download the distribution package for your operating system from Radiator downloads
Install the package. On Ubuntu 16.04, 18.04, 20.04, 22.04 and Debian 9 (Stretch), 10 (Buster), 11 (Bullseye) or 12 (Bookworm) the package is named as radiator-sim_x.yy-nn_all.deb:
```
sudo apt install ./radiator-sim_x.yy-nn_all.deb
```
Build a Radiator configuration file based on /opt/radiator/radiator-sim/goodies/3gpp-aaa-server.cfg.
Configure Radiator HSS emulator file (/opt/radiator/radiator-sim/goodies/server_hss.cfg) or connect to the HSS over SWx.
Run Radiator with the configuration file developed in the step 3.
Test and refine the configuration file. For more information, see Testing Radiator 3GPP AAA Server.
Restart Radiator:
```
sudo systemctl restart radiator
```
Set Radiator to start automatically when booting. For more information, see Radiator reference manual .

See /opt/radiator/radiator-sim/goodies/ for Radiator SIM Module configuration samples.

Upgrading from a deb

Upgrades between deb packages do not require any special commands. Use

apt
                     install

or any other commands that you typically use to upgrade packages. Note: remember to restart radiator after each upgrade.

2.2.3. Installing and upgrading with source code package

Also known as the tar or tgz package, this is the general and widely portable procedure for installing Radiator SIM Module. However, a number of platform-specific installation methods are also available.

The Radiator SIM Module source code is supplied as a gzipped, tarred package. The standard distribution file name is Radius-EAP-SIM-x.yy-nn.tgz, where "x.yy-nn" is the revision number.

Download the source code package from Radiator downloads and save it to somewhere suitable, such as /usr/local/src/.
Unpack the source code package as follows:
```
tar xvf Radius-EAP-SIM-x.yy-nn.tgz
```
Unpacking creates a directory Radius-EAP-SIM-x.yy-nn into the current directory:
```
cd Radius-EAP-SIM-x.yy-nn
```
Prepare the distribution for installation:
```
perl Makefile.PL
```
Run the installation. You may need the root access rights for running this command:
```
make install
```
Build a Radiator configuration file based on goodies/3gpp-aaa-server.cfg.
Configure Radiator HSS emulator file (goodies/server_hss.cfg) or connect to the HSS over SWx.
Run Radiator with the configuration file developed in the step 6.
Test and refine the configuration file. For more information, see Testing Radiator 3GPP AAA Server.
Set Radiator to start automatically when booting. For more information, see Radiator reference manual .

Upgrading

To upgrade Radiator SIM Module with .tgz package, repeat the installation using the new distribution package file. The files in the new distribution will overwrite any files in the old distribution.

2.2.4. Installing and upgrading from repository

Follow the installation instructions from Radiator SIM repository pages available in Radiator Linux package repositories

Upgrading from repository

Upgrades from repository do not require any special commands, use commands that you typically use to upgrade packages. Note: remember to restart radiator after each upgrade.