Agent

Installieren und Konfigurieren des Agenten

Hinweis:

  • Installieren Sie den Workspace Environment Management (WEM) -Agent nicht auf dem Infrastrukturserver.
  • Installieren Sie den WEM-Agent und die Verwaltungskonsole nicht auf demselben Computer.
  • Wenn Sie in Citrix StoreFront res veröffentlichte Ressourcen als Anwendungsverknüpfungen in WEM über die Verwaltungskonsole zuweisen möchten, stellen Sie sicher, dass die Citrix Workspace App für Windows auf der Verwaltungskonsole und auf den Agent-Hostcomputern installiert ist. Weitere Informationen finden Sie unter Systemanforderungen.

Schritt 1: Konfigurieren von Gruppenrichtlinien (optional)

Optional können Sie die Gruppenrichtlinien für den Agenten mit deradministrativen Vorlage fürCitrix Workspace Environment Management Agent-Hostkonfiguration konfigurieren. Das WEM-Installationspaket enthält diese Vorlage. Die Vorlagendateien sind in ADMX-Dateien und sprachspezifische ADML-Dateien unterteilt. Es wird empfohlen, die Gruppenrichtlinien auf dem Domänencontroller zu konfigurieren.

Führen Sie die folgenden Schritte aus, um die Agent-Host-Konfigurationsrichtlinie hinzuzufügen:

  1. Kopieren Sie den mit dem WEM-Installationspaket bereitgestelltenOrdnerAgent-Gruppenrichtlinien auf Ihren WEM-DomänenController.
  2. Fügen Sie die ADMX-Dateien hinzu.

  3. Wechseln Sie zumOrdnerAgent-Gruppenrichtlinien > ADMX.
  4. Kopieren Sie die beiden Dateien (Citrix Workspace Environment Management Agent-Hostkonfiguration.admx und CitrixBase.admx).
  5. Wechseln Sie zum < C:\Windows >Ordner\ PolicyDefinitions, und fügen Sie die Dateien ein.

  6. Fügen Sie die ADML-Dateien hinzu.

  7. Wechseln Sie zumOrdnerAgent-Gruppenrichtlinien > ADMX > en-US.
  8. Kopieren Sie die beiden Dateien (Citrix Workspace Environment Management Agent Host Configuration.adml und CitrixBase.adml).
  9. Wechseln Sie zum < C:\Windows >Ordner\ PolicyDefinitions\ en-US, und fügen Sie die Dateien ein.

Verwenden Sie den Gruppenrichtlinienverwaltungs-Editor, um ein Gruppenrichtlinienobjekt mit den folgenden Einstellungen zu konfigurieren:

Gruppenrichtlinien-Verwaltungseditor

Infrastruktur-Server. Die Adresse des WEM-Infrastrukturservers. Geben Sie den Namen oder die IP-Adresse des Computers ein, auf dem der Infrastrukturdienst installiert ist.

Agent-Dienst-Port. Der Port, über den der Agent eine Verbindung zum Infrastrukturserver herstellt. Der Agentendienst-Port muss mit dem Port übereinstimmen, den Sie während der Konfiguration der Infrastrukturdienste für den Agentendienst-Port konfiguriert haben. Wenn nicht angegeben, wird der Port standardmäßig 8286 verwendet.

Cache-Synchronisationsport. (Gilt für Workspace Environment Management 1909 und früher; ersetzt durch zwischengespeicherte Datensynchronisierungs-Port in Workspace Environment Management 1912 und höher.) Der Port, auf dem der Agent-Cache-Synchronisierungsprozess eine Verbindung mit dem Infrastrukturdienst herstellt, um den Agent-Cache mit dem Infrastrukturserver zu synchronisieren. Der Cachesynchronisationsport muss mit dem Port übereinstimmen, den Sie während der Konfiguration der Infrastrukturdienste für den Cachesynchronisationsport (WEM Infrastructure Service Configuration > Network Settings) konfiguriert haben. Der Port ist standardmäßig 8285 und entspricht dem Befehlszeilenargument AgentCacheSyncPort.

