Workspace Environment Management - Installation und Konfiguration

Diesen Blogbeitrag sehe ich als die Fortsetzung des folgenden Artikels Citrix WEM ist ein gutes Produkt, finden sie mit mir heraus, warum? Hier werden die notwendigen Installationsschritte, allgemeine Basis-Konfiguration, sowie für die System-Optimierung notwendige Konfiguration beschrieben. Die Anleitung wurde auf Basis der Version WEM 2006 erstellt.

 

Citrix Workspace Environment Management - Architekturdiagramm und  Firewall Ports

 

WEM  

Legen Sie bitte die Regeln Ihrer Firewall fest, um die Kommunikation zwischen den WEM-Komponenten zu ermöglichen:  

 Source  Destination  Type   Port  Beschreibung

 Infrastructure

Service

 Agent  TCP  8285  Cache Synchronization Port
 8286  Agent Service Port
 8287   WEM Monitoring Port
 8288  Cached Data Synchronization Port (ab Version )
 49752  
 License Server   TCP  27000   Kommunikation mit dem License Server
 7279  Vendor Daemon, Check-in/check-out von Lizenzen 
 MS SQL Server  TCP  1433  Kommunikation mit dem Datenbank Server
 Administration console   Infrastructure service   TCP   8284  Kommunikation zwischen Brocker und Console

 Quellen:  CTX101810 - Communication Ports Used by Citrix Technologies

 

Vorbereitung

Bevor Sie mit der Installation beginnen können, sind einige vorbereitende Schritte notwendig.

1. Laden Sie die Installationsdatei herunter.  Workspace-environment-management

002 WEM 2003

und entpacken Sie diese:

002 WEM 2006

2. Service Account erstellen

Erstellen Sie einen Windows Service Benutzer. Der Benutzer muss ein Mitglied der lokalen Administratoren auf dem Infrastructure Service Server (Brocker) sein.

003 WEM Local Admin

3. Anpassung des Datenbank-Authentifizierungsmodus 

Stellen Sie die Datenbank-Authentifizierung auf einen gemischten Modus um. In diesem Fall kann die SQL-Datenbank sowohl in AD zentralverwaltete Benutzer als auch lokal angelegte für die Datenbank-Zugriffe berechtigen.

SQL-Server > rechte Maustaste => Properties >  Security >  SQL Server and Windows Authentication Mode

004 WEM 2003.PNG

4. GPO Vorlagen importieren / Richtlinien erstellen

Dieser Schritt ist optional, ist aber empfohlen, dass die Adresse des WEM-Brokers zentral verwaltet wird.
Die Vorlage-Dateien befindet sich in dem Ordner:

Workspace-Environment-Management-v-2005-02-00-01\Agent Group Policies\ADMX

 Quelle   Ziel 
 Agent Group Policies\ADMX\Citrix Workspace Environment
Management Agent Host Configuration.admx
 C:\Windows\PolicyDefinitions\ 
 Agent Group Policies\ADMX\en-US\ Citrix Workspace
Environment Management Agent Host Configuration.adml
 C:\Windows\PolicyDefinitions\en-US 
 Als Ziel kann auch einen Domain-Speicherort verwendet
werden: \\DC\sysvol\DomainName.lab\Policies\PolicyDefinition 

Die bereits existierende Vorlagen müssen gelöscht werden.

Wenn Sie keine ADMX-Vorlage importieren dürfen, können Sie auch einen einzelnen Wert per GPO verteilen: HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Norskale\Agent Host\BrokerSvcName

WEM BrokerSvcName

 

Installation WEM Infrastructure Services (Broker)

In meinem Fall werden alle Komponenten (Brocker und Administration Konsole) auf einem Server installiert. Bei Bedarf können Sie die Administration Konsole auf einem separaten Desktop / Server installieren.

1. Die Installation ist sehr einfach und benötigt keine besonderen Kenntnisse. Wir installieren zuerst die Citrix Workspace Environment Management Infrastructure Services

102 WEM 2003

2. Klicken Sie auf Install, um die notwendigen Komponenten zu installieren:

103 WEM 2003

3. Weiter

104 WEM 2003

4. Akzeptieren Sie die Lizenzvereinbarung. Weiter...

105 WEM 2003

5. Die gewünschte Information eingeben und Weiter...

106 WEM 2003

6. An dieser Stelle eine vollständige Installation auswählen

107 WEM 2003

7. Auf Install klicken

