Konfiguration der Bloonix-WebGUI

Die Konfiguration der WebGUI befindet sich in:

/etc/bloonix/webgui/main.conf

Sektion: heaven

Diese Parameter sind für das MVC-Framework von Bloonix und sollten nicht geändert werden.

heaven {
    base /srv/bloonix/webgui/lib
    model Database, REST
    view Template, JSON
}

Sektion: system

system {
    user bloonix
    group bloonix
    timezone Europe/Berlin
}

Parameter	Standard	Beschreibung
user	bloonix	Mit welchem Benutzer soll der Daemon laufen.
group	bloonix	Mit welcher Gruppe soll der Daemon laufen.
timezone	Europe/Berlin	Die Zeitzone des Servers.

Sektion: proc_manager

In dieser Sektion findet die Verwaltung der Prozesse statt, die die Bloonix-WebGUI startet, um Anfragen zu bearbeiten.

proc_manager {
    max_servers 10
    min_spare_servers 5
    max_spare_servers 8
}

Parameter	Standard	Beschreibung
min_spare_servers	10	Wieviele Prozesse mit Leerlauf sollen mindestens verfügbar sein. Wenn die Zahl unterschritten wird, werden weitere Prozesse gestartet, solange, bis der Parameter max_spare_servers erreicht ist.
max_spare_servers	20	Wieviele Prozesse mit Leerlauf darf es maximal geben. Wenn die Zahl erreicht ist, werden soviele Prozesse beendet, bis der Parameter min_spare_servers erreicht ist.
max_servers	50	Wieviele Prozesse dürfen maximal gestartet sein.
max_requests	0	Wieviele Requests darf ein Prozess verarbeiten, bis er sich selbst beendet. 0 bedeuted unendlich.
max_process_size	1GB	Auf wieviel MB/GB darf ein Prozess maximal wachsen, bis er sich selbst beendet. 0 bedeuted unendlich. Möglich Angaben: xMB, xGB
timeout	300	Wie lange darf ein Requests und dessen Verarbeitung andauern. Nach Ablauf des Timeouts wird die Verarbeitung abgebrochen.
lockfile	/var/lib/bloonix/ipc/webgui.%P.lock	Diese Datei wird lediglich zum internen Locking verwendet.

Sektion: fcgi_server

In dieser Sektion werden die Parameter für den FastCGI Server konfiguriert. Die Konfiguration ist sehr einfach.

fcgi_server {
    port 9001
}

Parameter	Standard	Beschreibung
port	9000	Auf welchem Port soll die FastCGI Applikation lauschen.

Sektion: server_status

Über Server-Status lässt sich der Status der Server-Prozesse abrufen.

Der Aufruf kann über HTTP/HTTPS erfolgen.

Parameter	Standard	Beschreibung
enabled	yes	Hiermit kann die Funktionalität aktiviert oder deaktivert werden.
location	/server-status	Der Pfad, der zur Abfrage der Server-Statistiken gültig ist.
allow_from	127.0.0.1	Eine komma-separierte Liste von IPs, von denen der Server-Status abgefragt werden darf.

Sektion: webapp

webapp {
    hostname yourdomain.test
    sid_expire_time 3600
    sid_refresh_time 300
    chart_library other
    html_path /srv/bloonix/webgui/templates/html
    check_frequency low
}

