Cloud Connector-Installation

Sie können die Cloud Connector-Software interaktiv oder über die Befehlszeile installieren.

• Die Installation erfolgt mit den Berechtigungen des Benutzers, der die Installation startet. Der Cloud Connector benötigt Zugriff auf die Cloud, um:

• den Benutzer zu authentifizieren, der die Installation durchführt
• die Berechtigungen des Installers zu validieren

• die Cloud Connector-Dienste herunterzuladen und zu konfigurieren

• Zu beachtende Informationen vor der Installation

• Systemanforderungen: Zur Vorbereitung der Maschinen für das Hosting des Cloud Connectors.
• Abschnitt Antivirus-Ausschlüsse des Tech Zone-Artikels Best Practices für Endpunktsicherheit und Antivirus: Enthält Richtlinien, die Ihnen helfen, das richtige Gleichgewicht zwischen Sicherheit und Leistung für die Cloud Connectors in Ihrer Umgebung zu finden. Citrix empfiehlt dringend, diese Richtlinien mit den Antivirus- und Sicherheitsteams Ihres Unternehmens zu überprüfen und strenge Labortests durchzuführen, bevor Sie sie in einer Produktionsumgebung anwenden.
• System- und Konnektivitätsanforderungen: Um sicherzustellen, dass alle Maschinen, die den Cloud Connector hosten, mit Citrix Cloud kommunizieren können.
• Cloud Connector-Proxy- und Firewallkonfiguration: Wenn Sie den Cloud Connector in einer Umgebung mit einem Webproxy oder strengen Firewallregeln installieren.

• Überlegungen zu Skalierung und Größe für Cloud Connectors: Enthält Details zu getesteten Maximalkapazitäten und Best-Practice-Empfehlungen für die Konfiguration von Maschinen zum Hosten des Cloud Connectors.

• Überlegungen und Hinweise zur Installation

• Installieren Sie den Cloud Connector nicht auf einem Active Directory-Domänencontroller oder einer anderen Maschine, die für Ihre Ressourcenstandortinfrastruktur kritisch ist. Regelmäßige Wartungsarbeiten am Cloud Connector führen zu Maschinenoperationen, die einen Ausfall dieser zusätzlichen Ressourcen verursachen.
• Laden oder installieren Sie keine anderen Citrix®-Produkte auf den Maschinen, die den Cloud Connector hosten.
• Führen Sie kein separates Upgrade einzelner Komponenten des Cloud Connectors durch.
• Laden oder installieren Sie den Cloud Connector nicht auf Maschinen, die zu anderen Citrix-Produktbereitstellungen gehören (z. B. Delivery Controller in einer lokalen Citrix Virtual Apps and Desktops™-Bereitstellung).
• Führen Sie kein Upgrade eines zuvor installierten Cloud Connectors auf eine neuere Version durch. Deinstallieren Sie stattdessen den alten Cloud Connector und installieren Sie dann den neuen.
• Der Cloud Connector-Installer wird von Citrix Cloud heruntergeladen. Ihr Browser muss daher das Herunterladen ausführbarer Dateien zulassen.
• Wenn Sie den grafischen Installer verwenden, muss ein Browser installiert und als Standard-Systembrowser festgelegt sein.

Hinweise nach der Bereitstellung

Halten Sie nach der Installation alle Cloud Connectors kontinuierlich eingeschaltet, um eine stets aktive Verbindung zu Citrix Cloud zu gewährleisten.

Umbenennen von Maschinen

Benennen Sie die Maschine, die den Cloud Connector hostet, nach der Installation nicht um. Wenn Sie den Servernamen später ändern müssen, führen Sie die folgenden Aufgaben aus:

1. Entfernen Sie die Maschine vom Ressourcenstandort:
   1. Wählen Sie im Citrix Cloud-Menü Ressourcenstandorte aus.
   2. Suchen Sie den Ressourcenstandort, den Sie verwalten möchten, und wählen Sie dann die Kachel Cloud Connectors aus.
   3. Suchen Sie die Maschine, die Sie verwalten möchten, und klicken Sie dann auf das Ellipsenmenü. Wählen Sie Connector entfernen aus.
