KACE Systems Management Appliance 13.0 Common Documents

Manuelle Bereitstellung des KACE Agent

Die manuelle Bereitstellung ist hilfreich, wenn die automatisierte Agenten-Provisionierung nicht praktikabel ist oder Sie die KACE Agent-Software per E-Mail oder mithilfe von Anmeldeskripten, einem Gruppenrichtlinienobjekt oder Active Directory bereitstellen möchten.

•

E-Mail: Bei der E-Mail-basierten Bereitstellung von KACE Agenten senden Sie den Benutzern eine E-Mail mit einem der folgenden Inhalte:

◦

Die Installationsdatei für den Agenten.

◦

Einen Link zu der Appliance, von der die Agenten-Datei heruntergeladen werden kann.

◦

Einen Webspeicherort zum Download der erforderlichen Installationsdatei.

•

Logon-Skripte: Mithilfe von Anmeldeskripten können Sie den KACE Agent bereitstellen, wenn sich der Benutzer bei einem Gerät anmeldet. Bei Verwendung von Logon-Skripten laden Sie die entsprechende Datei in ein zugängliches Verzeichnis hoch und erstellen ein Logon-Skript, um die Datei abzurufen.

Agenteninstallationsdateien abrufen

Die Agenteninstallationsdateien stehen auf der Appliance zur Verfügung.

Die KACE Agent-Agenteninstallationsdateien für Windows, Mac OS X und Linux Geräte finden Sie im folgenden Verzeichnis der Appliance:

\\appliance_hostname\client\agent_provisioning

HINWEIS: Die Dateifreigabe muss aktiviert sein, um auf die Installationsdateien zugreifen zu können. Siehe Dateifreigabe auf Systemebene aktivieren.

Die Appliance verwendet einen Registrierungsprozess, der authentifizierten KACE Agenten ermöglicht, sich mit der Appliance zu verbinden. Dies kann entweder durch Verknüpfung eines Tokens mit einem Agenten oder durch Genehmigung einer Verbindungsanforderung durch einen Geräteadministrator erfolgen. Agent-Installationsprogramme, die auf diese Weise abgerufen wurden, enthalten kein gültiges Token. Sie können das Agent-Token manuell an das Installationsprogramm übergeben, indem Sie eine der folgenden Optionen verwenden:

•

Windows-Geräte:

◦

Verwenden Sie beim Starten des Installationsprogramms die folgenden Parameter: HOST=<appliance_hostname> TOKEN=<agent_token> oder:

◦

Ändern Sie den Namen der Installationsdatei manuell mithilfe der folgenden Syntax: AMPAgent-xx.xx.xx-x86_<appliance_hostname>+<agent_token>.msi

•

Nicht-Windows-Geräte:

◦

Verwenden Sie die Umgebungsvariablen KACE_HOST und KACE_TOKEN, um den Hostnamen und das Agent-Token der Appliance anzugeben, bevor Sie die Installationsdatei ausführen. Oder:

◦

Ändern Sie den Namen der Installationsdatei manuell mithilfe der folgenden Syntax: <agent_installation_filename>_<appliance_hostname>+<agent_token>.<extension>

Wenn Sie während der Agent-Installation keine gültige Tokenzeichenfolge angeben, führen alle Verbindungsanforderungen dazu, dass der Agent unter Quarantäne gestellt wird.

Alternativ können Sie Installationspakete für Agent-Token für Ihr Betriebssystem von der Seite Agent Token Detail (Details zu Agent-Token) herunterladen. Weitere Informationen hierzu finden Sie unter Registrieren des KACE Agent bei der Appliance.

KACE Agent auf Windows-Geräten manuell bereitstellen

KACE Agent auf Windows-Geräten mithilfe des Installationsassistenten manuell bereitstellen

KACE Agent auf Windows-Geräten über die Befehlszeile manuell bereitstellen

Verwalten des KACE Agent auf Windows-Geräten über die Windows-Taskleiste

Sie können den KACE Agent mithilfe des Installationsassistenten oder über die Befehlszeile des jeweiligen Geräts manuell auf Windows-Geräten bereitstellen.

Bei der manuellen Installation des Agenten müssen die ausführbaren Dateien des Agenten an folgenden Speicherorten installiert werden:

•

Windows 32-Bit-Geräte: C:\Programme\Quest\KACE\