Parameter	Standard	Beschreibung
hostname	wird ermittelt	Der Hostname, auf dem die WebGUI läuft. Der Hostname wird automatisch ermittelt, wenn er nicht angegeben ist.
sid_expire_time	3600	Nach wievielen Sekunden läuft eine Session-ID ab. Der Benutzer muss sich danach erneut anmelden.
sid_refresh_time	300	Nach wievielen Sekunden wird die Ablaufzeit der Session-ID des Benutzers erneuert.
chart_library	other	Mit diesem Parameter kann die Chart-Library ausgewählt werden. Gültige Werte sind other und highcharts. Mit dem Wert other werden die Chart-Libraries Flot, D3js, topojson und datamaps verwendet. Mit dem Wert highcharts werden die Chart-Libraries Highcharts und Highmaps verwendet. Bitte beachten Sie, dass Highcharts nur verwendet werden darf, wenn Sie über eine gültige Highcharts und Highmaps Lizenz verfügen. Weitere Informationen hierzu finden Sie im Bereich Lizenzen
html_path	/srv/bloonix/webgui/templates/html	Der Pfad zur internen Dokumentation zur WebGUI.
check_frequency	low	Mit diesem Parameter können die mindest-Intervalle für Service-Checks konfiguriert werden. Mit dem Wert low ist ein Intervall von mindestens 60 Sekunden möglich. Mit dem Wert high ist der kleinste Intervall von 15 Sekunden möglich.
allow_simple_usernames	no	Standardmäßig müssen Benutzernamen in der WebGUI im E-Mail Format angelegt werden. Setzt man diesen Parameter auf yes, so ist es möglich, auch einfache Namen zu verwenden. Der Benutzername muss mindestens 2 Zeichen lang sein und darf weder mit einem Leerzeichen beginnen oder enden.

Sektion: email

Mit der E-Mail Parametern kann festgelegt werden, über welche Ereignisse Sie als Administrator informiert werden. Wenn Sie zum Beispiel den Wunsch haben, bei einer Anfrage zum Passwort-Reset per E-Mail informiert zu werden, so setzen Sie den Parameter flags auf password-request.

email {
    sendmail /usr/sbin/sendmail -t -oi -oem
    from root@localhost
    to root@localhost
    subject [BLOONIX-WEBGUI] %s
    flags success-login, failed-login, password-request
}

Parameter	Standard	Beschreibung
sendmail	/usr/sbin/sendmail -t -oi -oem	Kommando zum Versenden von E-Mails.
from		Der Absender der E-Mail.
to		Der Empfänger der E-Mail.
subject		Der Betreff der Nachricht. Der String %s wird mit dem eigentlichen Betreff ersetzt.
flags		Mögliche Werte sind success-login, failed-login und password-request.

Sektion: database

In dieser Sektion werden die Parameter für die Datenbank konfiguiert und sind selbsterklärend.

database {
    include /etc/bloonix/database/main.conf

    #driver Pg
    #host 127.0.0.1
    #port 5432
    #database bloonix
    #user bloonix
    #password secret

    logger {
        file {
            filename /var/log/bloonix/bloonix-webgui-database.log
            filelock 0
            maxlevel info
            minlevel emerg
            message_layout [%T] %L %P %t %X %Y %m (%C)
        }
    }
}

Die Konfiguration des Loggers ist identisch zur Konfiguration des Haupt-Loggers weiter unten.

Sektion: elasticsearch

In dieser Sektion werden die Verbindungsparameter zu Elasticsearch konfiguriert.

elasticsearch {
    proto http
    host 127.0.0.1:9200, 127.0.0.2:9200
    timeout 60
    mode balanced
}

Parameter	Standard	Beschreibung
proto	http	Das Protokoll, unter das Elasticsearch erreichbar ist.
host	127.0.0.1	Der Hostname bzw. die IP-Adresse zu Elasticsearch. Es können mehrere komma-separierte Hosts angegeben werden.
timeout	60	Die maximale Zeit pro Request. Danach wird der Request abgebrochen.
mode	balanced	Es ist möglich, die Requests auf mehrere Elasticsearch-Server zu verteilen oder aber ein Failover einzurichten. Mögliche Werte sind balanced und failover.

Sektion: template

template {
    path /srv/bloonix/webgui/templates
}

Diese Parameter sind für das Template-System und sollten nicht geändert werden.

Sektion: logger

Hier findet die Konfiguration des Logger statt. Weitere Informationen zu den Einstellungsmöglichkeiten finden Sie unter
http://search.cpan.org/dist/Log-Handler/ .

logger {
    file {
        filename /var/log/bloonix/bloonix-webgui.log
        filelock 0
        maxlevel info
        minlevel emerg
        timeformat %b %d %Y %H:%M:%S
        message_layout [%T] %L %P %t %X %Y %m (%C)
    }
}