Background / Context

For a proper creation of the peering network in eCDN mode, our Peering Manager component requires the local IP address of each participant from the stream’s audience.

This can be achieved in two ways:

  • Place a Peering Manager instance within the local network

  • Disable mDNS for specific URLs in the client’s browser

This article will describe the first mentioned variant.


Server Requirements

CPU requirements

At least 6 cores

RAM requirements

At least 8 GB

Operating system requirements

Supported operating systems:

  • RHEL (version 7+)

  • CentOS (version 7+)

  • Debian

  • Ubuntu

Other OS might take additional setup and testing effort with additional cost.

Network requirements

Full HTTPS (port 443) connectivity from Peering Manager to:

  • *.strivetech.io

  • *.strivecast.com

Support internal connections from clients to the Peering Manager via WSS/HTTPS

If wildcard whitelisting is not supported, we can provide you with specified domains or IP addresses.

Server authentication requirements

  • SSL certificate for HTTPS

  • Internal DNS entry

OPTIONAL: Application log requirements

Full HTTPS (port 443) connectivity from Peering Manager to:

  • logging.googleapis.com

This feature allows the StriveCast team to view the application log remotely which helps us trobuleshooting.

User Requirements

  • SSH access to the server

  • sudo rights or root access to the server

Who should use this document?

Network administrators, responsible for the server architecture of the organization aiming to use StriveCast eCDN.


Installation

Your Technical Account Manager will provide you with the latest installation package based on your OS. Upload the .deb or .rpm package to the server and install the package with the distribution’s default package manager.

  • Debian/Ubuntu

sudo apt-get install /path/to/strivecast-p2pdn-tracker_$Version_linux_amd64.deb
BASH
  • RHEL/CentOS

sudo yum install strivecast-p2pdn-tracker_$Version_linux_amd64.rpm
BASH

Do not use the dpkg or rpm tools directly as they will not ensure all required dependencies are installed automatically.

Configuration

After you have finished the installation successfully, the service will be enabled but not active/started. Future reboots will start the service automatically. Before the initial start, you need to adjust some configuration files

SSL Certificate

The Peering Manager only supports secured connections from clients which are ensured by usage of a valid SSL certificate.

If you have a chain certificate, ensure to have the full chain in the certificate you place on the server.

If your organization has its own certificate authority, you can use a self-signed certificate. In this case you need to ensure that the clients trust the certificate.

Option 1: Exchange the dummy files

During the installation, the package will generate two files located in /opt/strivecast/:

  • cert.pem

  • private.key

These are dummy files that you can replace with the actual certificate and corresponding key. In this case, you must not adjust the path to the certificate and key in /opt/strivecast/config.yaml

Option 2: Adjust the path in the configuration file

Alternatively, if the certificate is already on the server or you want to use a different directory, you can do this as well. Is this case, you must adjust the path to the certificate and key in /opt/strivecast/config.yaml

The Peering Manager service will run with a generated strivecast user. Please ensure that the user has at least read rights for the certificate and key.

Configuring the web proxy

If the peering manager needs to connect to the internet through a web proxy, you need to edit the file p2pdn-tracker located in /etc/default/. Uncomment one of the two variables (or both), depending on what kind of proxy server is used, and add the proxy IP address or DNS name. Changes in this file at a later point time in time require a restart of the service to take effect.

Starting the service

Once you have done finished all configuration steps, you can start the service with systemctl start p2pdn-tracker. To verify that the service is running, run systemctl status p2pdn-tracker.

To get more detailed application logs, you can run sudo journalctl -u p2pdn-tracker.

Additional features

You have the possibility to configure the peering manager, that the application log is pushed to cloud storage that is accessible to StriveCast. This helps us to support you with troubleshooting, in case the service is not working as intended. To get more details on how to achieve this, please visit Activate local Peering Manager remote logging.

Frequently asked questions

  • Why does the service need to connect to the internet?
    Although the service is set up to allow local clients to connect, it pulls the SDK configuration from the internet.

Contact us

For any further questions or problems, please reach out any time to support@strivecast.com.