2. Deinstallieren Sie die Cloud Connector-Software.
3. Benennen Sie die Maschine um.
4. Installieren Sie die neueste Version der Cloud Connector-Software, wie in diesem Artikel beschrieben.

Verschieben von Maschinen in eine andere Domäne

Verschieben Sie die Maschine, die den Cloud Connector hostet, nach der Installation nicht in eine andere Domäne. Wenn Sie die Maschine später einer anderen Domäne beitreten lassen müssen, führen Sie die folgenden Aufgaben aus:

1. Entfernen Sie die Maschine vom Ressourcenstandort.
2. Deinstallieren Sie die Cloud Connector-Software.
3. Trennen Sie die Maschine von ihrer aktuellen Domäne und fügen Sie sie der neuen Domäne wieder hinzu.
4. Installieren Sie die neueste Version der Cloud Connector-Software, wie in diesem Artikel beschrieben.

Überlegungen zu geklonten Maschinen

Jede Maschine, die den Cloud Connector hostet, muss eine eindeutige SID und Connector-ID haben, damit Citrix Cloud zuverlässig mit den Maschinen an Ihrem Ressourcenstandort kommunizieren kann. Wenn Sie den Cloud Connector auf mehreren Maschinen an Ihrem Ressourcenstandort hosten und geklonte Maschinen verwenden möchten, führen Sie die folgenden Schritte aus:

1. Bereiten Sie die Maschinen-Vorlage gemäß den Anforderungen Ihrer Umgebung vor.
2. Stellen Sie die Anzahl der Maschinen bereit, die Sie als Cloud Connectors verwenden möchten.
3. Installieren Sie den Cloud Connector auf jeder Maschine, entweder manuell oder im unbeaufsichtigten Installationsmodus.

Die Installation des Cloud Connectors auf einer Maschinen-Vorlage (vor dem Klonen) wird nicht unterstützt. Wenn Sie eine Maschine mit installiertem Cloud Connector klonen, werden die Cloud Connector-Dienste nicht ausgeführt und die Maschine kann keine Verbindung zu Citrix Cloud herstellen.

Überlegungen zu Diensten

Die Installationsschritte in diesem Artikel beschreiben den Prozess zur Bereitstellung von Cloud Connectors, unabhängig davon, für welchen Dienst sie verwendet werden.

Stellen Sie bei der Bereitstellung von Cloud Connectors für Citrix DaaS sicher, dass die AD-Domänen, in denen sich die Connectors befinden, aktiv sind und in der Citrix Cloud-Konsole nicht als „ungenutzt“ angezeigt werden. Wenn Sie während der Einrichtung des Maschinenkatalogs in Citrix DaaS eine ungenutzte Domäne angeben, kann ein Fehler auftreten. Weitere Informationen finden Sie unter Ressourcentyp hinzufügen oder ungenutzte Domäne in Citrix Cloud aktivieren in der Citrix DaaS-Produktdokumentation.

Für zusätzliche Überlegungen zu anderen Diensten konsultieren Sie die Dokumentation des jeweiligen Dienstes.

Standard-Ressourcenstandorte

Wenn Sie keine Ressourcenstandorte in Ihrem Citrix Cloud-Konto haben und Cloud Connectors in Ihrer Domäne installieren, wird der von Citrix Cloud erstellte Ressourcenstandort zum Standard-Ressourcenstandort. Sie können nur einen Standard-Ressourcenstandort in Ihrem Konto haben. Bei Bedarf können Sie zusätzliche Ressourcenstandorte in Citrix Cloud erstellen und dann den gewünschten auswählen, wenn Sie Cloud Connectors in anderen Domänen installieren.

Alternativ können Sie die benötigten Ressourcenstandorte zuerst in der Konsole erstellen, bevor Sie Cloud Connectors in Ihren Domänen installieren. Der Cloud Connector-Installer fordert Sie während der Installation auf, den gewünschten Ressourcenstandort auszuwählen.

Interaktive Installation

Sie können Cloud Connectors über die grafische Installer-Oberfläche herunterladen und installieren. Zuvor müssen Sie jedoch einen oder mehrere Ressourcenstandorte in der Citrix Cloud-Verwaltungskonsole erstellen, auf denen Cloud Connectors bereitgestellt werden sollen. Weitere Informationen zu Ressourcenstandorten finden Sie unter Ressourcenstandorte.

