Installation of the WebGUI

The Bloonix-WebGUI is splitted into two packages. The first package called bloonix-webgui-core contains dependencies and the configuration files for the WebGUI. The second package called bloonix-webgui contains the web application and will be installed to /srv/bloonix/webgui.

Install the webgui:

# Debian / Ubuntu
apt-get install bloonix-webgui

# Red Hat / CentOS / Fedora
yum install bloonix-webgui

# SuSE / SLES
zypper install bloonix-webgui

Nginx configuration

The Bloonix-WebGUI runs as a external FastCGI application and needs Nginx as a reverse proxy. After the installation a configuration file is created for Nginx:

/etc/bloonix/webgui/nginx.conf

All you need to do is to include the file into the Nginx configuration. Create a new configuration file:

/etc/nginx/conf.d/001_bloonix.conf

and insert the following line:

include /etc/bloonix/webgui/nginx.conf;

The configuration file /etc/bloonix/webgui/nginx.conf looks like as follows:

server {
    listen 443;
    server_name _;

    access_log /var/log/nginx/bloonix-webgui.access.log;
    error_log /var/log/nginx/bloonix-webgui.error.log;

    location ~ /public {
        root /srv/bloonix/webgui;
    }

    location /favicon.ico {
        root /srv/bloonix/webgui/public/img;
    }

    location / {
        expires off;
        include /etc/nginx/fastcgi_params;
        root /srv/bloonix/webgui/public;
        fastcgi_pass 127.0.0.1:9000;
    }

    ssl on;
    ssl_certificate /etc/bloonix/webgui/pki/server.cert;
    ssl_certificate_key /etc/bloonix/webgui/pki/server.key;
}

The paramter server_name is configured as catch-all. If you want to use multiple domains on the server then you should change the paramter. Please note that you should use a valid certificate, if possible.

Nginx restarten

After the configuration of the WebGUI you can restart Nginx:

/etc/init.d/nginx restart
# or
systemctl restart nginx.service

Database schema and Elasticsearch template

You can find some scripts to create the database schema and Elasticsearch template in the following directory:

/srv/bloonix/webgui/schema

Execute the following command to create the database schema:

# PostgreSQL
/srv/bloonix/webgui/schema/init-database --postgres
# MariaDB/MySQL
/srv/bloonix/webgui/schema/init-database --mysql

The skript creates the database schema and the user bloonix with a password. The password is automatically generated and configured into the configuration file /etc/bloonix/database/main.conf. This file is used by all components that needs a connection to the database.

Execute the following command to create the Elasticsearch template:

/srv/bloonix/webgui/schema/init-elasticsearch localhost:9200

Start the WebGUI

If all steps are done please start the WebGUI:

/etc/init.d/bloonix-webgui restart
# or
systemctl restart bloonix-webgui.service

Now open a web browser and enter the hostname.

Notice: The initial access to the WebGUI is:

Username: admin
Password: admin

If you have forgotten the password sometimes, so you can use the script /srv/bloonix/webgui/bin/generate-password to generate a new password. The script returns two update statements, which have to been executed on the database.

Please note that the user admin should only be used to act in the ADMINISTRATION area of the webgui. The first step that you should do after the login is to create a own company, a own group and a own user. The user and the group should be assigned to the new company and the user should have operator rights.