108 WEM 2003

8. Nach weniger Sekunden ist die Installation abgeschlossen. Hier haben Sie die Möglichkeit die Konfiguration der Datenbank vorzunehmen. Es empfiehlt sich aber zuerst auch die Management Console zu installieren, falls die Installation aller Komponenten auf einem Server geplant ist.

109 WEM 2003

 

Installation WEM Management Console

1. Die Installation der Management Console ist ebenso einfache wie die Installation der Infrastruktur Services

201 WEM 2003

2. Weiter

202 WEM 2003

3. Akzeptieren Sie die Lizenzvereinbarung. Weiter...

203 WEM 2003

4. Eine vollständige Installation auswählen

205 WEM 2003

5. auf Install klicken

206 WEM 2003

6. Klicken auf Finish, um die Installation abzuschließen

207 WEM 2003

7. Folgende Verknüpfungen werden nach der Installation der beiden oberen Komponenten erstellt:

208 WEM 2003 

 

ServicePrincipalName (SPN) angelegen

Nach der Installation der Workspace Environment Management Infrastructure Services müssen wir noch ein Service Principal Name (SPN) anlegen:

setspn -C -S Norskale/BrokerService [hostname]

WEM create ServicePrincipalName

WEM verwendet Kerberos-Authentifizierung bei der Kommunikation zwischen: Agenten, Infrastructure Services und Active Directory (AD).

Wenn ein Lastenausgleich für die WEM Infrastructure Services verwendet wird, muss die Befehlskette wie folgt angepasst werden:

setspn -U -S Norskale/BrokerService [accountname]

 

WEM Datenbank Erstellung

1. Starten Sie die WEM Database Management Utility. Die Installation wird vereinfacht, wenn der Benutzer, der die Installation startet, eine sysadmin-Berechtigung auf dem DB-Server hat.

300 WEM 2003

2. Im Falle einer Neuinstallation wählen Sie Create Database

301 WEM 2003

3. Klicken Sie auf Next

302 WEM 2003

4. Auf der Seite Database Information werden nur die markierten Felder gefüllt.

Server and instance name: geben Sie nur der Name des SQL-Servers, wenn Sie die Standard-Instanz verwenden. Wenn Ihre Instanz einen anderen Port (nicht 1433) verwendet, geben auch die Portnummer ein. z.B. SQL2017/CitrixDBs,1435

Database name: An dieser Stelle wird der Datenbank-Name eintragen, die durch den Wizard erstellt wird.

303 WEM 2003

5Use integrated connection (Windows credentials) Wenn Sie nicht über eine ausreichende Berechtigung (sysadmin) verfügen, um die DB durch den Wizard zu installieren, können Sie hier die entsprechende Credentials eingeben.

304 WEM 2003

6VUEM Administrators

Initial administrator group – in meinem Fall wird eine bestehende Gruppe der Citrix Administratoren hinzugefügt. Nur Mitglieder diese Gruppe bekommen Full-Admin-Rechte und können die Management Konsole starten.

Im Bereich Database Security haben wir zwei Konfigurationsmöglichkeiten.

Use Windows authentication for infrastructure service database connection – hier wird das bereiterstellte Service Account eingetragen.

Optional: Set vuemUser SQL user account password – wenn Sie diese Option aktivieren, können Sie ein komplexes Password für diesen Service Account erstellen, sonst wird ein 8-stelliges Password automatisch erstellt. Ein solches Password wird bei der Verwendung von SQL Server Always On Availability Group benötigt.

Beide DB-Konten haben gleiche Berechtigung auf der WEM Datenbank:

  • Server Role:
    • Public
  • Role Membership
    • db_datareader
    • db_datawriter

305 WEM 2003

7. Wenn alle Einstellungen korrekt sind, klicken Sie auf die Schaltfläche Create Database

306 WEM 2003

8. Die Datenbank wurde erfolgreich erstellt

307 WEM 2003

9. Beenden Sie den Wizard

308 WEM 2003

Die Konsole kann geschlossen werden.

309 WEM 2003

10. Die Log-Datei Citrix WEM Database Management Utility Debug Log finden Sie in dem Ordner

C:\Program Files (x86)\Norskale\Norskale Infrastructure Services\

310 WEM 2003

 

Workspace Environment Management - initiale Konfiguration

1. Starten Sie WEM Infrastructure Service Configuration Utility

400 WEM 2003