•

Windows 64-Bit-Geräte: C:\Programme (x86)\Quest\KACE\

Die Konfigurationsdateien, Protokolle und anderen Daten des Agenten befinden sich in folgenden Verzeichnissen:

•

Windows 32-Bit-Geräte: C:\Dokumente und Einstellungen\All Users\Quest\KACE

•

Windows 64-Bit-Geräte: C:\ProgramData\Quest\KACE

KACE Agent auf Windows-Geräten mithilfe des Installationsassistenten manuell bereitstellen

Sie können den KACE Agent manuell auf Windows-Geräten bereitstellen, indem Sie auf den Geräten den Installationsassistenten ausführen.

Wechseln Sie zum freigegebenen Verzeichnis der Appliance:

\\appliance_hostname\client\agent_provisioning\windows_platform

Kopieren Sie die Datei ampagent-x.x.xxxxx-x86.msi auf das Gerät.

Doppelklicken Sie auf die Datei, um die Installation zu starten, und befolgen Sie die Anweisungen im Installationsassistenten.

Wenn Sie den Agenten bei der Appliance registrieren möchten:

◦

Verwenden Sie beim Starten des Installationsprogramms die folgenden Parameter: HOST=<appliance_hostname> TOKEN=<agent_token> oder:

◦

Ändern Sie den Namen der Installationsdatei manuell mithilfe der folgenden Syntax: AMPAgent-xx.xx.xx-x86_<appliance_hostname>+<agent_token>.msi

Sie können die Zeichenfolge des Agent-Tokens auf der Seite Agent Token Detail (Details zum Agent-Token) abrufen. Weitere Informationen finden Sie unter Registrieren des KACE Agent bei der Appliance.

Die Geräteinformationen werden innerhalb weniger Minuten im Inventar der Appliance angezeigt. Siehe Verwalten von Anwendungen auf der Seite "Software".

KACE Agent auf Windows-Geräten über die Befehlszeile manuell bereitstellen

Es gibt verschiedene Möglichkeiten zur Bereitstellung des Agenten mithilfe der Befehlszeile auf Windows-Geräten.

Beispiel:

•

In einer Batch-Datei als Teil eines Anmeldeskripts, mit dem die Installationsdatei (msiexec) ausgeführt wird und verschiedene Parameter, etwa der Wert des Hosts, festgelegt werden.

•

Legen Sie eine Umgebungsvariable für den Servernamen fest und führen Sie anschließend die Installationsdatei aus.

•

Ändern Sie den Namen der Installationsdatei, mit der der Servername während der Installation automatisch festgelegt wird.

In der folgenden Tabelle sind die Befehlszeilenparameter zur Bereitstellung des Agenten aufgeführt.

Befehlszeilenparameter für den Agenten
Beschreibung	Parameter
Windows Installationsprogramm	msiexec oder msiexec.exe
Installationsflag	/i Beispiel: msiexec /i ampagent-6.x.xxxxx-x86
Deinstallationsflag	/x Beispiel: msiexec /x ampagent-6.x.xxxxx-x86
Installation im Hintergrund	/qn Beispiel: msiexec /qn /i ampagent-6.x.xxxxx-x86
Ausführliche Protokollausgabe	/Lv log.txt Beispiel: msiexec /qn /Lv C:\temp\log.txt /i ampagent-6.x.xxxxx-x86
Automatische Festlegung des Hostnamens: Benennt die Installationsdatei in den Namen des Servers um. So wird der Hostname automatisch festgelegt.	rename agent_installer.msi_hostname.msi Beispiel: msiexec /qn /i ampagent-6.x.xxxxx-x86_kace_sma.example.com.msi
Festlegen von Eigenschaften	PROPERTY=value (GROSSBUCHSTABEN verwenden) Beispiel: msiexec /qn /i ampagent-6.x.xxxxx-x86.msi HOST=kace_sma.example.com
Festlegen des Servernamens	set KACE_SERVER=kace_sma_name Hier muss eine zu installierende msiexec-Datei angefügt werden. Beispiel: set KACE_SERVER=kboxmsiexec /i ampagent-6.x.xxxxx-x86
Vermeiden Sie die Installation von Anmelde- oder Systemstart-Elementen und behalten Sie die bestehenden Dateien mit der Bezeichnung userinit.exe bei.	NOHOOKS=1 Beispiel: msiexec /qn /i ampagent-6.x.xxxxx-x86.msi HOST=kace_sma.example.com NOHOOKS=1
Installiert den Agenten, startet jedoch nicht den Dienst. Dadurch kann ein Image des Agenten erstellt werden, das auf andere Geräte geklont wird.	CLONEPREP=yes/no Beispiel: msiexec /qn /i ampagent-6.x.xxxxx-x86.msi HOST=kace_sma.example.com CLONEPREP=yes
Legen Sie die Debug-Ebene für den Agenten fest, wenn dieser Protokolle generiert.	DEBUG=true/all Beispiel: msiexec /qn /i ampagent-6.x.xxxxx-x86.msi HOST=kace_sma.example.com DEBUG=true
Erzwingt die ausschließliche Kommunikation des Agenten per HTTPS. Beim Ausfall von HTTPS ist die Nutzung von HTTP nicht möglich.	SSLREQUIRED=true Beispiel: msiexec /qn /i ampagent-6.x.xxxxx-x86.msi HOST=kace_sma.example.com SSLREQUIRED=true

