Produktdokumentation
Linux Virtual Delivery Agent
Aktuelles Release 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2308 2305 2303 2301 2212 2210 2209 2207 2206 2204 2203 LTSR 2201 2112 2110 2109 2107 2106 2104 2103 1912 LTSR 7.15
PDF anzeigen

Erstellen eines nicht in die Domäne eingebundenen Linux VDA mit Easy Install

August 3, 2026
Beitrag von: 
C C

Dieser Artikel führt Sie durch die Verwendung der Easy-Install-Methode, um einen nicht in die Domäne eingebundenen Linux VDA mit einem Maschinenkatalog in Citrix DaaS oder Citrix Virtual Apps and Desktops™ 2407 und höher zu erstellen und zu registrieren.

Wichtig:

Schritt 1: Einen leeren Maschinenkatalog erstellen

Melden Sie sich bei Citrix Web Studio™ an und erstellen Sie einen leeren Maschinenkatalog ohne Maschinen. Der Linux VDA unterstützt die Verwendung einer Token-Datei für die Registrierung bei einem energieverwalteten Maschinenkatalog nicht.

Der Prozess zum Erstellen von Maschinenkatalogen und Hinzufügen von Linux-VDA-Maschinen ähnelt dem traditionellen Windows-VDA-Ansatz. Eine detailliertere Beschreibung zur Durchführung dieser Aufgaben finden Sie unter Maschinenkataloge erstellen und Maschinenkataloge verwalten.

Zum Erstellen von Maschinenkatalogen, die Linux-VDA-Maschinen enthalten, gibt es einige Einschränkungen, die den Prozess von der Erstellung von Maschinenkatalogen für Windows-VDA-Maschinen unterscheiden:

  • Wählen Sie für das Betriebssystem:

    • Die Option Multi-session OS für ein Bereitstellungsmodell für gehostete Shared Desktops.
    • Die Option Single-session OS für ein VDI-Bereitstellungsmodell für dedizierte Desktops.
  • Mischen Sie keine Linux- und Windows-VDA-Maschinen im selben Maschinenkatalog.
  • Mischen Sie keine in die Domäne eingebundenen und nicht in die Domäne eingebundenen Maschinen im selben Maschinenkatalog.
  • Zum Erstellen eines Maschinenkatalogs für die Token-Registrierung wählen Sie auf der Seite Maschinentyp die Option Single-session OS oder Multi-session OS und auf der Seite Maschinenverwaltung die Option „Maschinen, die nicht energieverwaltet sind (z. B. physische Maschinen)“.

Hinweis:

Frühere Versionen von Citrix Studio unterstützen den Begriff „Linux OS“ nicht. Die Auswahl der Option Windows Server OS oder Server OS impliziert jedoch ein äquivalentes Bereitstellungsmodell für gehostete Shared Desktops. Die Auswahl der Option Windows Desktop OS oder Desktop OS impliziert ein Bereitstellungsmodell mit einem Benutzer pro Maschine.

Schritt 2: Registrierungstoken erstellen

Um einen nicht in die Domäne eingebundenen VDA mit Easy Install zu erstellen, benötigen Sie eine Token-Datei, um den VDA bei einem Maschinenkatalog zu registrieren und den VDA beim Cloud- oder On-Premises-Delivery Controller zu authentifizieren. Der Linux VDA unterstützt die Verwendung einer Token-Datei für die Registrierung bei einem energieverwalteten Maschinenkatalog nicht.

Führen Sie die folgenden Schritte in Citrix Web Studio aus, um ein Registrierungstoken zu erstellen:

Tipp:

In Citrix DaaS wird Web Studio als „Full Configuration“ bezeichnet.

  1. Wählen Sie den leeren Maschinenkatalog aus, den Sie zuvor erstellt haben, und wählen Sie dann Manage Enrollment Tokens in der Aktionsleiste aus.

  2. Auf der Seite Manage Enrollment Tokens klicken Sie auf Generate, um ein Registrierungstoken zu erstellen. Alternativ können Sie ein vorhandenes Token auswählen, das sich in einem gültigen Status befindet.

  3. Folgen Sie dem Assistenten, um die Einstellungen abzuschließen.

  4. Laden Sie das erfolgreich erstellte Token herunter und speichern Sie es mit den geringsten Berechtigungen an einem sicheren Ort. Später, wenn Sie das Easy Install-Skript ausführen, können Sie mit der Variable CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE den Pfad zur Token-Datei für die Registrierung des VDA angeben.

