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
Informationen zur Überprüfung vor der Installation
Lesen Sie die Systemanforderungen vor der Installation.
Anleitung nach der Bereitstellung
Lassen Sie nach der Installation alle Cloud Connectors kontinuierlich eingeschaltet, um eine stets aktive Verbindung zu Citrix Cloud zu gewährleisten.
Upgrades
Upgrades werden normalerweise automatisch von Citrix Cloud verwaltet. Um ein manuelles Upgrade durchzuführen, deinstallieren Sie zuerst den alten Cloud Connector, bevor Sie die neue Version installieren. Führen Sie kein Upgrade eines zuvor installierten Cloud Connectors mit einer neueren Version durch. Führen Sie kein Upgrade einzelner Komponenten des Cloud Connectors separat durch.
Umbenennen von Maschinen
Benennen Sie die Maschine, auf der der Cloud Connector gehostet wird, nach der Installation nicht um. Wenn Sie den Servernamen später ändern müssen, führen Sie die folgenden Aufgaben aus:
- Entfernen Sie die Maschine vom Ressourcenstandort:
- Wählen Sie im Citrix Cloud-Menü die Option Ressourcenstandorte.
- Suchen Sie den Ressourcenstandort, den Sie verwalten möchten, und wählen Sie dann die Kachel Cloud Connectors aus.
- Suchen Sie die Maschine, die Sie verwalten möchten, und klicken Sie dann auf das Ellipsenmenü. Wählen Sie Connector entfernen.
- Deinstallieren Sie die Cloud Connector-Software.
- Benennen Sie die Maschine um.
- 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, auf der der Cloud Connector gehostet wird, nach der Installation nicht in eine andere Domäne. Wenn Sie die Maschine später einer anderen Domäne hinzufügen müssen, führen Sie die folgenden Aufgaben aus:
- Entfernen Sie die Maschine vom Ressourcenstandort.
- Deinstallieren Sie die Cloud Connector-Software.
- Trennen Sie die Maschine von ihrer aktuellen Domäne und fügen Sie die Maschine der neuen Domäne wieder hinzu.
- 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 möchten und geklonte Maschinen verwenden möchten, führen Sie die folgenden Schritte aus:
- Bereiten Sie die Maschinen-Vorlage gemäß den Anforderungen Ihrer Umgebung vor.
- Stellen Sie die Anzahl der Maschinen bereit, die Sie als Cloud Connectors verwenden möchten.
- 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.
Wenn Sie Cloud Connectors für Citrix DaaS bereitstellen, vergewissern Sie sich, 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 beim Einrichten des Maschinenkatalogs in Citrix DaaS eine ungenutzte Domäne angeben, kann ein Fehler auftreten. Weitere Informationen finden Sie unter Hinzufügen eines Ressourcentyps oder Aktivieren einer ungenutzten Domäne in Citrix Cloud in der Citrix DaaS-Produktdokumentation.
Weitere Überlegungen zu anderen Diensten finden Sie in der 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 erstellen in Citrix Cloud 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 Installationsschnittstelle herunterladen und installieren. Zuvor müssen Sie in der Citrix Cloud-Verwaltungskonsole einen oder mehrere Ressourcenstandorte erstellen, auf denen Cloud Connectors bereitgestellt werden sollen. Weitere Informationen zu Ressourcenstandorten finden Sie unter Ressourcenstandorte.
Citrix Cloud Connector™-Software herunterladen
-
Melden Sie sich als Windows-Administrator an der Maschine an, auf der Sie Citrix Cloud Connectors installieren möchten.
-
Besuchen Sie https://citrix.cloud.com und melden Sie sich bei Ihrem Administratorkonto an.
-
Navigieren Sie in der Citrix Cloud-Konsole über das Hauptmenü zu Ressourcenstandorte.
-
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.
-
Suchen Sie den Ressourcenstandort, den Sie verwalten möchten, und wählen Sie + Cloud Connectors.
-
Wählen Sie im geöffneten Fenster Herunterladen. Speichern Sie die Datei cwcconnector.exe an einem lokalen Speicherort auf Ihrem Connector-Computer.
Installieren der Citrix Cloud Connector-Software
Voraussetzungen
-
Klicken Sie mit der rechten Maustaste auf die Installationsdatei
cwcconnector.exeund 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. -
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-Probleme in WinHTTP
-
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
-
Nachdem Sie den Proxy-Server aktualisiert und die erweiterte Konnektivitätsprüfung durchgeführt haben, klicken Sie auf Cloud Connector installieren.
-
Auf der Seite Anmelden klicken Sie auf Anmelden und installieren
Cloud Connector-Anmeldung(/de-de/citrix-cloud/media/cloud-connector-login.png)
-
Das Fenster Citrix Cloud-Konnektivitätstest wird angezeigt, und der Status des ersten Upgrades und der Tests wird zusammen mit den Ereignisprotokollen angezeigt.
Erste Tests werden ausgeführt(/de-de/citrix-cloud/media/initial-tests-in-progress.png)
-
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. -
Sobald das erste Upgrade und die Tests abgeschlossen sind, wird der Citrix Cloud-Konnektivitätstest als Erfolgreich angezeigt, wie in der folgenden Abbildung dargestellt. Die Ergebnisse der Konnektivitätsprüfung werden nach dem ersten Upgrade im Feld „Ereignisprotokoll“ angezeigt.
Erste Tests abgeschlossen(/de-de/citrix-cloud/media/initial-tests-complete.png)
Nicht verwendete Domänen aktivieren
Wenn Sie Ressourcenstandorte erstellen und Cloud Connectors für Citrix DaaS™ bereitstellen, vergewissern Sie sich, dass 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 ungenutzte Domäne in Citrix Cloud aktivieren in der Citrix DaaS-Produktdokumentation.
Zusätzliche Ressourcenstandorte erstellen
- Klicken Sie in der Citrix Cloud-Verwaltungskonsole auf die Menüschaltfläche und wählen Sie Ressourcenstandorte aus.
- Klicken Sie auf + Ressourcenstandort und geben Sie einen aussagekräftigen Namen ein.
- Klicken Sie auf Speichern. Citrix Cloud zeigt eine Kachel für den neuen Ressourcenstandort an.
- Klicken Sie auf Cloud Connectors und dann auf Herunterladen, um die Cloud Connector-Software zu beziehen.
- 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 hat, 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 ID und des Geheimnisses des sicheren Prinzipals 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 (unter „Identitäts- und Zugriffsverwaltung“) angezeigt wird.
- clientId Erforderlich. Die sichere Prinzipal-ID, die ein Administrator erstellen kann und die sich auf der Seite „API-Zugriff“ befindet.
- clientSecret Erforderlich. Das sichere Prinzipal-Geheimnis, das nach dem Erstellen 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.
Beispielkonfigurationsdatei
{
"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 im Falle eines Fehlers einen potenziellen Fehlercode zu untersuchen. Sie können den Standardmechanismus verwenden, um echo %ErrorLevel% nach Abschluss der Installation auszuführen.
HTTPS-Konfiguration
Damit StoreFront™- und NetScaler Gateway-Appliances sicher eine Verbindung zum Cloud Connector herstellen und alle Daten verschlüsseln können, 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 Lastenausgleich vor dem Connector bereitgestellt haben, verwenden Sie den FQDN des Lastenausgleichs.
- Das Zertifikat kann von einer Unternehmens-CA oder einer öffentlichen CA signiert werden.
- Alle StoreFront- und Gateway-Server, die eine Verbindung zum Cloud Connector herstellen, müssen dem Zertifikat vertrauen.
So aktivieren Sie HTTPS:
-
Öffnen Sie das Zertifikate-MMC-Snap-In.
-
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.
-
Öffnen Sie das Zertifikat, wechseln Sie zur Registerkarte Details und notieren Sie sich den Fingerabdruck (Thumbprint), wobei Leerzeichen ignoriert werden.
-
Bestimmen Sie, an welche IP-Adresse das Zertifikat gebunden werden soll. Normalerweise können Sie die IP-Adresse
0.0.0.0verwenden, 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 dieses Netzwerkadapters. -
Führen Sie in einer Eingabeaufforderung mit erhöhten Rechten 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--> -
Um HTTP zu deaktivieren, navigieren Sie in der Registrierung zu
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\DesktopServerund erstellen Sie einenDWORDmit dem NamenXMLServicesEnableNonSSLund dem Wert 0.
Nächste Schritte
- 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.
- 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.
- 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.
- 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.
Fehlerbehebung bei Installationsproblemen
Dieser Abschnitt beschreibt einige Möglichkeiten zur Diagnose und Behebung von Problemen, die während der Installation auftreten können. Weitere Informationen zur Fehlerbehebung bei Installationsproblemen finden Sie im Citrix Cloud Connector-Handbuch zur Fehlerbehebung.
Installationsprotokolle
Sie können bei der Installation aufgetretene Probleme beheben, indem Sie zunächst die verfügbaren Protokolldateien konsultieren.
Ereignisse, die während der Installation aufgetreten sind, sind in der Windows-Ereignisanzeige verfügbar. 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:
Can't reach this page.
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, bestätigen Sie, dass die folgenden Citrix-Dienste den Status Gestartet haben:
- 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 dabei helfen zu ü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 zur Behebung einer fehlgeschlagenen Konnektivitätsprüfung finden Sie unter CTX224133: Cloud Connector Konnektivitätsprüfung fehlgeschlagen.