User login
Qlustar: Install and enjoy!

The QluMan Sandbox

Starting the Sandbox

The QluMan sandbox emulates a running Qlustar cluster. The complete setup is packed into a Docker container image. Therefore, you need to have the Docker engine installed on the machine, where you want to run the sandbox. Check the instructions about Docker installation, if you haven't installed it on your machine yet. Once Docker is setup, the sandbox can be started with the command

$ docker run -p 8001:6001 -p 8002:6002 -d --cap-add=NET_ADMIN qlustar/qluman-sandbox

You can check whether the sandbox is running correctly by executing

$ docker top $(docker ps | awk '$2 == "qlustar/qluman-sandbox" {print $1}')

This should show a single qlumand, single mysqld and a number of qluman-execd processes. Before you can connect the GUI to the sandbox, you need to generate a one-time token. To do this execute

$ docker exec  $(docker ps | awk '$2 == "qlustar/qluman-sandbox" {print $1}') \
  qluman-cli --gencert --pin 1234

Note, that we set the token pin to "1234". This needs to be input in the QluMan GUI, when you define the cluster connection to the sandbox as described below.

Starting the QluMan GUI

Once the sandbox is running, you can connect to it with the QluMan GUI. Start it either from the Docker image by downloading our run script
(sha256: 1ee39af0953af315ba05494f0554efe905d7bb4c337573606b620edb4868de19)
and executing like (from the directory to where you saved it)

$ chmod 755 run-qluman-docker
$ ./run-qluman-docker

or if you have singularity installed, download the QluMan singularity image, then decompress and execute it as

$ gunzip qluman-singularity.img.gz
$ singularity exec qluman-singularity.img qluman-qt 

Once started, use the token generated like described above to add a cluster connection for the sandbox. Please make sure, that you choose localhost and port 8001 for the Local: setting of the connection. This assumes you execute the GUI container on the same machine as the sandbox.

Once connected, you can start playing with the GUI and try out a few things. Note, that the fake nodes inside of the sandbox are wrongly configured on purpose (red wrench symbol). That way you can familiarize yourself with the Hardware/GPU wizards and generate correct configurations.

You also have to be aware of the fact, that all commands you start via the RXengine, are executed inside the same sandbox container. So regardless of what node you target for execution, a rm -rf /* will kill your whole sandbox ;) Hence, don't be surprised ... Good job it's just a container: Removing it (docker rm <container id>), and starting from scratch is simple (remember to generate a new one-time-token in that case). Checkout the QluMan Guide for all the details about supported operations/configurations. If something is not working as expected, please let us know.

glqxz9283 sfy39587stf02 mnesdcuix8