Schritt 3: .NET installieren

Bevor Sie das Linux VDA-Paket installieren, installieren Sie .NET gemäß den Systemanforderungen.

Nach der Installation von .NET führen Sie den Befehl which dotnet aus, um Ihren Laufzeitpfad zu finden.

Basierend auf der Befehlsausgabe legen Sie den binären .NET-Laufzeitpfad fest. Wenn die Befehlsausgabe beispielsweise /aa/bb/dotnet lautet, verwenden Sie /aa/bb als binären .NET-Pfad.

Schritt 4: Selbstsignierte CA-Zertifikate hinzufügen

Einzelheiten zur Konfiguration selbstsignierter CA-Zertifikate finden Sie unter Selbstsignierte Zertifikate für WebSocket konfigurieren. Dieser Abschnitt umfasst das Platzieren und Aktualisieren von CA-Zertifikaten auf dem Linux VDA.

  • Für RHEL und Rocky Linux:

    Speichern Sie Ihre selbstsignierten CA-Zertifikate im Verzeichnis /etc/pki/ca-trust/source/anchors auf dem Linux VDA, und führen Sie dann den folgenden Befehl aus, um die Zertifikate zu aktualisieren:

     sudo update-ca-trust
 <!--NeedCopy-->

  • Für SUSE, Ubuntu und Debian:

    Legen Sie das Stamm-CA-Zertifikat im Verzeichnis /usr/local/share/ca-certificates ab. Führen Sie dann den Befehl update-ca-certificate aus.

     sudo update-ca-certificates
 <!--NeedCopy-->

Schritt 5: Linux VDA-Paket herunterladen

  1. Gehen Sie zur Citrix Virtual Apps and Desktops-Downloadseite.
  2. erweitern Sie die entsprechende Version von Citrix Virtual Apps™ and Desktops.

  3. erweitern Sie Components, um den Linux VDA zu finden. Beispiel:

    Komponenten für Citrix Virtual Apps and Desktops

  4. Klicken Sie auf den Linux VDA-Link, um auf die Linux VDA-Downloads zuzugreifen.

    Linux VDA-Downloads

  5. Laden Sie das Linux VDA-Paket herunter, das Ihrer Linux-Distribution entspricht.

  6. Laden Sie den öffentlichen GPG-Schlüssel herunter, mit dem Sie die Integrität des Linux VDA-Pakets überprüfen können. Beispiel:

    Öffentlicher GPG-Schlüssel

    So überprüfen Sie die Integrität des Linux VDA-Pakets mit dem öffentlichen Schlüssel:

    • Führen Sie für ein RPM-Paket die folgenden Befehle aus, um den öffentlichen Schlüssel in die RPM-Datenbank zu importieren und die Paketintegrität zu überprüfen:

       rpmkeys --import <path to the public key>
 rpm --checksig --verbose <path to the Linux VDA package>
 <!--NeedCopy-->

    • Führen Sie für ein DEB-Paket die folgenden Befehle aus, um den öffentlichen Schlüssel in die DEB-Datenbank zu importieren und die Paketintegrität zu überprüfen:

       sudo apt-get install dpkg-sig
 gpg --import <path to the public key>
 dpkg-sig --verify <path to the Linux VDA package>
 <!--NeedCopy-->

Schritt 6: Linux VDA-Paket installieren

Führen Sie die folgenden Befehle aus, um die Umgebung für den Linux VDA einzurichten.

Für RHEL- und Rocky Linux-Distributionen:

