Traffic Portal Administration

Traffic Portal is only supported on CentOS Linux distributions version 7.x and 8.x. It runs on NodeJS and requires version 12 or higher.

Installing Traffic Portal

  1. Download the Traffic Portal RPM from Apache Jenkins or build the Traffic Portal RPM from source using the instructions in Building Traffic Control.

  2. Copy the Traffic Portal RPM to your server

  3. Install NodeJS. This can be done by building it from source, installing with yum(8) if it happens to be in your available repositories (at version 12+), or using the NodeSource setup script.

    #49 Installing NodeJS using the NodeSource Setup Script
    curl --silent --location https://rpm.nodesource.com/setup_12.x | sudo bash -

  4. Install the Traffic Portal RPM with yum(8) or rpm(8) e.g. by running yum install path/to/traffic_portal.rpm as the root user or with sudo(8).

Configuring Traffic Portal

  • update /etc/traffic_portal/conf/config.js (if Traffic Portal is being upgraded, reconcile config.js with config.js.rpmnew and then delete config.js.rpmnew)

  • update /opt/traffic_portal/public/traffic_portal_properties.json (if Traffic Portal is being upgraded, reconcile traffic_portal_properties.json with traffic_portal_properties.json.rpmnew and then delete traffic_portal_properties.json.rpmnew)

  • Optional: update /opt/traffic_portal/public/resources/assets/css/custom.css to customize Traffic Portal styling.

Configuring OAuth Through Traffic Portal

See Configure OAuth Login.

Starting Traffic Portal

The Traffic Portal RPM comes with a systemd(1) unit file, so under normal circumstances Traffic Portal may be started with systemctl(1).

#50 Starting Traffic Portal
systemctl start traffic_portal

Stopping Traffic Portal

The Traffic Portal RPM comes with a systemd(1) unit file, so under normal circumstances Traffic Portal may be stopped with systemctl(1).

#51 Stopping Traffic Portal
systemctl stop traffic_portal