Herunterladen der Citrix Cloud Connector™-Software

1. Melden Sie sich als Windows-Administrator an dem Computer an, auf dem Sie Citrix Cloud Connectors installieren möchten.

2. Besuchen Sie https://citrix.cloud.com und melden Sie sich bei Ihrem Administratorkonto an.

3. Navigieren Sie in der Citrix Cloud-Konsole über das Hauptmenü zu Ressourcenstandorte.

4. Wenn Sie noch keinen Ressourcenstandort haben, klicken Sie auf das Pluszeichen (+) oder wählen Sie Ressourcenstandort hinzufügen. Weitere Informationen finden Sie unter Ressourcenstandort erstellen.

5. Suchen Sie den Ressourcenstandort, den Sie verwalten möchten, und wählen Sie + Cloud Connectors aus.

   

6. Wählen Sie im geöffneten Fenster Herunterladen aus. Speichern Sie die Datei cwcconnector.exe an einem lokalen Speicherort auf Ihrem Connector-Computer.

Installieren der Citrix Cloud Connector-Software

• Voraussetzungen

• 1. Klicken Sie mit der rechten Maustaste auf die Installationsdatei cwcconnector.exe und wählen Sie Als Administrator ausführen. Das Installationsprogramm führt eine erste Konnektivitätsprüfung durch, um sicherzustellen, dass Sie eine Verbindung zu Citrix Cloud herstellen können, bevor der Cloud Connector installiert wird.
• 1. Klicken Sie auf Verwalten, um den Proxyserver zu aktualisieren.

Hinweis:

Aufgrund einer Einschränkung in Microsoft WinHTTP wird nur ein Proxyserver unterstützt. Weitere Informationen finden Sie unter AutoProxy Issues in WinHTTP

1. Klicken Sie auf Erweiterte Konnektivitätsprüfung, um eine ausführliche Prüfung durchzuführen und sicherzustellen, dass die grundlegenden Konnektivitätsanforderungen für die Connector-Installation auf dem Computer erfüllt sind.

   

Erstes Upgrade und Tests

1. Nachdem Sie den Proxyserver aktualisiert und die Erweiterte Konnektivitätsprüfung durchgeführt haben, klicken Sie auf Cloud Connector installieren.

2. Klicken Sie auf der Seite Anmelden auf Anmelden und installieren.

   

• 1. Das Fenster Citrix Cloud Connectivity Test wird angezeigt, und der Status des ersten Upgrades und der Tests wird zusammen mit den Ereignisprotokollen angezeigt.
• 

1. Klicken Sie auf Protokolle anzeigen, um das Verzeichnis (C:\ProgramData\Citrix\WorkspaceCloud\InstallLogs) zu öffnen, das alle Debug-Protokolle der Konnektivitätsprüfung enthält.

2. Sobald das erste Upgrade und die Tests abgeschlossen sind, wird der Citrix Cloud Connectivity Test als Erfolgreich angezeigt, wie in der folgenden Abbildung dargestellt. Die Ergebnisse der Konnektivitätsprüfung werden nach dem ersten Upgrade im Feld „Ereignisprotokoll“ angezeigt.

   

Nicht verwendete Domänen aktivieren

Wenn Sie Ressourcenstandorte erstellen und Cloud Connectors für Citrix DaaS™ bereitstellen, überprüfen Sie, ob die AD-Domänen, die Sie mit Citrix DaaS verwenden, aktiv sind und nicht als ungenutzt gelten. Wenn Sie beim Einrichten von Maschinenkatalogen in Citrix DaaS eine ungenutzte Domäne angeben, kann ein Fehler auftreten.

Weitere Informationen finden Sie unter Ressourcentyp hinzufügen oder eine ungenutzte Domäne in Citrix Cloud aktivieren in der Citrix DaaS-Produktdokumentation.

Zusätzliche Ressourcenstandorte erstellen