Hinweis:

  • Installieren Sie für RHEL und CentOS das EPEL-Repository, bevor Sie den Linux VDA erfolgreich installieren können. Informationen zur Installation von EPEL finden Sie in den Anweisungen unter https://docs.fedoraproject.org/de-de/epel/.

  • Bevor Sie den Linux VDA unter RHEL 9.x und Rocky Linux 9.x installieren, aktualisieren Sie das Paket libsepol auf Version 3.4 oder höher.

sudo yum  -y localinstall   <PATH>/<Linux VDA RPM>
<!--NeedCopy-->

Hinweis:

Nach der Installation des Linux VDA unter RHEL 8.x/9.x und Rocky Linux 8.x/9.x, die auf GCP gehostet werden, kann die Ethernet-Verbindung verloren gehen und der Linux VDA nach einem VM-Neustart unerreichbar sein. Um das Problem zu umgehen, legen Sie beim ersten Anmelden an der VM ein Root-Passwort fest und stellen Sie sicher, dass Sie sich als Root an der VM anmelden können. Führen Sie dann nach dem Neustart der VM die folgenden Befehle in der Konsole aus:

nmcli dev connect eth0
systemctl restart NetworkManager
<!--NeedCopy-->

Für Ubuntu/Debian-Distributionen:

sudo dpkg -i <PATH>/<Linux VDA deb>
sudo apt-get install -f
<!--NeedCopy-->

Hinweis:

  • Um die erforderlichen Abhängigkeiten für eine Debian 11-Distribution zu installieren, fügen Sie die Zeile deb http://deb.debian.org/debian/ bullseye main zur Datei /etc/apt/sources.list hinzu.

  • Deaktivieren Sie für Ubuntu 24.04/22.04 auf GCP RDNS. Fügen Sie dazu die Zeile rdns = false unter [libdefaults] in /etc/krb5.conf hinzu.

Für SUSE-Distributionen:

  1. Stellen Sie für SUSE 15.6 auf AWS, Azure und GCP sicher, dass:

    • Sie libstdc++6 Version 12 oder höher verwenden.
    • Der Parameter Default_WM in /etc/sysconfig/windowmanager auf “gnome” eingestellt ist.

  2. Führen Sie den folgenden Befehl aus, um den Linux VDA zu installieren:

    zypper -i install <PATH>/<Linux VDA RPM>
<!--NeedCopy-->

Schritt 7: NVIDIA GRID-Treiber installieren

Um HDX™ 3D Pro zu aktivieren, müssen Sie die NVIDIA GRID-Treiber auf Ihrem Hypervisor und auf der VDA-Maschine installieren.

Informationen zur Installation und Konfiguration des NVIDIA GRID Virtual GPU Managers (des Hosttreibers) auf den jeweiligen Hypervisoren finden Sie in den folgenden Anleitungen:

Führen Sie die folgenden allgemeinen Schritte aus, um die NVIDIA GRID-Gast-VM-Treiber zu installieren und zu konfigurieren:

  1. Stellen Sie sicher, dass die Gast-VM heruntergefahren ist.
  2. Weisen Sie der VM im Hypervisor-Bedienfeld eine GPU zu.
  3. Starten Sie die VM.
  4. Installieren Sie den Gast-VM-Treiber (von Ihrem Cloud-Anbieter oder NVIDIA) auf der VM.

Schritt 8: Zu verwendende Datenbank angeben