Das System sucht an diesen Speicherorten im angezeigten Ordner nach dem Wert des Hosts:

Die Installationsdatei

Der Eigenschaftswert HOST

KACE_SERVER (Umgebungsvariable)

Die Datei amp.conf

Wenn Sie den Agenten bei der Appliance registrieren möchten:

•

Verwenden Sie beim Starten des Installationsprogramms die folgenden Parameter: HOST=<appliance_hostname> TOKEN=<agent_token> oder:

•

Ändern Sie den Namen der Installationsdatei manuell mithilfe der folgenden Syntax: AMPAgent-xx.xx.xx-x86_<appliance_hostname>+<agent_token>.msi

Sie können die Zeichenfolge des Agent-Tokens auf der Seite Agent Token Detail (Details zum Agent-Token) abrufen. Weitere Informationen finden Sie unter Registrieren des KACE Agent bei der Appliance

VORSICHT: Wenn Sie den Wert des Hosts leer lassen, müssen Sie die Umgebungsvariable festlegen. Andernfalls stellt der Agent keine Verbindung mit der Appliance her. Quest empfiehlt, den vollständig qualifizierten Domänennamen als Hostnamen zu verwenden.

Verwalten des KACE Agent auf Windows-Geräten über die Windows-Taskleiste

Sie können über die Windows-Taskleiste den Status des KACE Agent anzeigen, eine Bestandsaufnahme erzwingen und die Agenteninformationen anzeigen.

Um den KACE Agent-Status über die Taskleiste aufzurufen, müssen Sie im Abschnitt Agenten- und Kommunikationseinstellungen die Option Agenten-Status auf Gerät aktivieren. Weitere Informationen hierzu finden Sie unter Agentenkommunikation und Protokolleinstellungen konfigurieren.

Klicken Sie auf dem Windows-Gerät, auf dem der KACE Agent ausgeführt wird, in der Windows-Taskleiste auf

Die Anzeige in der unteren rechten Ecke des Symbols gibt Auskunft über den Status des Agenten:

◦

: Der Agent ist mit der Appliance verbunden.

◦

: Der Agent befindet sich im Snooze-Modus.

◦

: Der Agent weist ausstehende Aktionen auf.

◦

: Der Agent ist von der Appliance getrennt.

Um herauszufinden, ob der Agent mit der Appliance verbunden ist, beachten Sie das Statussymbol im Menü.

Hierbei handelt es sich um die gleiche Anzeige wie oben beschrieben, die auf dem Agent-Symbol angezeigt wird und darüber Auskunft gibt, ob der Agent verbunden ist, sich im Snooze-Modus befindet, ausstehende Aktionen aufweist oder von der Appliance getrennt wurde.

Um die Gerätebestandsaufnahme auszuführen, klicken Sie im Menü auf Bestandsaufnahme.

Um den Agenten neu zu starten, klicken Sie auf Agent neu starten im Menü.

Um die Aktivität des Agenten während eines bestimmten Zeitraums vorübergehend zu unterbrechen, klicken Sie auf Agent im Snooze-Modus und wählen Sie einen Zeitraum im Menü aus. Sie können den Agent für 15 Minuten, 30 Minuten, eine Stunde oder zwei Stunden lang in den Snooze-Modus versetzen.

