Section 2. Installing Radiator SIM Module

2. Installing Radiator SIM Module

This section the describes how to install Radiator SIM Module.

2.1. Prerequisites

The prerequisites for Radiator 3GPP AAA Server are described in its reference manual. To be able to install Radiator SIM module, your system must meet these prerequisites

Radiator 4.26 or later is recommended. Absolute minimum is Radiator 4.14.
If you need LocalAddress or LocalPort parameters, you must have Radiator 4.17 or later.
Radiator Carrier module 1.7 or later is recommended.
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
- Convert::ASN1 version 0.26 or later, if you need SIGTRAN <PeerSP> support

2.2. Required setup for testing

To test the Radiator SIM module after installation, you must have the following equipment and information available:

Diameter peering information for Radiator <--> HSS/DRA connection:
- Radiator configuration requires Diameter identity (Origin-Host and Origin-Realm) that identifies Radiator to the other Diameter nodes
- The IP and port of Diameter peer Radiator connects to, this is the HSS/DRA IP address and port
- TCP/SCTP (transport protocol) the peering uses
- DestinationHost and DestinationRealm can be set initially to choose a HSS/DRA to send the request to
- See more information from example configurations in goodies directory, for example goodies/eap_aka_wx.cfg
Certificate for Radiator if Diameter peering uses TLS
- Radiator can use TLS but doesn't require it
Radius client, such as WLAN controller or stand-alone WLAN Access Point, settings
- Radiator needs to know the IP address and the shared secret so that it knows from where the Radius requests are received.
A test device(s) with a SIM card that's known to HSS
- Android devices can be configured manually. Apple devices need a profile that can be built with Apple Configurator software available on Macs from App Store.

2.3. Installing and upgrading

This section provides instructions for installing and upgrading Radiator SIM Module. Radiator SIM Module is available for a wide range of platforms and the installation procedure depends on the platform and the type of package selected.

2.3.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 one of the following configuration files:
- /opt/radiator/radiator-sim/goodies/eap_sim_wx.cfg
- /opt/radiator/radiator-sim/goodies/eap_aka_wx.cfg
- /opt/radiator/radiator-sim/goodies/eap_sim_map.cfg
- /opt/radiator/radiator-sim/goodies/eap_aka_map.cfg
Configure Radiator HSS emulator file (/opt/radiator/radiator-sim/goodies/wxmap.cfg), or connect to the HSS over SWx, Cx or Wx, or connect to the HLR over SIGTRAN.
Run Radiator with the configuration file developed in the step 3.
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.3.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 one of the following configuration files:
- /opt/radiator/radiator-sim/goodies/eap_sim_wx.cfg
- /opt/radiator/radiator-sim/goodies/eap_aka_wx.cfg
- /opt/radiator/radiator-sim/goodies/eap_sim_map.cfg
- /opt/radiator/radiator-sim/goodies/eap_aka_map.cfg
Configure Radiator HSS emulator file (/opt/radiator/radiator-sim/goodies/wxmap.cfg), or connect to the HSS over SWx, Cx or Wx, or connect to the HLR over SIGTRAN.
Run Radiator with the configuration file developed in the step 3.
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.3.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 one of the following configuration files:
- goodies/eap_sim_wx.cfg
- goodies/eap_aka_wx.cfg
- goodies/eap_sim_map.cfg
- goodies/eap_aka_map.cfg
Configure Radiator HSS emulator file (goodies/wxmap.cfg), or connect to the HSS over SWx, Cx or Wx, or connect to the HLR over SIGTRAN.
Run Radiator with the configuration file developed in the step 6.
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.3.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.