Sie können nach der Installation des Linux VDA-Pakets zwischen SQLite, PostgreSQL und dem integrierten Registrierungsdienst wechseln.

  • Führen Sie dazu die folgenden Schritte aus:

    • Wir empfehlen die Verwendung von SQLite nur für den VDI-Modus und die Verwendung von PostgreSQL oder des integrierten Registrierungsdienstes für ein Bereitstellungsmodell für gehostete Shared Desktops.

    • Für die einfache Installation und MCS können Sie SQLite, PostgreSQL oder den integrierten Registrierungsdienst verwenden, ohne diese manuell installieren zu müssen. Sofern nicht anders über /etc/xdl/db.conf angegeben, verwendet der Linux VDA standardmäßig den integrierten Registrierungsdienst. Wenn Sie eine benutzerdefinierte Version von PostgreSQL anstelle der von Ihrer Linux-Distribution bereitgestellten Version benötigen, müssen Sie die angegebene Version manuell installieren, /etc/xdl/db.conf bearbeiten, um die neue Version widerzuspiegeln, und den PostgreSQL-Dienst starten, bevor Sie das Easy Install-Skript (ctxinstall.sh) oder das MCS-Skript (deploymcs.sh) ausführen.

    • Sie können auch /etc/xdl/db.conf verwenden, um die Portnummer für PostgreSQL zu konfigurieren.

    • Um den integrierten Registrierungsdienst unter RHEL9, RHEL10 und Rocky9 zu verwenden, muss das CodeReady Builder-Repository aktiviert werden:

    RHEL9: subscription-manager repos –enable codeready-builder-for-rhel-9-$(arch)-rpms RHEL10: subscription-manager repos –enable codeready-builder-for-rhel-10-$(arch)-rpms Rocky9: dnf config-manager –enable crb

  1. Führen Sie /opt/Citrix/VDA/sbin/ctxcleanup.sh aus. Überspringen Sie diesen Schritt, wenn es sich um eine Neuinstallation handelt.

  2. Bearbeiten Sie /etc/xdl/db.conf, bevor Sie deploymcs.sh ausführen. Es folgt eine Beispiel-db.conf-Datei:

# database configuration file for Linux VDA



## database choice

# possible choices are:

#     SQLite

#     PostgreSQL

#     ctxregd - use the built-in registry service # default choice is ctxregd

DbType="ctxregd"



## database port

# specify database port for the database.

# if not specified, default port will be used:

# SQLite: N/A

# PostgreSQL: 5432

DbPort=5432



## PostgreSQL customized

# only the following value means true, otherwise false:

#     true

#     yes

#     y

#     YES

#     Y

# default is false

DbCustomizePostgreSQL=false



## PostgreSQL service name

# specify the service name of PostgreSQL for Linux VDA

# default is "postgresql"

DbPostgreSQLServiceName="postgresql"

<!--NeedCopy-->

Sie können SQLite, PostgreSQL oder den integrierten Registrierungsdienst festlegen, der verwendet werden soll, indem Sie /etc/xdl/db.conf nach der Installation des Linux VDA-Pakets bearbeiten.

Bearbeiten Sie dazu /etc/xdl/db.conf, bevor Sie sudo /opt/Citrix/VDA/sbin/ctxinstall.sh oder /opt/Citrix/VDA/bin/easyinstall ausführen.

Hinweis:

  • Wir empfehlen, SQLite nur für den VDI-Modus zu verwenden.

  • Für die einfache Installation und MCS können Sie SQLite, PostgreSQL oder den integrierten Registrierungsdienst verwenden, ohne diese manuell installieren zu müssen. Sofern nicht anders über /etc/xdl/db.conf angegeben, verwendet der Linux VDA standardmäßig den integrierten Registrierungsdienst.

  • Sie können auch /etc/xdl/db.conf verwenden, um die Portnummer für PostgreSQL zu konfigurieren.

  • Um den integrierten Registrierungsdienst unter RHEL9, RHEL10 und Rocky9 zu verwenden, muss das CodeReady Builder-Repository aktiviert werden: RHEL9: subscription-manager repos –enable codeready-builder-for-rhel-9-$(arch)-rpms RHEL10: subscription-manager repos –enable codeready-builder-for-rhel-10-$(arch)-rpms Rocky9: dnf config-manager –enable crb

Schritt 9: Führen Sie die einfache Installation aus, um die Umgebung und den VDA zu konfigurieren und die Installation abzuschließen

Nach der Installation des Linux VDA-Pakets konfigurieren Sie die Laufzeitumgebung mithilfe des ctxinstall.sh-Skripts oder der GUI.

Wenn Sie den sudo-Befehl ausführen, geben Sie die Option -E ein, um die vorhandenen Umgebungsvariablen an die neue Shell zu übergeben, die er erstellt. Wir empfehlen, dass Sie eine Shell-Skriptdatei aus den vorhergehenden Befehlen mit #!/bin/bash als erster Zeile erstellen.