Zwischengespeicherter Datensynchronisationsport. (Gilt für Workspace Environment Management 1912 und höher; ersetzt den Cache-Synchronisationsport von Workspace Environment Management 1909 und früher.) Der Port, auf dem der Agent-Cache-Synchronisierungsprozess eine Verbindung mit dem Infrastrukturdienst herstellt, um den Agent-Cache mit dem Infrastrukturserver zu synchronisieren. Der zwischengespeicherte Datensynchronisierungsport muss mit dem Port übereinstimmen, den Sie während der Konfiguration der Infrastrukturdienste für den zwischengespeicherten Datensynchronisierungsport (WEM Infrastructure Service Configuration > Network Settings) konfiguriert haben. Der Port ist standardmäßig 8288 und entspricht dem Befehlszeilenargument CachedDataSyncPort. Alternativ können Sie den Port über eine Befehlszeilenoption bei der unbeaufsichtigten Installation des WEM-Agenten angeben. Beispiel:

  • citrix_wem_agent_bundle.exe /quiet cachedDataSyncPort=9000

Citrix Cloud Connectors: Gilt nicht für die lokalen Versionen von WEM. Lassen Sie den Status Nicht konfiguriert.

Agent-Proxy-Konfiguration. Gilt nicht für die lokalen Versionen von WEM. Lassen Sie den Status Nicht konfiguriert.

VueMapPcmd zusätzliche Synchronisierungsverzögerung. Gibt an, wie lange der Startprogramm der Agentenanwendung (VuemAppCmd.exe) wartet, bevor die veröffentlichten Citrix Virtual Apps and Desktops gestartet werden. Diese Einstellung stellt sicher, dass die erforderlichen Agentenarbeiten zuerst abgeschlossen werden. Wenn nicht angegeben, ist das Verzögerungsintervall standardmäßig 0.

Schritt 2: Installieren des Agenten

Wichtig:

Obwohl .NET Framework während der Agenteninstallation automatisch installiert werden kann, empfiehlt es sich, es manuell zu installieren, bevor Sie den Agent installieren. Andernfalls müssen Sie den Computer neu starten, um mit der Agenteninstallation fortzufahren, und es kann lange dauern, bis der Vorgang abgeschlossen ist.

Sie können das Setup des Citrix Workspace Environment Management Agent in Ihrer Benutzerumgebung ausführen. Sie können den Agenten auch über die Befehlszeile installieren. Standardmäßig wird der Agent je nach Betriebssystem in einem der folgenden Ordner installiert:

  • C:\Program Files (x86)\ Citrix\ Workspace Environment Management Agent (auf 64-Bit-Betriebssystem)
  • C:\Program Files\ Citrix\ Workspace Environment Management Agent (auf 32-Bit-Betriebssystem)

Führen Sie die folgenden Schritte aus, um den Agenten interaktiv zu installieren:

  1. Führen Sie den Citrix Workspace Environment Management Agent Setup.exe auf Ihrem Computer aus.
  2. Wählen Sie Ich stimme den Lizenzbedingungen zu und klicken Sie dann auf Installieren.
  3. Klicken Sie auf der Willkommensseite auf Weiter.

Hinweis:

Die Willkommensseite kann einige Zeit dauern, bis sie angezeigt wird. Diese Verzögerung tritt auf, wenn die erforderliche Software fehlt und im Hintergrund installiert wird.

  1. Klicken Sie auf der Seite Zielordner auf Weiter.
  • Standardmäßig wird das Zielordnerfeld automatisch mit dem Standardordnerpfad gefüllt. Wenn Sie den Agent in einem anderen Ordner installieren möchten, klicken Sie auf Ändern, um zum Ordner zu navigieren, und klicken Sie dann auf Weiter.
  • Wenn Sie den WEM-Agent bereits installiert haben, wird das Zielordnerfeld automatisch mit dem Pfad des vorhandenen Installationsordners gefüllt.
  1. Wählen Sie auf der Seite Bereitstellungstyp den entsprechenden Bereitstellungstyp aus, und klicken Sie dann auf Weiter. Wählen Sie in diesem Fall die Option Lokale Bereitstellung aus.