2. Registerkarte Database Setting. Geben den Namen des Datenbank-Servers, sowie der Datenbank entsprechen der Konfiguration ein.

401 WEM 2003

3. Registerkarte Network Setting.

Hier können Sie die Kommunikations-Ports bei Bedarf anpassen.

402 WEM 2003

4Registerkarte Advanced Setting. Hier werden teilweise die Informationen eingegeben, die bereits bei der Erstellung der Datenbank festgelegt wurden:

  • Enable Windows account impersonation
  • Set vuemUser SQL user account password

Weitere Einstellungen können mit vordefinierten Werten gelassen werden.

  • Infrastructure service cache refresh delay (min)

Diese Option legt fest, wie oft der Infrastructure Service Server die lokalen Cache-Daten mit der Datenbank abgleicht. Die Cache-Daten werden genutzt, wenn die Verbindung mit der Datenbank unterbrochen wurde.

Weitere vier Einstellungen beziehen sich ebenfalls auf die Konfiguration mit der Datenbank

  • Infrastructure service SQL state monitor delay (sec)

hier wird ein Zeitintervall in Sekunden festgelegt, wie oft die Infrastructure Services im Falle eines Ausfalls die Datenbank abfragen sollen

  • Infrastructure service SQL connection timeout (sec)

Hier können Sie die Zeit (in Sekunden) eingeben, wie lange die Infrastructure Services beim Verbindungsaufbau warten soll, bevor die Kommunikation mit einem Fehler abgebrochen wird.

  • Enable debug mode

Diese Option aktiviert bzw. deaktiviert eine ausführliche Protokollierung

  • Use cache even if online.

Diese Option kann die unnötige Kommunikation mit dem Datenbank Server reduzieren, in dem die Daten auf dem lokalen Cache gelesen werden.

  • Enable performance tuning

Die zwei folgenden Optionen sind für die Performanceoptimierung vorgesehen. Sie können den Schwellenwert für die Anzahl des verbundenen Agenten (standardmäßig 200) bestimmen und wenn die Anzahl überschreitet wird, wird die Verbindung mit der Infrastructure Services schneller durchgeführt.

  • Minimum number of worker threads - mögliche Konfigurationswerte sind von 30 bis 3000
  • Minimum number of asynchronous I/O threads - mögliche Konfigurationswerte sind von 30 bis 3000

403 WEM 2003

5. Registerkarte Database Maintenance

Die Option Enable scheduled database maintenance konfiguriert die Aufbewahrungsrichtlinie der WEM Datenbank.

 Name   Beschreibung   Standardwert 
 Statistics retention period   Legt fest, wie lange die statistischen Informationen (Agenten/Benutzer) aufbewahrt werden  365 Tage
 System monitoring retention period   Legt fest, wie lange die Systemoptimierung Statistiken aufbewahrt werden  90 Tage
 Agent registrations retention period  Legt fest, wie lange Agent-Registrierungsprotokolle aufbewahrt werden.  1 Tage
 Execution time  Legt die Wartungszeit fest, wann die oberen Tasks durchgeführt werden.  02:00

 

404 WEM 2003

6. Registerkarte Licensing

Es gibt zwei mögliche Optionen die Adresse eines Lizenzservers einzutragen. Wie auf dem Bild unter dargestellt oder über die Management Konsole. Unabhängig davon, wie Sie die Konfiguration vornehmen, bleiben Lizenzserver-Informationen an derselben Stelle in der Datenbank gespeichert.

Global license server override – falls die Lizenzserver-Informationen bereits über Management Konsole konfiguriert wurden, werden diese hiermit überschrieben

Save Configuration -  vergessen Sie nicht die vorgenommenen Änderungen zu speichern.

405 WEM 2003

Die initiale Konfiguration der Workspace Environment Management ist hiermit abgeschlossen.

 

WEM Konsole - first start

1. Starten Sie die WEM Administration Console

500 WEM 2003

2. Klicken Sie auf die Connect-Schaltfläche

501 WEM 2003

3. In dem Feld Infrastructure Server Name können Sie sowohl den Servername als auch den localhost, eine IP-Adresse oder ein FQDN eingeben.

502 WEM 2003

4. Es empfiehlt sich ein neues Configuration Set anzulegen und die vorinstallierte Default Site unberührt lassen.

Klicken Sie auf Create

503 WEM 2003

5. Geben Sie im geöffneten Fenster einen Site-Namen und eine passende Beschreibung ein und klicken Sie dann auf OK.