Alternativ können Sie alle Variablen mit einem einzigen Befehl angeben.

Um die Umgebungsvariablen des VDA-Laufzeitumfelds (die mit „CTX_XDL_“ beginnenden Variablen) einzurichten, können Sie ctxinstall.sh -s ausführen (beachten Sie, dass der Buchstabe s hier klein geschrieben ist).

Hinweis:

Bevor Sie die Laufzeitumgebung einrichten, stellen Sie sicher, dass das Gebietsschema en_US.UTF-8 in Ihrem Betriebssystem installiert ist. Wenn das Gebietsschema in Ihrem Betriebssystem nicht verfügbar ist, führen Sie den Befehl sudo locale-gen en_US.UTF-8 aus. Bearbeiten Sie für Debian die Datei /etc/locale.gen, indem Sie die Zeile # en_US.UTF-8 UTF-8 auskommentieren, und führen Sie dann den Befehl sudo locale-gen aus.

GUI

Sie können die einfache Installation über eine GUI verwenden. Führen Sie den Befehl /opt/Citrix/VDA/sbin/linux-vda-installer in der Desktop-Umgebung Ihres VDA aus und folgen Sie dann den Anweisungen in der GUI für die einfache Installation.

Einfache Installation

Die GUI für die einfache Installation führt Sie durch die folgenden Vorgänge:

  • Systemumgebung prüfen
  • Datenbank konfigurieren
  • Abhängigkeiten installieren
  • Laufzeitumgebung konfigurieren

Hinweis:

Der Benutzer kann auch auf die Schaltfläche „Erweiterte Konfiguration (optional)“ klicken, um die detaillierten Konfigurationsoptionen zu erweiternieren.

ctxinstall.sh

ctxinstall.sh ist das Easy-Install-Skript für die Vorkonfiguration und das Einrichten der VDA-Laufzeitumgebungsvariablen.

  • Nur Root kann dieses Skript ausführen.

  • Easy Install verwendet /opt/Citrix/VDA/sbin/ctxinstall.conf als Konfigurationsdatei, um die Werte aller verwendeten Umgebungsvariablen festzulegen, zu speichern und zu synchronisieren. Wir empfehlen Ihnen, die Vorlage (ctxinstall.conf.tmpl) sorgfältig zu lesen und dann Ihre eigene ctxinstall.conf anzupassen. Wenn Sie die Konfigurationsdatei zum ersten Mal erstellen, verwenden Sie eine der folgenden Methoden:
    • Durch Kopieren der Vorlagendatei /opt/Citrix/VDA/sbin/ctxinstall.conf.tmpl und Speichern als /opt/Citrix/VDA/sbin/ctxinstall.conf.
    • Durch Ausführen von ctxinstall.sh. Jedes Mal, wenn Sie ctxinstall.sh ausführen, wird Ihre Eingabe in /opt/Citrix/VDA/sbin/ctxinstall.conf gespeichert.

  • Easy Install unterstützt modularen Betrieb. Module umfassen Vorabprüfung, Installation, Domänenkonfiguration, Setup und Verifizierung.

  • Details zur Fehlerbehebung für dieses Skript finden Sie in /var/log/xdl/ctxinstall.log.

Weitere Informationen erhalten Sie mit dem Hilfebefehl ctxinstall.sh -h.

Hinweis:

  • Stellen Sie nach dem Prinzip der geringsten Rechte sicher, dass nur der Root-Benutzer /opt/Citrix/VDA/sbin/ctxinstall.conf lesen kann, da das Kennwort für den Domänenbeitritt in der Datei festgelegt sein könnte.
  • Durch die Deinstallation des Linux VDA werden Dateien unter /opt/Citrix/VDA entfernt. Wir empfehlen Ihnen, /opt/Citrix/VDA/sbin/ctxinstall.conf vor der Deinstallation des VDA zu sichern.

