Section 2. Installing Radiator Policy and Charging Module

2. Installing Radiator Policy and Charging Module

Radiator runs on a wide range of platforms. The installation procedure depends on the platform and the type of package selected.

Start by installing Radiator. See the Radiator reference manual

for the installation instructions. When Radiator has been installed, proceed with Radiator Policy and Charging Module installation.

2.1. Prerequisites

The prerequisites for Radiator and Radiator Policy and Charging Module support are defined in the Radiator reference manual

.

If you require Radiator SIM Pack for EAP-SIM (Extensible Authentication Protocol - Subscriber Identity Module), EAP-AKA (Extensible Authentication Protocol - Authentication and Key Agreement) or EAP-AKA' (Extensible Authentication Protocol - Authentication and Key Agreement Prime), see the Radiator SIM module reference manual

for the installation instructions.

2.2. Installing and upgrading Radiator Policy and Charging Module

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

See Radiator documentation

for additional installation topics, such as container installation, management with Ansible, package and repository download location, and post-installation and troubleshooting instructions.

Start by installing Radiator as described the Radiator reference manual

If you plan to use Radiator as an OCS or a PCRF, you need to also install the Radiator Service Provider 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 Policy and Charging 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-policy-charging-x.yy-nn.el7.noarch.rpm
```
On RHEL 8 and compatible systems use package that ends with el8.noarch.rpm:
```
sudo yum install ./radiator-policy-charging-x.yy-nn.el8.noarch.rpm
```
On RHEL 9 and compatible systems use package that ends with el9.noarch.rpm:
```
sudo yum install ./radiator-policy-charging-x.yy-nn.el9.noarch.rpm
```
Build a Radiator configuration file based on the examples in /opt/radiator/radiator-policy-charging/goodies/*.cfg.
Prepare your desired Diameter application, such as PCRF (Policy and Charging Rules Function) or PCEF (Policy and Charging Enforcement Function) to use Radiator.
Restart Radiator:
```
sudo systemctl restart radiator
```
Set Radiator to start automatically when booting. For more information, see Radiator reference manual .

See /opt/radiator/radiator-policy-charging/goodies/ for Radiator Policy and Charging 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 Policy and Charging 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-policy-charging_x.yy-nn_all.deb:
```
sudo apt install ./radiator-policy-charging_x.yy-nn_all.deb
```
Build a Radiator configuration file based on the examples in /opt/radiator/radiator-policy-charging/goodies/*.cfg.
Prepare your desired Diameter application, such as PCRF or PCEF to use Radiator.
Restart Radiator:
```
sudo systemctl restart radiator
```
Set Radiator to start automatically when booting. For more information, see Radiator reference manual .

See /opt/radiator/radiator-policy-charging/goodies/ for Radiator Policy and Charging 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 Policy and Charging Module. However, a number of platform-specific installation methods are also available.

The source code is supplied as a gzipped, tarred package. The standard distribution file name is Radius-Policy-Charging-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-Policy-Charging-x.yy-nn.tgz

Unpacking creates a directory Radius-Policy-Charging-x.yy-nn into the current directory:
```
cd Radius-Policy-Charging-x.yy-nn
```
Prepare the distribution for installation:
```
perl Makefile.PL
```
Run the installation:
```
sudo make install
```
Build a Radiator configuration file based on the examples in goodies/*.cfg.
Prepare your desired Diameter application, such as PCRF or PCEF to use Radiator.
Run Radiator with the configuration file developed above.
Test and refine the configuration file.
Set Radiator to start automatically when booting. For more information, see Radiator reference manual .

Upgrading

To upgrade Radiator Policy and Charging 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 Policy and Charging 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.