EPOPS – Installation des Windows Agenten

Anbei eine Kurzanleitung für die Installation des EPOPS Agenten auf Windows. Zur Erinnerung, EPOPS Agent liefert OS Metriken direkt and das vRealize Operations und ersetzt damit den Hyperic Agent.

Voraussetzungen:

1. vR Ops muss in der Advanced oder Enterprise Version lizensiert sein
2. Es wird ein Registrierungsbenutzer auf vR Ops benötigt, dem die Rolle des Agent Manager zugewiesen wurde
3. vR Ops SSL Thumbprint muss vorliegen
4. User, Passwort, Hostname und Thumbprint sind bekannt (werden bei der Installation benötigt)

1. Anlegen des Registrierungs-Benutzers

 

Als Administrator in vR Ops einloggen, im Bereich “Administration -> Access Control” mit + einen neuen Benutzer anlegen

Diesem Nutzer die vordefinierte Rolle Agentmanager zuweisen:

Dem angelegten Nutzer Rechte auf die Bereiche “Operating Systems” und “Remote Checks” geben:

2. SSL Thumbprint des vR Ops Server kopieren

Die Installation frag zwischendrin nach dem SSL Thumbprint. Da steht man dann überrascht und fängt an zu suchen. Um es zu finden öffnen Sie im Browser http://VROPS-IP/admin, loggen Sie sich hier als admin ein und klicken oben rechts auf das sehr kleine gelbe Icon:

Es öffnet sich ein Fenster mit zwei Abschnitten. Wir brauchen immer das zweite Thumbprint (wichtig bei mehreren Nodes, da das zweite Zertifikat dem Cluster gemeinsam ist):

Diese Zahlen mitsamt der Doppelpunkte sollten wir mal in eine Text-Datei ablegen und speichern…

3. Eigentliche Installation des Agents

Das ist sehr unspektakulär, weil man ja jetzt schon weiss, was man alles eingeben muss:

3.1 Die Datei epops-agent-x86-64-win-6.1.0-3030162.exe anklicken

3.2 Den Namen des vR Ops Servers und Port (443) angeben

 

3.3 SSL Thumbprint hineinkopieren

3.4 Den Namen des Registrierungsbenutzers und Passwort angeben

4. Ergebnis

Wenn alles gut ging, erscheint in einigen Minuten in vR Ops der Agent:

Und auch in der Ansicht der virtuellen Umgebung kann man nun die Verbindung der VM-Metriken mit den OS-Metriken sehen:

Wenn es nicht klappt: auf der Windows Maschine im CMD-Fenster in das Verzeichnis “C:\ep-agent\bin>” wechseln und “ep-agent.bat stop” aufrufen. Anschliessend mit “ep-agent start” und eventuelle Fehlermeldungen lesen:

Wenn auch das keine Klarheit bringt, im Verzeichnis C:\ep-agent\log die Logdateien anschauen.

5. Unbeaufsichtigte Installation (für Puppet, Chef und andere…)

Möchten Sie diesen Spass mit Klicken nicht auf jedem Windows-Client wiederholen, kann man auch eine “silent” Installation durchführen und bei Bedarf automatisieren (Gross- und Kleinschreibung penibel beachten):

C:\Users\tbaublys> epops-agent-x86-win-6.1.0-3030162.exe /VERYSILENT -username epops -password PASSWORD -serverAddress VROPS01 -serverCertificateThumbprint "40:43:F3:12:BA:DF:CB:70:D7:34:0E:C3:5A:8B:A5:3F:DF:70:D0:3A"