Sie können ctxinstall.sh im interaktiven Modus oder im unbeaufsichtigten Modus ausführen. Bevor Sie das Skript ausführen, legen Sie die folgenden Umgebungsvariablen fest:

  • CTX_XDL_NON_DOMAIN_JOINED=’y|n’ – Ob die Maschine einer Domäne beitreten soll. Der Standardwert ist ‘n’. Für Szenarien ohne Domänenbeitritt setzen Sie ihn auf ‘y’.

  • CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE=’<Pfad-zur-Token-Datei-auf-VDA-Maschine>‘ – Um einen nicht domänenverbundenen VDA mit Easy Install zu erstellen, benötigen Sie eine Token-Datei, um den VDA in einem Maschinenkatalog des Delivery Controller zu registrieren. Speichern Sie das Token mit den geringsten Rechten an einem sicheren Ort.

  • CTX_XDL_VDI_MODE=’j|n’ – Ob die Maschine als dediziertes Desktop-Bereitstellungsmodell (VDI) oder als gehostetes Shared-Desktop-Bereitstellungsmodell konfiguriert werden soll. Für HDX 3D Pro-Umgebungen setzen Sie den Wert auf ‘j’.

  • CTX_XDL_HDX_3D_PRO=’y|n’ – Der Linux VDA unterstützt HDX 3D Pro, eine Reihe von GPU-Beschleunigungstechnologien, die zur Optimierung der Virtualisierung grafikintensiver Anwendungen entwickelt wurden. Wenn HDX 3D Pro ausgewählt ist, wird der VDA für VDI-Desktops (Einzelsitzungsmodus) konfiguriert – (d. h. CTX_XDL_VDI_MODE=’y’).

  • CTX_XDL_START_SERVICE=’y|n’ – Legt fest, ob die Linux VDA-Dienste gestartet werden, wenn die Konfiguration abgeschlossen ist.

  • CTX_XDL_REGISTER_SERVICE=’y|n’ – Die Linux Virtual Desktop-Dienste werden nach dem Start der Maschine gestartet.

  • CTX_XDL_ADD_FIREWALL_RULES=’y|n’ – Die Linux VDA-Dienste erfordern, dass eingehende Netzwerkverbindungen über die System-Firewall zugelassen werden. Sie können die erforderlichen Ports (standardmäßig Ports 80 und 1494) automatisch in der System-Firewall für den Linux Virtual Desktop öffnen.

  • CTX_XDL_DESKTOP_ENVIRONMENT=gnome/gnome-classic/mate – Gibt die GNOME-, GNOME Classic- oder MATE-Desktopumgebung an, die in Sitzungen verwendet werden soll. Wenn Sie die Variable nicht angeben, wird der auf dem VDA konfigurierte Standard-Desktop verwendet.

  • CTX_XDL_DESKTOP_ENVIRONMENT=gnome/gnome-classic/kde/mate/xfce/’<none>‘ – Gibt die GNOME-, GNOME Classic-, KDE-, MATE- oder Xfce-Desktopumgebung an, die in Sitzungen verwendet werden soll. Wenn Sie sie auf ‘<none>’ setzen, wird der auf dem VDA konfigurierte Standard-Desktop verwendet. Sie können eine in Sitzungen zu verwendende Desktopumgebung mit der Variablen CTX_XDL_DESKTOP_ENVIRONMENT angeben. Sie können auch zwischen Desktopumgebungen wechseln, indem Sie Befehle ausführen oder die Systemleiste verwenden. Weitere Informationen finden Sie unter Befehle zum Desktop-Wechsel und Systemleiste.

  • CTX_XDL_DOTNET_RUNTIME_PATH=’<path-to-install-dotnet-runtime>‘ – Der Pfad zur Installation von .NET zur Unterstützung des neuen Broker-Agent-Dienstes (ctxvda). Der Standardpfad ist ‘/usr/bin’.

  • CTX_XDL_VDA_PORT=’<port-number>‘ – Der Linux VDA kommuniziert mit Delivery Controllern über einen TCP/IP-Port.

Interaktiver Modus