504 WEM 2003

6. Wählen Sie das erstellte Configuration Set aus. Weiter klicken Sie auf die Schaltfläche Restore

505 WEM 2003

7. Select what to restore. Wählen Sie die Option Setting und klicken Sie Next

506 WEM 2003

8. Restore settings. Next

507 WEM 2003

9. Source. Klicken Sie auf Browse

508 WEM 2003

Navigieren zum entpackten WEM-Ordner Workspace-Environment-Management-v-2005-02-00-01\Configuration Templates\Default Recommended Settings und klicken Sie auf OK

508 WEM 2003

10. Im Bereich Setting Type Selection wählen Sie die markierten Optionen:

  • System Optimization Settings
  • Agent Configuration Settings
  • System Monitoring Settings

509 WEM 2003

11Restore settings processing. Klicken Sie auf Restore Settings

510 WEM 2003

12. Klicken Sie auf Yes, um die Vorlage zu importieren

511 WEM 2003

13. Klicken Sie auf Finish

512 WEM 2003

 

WEM Agent Installation

1. Starten Sie Citrix Workspace Environment Management Agent Setup.exe auf dem Ziel-System.

 600 WEM Agent Install

2. Wählen Sie I agree to the license terms and conditions  klicken Sie dann auf Installieren.

601 WEM Agent Install

3. Auf der Willkommensseite klicken Sie auf Next

602 WEM Agent Install

4. Falls notwendig können Sie hier den Installationspfad anpassen, sonst Next.

603 WEM Agent Install

5. Wählen Sie für Sie eine passende Deployment-Methode aus. In meinem Fall passt On-Premises Deployment

604 WEM Agent Install

6. Sie können diesen Schritt überspringen, wenn Sie die Adresse des WEM Brokers per Group Policy verteilen wollen. Sonst geben Sie den FQDN oder die IP-Adresse des WEM Brokers ein und klicken Sie dann auf Next.

605 WEM Agent Install

7. Die erweitere Einstellungen sind in erster Linie für die Bereitstellung per PVS vorgesehen. Standardmäßig wird die Cache-Datei auf dem Laufwerk D: abgelegt.

VUEAMAppCMD Extra Sync Delay – hier können Sie die Startverzögerung von VUEMAppCmd.exe konfigurieren.

606 WEM Agent Install

8. Wenn alle Einstellungen korrekt sind, starten Sie die Installation

607 WEM Agent Install

9. Die Installation ist hiermit abgeschlossen.

607 WEM Agent Install

Close

608 WEM Agent Install

 

WEM Konsole – weitere Konfiguration

Nach eine erfolgreichen Agenten-Installation kehren wir zu der Management Konsole zurück. Die darauffolgenden Schritte sorgen dafür, dass die Agenten auf der Konsole erscheinen.

1. VM – installierten Agenten hinzufügen

In den weiteren Schritten können wir sowohl die einzelnen Objekte (VMs mit den mit den installierten Agenten) hinzufügen), als auch die vollständigen OU-Strukturen (die wiederum Agenten beinhalten) mit dem WEM Broker verknüpfen.

Das folgende Beispiel zeigt das Hinzufügen einer OU

Active Directory Objects > Machines > Add OU > passende OU auswählen und mit OK bestätigen.

 Add OU 01

Sie die OU jederzeit anpassen, löschen oder eine weitere hinzufügen.

Add OU 02

2. Wechseln Sie zu der Registerkarte Administration > Agenten > und klicken Sie auf Refresh. Der Server mit einem installieren Agent erscheint anschließend auf der Konsole.

Add OU 03

Falls der Agent nicht direkt auf der Konsole erscheint, sollen den Agent manuell starten:

C:\Program Files (x86)\Citrix\Workspace Environment Management Agent\Citrix.Wem.Agent.Service.exe

Citrix WEM Agent

 

Offizielle Dokumentation:


Im weiteren Artikel geht es um die System Optimierung: Workspace Environment Management - System Optimization

Wir nutzen Cookies auf unserer Website. Einige von ihnen sind essenziell für den Betrieb der Seite, während andere uns helfen, diese Website und die Nutzererfahrung zu verbessern (Tracking Cookies). Sie können selbst entscheiden, ob Sie die Cookies zulassen möchten. Bitte beachten Sie, dass bei einer Ablehnung womöglich nicht mehr alle Funktionalitäten der Seite zur Verfügung stehen.