Die Konfiguration der WebGUI befindet sich in:
/etc/bloonix/webgui/main.conf
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
}
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. |
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. |
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. |
Ü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. |
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. |
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. |
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.
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. |
template {
path /srv/bloonix/webgui/templates
}
Diese Parameter sind für das Template-System und sollten nicht geändert werden.
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)
}
}