Um das Skript ctxinstall.sh im interaktiven Modus auszuführen, verwenden Sie den Befehl sudo /opt/Citrix/VDA/sbin/ctxinstall.sh ohne die Option -S. Geben Sie den entsprechenden Variablenwert bei jeder Eingabeaufforderung in der Befehlszeilenschnittstelle ein. Wenn eine Variable bereits festgelegt ist, fragt ctxinstall.sh nach einer Bestätigung, falls Sie sie ändern möchten.

Stiller Modus

Im stillen Modus müssen Sie die vorhergehenden Variablen mithilfe von /opt/Citrix/VDA/sbin/ctxinstall.conf oder dem Exportbefehl festlegen. Führen Sie danach ctxinstall.sh -S aus (beachten Sie, dass der Buchstabe S hier großgeschrieben ist). Wenn nicht alle erforderlichen Variablen festgelegt sind oder ein Wert ungültig ist, bricht ctxinstall.sh die Ausführung ab, es sei denn, es sind Standardwerte vorhanden.

Wenn Sie ihn festlegen, überschreibt der exportierte Wert für jede Variable den Wert in /Citrix/VDA/sbin/ctxinstall.conf. Alle aktualisierten Werte werden in /Citrix/VDA/sbin/ctxinstall.conf gespeichert.

export CTX_XDL_NON_DOMAIN_JOINED='y'
export CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE='<token-file-path>'
export CTX_XDL_VDI_MODE='y|n'
export CTX_XDL_START_SERVICE='y|n'
export CTX_XDL_REGISTER_SERVICE='y|n'
export CTX_XDL_ADD_FIREWALL_RULES='y|n'
export CTX_XDL_HDX_3D_PRO='y|n'
export CTX_XDL_DESKTOP_ENVIRONMENT=gnome|gnome-classic|kde|mate|xfce|'<none>'
export CTX_XDL_DOTNET_RUNTIME_PATH='<path-to-install-dotnet-runtime>'
export CTX_XDL_VDA_PORT='<port-number>'
sudo -E /opt/Citrix/VDA/sbin/ctxinstall.sh -S
<!--NeedCopy-->

Wenn Sie den sudo-Befehl ausführen, geben Sie die Option -E ein, um die vorhandenen Umgebungsvariablen an die neue Shell zu übergeben, die er erstellt. Wir empfehlen, dass Sie eine Shell-Skriptdatei aus den vorhergehenden Befehlen mit #!/bin/bash als erster Zeile erstellen.

Alternativ können Sie alle Variablen mit einem einzigen Befehl angeben.

Um die Umgebungsvariablen des VDA einzurichten (die Variablen, die mit ‘CTX_XDL_’ beginnen), können Sie ctxinstall.sh -s ausführen (beachten Sie, dass der Buchstabe s hier in Kleinbuchstaben geschrieben ist).

Schritt 10: XDPing ausführen

Führen Sie sudo /opt/Citrix/VDA/bin/xdping aus, um nach häufigen Konfigurationsproblemen in einer Linux VDA-Umgebung zu suchen. Weitere Informationen finden Sie unter XDPing.

Schritt 11: Den Linux VDA ausführen

Linux VDA starten:

So starten Sie die Linux VDA-Dienste:

sudo systemctl start ctxhdx.service

sudo systemctl start ctxvda.service
<!--NeedCopy-->

Linux VDA beenden:

So beenden Sie die Linux VDA-Dienste:

sudo systemctl stop ctxvda.service

sudo systemctl stop ctxhdx.service
<!--NeedCopy-->

Hinweis:

Bevor Sie die Dienste ctxvda und ctxhdx beenden, führen Sie den Befehl systemctl stop ctxmonitord aus, um den Überwachungsdienst-Daemon zu beenden. Andernfalls startet der Überwachungsdienst-Daemon die von Ihnen beendeten Dienste neu.

Linux VDA neu starten:

So starten Sie die Linux VDA-Dienste neu:

sudo systemctl stop ctxvda.service

sudo systemctl restart ctxhdx.service

sudo systemctl start ctxvda.service
<!--NeedCopy-->

Status des Linux VDA überprüfen:

So überprüfen Sie den Ausführungsstatus der Linux VDA-Dienste:

sudo systemctl status ctxvda.service

sudo systemctl status ctxhdx.service
<!--NeedCopy-->

Schritt 12: Bereitstellungsgruppen erstellen

Der Prozess zum Erstellen einer Bereitstellungsgruppe und zum Hinzufügen von Maschinenkatalogen, die Linux-VDA-Maschinen enthalten, ist nahezu identisch mit dem für Windows-VDA-Maschinen. Eine detailliertere Beschreibung zur Durchführung dieser Aufgaben finden Sie unter Bereitstellungsgruppen erstellen.

Für die Erstellung von Bereitstellungsgruppen, die Linux-VDA-Maschinenkataloge enthalten, gelten die folgenden Einschränkungen:

  • Stellen Sie sicher, dass die von Ihnen ausgewählten AD-Benutzer und -Gruppen ordnungsgemäß für die Anmeldung an den Linux-VDA-Maschinen konfiguriert wurden.
  • Lassen Sie die Anmeldung nicht authentifizierter (anonymer) Benutzer nicht zu.
  • Mischen Sie die Bereitstellungsgruppe nicht mit Maschinenkatalogen, die Windows-Maschinen enthalten.

Wichtig:

Die Veröffentlichung von Anwendungen wird ab Linux VDA Version 1.4 unterstützt. Der Linux VDA unterstützt jedoch nicht die Bereitstellung von Desktops und Apps auf derselben Maschine.

Informationen zum Erstellen von Maschinenkatalogen und Bereitstellungsgruppen finden Sie unter Citrix Virtual Apps and Desktops 7 2503.

Schritt 13: Lokale Kontenzuordnung aktivieren

Was passiert, wenn die lokale Kontenzuordnung nicht aktiviert ist?

Sitzungen, die auf nicht in die Domäne eingebundenen VDAs gehostet werden, schlagen bei der Anmeldung fehl, zeigen eine Kennwortaufforderung an, akzeptieren aber das korrekte Kennwort nicht. Fehler ähnlich den folgenden können in der hdx.log gefunden werden:

2024-09-25 06:40:30.767979 [LOGIN_BOX:ERROR] <P124211:T58675:S4> citrix-ctxlogin: PamAuthenticate: pam authentication: Authentication failure. Can retry for user 'user3'
2024-09-25 06:40:30.768431 [LOGIN:ERROR] <P124211:T58675:S4> citrix-ctxlogin: LoginBoxValidate: Failed to validate user 'user3'. Due to INVALID_PASSWORD
2024-09-25 06:40:30.768947 [LOGIN_AUTH:INFO] <P124218:T58682:S4> citrix-ctxloginui: CalLabelFormat: Update username label on LoginUI from 'user3' to 'user3' (18)
2024-09-25 06:41:18.766196 [GFX_SLIDER:ERROR] <P124161:T58699:S4> citrix-ctxgfx: GfxCreateSliderListener: Failed to get user home dir.
<!--NeedCopy-->

Lokale Kontenzuordnung aktivieren

Um sicherzustellen, dass Benutzer sich an einem nicht in die Domäne eingebundenen Linux VDA anmelden können, aktivieren Sie die lokale Kontenzuordnung mit dem folgenden Befehl:

Set-BrokerDesktopGroup -Name "<your delivery group name>" -MachineLogOnType LocalMappedAccount
<!--NeedCopy-->

Führen Sie den Befehl bei einer lokalen Bereitstellung direkt auf dem Delivery Controller aus. Bei einer Citrix DaaS-Bereitstellung führen Sie den Befehl über das Citrix Virtual Apps and Desktops Remote PowerShell SDK aus.

Erstellen eines nicht in die Domäne eingebundenen Linux VDA mit Easy Install
August 3, 2026
Beitrag von: 
C C
August 3, 2026
Beitrag von: 
C C

In diesem Artikel

Feedback zur Site | Your privacy choices footer linkIhre Datenschutzauswahl | Datenschutz und rechtliche Bestimmungen | Cookie-Einstellungen | Einstellungen für die Zustimmung | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.