Installation des WEM-Agenten 01

  1. Geben Sie auf der Seite Infrastrukturdienstkonfiguration den Infrastrukturdienst an, mit dem der Agent eine Verbindung herstellt, und klicken Sie dann auf Weiter.
  • Konfiguration überspringen. Wählen Sie diese Option aus, wenn Sie die Einstellung bereits mithilfe von Gruppenrichtlinien konfiguriert haben.
  • Konfigurieren Sie den Infrastrukturdienst. Hiermit können Sie den Infrastrukturdienst konfigurieren, indem Sie den FQDN oder die IP-Adresse des Infrastrukturdienstes eingeben.
  • Agent-Dienst-Port. Standardmäßig ist der Wert 8286.
  • Zwischengespeicherter Datensynchronisationsport. Standardmäßig ist der Wert 8288.

    Installation des WEM-Agenten 02

  1. Konfigurieren Sie auf der Seite Erweiterte Einstellungen erweiterte Einstellungen für den Agent, und klicken Sie dann auf Weiter.
  • Alternativer Cache-Speicherort (optional). Hier können Sie einen alternativen Speicherort für den Agent-Cache angeben. Klicken Sie auf Durchsuchen, um zum entsprechenden Ordner zu navigieren.
  • VueAppCmd Zusätzliche Synchronisierungsverzögerung (Optional). Hier können Sie angeben, wie lange der Startprogramm der Agentenanwendung (VuemAppCmd.exe) wartet, bevor veröffentlichte Ressourcen gestartet werden. Durch das Festlegen dieser Verzögerung wird sichergestellt, dass die erforderliche Agentenarbeit zuerst abgeschlossen wird. Der Standardwert ist 0.

    Hinweis:

    Der Wert, den Sie für das zusätzliche Synchronisierungsverzögerungsintervall eingeben, muss eine ganze Zahl größer oder gleich Null sein.

    Installation des WEM-Agenten 03

  1. Klicken Sie auf der Seite Bereit zur Installation auf Installieren.
  2. Klicken Sie auf Fertig stellen, um den Installationsassistenten zu beenden.

Alternativ können Sie eine unbeaufsichtigte Installation des WEM-Agenten wählen. Verwenden Sie dazu die folgende Befehlszeile:

  • „ Citrix Workspace Environment Management Agent Setup.exe“ /quiet Cloud=0

Tipp:

Sie können die Protokolldateien konsultieren, um die Agenteninstallation zu beheben. Standardmäßig werden Protokolldateien, die alle Aktionen aufzeichnen, die während der Installation auftreten, in%TEMP% erstellt. Sie können den Befehl /log log.txt verwenden, um einen bestimmten Speicherort für die zu speichernden Protokolldateien festzulegen.

Sie können auch Befehlszeilenoptionen verwenden, um benutzerdefinierte Argumente anzugeben. Auf diese Weise können Sie die Agent- und Systemeinstellungen während des Installationsvorgangs anpassen. Weitere Informationen finden Sie unter Gut zu wissen.

Nach der Installation wird der Agent als Citrix WEM Agent Host Service (früher Norskale Agent Host Service) und Citrix WEM Agent User Logon Service ausgeführt. Der Agent wird als Konto LocalSystem ausgeführt. Wir unterstützen die Änderung dieses Kontos nicht. Der Dienst erfordert die Anmeldung als lokale Systemberechtigung.

Schritt 3: Erstellen des Agentendienst-Cache (optional)

Standardmäßig wird der Agent-Service-Cache erstellt, wenn der Agent zum ersten Mal ausgeführt wird. Sie können den Agentendienstcache erstellen, bevor der Agent ausgeführt wird. Dies ist hilfreich, wenn Sie ein Image erstellen möchten, das den WEM-Agent-Host als vorinstallierte Software enthält.

