manuelle Registrierung

Am einfachsten, da am wenigsten Vorbereitung notwendig, ist die manuelle Registrierung von Agents in Bloonix.

Zuerst muss in der WebGui ein Host angelegt werden.

Hier können auch, wenn vorhanden, ein Template oder Usergruppe hinterlegt werden. Nachdem alle notwendigen Felder ausgewählt sind, mit „Submit“ anlegen.

Anschließend kann man sich die HostID und das genertierte Passwort anzeigen lassen, das Passwort lässt sich gegebenenfalls auch ändern.
Um diese Informationen auch noch im Nachhinein einzusehen, kann der Host bearbeitet werden.

Auf dem Agentserver muss unter /etc/bloonix/agent/main.conf in der server Rubrik der Bloonixserver angegeben werden und bei host die ID, Passwort, Agent ID und auf aktiv gestellt werden.
Zusätzlich muss noch die Agent ID angegeben werden.
Jeder Service ist mit einer Agent-ID gekennzeichnet. Mit dieser Option kann ausgewählt werden, welche Services eines Hosts von diesem Agenten aus überwacht werden. Mögliche Werte sind localhost, intranet und remote.

server {
    host <FQDN>
host {
    host_id  <ID>      # ENTER THE HOST ID
    password <PASSWORT> # ENTER THE PASSWORD
    active   yes     # ACTIVATE THE HOST
    agent_id localhost
}

Anschließend muss der Host am Server initialisiert werden, dies geschieht mit bloonix-init-host <HostID>.<HostPasswort> <Bloonixserver>
Wenn die Initialisierung erfolgreich war, kommt folgende Meldung:

Host successfully installed
Restarting the agent now

Worauf hin der Agent neugestartet werden muss.

systemctl restart bloonix-agent.service

automatische Registrierung

Diese ist vor allem interessant für Automatisierungen und vorbereitete Templates/Images. Hier wird aber mehr Vorbereitung im Bloonix benötigt.

notwendige Daten heraussuchen

Es wird für die automatische Registrierung eine Company welche die Registrierung aktiv hat, Template, Hostgroup und mindestens ein User mit maximal Operator Rechten benötigt.

Corporate ID und Authkey

Für die Registrierung ist die Company ID notwendig, nicht die Real Company ID.

Der Authkey dient zur Authentifikation des Agenten.

Agent konfigurieren

Nach der Installation des Agenten muss unter /etc/bloonix/agent/main.conf der Bloonix Server eingestellt werden:

vim /etc/bloonix/agent/main.conf
host

Zusätzlich wird für die Anmeldung des Agent am Server eine /etc/bloonix/agent/register.conf benötigt, mit folgendem Inhalt:

webgui_url https://<FQDN der Webgui>/
data {
    company_id <Company ID>
    company_authkey <Company Key>
}

Host akzeptieren

Nun muss der Host noch akzeptiert und hinterlegt werden.
Dazu muss man sich mit dem Operatoruser anmelden.
Hier zeigt sich oben rechts eine rote Zahl, die der wartenden Hosts enspricht. In diesem Beispiel 1.

Nachdem man auf die 1 geklickt hat, werden die Hosts angezeigt.

Auswählen tut man diese mit einem Klick.

Nach dem Auswählen zeigt sich unten links eine kleine blaue 1. Welche dem ausgewählten einen Host enspricht. Anschließend muss das Plus links daneben angeklickt werden. Um den Host hinzuzufügen

Nun erscheint ein Fenster, in dem man die Usergruppe und das Template auswählen kann. Eine Contact Group ist keine Vorraussetzung.

Anschließend ist der Host hinzugefügt, aber noch deaktiviert. Erkennbar an dem roten Symbol.

Nach dem anklicken des Hosts, erscheint unten links wieder eine kleine blaue 1. Zusätzlich gibt es nun mehr Symbole, zb das rote Symbol als Negativ. Wenn man darauf klickt kann man den Host aktivieren.

Mit dem Symbol kann man Hosts aktivieren und auch deaktivieren.