Quelltext der Seite Zabbix Agent per Gruppenrichtlinie installieren lassen


[[Kategorie:Zabbix]]
Bei einem Kunden waren es zu viele Server als das bei diesen der Zabbix-Agent bei allen von Hand installiert werden konnte.<br>
Es gab zwar eine Softwareverteilung - welche für die Server jedoch nicht genutzt werden durfte.<br>
<br>
Zunächst dachte ich an ein Script - jedoch stand nur ein Benutzerdefinierter Administrationsaccount zur Verfügung und die UAC-Kontrolle auf vielen Servern war noch aktiviert. Eine Remote-Installation z.B. per WMI wäre daran gescheitert.<br>
Das Problem hatte ich schon als ich mir den Updater für den Zabbix-Agenten ausgedacht hatte: [[Agent Auto Updater|Zabbix Agent Auto Updater]] - dort habe ich das Problem umgangen indem ich einfach den SYSTEM-Benutzer genommen habe - dieser hat volle Rechte und keine UAC-Abfrage. Gestartet wird das Update über die Windows Aufgabenplanung.<br>
<br>
Also die Installation in die Aufgabenplanung eintragen lassen ...<br>
Naheliegend war die Idee dies per Gruppenrichtlinie zu tun - und das hat auch auf Anhieb geklappt!<br>
<br>
----
==Voraussetzungen==
* Ihr habt eine zentrale Freigabe auf der das Installationsskript abgelegt ist - siehe 
** [[Zabbix Agent für Windows per Skript automatisch installieren Musterdatei]] für das Installationsskript
** [http://znil.net/index.php?title=Zabbix_Server_%2B_Agent_unter_Ubuntu_14.04_LTS_installieren#Windows-Freigabe_f.C3.BCr_Agenten-Dateien_einrichten Windows-Freigabe für Agenten einrichten] für eine geeignete Freigabe
** Auf die Freigabe muss man ohne Benutzername und Passwort kommen! Wir lassen das Paket als Benutzer "SYSTEM" installieren der sonst keinen Zugriff hat
* Und Ihr habt das Installationsskript vorher getestet - an ein paar Rechnern von Hand
* Eure Server sind auch unterhalb von OU's (Organisationseinheiten) organisiert
<br>
<br>
----
==Einrichtung eines Task als "Sofortige Aufgabe" (ab W7 / 2008 R2)==
{{Warnung| Dieser geplante Task wird bei dieser Methode jedes mal ausgeführt wenn der Computer die Computerkonfiguration der Gruppenrichtlinie übernimmt! Also alle 90 Minuten +/- 30 Minuten!!!<br>Diese Methode ist also prima für die Erst-Verteilung des Agenten - und danach sollte die Gruppenrichtlinie wieder deaktiviert oder die Verknüpfung gelöscht werden.<br>Die regelmäßige Neuinstallation ist bei der Verwendung meines Installationsskriptes zwar völlig Problemlos - aber auch völlig unnötig.}}<br>
{{Hinweis| In der Praxis mache ich es dennoch genau so. Statt der InstallZabbixAgent.bat nutze ich jedoch eine weitere Batchdatei InstallZabbixAgentGPO.bat -> Diese prüft ob der Agent schon installiert st und beendet sich in diesem Fall sofort wieder. Fehlt der Agent wird die eigentliche Installation aufgerufen.}}<br><br>
Wir erstellen im Gruppenrichtlinien-Editor auf der gewünschten OU eine neue Gruppenrichtlinie, z.B. "Zabbix Agent installieren" und bearbeiten diese.<br>
Dann navigieren wir zu:<br>
 Computerkonfiguration
 --> Einstellungen
     --> Systemsteuerungseinstellungen
         --> Geplante Aufgaben
[[Datei:ZabbixAgent_via_GPO_002.png]]<br>
Wir klicken mit der rechten Maustaste auf "'''Geplante Aufgaben'''" oder rechts in den leeren Bereich und wählen
 Sofortige Aufgabe (mindestens Windows 7)
<br>
<br>
Es öffnet sich ein neues Fenster in der wir die Details eingeben können:<br>
[[Datei:ZabbixAgent_via_GPO_003.png]]<br>
Bei "'''''Benutzer oder Gruppe ändern...'''''" klickt ihr drauf und gebt im Nachfolgenden Fenster "SYSTEM" ein. Falls er mehrere Benutzer oder Gruppen vorschlägt wählt den reinen SYSTEM Benutzer aus.<br>
Setzt die Haken wie angegeben und vergesst den Namen nicht.<br>
Auf dem Tab "'''Aktionen'''" fügen wir nun noch den Aufruf unseres Installationsskriptes hinzu:<br>
[[Datei:ZabbixAgent_via_GPO_004.png]]<br>
<br>
Klickt auf {{key|OK}} und schließt die Gruppenrichtlinie.<br>
<br>
<br>
----

==Installation prüfen==
Geht auf einen Server auf dem der Agent noch nicht installiert ist und aktualisiert dort die Gruppenrichtlinie mit<br>
 gpupdate /force
unmittelbar nach dem Befehl wird die Installation beginnen (allerdings im Hintergrund ohne das Ihr etwas seht.<br>
Während dessen gibt es in der Aufgabenplanung auch eine Aufgabe "Zabbix Agent installieren" - die aber nach erfolgreichen Abschluss sich selbst wieder löscht.<br>
<br>
<br>
Ohne das manuelle Aktualisieren der Gruppenrichtlinien müsst Ihr den natürlichen Intervall abwarten - die Server prüfen Regelmäßig ob sich etwas geändert hat und übernehmen dann Änderungen.<br>
<br>
Per Default ist der Wert für die Computerkonfiguration 90 Minuten +/- einem 30 Minuten Zeitfenster (siehe https://technet.microsoft.com/en-us/library/cc940895.aspx )<br>
Es kann also bis zu 2h Stunden dauern bis der letzte Server dies übernommen hat.
<br>
<br>
----
==Installationsskript nur einmal ausführen per GPO==
Wenn Ihr zusätzlich bei der Erstellung der Aufgabe folgenden Haken setzt so wird das Skript nur ein einziges mal ausgeführt:<br>
[[Datei:ZabbixAgent_via_GPO_005.png]]<br>
<br>
<br>
----
==Nur auf Servern ausführen per WMI-Filter==
Der Filter ist:<br>
 Select * from Win32_OperatingSystem where Caption like "%Server%"
<br>
Anleitung für die Anwendung: http://www.windowspro.de/wolfgang-sommergut/gruppenrichtlinien-mit-wmi-filter-auf-bestimmte-pcs-oder-user-beschraenken
<br>
<br>
----

==Installationsskript nur bei Bedarf ausführen per Skript==
Wie ich oben beschrieben habe wird das Skript nun bei jeder Aktualisierung der Computerkonfiguration der Gruppenrichtlinie ausgeführt.<br>
Es ist natürlich völlig unnötig den Agenten alle ca. 90 Minuten neu zu installieren.<br>
Andererseits hat die Gruppenrichtlinie den Charme das neue Server etc. automatisch mit dem Agenten versorgt werden. Im Zusammenspiel mit einer entsprechenden Autoregistrierung auf dem Zabbix Server entgeht uns so kein Server.<br>
Auch bei zum Beispiel bei provisionierten Citrix-Terminalservern ist dies eine gute Lösung - wenn man den Agent auf das Template packt melden sich nämlich alle Server unter dem gleichen Namen da man in der Agenten-Konfigurationsdatei keine Umgebungsvariablen verwenden kann.<br>
<br>
Bleibt das Problem des ständigen Neuinstallierens.<br>
<br>
Das habe ich nun wie folgt abgeschwächt: Ich lasse das Installationsskript nicht direkt starten sondern starte statt dessen die separate Datei<br>
 InstallZabbixAgentGPO.bat
die ich im gleichen Verzeichnis wie die normale '''''InstallZabbixAgent.bat''''' ablege.<br>
Inhalt der Datei:<br>
<source lang="DOS">
@echo off
If exist "%PROGRAMFILES%\Zabbix\zabbix_agentd.win.conf" (
	Echo Agent ist installiert
) else (
	Echo Agent ist NICHT installiert, starte Setup
	\\10.112.5.88\ZabbixAgent\Agent\InstallZabbixAgent.bat
)
exit 0
</source>
Alternativ kann man prüfen ob es einen passenden Dienst gibt:<br>
<source lang="DOS">
@echo off
REM Make a test if Zabbix-Agent is already installed
sc query "Zabbix Agent" >nul 2>&1
If NOT ERRORLEVEL 1 (
    Echo Zabbix-Agent already installed - Install Agent DENIED - Exit Script
	GoTo END
        REM an Ende springen und Skript verlassen
) Else (
    Echo Missing Zabbix-Agent Configuration-File - Install Agent ALLOWED
    Set GPO_INSTALL_AGENT=TRUE
    REM Installieren des Agenten
)

:END
</source>
<br>
Ich prüfe ob es schon eine Zabbix-Installation gibt (am vorhanden sein einer entsprechenden Konfigurationsdatei) und starte nur im Fehlerfall das Setup.<br>
{{Tipp| Natürlich könnte man hier auch noch eine Unterscheidung einbauen - die GPO gilt zum Beispiel für alle Computer in der Domäne und im Skript filtere ich die Workstations heraus bzw. erlaube nur die Installation auf Servern ... oder arbeite hier dann mit Black- oder Whitelist}}<br>
<br>
<br>
----

==Windows XP / 2003==
Funktioniert im Prinzip genauso wie zuvor - aber:<br>
* Der Patch KB943729 von Microsoft muss installiert sein (kommt auch über Windows Update): http://www.microsoft.com/de-de/download/details.aspx?id=3628
* Die Gruppenrichtlinie selbst muss von mindestens einem Windows Vista / 7 oder Windows 2008 Server aus erstellt / bearbeitet werden
Ansonsten bei der Erstellung einfach die XP-Option wählen:<br>
[[Datei:ZabbixAgent_via_GPO_006.png]]<br>
<br>
[[Datei:ZabbixAgent_via_GPO_007.png]]<br>
Da er mir in der Auswahl als Standard nur .exe Dateien anbietet habe ich dem Skript ('''.BAT''') die '''CMD.EXE''' voran gestellt.<br>
<u>'''Ausführen:'''</u><br>
 C:\Windows\System32\CMD.exe
oder
 %ComSpec%
<br>
<u>'''Argumente:'''</u><br>
 /C \\Server\Freigabe\Script.bat
<br>
<br>
----

==Kommentare==
<comments />