Installation der WebGUI

Die Bloonix-WebGUI ist in zwei Pakete aufgeteilt. Es gibt zum Einen das Paket bloonix-webgui-core, welches Abhängigkeiten installiert und über die Konfigurationsdateien der WebGUI verfügt und zum Anderen das Paket bloonix-webgui, welches die Web-Applikation enthält, die unter /srv/bloonix/webgui installiert wird.

Die WebGUI kann wie folgt installiert werden:

# Debian / Ubuntu
apt-get install bloonix-webgui

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

# SuSE / SLES
zypper install bloonix-webgui

Nginx konfigurieren

Die Bloonix-WebGUI läuft als externe FastCGI Applikation und benötigt Nginx als Reverse Proxy. Sie können natürlich auch einen anderen Webserver verwenden. Zu beachten ist nur, dass der Webserver HTTP Requests zu einer externen FastCGI Applikation über IP:Port weiterleiten kann. Wir verwenden Nginx, da Nginx sehr populär, einfach zu konfigurieren und sehr, sehr schnell ist.

Nach der Installation der WebGUI wird eine Konfigurationsdatei für Nginx angelegt:

/etc/bloonix/webgui/nginx.conf

Diese Konfigurationsdatei müssen Sie in der Konfiguration von Nginx inkludieren. Erstellen Sie hierzu die Konfigurationsdatei

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

mit folgendem Inhalt:

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

Die Konfigurationsdatei /etc/bloonix/webgui/nginx.conf sieht in etwas so aus:

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;
}

Der Paramter server_name ist hier als Catch-All eingerichtet. Falls Sie vorhaben, den Nginx auf dem Server für mehrere Domains zu verwenden, dann sollten Sie den Servernamen anpassen, anstonsten können Sie den Namen so stehen lassen. Das SSL-Zertifikat wurde bereits mit der Installation generiert. Bitte beachten Sie, dass Sie ein gültiges Zertifikat verwenden sollten. Zum Testen sollte jedoch das selbst-generierte Zertifikat ausreichen.

Nginx restarten

Nach der Konfiguration der WebGUI können wir nun den Nginx restarten:

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

Datenbankschema und Elasticsearch-Template

Um das Schema für die Datenbank und das Template für Elasticsearch anzulegen, gibt es im Verzeichnis

/srv/bloonix/webgui/schema

ein paar Skripte zur Hilfe.

Um das Schema für die Datenbank anzulegen, muss folgendes Kommando ausgeführt werden:

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

Das Skript erstellt das Datenbank-Schema sowie einen Zugang für den Benutzer bloonix. Das Passwort für die Datenbank wird dabei automatisch generiert und in die Konfigurationsdatei /etc/bloonix/database/main.conf geschrieben. Diese Datei wird von allen Komponenten, die einen Zugang zu Datenbank benötigen, inkludiert.

Um das Template für Elasticsearch anzulegen, muss folgendes Kommando ausgeführt werden:

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

WebGUI starten

Wenn alle Schritte durchgeführt wurden, kann die WebGUI gestartet werden:

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

Öffnen Sie als nächstes einen Webbrowser und geben den Hostnamen ein, der in der Nginx Konfiguration angegeben wurde bzw. auf dem die WebGUI läuft.

Wichtig: Der initiale Zugang zur WebGUI lautet:

Benutzername: admin
Passwort: admin

Falls Sie mal das Passwort vergessen haben, so können Sie das Skript /srv/bloonix/webgui/bin/generate-password verwenden, um ein neues Passwort zu generieren. Das Skript gibt zwei Update-Statements aus, die auf der Datenbank von Bloonix ausgeführt werden müssen. Die User-ID des Benutzers admin ist immer 1.

Bitte beachten Sie, dass der Benutzer admin nur verwendet werden sollte, um im Bereich ADMINISTRATION zu agieren. Bitte erstellen Sie als aller erstes eine eigene Company, eine eigene Gruppe und einen eigenen Benutzer. Der Benutzer und die Gruppe müssen der neuen Company zugeordnet werden und der Benutzer sollte Operator-Rechte haben. Für weitere Informationen lesen Sie bitte hier weiter: Companies und wie diese funktionieren