Installing and Running Streamlab on Linux

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.

This page contains the following topics:

Installing StreamLab

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 named SQLstream-StreamLab-<VERSION> that you acquired by downloading from https://www.sqlstream.com/downloads.

If you have previously installed StreamLab, we recommend exporting any existing projects before proceeding.

You can also install StreamLab from the command line.

To install StreamLab:

  1. From a terminal prompt enter ./SQLstream-StreamLab-X.Y.Z-linux-x64.run, where X.Y.Z represent the release and version numbers, as in SQLstream-StreamLab-2.3.0.run. If the installer does not launch, make sure the file is executable by running chmod +x . The Welcome page appears, introducing the Setup Wizard.
  2. Click Forward. The License Agreement page of the installation wizard opens.
  3. If you are logged in as root, the default directory is /opt/sqlstream/<VERSION>/, otherwise the default directory is /home/<user>/sqlstream/SQLstream/<VERSION>/
  4. Confirm the directory, then click Forward. The Repository Directory page opens.
  5. Confirm the directory, then click Forward.
  6. Click Forward. The StreamLab Service/Daemon page opens. This page lets you setup StreamLab as a service that starts automatically at system startup.
  7. Choose whether or not to create the service and click Forward. The Ready to Install page opens.
  8. Click Forward to start the Installation.

If there is a StreamLab server already running on your computer, the installer will warn you. In this case, you can proceed with the install, but you should export any previously created StreamApps before you continue installing. The installer will automatically stop the StreamLab server before installing.

For more details on exporting projects, see Exporting Projects from the Projects Home Page.

Note: If you attempt to install into a directory that already contains StreamLab, the installer will overwrite any existing work.

Using Google Maps and OpenStreetMaps Tiles with 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:

https://developers.google.com/maps/documentation/javascript/tutorial# api_key

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:

-m google:AGzaSyrDBVfuWtaa40S1pM8U-0YED3ONjvq6-7mFZ*

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.

Using StreamLab with OpenStreetMaps

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:

-m mapbox:myserver.jeo4y40c

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.

Setting the Map Service in the Linux Environment

You can also set the map service in /etc/default/streamlabd, by setting STREAMLABMAPSERVICE to 'google:' or 'mapbox:'.

Installing StreamLab on the Command Line

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.

Viewing Options for Command-line Installation

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

./<installername> --help
Option Description Default
--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
--overwrite If set to 1, enables forced overwrite for non-interactive installs. 0

Running StreamLab

By default, StreamLab is installed as a service, and will start automatically upon reboot. (It also starts by default after installation.) To access StreamLab, do one of the following:

  • Click the StreamLab icon in the StreamLab folder on your desktop.
  • Point your browser to localhost:5590 (or whatever server StreamLab is running on).

Starting StreamLab Manually

Before you start StreamLab, you need to have both s-Server and WebAgent running. This version of StreamLab checks to see if WebAgent is running before starting.

For information on running WebAgent, see the topic WebAgent.

Note: WebAgent must be running with write enabled (-w).

To start StreamLab in other cases, open the StreamLab folder on your desktop and double-click the Start StreamLab Server icon.

Alternately, run the following script, located in the /opt/sqlstream/.xxxx directory:

./streamlab.sh

To start the service as root, enter

sudo service streamlabd start

You can specify the following arguments when starting StreamLab from the command line.

Command-line argument Definition Default
-p Specify port (overrides $STREAMLAB_PORT) 5590
-s Server mode, restarts server if it exits No
-h -? Show this help message
-w WebAgent port or URL. If not specified, StreamLab looks for WebAgent on port 5580 of the same server running s-Server. http://yourhost:5580 where "yourhost" is the name of the server running s-Server.

Stopping StreamLab

To stop StreamLab, take one of the following steps:

  • If you are using a SQLstream appliance (such as Docker or an Amazon Machine Image) and you have access to the cover page, open the cover page and toggle the StreamLab Server is running control.
  • If you have a desktop, and if you have installed StreamLab as a service, click the Stop StreamLab Server icon in the StreamLab folder on your desktop.
  • If you are running StreamLab as a service, log in to the server and enter [sudo] service stop streamlabd. You do not need sudo if you are logged in as root (if for example, you use docker exec on a Guavus SQLstream docker image, as in docker exec service stop streamlabd).
  • If you used streamlab.sh to run StreamLab, you can stop StreamLab with stopStreamLab.sh.