Um den Agent-Dienstcache zu erstellen oder neu zu erstellen, führen Sie AgentCacheUtility.exe im Agentinstallationsordner über die Befehlszeile aus. Die ausführbare Datei akzeptiert die folgenden Befehlszeilenargumente:

  • -help: zeigt eine Liste der zulässigen Argumente an
  • -refreshcache oder -r: löst einen Cache-Build oder -Aktualisierung aus

Schritt 4: Starten Sie den Computer neu, um die Installation abzuschließen

Nützliche Info

Die ausführbare Agent-Datei akzeptiert benutzerdefinierte Argumente, wie in den Abschnitten Agent-Einstellungen und Systemeinstellungen beschrieben.

Agent-Einstellungen

Zu den Einstellungen des WEM-Agenten gehören:

  • AgentLocation. Hier können Sie den Speicherort für die Agenteninstallation angeben. Geben Sie einen gültigen Ordnerpfad an.

  • AgentCacheLocation. Hier können Sie einen alternativen Speicherort für den Agent-Cache angeben. Wenn konfiguriert, wird die lokale Agenten-Cache-Datei am angegebenen Speicherort statt im Agenteninstallationsordner gespeichert.

  • AgentCacheSyncPort. Hier können Sie den Port angeben, auf dem der Agent-Cache-Synchronisierungsprozess eine Verbindung mit dem Infrastrukturdienst herstellt, um den Agent-Cache mit dem Infrastrukturserver zu synchronisieren.

  • AgentServicePort. Hier können Sie den Port angeben, auf dem der Agent eine Verbindung zum Infrastrukturserver herstellt.

  • InfrastructureServer. Hier können Sie den FQDN oder die IP-Adresse des Infrastrukturservers angeben, auf dem der Infrastrukturdienst ausgeführt wird.

  • VueAppCmdDelay. Hier können Sie angeben, wie lange der Startprogramm der Agentenanwendung (VuemAppCmd.exe) wartet, bevor die veröffentlichten Citrix Virtual Apps and Desktops gestartet werden. Der Standardwert ist 0 (Millisekunden). Der Wert, den Sie für das zusätzliche Synchronisierungsverzögerungsintervall eingeben, muss eine ganze Zahl größer oder gleich Null sein.

Beachten Sie Folgendes:

  • Wenn Sie die Einstellungen über die Befehlszeile konfigurieren, verwendet das WEM-Agent-Installationsprogramm die konfigurierten Einstellungen.

  • Wenn Sie die Einstellungen nicht über die Befehlszeile konfigurieren und zuvor konfigurierte Einstellungen vorliegen, verwendet das Installationsprogramm die zuvor konfigurierten Einstellungen.

  • Wenn Sie die Einstellungen nicht über die Befehlszeile konfigurieren und keine zuvor konfigurierten Einstellungen vorliegen, verwendet das Installationsprogramm die Standardeinstellungen.

Systemeinstellungen

