Quick Start

The purpose of Quick Start section is to make you introduction to Niostreamer server and get live scenarios up and running.

  1. Install Niostreamer instance
  2. Create web control panel account
  3. Register Niostreamer instance

Install Niostreamer instance

The first step is to install the latest version of Niostreamer packet on you hardware. Currently Niostreamer distribution is provided for RHEL OS family as RPM packet. Installation is pretty simple, details are described in Install Niostreamer instance section.

We are going to install Niostreamer RPM for CentOS 7.

First, setup niostreamer repository by creating file /etc/yum.repos.d/niostreamer.repo with the following content:

[niostreamer-release]
name=niostreamer stable - $basearch
baseurl=https://repo.niostreamer.com/release/centos/7/$basearch
enabled=1
gpgcheck=1
gpgkey=https://repo.niostreamer.com/RPM-GPG-KEY-niostreamer

Run sudo yum install niostreamer to install Niostreamer package.

Installer ask you about installation of GPG key, answer Yes:

Retrieving key from https://repo.niostreamer.com/RPM-GPG-KEY-niostreamer
Importing GPG key 0x404F9F2A:
Userid     : "niostreamer \"
Fingerprint: 2f03 f5e9 3af6 728d 4fd0 e8c8 eb72 675a 404f 9f2a
From       : https://repo.niostreamer.com/RPM-GPG-KEY-niostreamer
Is this ok [y/N]: y

Niostreamer is installed. Run sudo systemctl enable niostreamer to enable service.

Run sudo systemctl start niostreamer to start Niostreamer.

Run sudo systemctl status niostreamer to verify Niostreamer is started:

● niostreamer.service - Niostreamer media server
Loaded: loaded (/usr/lib/systemd/system/niostreamer.service; enabled; vendor preset: disabled)
Active: active (running) since Fri 2020-03-27 13:11:16 UTC; 2s ago
Main PID: 3996 (niostreamer)
Tasks: 6
Memory: 596.0K
CGroup: /system.slice/niostreamer.service
└─3996 /usr/sbin/niostreamer -c /etc/niostreamer/niostreamer.conf

Register instance in web control panel

The best way to setup, configure and monitor your new Niostreamer instance is to use web control panel for that.

Please register a new account to proceed.

Sign into your account. You will see empty dashboard as there are no server instances registered yet:

Dashboard

Server instance you just installed in previous step is up and running, but it has not been connected to web panel.

Registration is pretty simple. When you start you instance first time you will see in logs:

2021-07-04 15:18:30.143799 info Niostreamer version: 0.1.256
2021-07-04 15:18:30.154345 info [geoip] File /etc/niostreamer/conf.d/GeoLite2-Country.mmdb does not exist. Skipping
2021-07-04 15:18:30.187350 info [geoip] File /etc/niostreamer/conf.d/GeoLite2-ASN.mmdb does not exist. Skipping
2021-07-04 15:18:30.188416 info [http-server] server started: 0.0.0.0:8080
2021-07-04 15:18:30.188455 info [core] VHost 'http-instance-api' started
2021-07-04 15:18:30.202712 error [saas-manager] Cannot open settings file: bad file descriptor. Ignore.
2021-07-04 15:18:31.147608 info [saas] This instance is not registered.

|
| To register instance in control panel please follow the steps:
|
| 1. Log into your account on https://niostreamer.com
| 2. Copy and open this link to activate instance: https://niostreamer.com/activate?token=XVXXSBCSCS6P3BVGRKSTPAQKRTCZJIF4R0A2HIJJ
|

2021-07-04 15:20:56.432473 info [saas] Instance has been registered in control panel
2021-07-04 15:21:10.342530 info [saas] First sync received

The only step you should do is to open a provided link in Step 2. in you browser while being logged in niostreamer account. Once done the rest of steps will happened automatically:

Dashboard

Instance will be registered and will appear in dashboard immediately:

API keys