1. Klicken Sie in der Citrix Cloud-Verwaltungskonsole auf die Menüschaltfläche und wählen Sie Ressourcenstandorte aus.
2. Klicken Sie auf + Ressourcenstandort und geben Sie einen aussagekräftigen Namen ein.
3. Klicken Sie auf Speichern. Citrix Cloud zeigt eine Kachel für den neuen Ressourcenstandort an.
4. Klicken Sie auf Cloud Connectors und dann auf Herunterladen, um die Cloud Connector-Software zu beziehen.
5. Installieren Sie auf jeder vorbereiteten Maschine die Cloud Connector-Software entweder mit dem Installationsassistenten oder der Befehlszeileninstallation. Citrix Cloud fordert Sie auf, den Ressourcenstandort auszuwählen, den Sie dem Cloud Connector zuordnen möchten.

Installation mit mehreren Kunden und vorhandenen Ressourcenstandorten

Wenn Sie Administrator für mehrere Kundenkonten sind, fordert Citrix Cloud Sie auf, das Kundenkonto auszuwählen, das Sie dem Cloud Connector zuordnen möchten.

Wenn Ihr Kundenkonto bereits mehrere Ressourcenstandorte aufweist, fordert Citrix Cloud Sie auf, den Ressourcenstandort auszuwählen, den Sie dem Cloud Connector zuordnen möchten.

Befehlszeileninstallation

Die unbeaufsichtigte oder automatisierte Installation wird unterstützt. Der Connector-Installer wird jedoch regelmäßig aktualisiert, daher wird empfohlen, für jede Installation den neuesten Installer herunterzuladen. Laden Sie einen neuen Cloud Connector-Installer von der Seite „Ressourcenstandorte“ in der Citrix Cloud-Konsole herunter.

• Anforderungen

Um die Befehlszeileninstallation mit Citrix Cloud zu verwenden, müssen Sie die folgenden Informationen angeben:

• Die Kunden-ID des Citrix Cloud-Kontos, für das Sie den Cloud Connector installieren. Diese ID wird oben auf der Registerkarte API-Zugriff unter Identitäts- und Zugriffsverwaltung angezeigt.
• Die ID und das Geheimnis des sicheren Prinzipals, den Sie für die Installation des Cloud Connectors verwenden möchten. Um diese Werte zu erhalten, müssen Sie zuerst einen sicheren Prinzipal erstellen. Der sichere Prinzipal muss mit „Vollzugriff“ erstellt werden. Weitere Informationen zum Erstellen eines Dienstprinzipals finden Sie unter Dienstprinzipal erstellen. Sobald Sie die ID und das Geheimnis des sicheren Prinzipals haben, können Sie mit der Cloud Connector-Installation fortfahren.

• Die Ressourcenstandort-ID für den Ressourcenstandort, den Sie dem Cloud Connector zuordnen möchten. Um diesen Wert abzurufen, wählen Sie die Schaltfläche ID unter dem Namen des Ressourcenstandorts auf der Seite Ressourcenstandorte aus. Wenn Sie diesen Wert nicht angeben, verwendet Citrix Cloud die ID des Standard-Ressourcenstandorts.

• Unterstützte Parameter

• Um die Sicherheit der sicheren Prinzipal-ID und des Geheimnisses zu gewährleisten, muss dem Installer eine JSON-Konfigurationsdatei bereitgestellt werden. Diese Datei muss nach Abschluss der Installation gelöscht werden. Unterstützte Werte für die Konfigurationsdatei sind:

• customerName Erforderlich. Die Kunden-ID, die auf der Seite „API-Zugriff“ in der Citrix Cloud-Konsole (innerhalb der Identitäts- und Zugriffsverwaltung) angezeigt wird.
• clientId Erforderlich. Die sichere Prinzipal-ID, die ein Administrator erstellen kann, befindet sich auf der Seite „API-Zugriff“.
• clientSecret Erforderlich. Das sichere Prinzipal-Geheimnis, das nach der Erstellung des sicheren Prinzipals heruntergeladen werden kann. Befindet sich auf der Seite „API-Zugriff“.
• resourceLocationId Empfohlen. Der eindeutige Bezeichner für einen vorhandenen Ressourcenstandort. Wählen Sie die Schaltfläche „ID“ aus, um die Ressourcenstandort-ID auf der Seite „Ressourcenstandorte“ in der Citrix Cloud-Konsole abzurufen. Wenn kein Wert angegeben wird, verwendet Citrix Cloud die ID des ersten Ressourcenstandorts im Konto.

• acceptTermsOfService Erforderlich. Muss auf true gesetzt werden.

