Configuring Quickstream Node

Configuring Quickstream Node


Initial configuration 

Linux 

To configure Quickstream Node please run the following command: 

$ quickstream-node-setup

Next select one of the following options:

1) set Node owner in Cloud, to enable Cloud Node administration

This option allows you to connect Quickstream Node to Quickstream Cloud. Please enter your login and password to Quickstream Cloud. If you do not have an account please register at cloud.quickstream.tech

2) remove Node owner in Cloud

To disconnect your Quickstream Node from the Quickstream Cloud please press 2. You will no longer be able to manage the Node from Quickstream Cloud.

3) create / change password to enable Qs-Client connections

By default a new installation of Quickstream Node does not have any management password  To be able to connect to Quickstream Node with Quickstream Client please select option 3 and enter your new password.  This options also allows you to change your existing password. 

4) download and install trial license

This option allows to download and install trial license for your Quickstream Node 

5) download and install all licenses available for this Node

If you purchased a license that Is generated for your Quickstream Node this option will allow to download it and install in your Quickstream Node database. 

6) change Node name (current: 'your-hostname1')

After pressing 6 you can change your Quickstream Node name. By default Quickstream Node name is the same as the operating system hostname. The same name will appear in Quickstream Cloud when you login to your web interface.  

0) quit setup

This option ends the setup and exits to the command line. 

Windows 

After installing Quickstream Node on Windows please right click on the Quickstream icon in the taskbar. The following context menu will show.



The menu has the following positions starting from top 
1. Status of connection from Quickstream Setup application to your local Quickstream Node status (green - connected, red - disconnected) 
2. Status of Quickstream Node connection to the Quickstream Cloud (green - connected, red - disconnected)
3. Status of the Quickstream Node service. You can change the status by clicking on the status 
4. Channels. The list of channels configured on the Node 
5. Change hostname - allow to change the name of Quickstream Node. The name is visible also in the list of Nodes in Quickstream Cloud 
6. Set node Owner - allows to connect Quickstream Node to Cloid. 
7. Remove node owner in Cloud - To disconnect your Quickstream Node from the Quickstream Cloud please press 2. You will no longer be able to manage the Node from Quickstream Cloud.
8. Add or change local Node password - by default a new installation of Quickstream Node does not have any management password  To be able to connect to Quickstream Node with Quickstream Client please select option 3 and enter your new password.  This options also allows you to change your existing password. 
9. Get a trial license  
10. Download licenses for the Node
11. Quickstram Cloud 
12. About 
13. Exit 

Advanced configuration 

Quickstream Node configuration is located in the following directories:
  1. /opt/quickstream/etc/quickstream-node in Linux
  2. %PROGRAMDATA%\Quickstream\Quickstream Node in Windows.
It contains the following files:
  1. quickstream-node.ini - Main configuration file. The structure is described below.
  2. db.main.sqlite - SQLite database containing the configuration of all channels and licenses.
  3. db.log.sqlite - SQLite database containing all logs and statistics.
  4. Any file with sqlite-shm and sqlite-wal extension - Used by SQLite to improve its performance.

quickstream-node.ini file contains management port and logging configuration. You can tune this file if you want to change the log level or management port. Log level can also be changed by Quickstream Client.

Example contents of the file:
[cloud]
connectToCloud=true

[logging]
consoleLog=1
debugTs=false
ffmpegLogLevel=0
guid={ca40f60d-2b90-4941-a889-183c4def3442}
hostname=qs-lab1-dev
logLevel=2

[server]
portRangeMax=29999
portRangeMin=20000
webSocketPort=32137
File content explanation:
  1. cloud 
    1. connectToCloud - (default: false) determines whether Node should connect to cloud. After running quickstream-node-setup the parameter is changed from false to true 
  2. logging
    1. consoleLog - [Allowed values: 0, 1] - If it is set do 1 Quickstream Node will output log to stdout.
    2. debugTS - an advanced timestamp processing in the transport stream. Should only be used for troubleshooting purposes. 
    3. ffmpegLogLevel - 
    4. logLevel - [Allowed values: 0, 1, 2, 3 ,4] - Sets logs levels.
      1. 0 - Critical
      2. 1 - Error
      3. 2 - Warning
      4. 3 - Info
      5. 4 - Debug (Be careful with this level. It produces a big amount of logs, which can easily affect the performance!)
  3. server
    1. portRangeMax - (default: 29999) - when using Quickstream Protocol, Quickstream Node is automatically open ports for SRT connections. portRange Max is the maximum port number in a range Quickstream Node will use when establishing a new connection.  
    2. portRangeMix - (default 20000) - when using Quickstream Protocol, Quickstream Node is automatically open ports for SRT connections. portRange Min is the minimum port number in a range Quickstream Node will use when establishing a new connection.  
    3. restApiPort - [Allowed values: 1 - 65535] - Port used by client to manage Quickstream Node. This port can not be used by any other application in the system. The default port for REST API is 32138. (Deprectiated) 
    4. webSocketPort - [Allowed values: 1 - 65535] - Port used by client to manage Quickstream Node. This port can not be used by any other application in the system. This the port used by Quickstream Client to connect to Quicksteam Node. restApiPort is sent to client via WebSocket. The default port for web socket is 32137.
If you change any settings in Quickstream Node configuration file you have to restart Quickstream Node service by typing following command:
$ service quickstream-node restart 
If you are using Windows restart service by using:
services.msc

    • Related Articles

    • Quickstream v2.0

      QUICKSTREAM V12.0  IS READY TO GO! It is required to update both Quickstream Client and Quickstream Node. Old version of Quickstream Client will not work properly with the latest version Quickstream Node. QUICKSTREAM CLOUD IS NOW OPERN  Quickstream ...
    • Configuring Quickstream Client

      After Quickstream Client installation, please run the application: For Windows: look for "Quicksteam Client" in programs   For Linux: execute command quickstream-client. If it is not in the path, you should find it in /opt/quickstream/bin For Mac OS: ...
    • Installing Quickstream Node

      System requirements Network  Operating system requirements Quickstream supports the following operating systems: Windows 8.1 Pro, Enterprise and Windows Server 2012R2 Windows 10 Pro, Enterprise, Workstation and Windows Server 2016, 2019 or newer  ...
    • Removing Quickstream Node

      Windows Open Control Panel. Then open Program and Features. Search for Quickstream Node. Then click on it and click Uninstall from top bar. Uninstallation will start without any prompt. It would be necessary to restart you computer in order to fully ...
    • Resetting the Node configuration

      Linux Debian/Ubuntu If you want to reset Quickstream Node configuration database including stored logs and statistics information, You must to reinstall Quickstream Node. Please execute the following command to remove Quickstream Node and remove its ...