Skip to main content
Skip table of contents

Installation

The SMPP Router can be installed on Redhat

or Debian distributions, or derivatives. These instructions provide two options for installing SMPP Router on a server.

Installation - Option A

https://vimeo.com/1091252501?share=copy#t=0

Login to your server and run the following to download and install the latest version of SMPP Router:

CODE
sudo apt update && \
sudo apt install -y tar apache2-utils jq && \
mkdir -p smpprouter && \
cd smpprouter && \
wget https://melroselabs.com/repo/smpprouter/opMLSMPPRouter_latest.tar.gz && \
tar -xzf opMLSMPPRouter_latest.tar.gz && \
sudo ./install.sh

Installation - Option B

Alternatively, follow the below steps for a basic installation: 

  1. Create smpprouter directory under the user directory USERDIR.

  2. Copy opMLSMPPRouter binary into USERDIR/smpprouter directory.

  3. Create configuration smpprouter.conf (see Configuration ).

  4. Create systemd service (updated USER and USERDIR). See Systemd below.

  5. Copy licensing files to USERDIR/smpprouter directory (license.json, license.sig). See Licensing for how to obtain licensing files.

  6. Reboot host.

 The SMPP Router will automatically start when the host has rebooted.

Optionally, the service can be configured to automatically restart in the event of a failure.

Ports

Open the following inward ports for operation of the SMPP Router.

Ports

Purpose

Notes

2775

SMPP connections from ESMEs (clients)

Changeable in configuration.

80

443

HTTP(S) API for management

Prometheus metrics (/metrics)

Changeable in configuration.

HTTPS requires stunnel setup. See TLS.

22

SSH access to host

Systemd

CODE
sudo vi /etc/systemd/system/mlsmpprouter
CODE
[Unit]
Description=Melrose Labs SMPP Router
After=network.target
After=systemd-user-sessions.service
After=network-online.target
[Service]
User=USER
Group=USER
Type=simple
WorkingDirectory=USERDIR/smpprouter
ExecStart=USERDIR/smpprouter/opMLSMPPRouter
ExecStop=/bin/kill -INT $MAINPID
[Install]
WantedBy=multi-user.target
CODE
sudo chmod u+x /etc/systemd/system/mlsmpprouter.service
sudo setcap 'cap_net_bind_service=+ep' USERDIR/smpprouter/opMLSMPPRouter
sudo systemctl enable mlsmpprouter

 

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.