SQLstream StreamLab is a browser-based application that lets you view and create visualizations of streaming data.
If you are running Guavus SQLstream in a Docker container, an Amazon Marketplace AMI, Microsoft Azure MI or other virtual machine >, Guavus StreamLab is installed alongside Guavus s-Server. If you are running Guavus SQLstream on Linux, you need to install StreamLab on its own.
You should install and run StreamLab after Installing SQLstream s-Server.
You can install SQLstream StreamLab using an X-windows wizard. The easiest way to launch the installer is by initiating the installation file from the command line.
The StreamLab installer ships as a binary file - usually named SQLstream-StreamLab-2.3.0 (where X.Y.Z is the version number) that you acquired by downloading it from http://www.sqlstream.com/downloads.
You can also install StreamLab from the command line.
To install StreamLab:
To use maps, you need to obtain and install either a Google Maps or MapBox api key before maps can be used. If you are using the the Pan and Zoom map visualization, StreamLab and s-Dashboard require a Google Maps API key.
To retrieve an API key, please visit the following link:
Once you have a Google Maps API key, you need to restart StreamLab to incorporate it. To do so when launching StreamLab from the command line, use a -m flag, as in:
To do so when launching StreamLab using the 'Start Streamlab Server' icon, right-click on the desktop 'Start Streamlab Server' icon, select Properties, and add the -m option to the end of the command.
You can now use the Pan and Zoom map visualization with full functionality.
To use OpenStreetMaps tiles, you need a Mapbox id. To design a map, go to https://www.mapbox.com/ and sign up and design the map they want.
Each map has a map id. This gets used in the -m option preceded by 'mapbox:', as in:
All StreamLab maps will use the same tile set. In order to use a different tile set, you need to restart StreamLab with a different Mapbox id.
You can also set the map service in /etc/default/streamlabd, by setting STREAMLABMAPSERVICE to 'google:
You can also install in text mode, which does not display the graphical installation wizard. To do so, enter
sudo ./StreamLab-X.Y.Z-x64.run --mode text
where X.Y.Z represent the release and version numbers, as in SQLstream-StreamLab-2.3.0.run.
if you are logged in as a super user, you do not need to include "sudo".
The text-mode installer performs the same steps as the graphical one, but displays its prompts and messages in the console window. By default, the installer will run in graphical mode, GTK. If this is not possible, it will run in xwindow mode. If there is no graphical environment available it will fall back to text mode.
There are command-line options to perform all of the functions available in the GUI version. For a list of the command-line options and their meanings, type
|--help||Display this list of options.||None|
|--optionfile <optionfile>||Installation option file||None|
|--mode <mode>||Installation mode.||Default: gtk Allowed: gtk xwindow text unattended|
|--prefix <prefix>||Installation Directory||/opt/sqlstream/<version>|
|--startStreamlabService <startStreamlabService>||Start the streamlabd service. 1 for yes, 0 for no.||1|
|--startStreamLabServer <startStreamLabServer>||Start the StreamLab server after installing||True|
|--installer-language <installer-language>||Language selection||Default: en
Allowed: sq ar es_AR pt_BR bg ca hr cs da nl en et fi fr de el he hu it ja ko lv lt no pl pt ro ru sr zh_CN sk sl es sv th zh_TW tr va cy