Zu den Systemeinstellungen, die mit dem Agent-Hostcomputer verknüpft sind, gehören:

  • GPNetworkStartTimeoutPolicyValue. Hiermit können Sie den Wert des Registrierungsschlüssels GpNetworkStartTimeoutPolicyValue, der während der Installation erstellt wurde, in Sekunden konfigurieren. Dieses Argument gibt an, wie lange die Gruppenrichtlinie bei der Anmeldung auf Benachrichtigungen zur Netzwerkverfügbarkeit wartet. Das Argument akzeptiert eine ganze Zahl im Bereich von 1 (Minimum) bis 600 (Maximum). Standardmäßig ist dieser Wert 120.

  • SyncForegroundPolicy. Ermöglicht die Konfiguration des Registrierungswerts SyncForegroundPolicy während der Agenteninstallation. Diese Richtlinieneinstellung bestimmt, ob die Gruppenrichtlinienverarbeitung synchron ist. Akzeptierte Werte: 0, 1. Wenn der Wert nicht festgelegt ist oder Sie den Wert auf 0 festlegen, verzögert der Citrix WEM-Agent-Benutzeranmeldedienst keine Anmeldungen, und Benutzergruppenrichtlinieneinstellungen werden im Hintergrund verarbeitet. Wenn Sie den Wert auf 1 festlegen, verzögert der Citrix WEM-Agent-Benutzeranmeldedienst Anmeldungen, bis die Verarbeitung der Gruppenrichtlinieneinstellungen des Benutzers abgeschlossen ist. Standardmäßig ändert sich der Wert während der Installation nicht.

    Wichtig:

    Wenn Gruppenrichtlinieneinstellungen im Hintergrund verarbeitet werden, wird möglicherweise Windows Shell (Windows Explorer) gestartet, bevor alle Richtlinieneinstellungen verarbeitet werden. Daher werden einige Einstellungen möglicherweise nicht wirksam, wenn sich ein Benutzer zum ersten Mal anmeldet. Wenn alle Richtlinieneinstellungen bei der ersten Anmeldung eines Benutzers verarbeitet werden sollen, legen Sie den Wert auf 1 fest.

  • WaitForNetwork. Hier können Sie den Wert desRegistrierungsschlüsselsWaitForNetwork in Sekunden konfigurieren, der während der Installation erstellt wurde. Dieses Argument gibt an, wie lange der Agent-Host darauf wartet, dass das Netzwerk vollständig initialisiert und verfügbar ist. Das Argument akzeptiert eine ganze Zahl im Bereich von 0 (Minimum) bis 300 (Maximum). Standardmäßig ist dieser Wert 30.

Die vorherigen drei Tasten stellen sicher, dass der WEM-Agent-Dienst gestartet wird, bevor der Windows-Anmeldebildschirm angezeigt wird. Alle drei Schlüssel werdenwährend der Installation unterHKEY_LOCAL_MACHINE\ SOFTWARE\ Microsoft\ Windows NT\ CurrentVersion\ Winlogon erstellt. Die Schlüssel stellen außerdem sicher, dass die Benutzerumgebung die GPOs der Infrastrukturserveradresse vor der Anmeldung empfängt. In Netzwerkumgebungen, in denen die Active Directory - oder Domänencontroller-Server langsam reagieren, kann es zu einer zusätzlichen Verarbeitungszeit kommen, bevor der Anmeldebildschirm angezeigt wird. Es wird empfohlen, den Wert desSchlüssels „GpNetworkStartTimeoutPolicyValue“ auf mindestens 30 festzulegen, damit er sich auswirkt.

  • ServicePipeMeout. Hiermit können Sie den Wert des Registrierungsschlüssels ServicesPipetimeOut konfigurieren. Der Schlüssel wird während der Installation unter HKEY_LOCAL_MACHINE\ SYSTEM\ CurrentControlSet\ Control erstellt. Dieser Registrierungsschlüssel fügt eine Verzögerung hinzu, bevor der Dienststeuerungsmanager über den Status des WEM-Agent-Dienstes berichten darf. Die Verzögerung verhindert, dass der Agent ausfällt, indem der Agent-Dienst nicht gestartet wird, bevor das Netzwerk initialisiert wird. Dieses Argument akzeptiert einen beliebigen Wert in Millisekunden. Wenn nicht angegeben, wird der Standardwert 60000 (60 Sekunden) verwendet.

    Hinweis:

    Wenn Sie die vorherigen Einstellungen nicht über die Befehlszeile konfigurieren, werden sie vom WEM-Agent-Installationsprogramm während der Installation nicht verarbeitet.

Beispiele

Sie können die Einstellungen im folgenden Befehlszeilenformat konfigurieren:

  • „ Citrix Workspace Environment Management Agent Setup.exe“ <key=value>

Beispiel:

  • Wählen Sie eine unbeaufsichtigte Installation oder ein Upgrade des WEM-Agenten
    • „ Citrix Workspace Environment Management Agent Setup.exe“ /quiet Cloud=0
  • Festlegen der Wartezeit für das Benutzeranmeldungsnetzwerk auf 60 Sekunden
    • „ Citrix Workspace Umgebungsverwaltungs-Agent Setup.exe“ WaitForNetwork=60
Agent