• Beispiel-Konfigurationsdatei

{
"customerName": "CustomerID",
"clientId": "SecurePrincipalID",
"clientSecret": "ClientSecret",
"resourceLocationId": "ResourceLocationId",
"acceptTermsOfService": "true"
}
<!--NeedCopy-->

Beispielbefehl

Der folgende Befehl installiert die Cloud Connector-Software unbeaufsichtigt mithilfe einer JSON-Konfigurationsdatei:

CWCConnector.exe /q /ParametersFilePath:c:\cwcconnector_install_params.json
<!--NeedCopy-->

Verwenden Sie /q, um eine unbeaufsichtigte Installation anzugeben.

Verwenden Sie Start /Wait CWCConnector.exe /ParametersFilePath:value, um einen potenziellen Fehlercode im Falle eines Fehlers zu untersuchen. Sie können den Standardmechanismus der Ausführung von echo %ErrorLevel% nach Abschluss der Installation verwenden.

HTTPS-Konfiguration

Um StoreFront™- und NetScaler Gateway-Appliances eine sichere Verbindung zum Cloud Connector und die Verschlüsselung aller Daten zu ermöglichen, wird dringend empfohlen, HTTPS zu aktivieren. Dies erfordert ein SSL-Zertifikat.

• Das Zertifikat muss den FQDN, der zum Erreichen des Connectors verwendet wird, als Common Name oder Subject Alternative Name enthalten. Wenn Sie einen Load Balancer vor dem Connector bereitgestellt haben, verwenden Sie den FQDN des Load Balancers.
• Das Zertifikat kann von einer Unternehmens-CA oder einer öffentlichen CA signiert werden.
• Alle StoreFront- und Gateway-Server, die sich mit dem Cloud Connector verbinden, müssen dem Zertifikat vertrauen.

So aktivieren Sie HTTPS:

1. Öffnen Sie das Zertifikate-MMC-Snap-In.

2. Erstellen oder importieren Sie ein geeignetes Zertifikat im Speicher für persönliche Zertifikate. Weitere Informationen zur Verwaltung von Zertifikaten finden Sie unter Zertifikate verwalten.

3. Öffnen Sie das Zertifikat, wechseln Sie zur Registerkarte Details und notieren Sie sich den Fingerabdruck, wobei Sie Leerzeichen ignorieren.

   

4. Bestimmen Sie, an welche IP-Adresse das Zertifikat gebunden werden soll. Normalerweise können Sie die IP-Adresse 0.0.0.0 verwenden, um sie auf alle IPv4-Adressen anzuwenden. Wenn IPv6 aktiviert ist, verwenden Sie [::], um sie auf alle IPv6-Adressen anzuwenden. Wenn Sie die Änderung nur auf einen bestimmten Netzwerkadapter anwenden möchten, notieren Sie sich die IP-Adresse des Netzwerkadapters.

5. Führen Sie in einer Eingabeaufforderung mit erhöhten Rechten Folgendes aus:

   netsh http add sslcert ipport=<IP address>:<Port number> certhash=<Certificate Hash Number> appid={Any GUID}
   <!--NeedCopy-->
   

   Sie können jede gültige GUID für die AppId verwenden. Ihr Zweck ist es, zu erfassen, welche Anwendung die Bindung hinzugefügt hat. Die Bindung gilt jedoch für alle Anwendungen, die diesen Port verwenden.

   Zum Beispiel:

   C:\> netsh http add sslcert ipport=0.0.0.0:443 certhash=BC96F958848639FD101A793B87915D5F2829B0B6 appid={6DE9BEFD-F4CB-4D63-8681-E88012D6F5F1}
   
   SSL Certificate successfully added
   <!--NeedCopy-->
   

6. Um HTTP zu deaktivieren, navigieren Sie in der Registrierung zu HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\DesktopServer und erstellen Sie einen DWORD-Wert mit dem Namen XMLServicesEnableNonSSL und dem Wert 0.

Nächste Schritte