HINWEIS: Sie können die Snooze-Funktion nur dann aktivieren, wenn die Option Agent auf Gerät im Snooze-Modus im Abschnitt Agent und Kommunikationseinstellungen auf der Appliance aktiviert ist und die maximale Anzahl von Snooze-Modus-Aktivierungen noch nicht erreicht wurde. Weitere Informationen hierzu finden Sie unter Agentenkommunikation und Protokolleinstellungen konfigurieren.

Durch die Aktivierung des Snooze-Modus für einen Agenten werden keine laufenden Agentenprozesse auf dem Gerät gestoppt. Sie verhindert nur, dass der Agent einen neuen Prozess startet. Wenn die Aktivierung der Agenten-Snooze-Funktion nicht möglich ist, z. B. aufgrund der Konfiguration, wird eine Fehlermeldung angezeigt.

Klicken Sie zum Installieren der Patches, die auf das Agent-Gerät heruntergeladen wurden, auf Deploy staged patches (Bereitgestellte Patches bereitstellen).

HINWEIS: Dieses Menüelement wird nur angezeigt, wenn alle anwendbaren Patches über einen Zeitplan für Erkennung, Staging und bedarfsgerechte Bereitstellung von Patches oder Windows-Funktionen auf das Agent-Gerät heruntergeladen werden. Weitere Informationen hierzu finden Sie unter Konfigurieren von Patch-Zeitplänen.

Klicken Sie zum Aufrufen von Links, die sich auf Agenten beziehen, im Menü auf Shortcuts (Verknüpfungen) und dann ggf. auf einen Link. Alle Standard-URI-Links (Uniform Resource Identifier) werden unterstützt, wie z. B. https-, ssh- und ftp-URLs.

Dieses Menüelement wird nur angezeigt, wenn der Systemadministrator einen oder mehrere Links festlegt. Weitere Informationen hierzu finden Sie unter Agentenkommunikation und Protokolleinstellungen konfigurieren.

Wenn Sie auf diesen Link klicken, startet Ihr Betriebssystem die Anwendung, die mit der ausgewählten Ressource verknüpft ist. Wenn Sie beispielsweise auf einen Link vom Typ HTTP klicken, öffnet Ihr System den Link im Standardbrowser.

Um mehr über die Agentenanwendung zu erfahren, klicken Sie auf Info.

KACE Agent auf Windows-Geräten mithilfe des Installationsassistenten manuell bereitstellen

KACE Agent auf Windows-Geräten manuell bereitstellen

KACE Agent auf Windows-Geräten mithilfe des Installationsassistenten manuell bereitstellen

KACE Agent auf Windows-Geräten über die Befehlszeile manuell bereitstellen

Verwalten des KACE Agent auf Windows-Geräten über die Windows-Taskleiste

Sie können den KACE Agent mithilfe des Installationsassistenten oder über die Befehlszeile des jeweiligen Geräts manuell auf Windows-Geräten bereitstellen.

Bei der manuellen Installation des Agenten müssen die ausführbaren Dateien des Agenten an folgenden Speicherorten installiert werden:

•

Windows 32-Bit-Geräte: C:\Programme\Quest\KACE\

•

Windows 64-Bit-Geräte: C:\Programme (x86)\Quest\KACE\

Die Konfigurationsdateien, Protokolle und anderen Daten des Agenten befinden sich in folgenden Verzeichnissen:

•

Windows 32-Bit-Geräte: C:\Dokumente und Einstellungen\All Users\Quest\KACE

•

Windows 64-Bit-Geräte: C:\ProgramData\Quest\KACE

KACE Agent auf Windows-Geräten mithilfe des Installationsassistenten manuell bereitstellen

Sie können den KACE Agent manuell auf Windows-Geräten bereitstellen, indem Sie auf den Geräten den Installationsassistenten ausführen.

Wechseln Sie zum freigegebenen Verzeichnis der Appliance:

\\appliance_hostname\client\agent_provisioning\windows_platform

Kopieren Sie die Datei ampagent-x.x.xxxxx-x86.msi auf das Gerät.

Doppelklicken Sie auf die Datei, um die Installation zu starten, und befolgen Sie die Anweisungen im Installationsassistenten.

Wenn Sie den Agenten bei der Appliance registrieren möchten:

◦

Verwenden Sie beim Starten des Installationsprogramms die folgenden Parameter: HOST=<appliance_hostname> TOKEN=<agent_token> oder:

◦

Ändern Sie den Namen der Installationsdatei manuell mithilfe der folgenden Syntax: AMPAgent-xx.xx.xx-x86_<appliance_hostname>+<agent_token>.msi

Sie können die Zeichenfolge des Agent-Tokens auf der Seite Agent Token Detail (Details zum Agent-Token) abrufen. Weitere Informationen finden Sie unter Registrieren des KACE Agent bei der Appliance.

Die Geräteinformationen werden innerhalb weniger Minuten im Inventar der Appliance angezeigt. Siehe Verwalten von Anwendungen auf der Seite "Software".

KACE Agent auf Windows-Geräten über die Befehlszeile manuell bereitstellen

Es gibt verschiedene Möglichkeiten zur Bereitstellung des Agenten mithilfe der Befehlszeile auf Windows-Geräten.

Beispiel:

•

In einer Batch-Datei als Teil eines Anmeldeskripts, mit dem die Installationsdatei (msiexec) ausgeführt wird und verschiedene Parameter, etwa der Wert des Hosts, festgelegt werden.

•

Legen Sie eine Umgebungsvariable für den Servernamen fest und führen Sie anschließend die Installationsdatei aus.

•

Ändern Sie den Namen der Installationsdatei, mit der der Servername während der Installation automatisch festgelegt wird.

In der folgenden Tabelle sind die Befehlszeilenparameter zur Bereitstellung des Agenten aufgeführt.

Befehlszeilenparameter für den Agenten
Beschreibung	Parameter
Windows Installationsprogramm	msiexec oder msiexec.exe
Installationsflag	/i Beispiel: msiexec /i ampagent-6.x.xxxxx-x86
Deinstallationsflag	/x Beispiel: msiexec /x ampagent-6.x.xxxxx-x86
Installation im Hintergrund	/qn Beispiel: msiexec /qn /i ampagent-6.x.xxxxx-x86
Ausführliche Protokollausgabe	/Lv log.txt Beispiel: msiexec /qn /Lv C:\temp\log.txt /i ampagent-6.x.xxxxx-x86
Automatische Festlegung des Hostnamens: Benennt die Installationsdatei in den Namen des Servers um. So wird der Hostname automatisch festgelegt.	rename agent_installer.msi_hostname.msi Beispiel: msiexec /qn /i ampagent-6.x.xxxxx-x86_kace_sma.example.com.msi
Festlegen von Eigenschaften	PROPERTY=value (GROSSBUCHSTABEN verwenden) Beispiel: msiexec /qn /i ampagent-6.x.xxxxx-x86.msi HOST=kace_sma.example.com
Festlegen des Servernamens	set KACE_SERVER=kace_sma_name Hier muss eine zu installierende msiexec-Datei angefügt werden. Beispiel: set KACE_SERVER=kboxmsiexec /i ampagent-6.x.xxxxx-x86
Vermeiden Sie die Installation von Anmelde- oder Systemstart-Elementen und behalten Sie die bestehenden Dateien mit der Bezeichnung userinit.exe bei.	NOHOOKS=1 Beispiel: msiexec /qn /i ampagent-6.x.xxxxx-x86.msi HOST=kace_sma.example.com NOHOOKS=1
Installiert den Agenten, startet jedoch nicht den Dienst. Dadurch kann ein Image des Agenten erstellt werden, das auf andere Geräte geklont wird.	CLONEPREP=yes/no Beispiel: msiexec /qn /i ampagent-6.x.xxxxx-x86.msi HOST=kace_sma.example.com CLONEPREP=yes
Legen Sie die Debug-Ebene für den Agenten fest, wenn dieser Protokolle generiert.	DEBUG=true/all Beispiel: msiexec /qn /i ampagent-6.x.xxxxx-x86.msi HOST=kace_sma.example.com DEBUG=true
Erzwingt die ausschließliche Kommunikation des Agenten per HTTPS. Beim Ausfall von HTTPS ist die Nutzung von HTTP nicht möglich.	SSLREQUIRED=true Beispiel: msiexec /qn /i ampagent-6.x.xxxxx-x86.msi HOST=kace_sma.example.com SSLREQUIRED=true