1. Richten Sie den Aktualisierungszeitplan für den Citrix Cloud Connector ein. Informationen zu Citrix Cloud Connector-Updates und zur Verwaltung von Aktualisierungszeitplänen finden Sie unter Connector-Updates.
2. Wenn Sie StoreFront verwenden, konfigurieren Sie StoreFront so, dass es den Connector verwenden kann, um DaaS zu erreichen und Ressourcen aufzulisten und zu starten. Wenn dies der erste Connector in einer neuen DaaS-Bereitstellung ist, erstellen Sie einen neuen Ressourcenfeed. Wenn dies ein zusätzlicher Connector ist, wird aus Gründen der Ausfallsicherheit empfohlen, alle Cloud Connectors zur Serverliste Ihres vorhandenen DaaS-Ressourcenfeeds hinzuzufügen. Weitere Informationen finden Sie unter Verwalten der in Stores verfügbaren Ressourcen.
3. Wenn Sie StoreFront mit einem NetScaler-Gateway verwenden, können Sie den Connector verwenden, um die Citrix Cloud Secure Ticket Authority (STA) zu erreichen. Weitere Informationen finden Sie unter Citrix Gateways konfigurieren.
4. Wenn dies der erste Connector in einer bestimmten Active Directory-Domäne ist, können Sie diese Domäne mit Citrix Cloud verbinden. Weitere Informationen finden Sie unter So verbinden Sie Ihr Active Directory mit Citrix Cloud.

Beheben von Installationsproblemen

Dieser Abschnitt beschreibt einige Möglichkeiten zur Diagnose und Behebung von Problemen, die während der Installation auftreten können. Weitere Anleitungen zur Behebung von Installationsproblemen finden Sie im Citrix Cloud Connector Troubleshooting Guide.

Installationsprotokolle

Sie können Probleme bei der Installation beheben, indem Sie zunächst die verfügbaren Protokolldateien konsultieren.

Ereignisse, die während der Installation aufgetreten sind, finden Sie in der Windows-Ereignisanzeige. Sie können auch die Installationsprotokolle des Cloud Connectors überprüfen, die sich unter %LOCALAPPDATA%\Temp\CitrixLogs\CloudServicesSetup befinden. Protokolle werden nach der Installation auch zu %ProgramData%\Citrix\WorkspaceCloud\InstallLogs hinzugefügt.

Exit-Codes

Die folgenden Exit-Codes können je nach Erfolg oder Misserfolg des Installationsvorgangs zurückgegeben werden:

• 1603 – Ein unerwarteter Fehler ist aufgetreten
• 2 – Eine Voraussetzungsprüfung ist fehlgeschlagen
• 0 – Installation erfolgreich abgeschlossen

Installationsfehler

Wenn Sie die Citrix Cloud Connector-Software durch Doppelklicken auf das Installationsprogramm installieren, erhalten Sie möglicherweise die folgende Fehlermeldung:

Diese Seite kann nicht erreicht werden.

Dieser Fehler kann auftreten, selbst wenn Sie als Administrator an der Maschine angemeldet sind, um den Citrix Cloud Connector zu installieren. Um diesen Fehler zu vermeiden, führen Sie die Citrix Cloud Connector-Software als Administrator aus, indem Sie mit der rechten Maustaste auf das Installationsprogramm klicken und „Als Administrator ausführen“ auswählen.

Konnektivitätsfehler

Um sicherzustellen, dass der Cloud Connector mit Citrix Cloud kommunizieren kann, vergewissern Sie sich, dass die folgenden Citrix-Dienste den Status Gestartet aufweisen:

• Citrix Cloud AD Provider
• Citrix Cloud Agent Logger
• Citrix Cloud Agent System
• Citrix Cloud Agent Watchdog
• Citrix Cloud Credential Provider
• Citrix Config Synchronizer Service
• Citrix High Availability Service
• Citrix NetScaler® CloudGateway
• Citrix Remote Broker Provider
• Citrix Remote HCL Server
• Citrix Session Manager Proxy

Weitere Informationen zu diesen Diensten finden Sie unter Installierte Dienste.

Das Cloud Connector Advanced Connectivity Check Tool kann überprüfen, ob der Cloud Connector Citrix Cloud und die zugehörigen Dienste erreichen kann.

Weitere Informationen finden Sie unter Cloud Connector Advanced Connectivity Check Tool.

Weitere Informationen zum Beheben eines fehlgeschlagenen Konnektivitätstests finden Sie unter CTX224133: Cloud Connector Connectivity Check Failed.