Linux Virtual Delivery Agent

Erstellen eines nicht in die Domäne eingebundenen Linux VDA mithilfe der einfachen Installation (Vorschau)

Dieser Artikel führt Sie durch die Verwendung der einfachen Installationsmethode zum Erstellen eines nicht in die Domäne eingebundenen Linux VDA in Citrix DaaS.

Wichtig:

Schritt 1: Maschinenkatalog erstellen

Erstellen Sie einen leeren Maschinenkatalog ohne Maschinen. Verwenden Sie beispielsweise das Citrix Remote PowerShell SDK und führen Sie den folgenden Befehl aus, um einen leeren Maschinenkatalog mit dem Namen Your-catalog-name zu erstellen, der Einzel-Sitzungs-Betriebssystemmaschinen unterstützt.

New-BrokerCatalog -AllocationType 'Static' -Description 'Your description' -MinimumFunctionalLevel 'L7_20' -Name 'Your-catalog-name' -SessionSupport 'SingleSession' -PersistUserChanges 'OnLocal' -ProvisioningType 'Manual' -MachinesArePhysical $true
<!--NeedCopy-->

Notieren Sie sich die UUID des erstellten Katalogs. Die UUID wird benötigt, wenn Sie später ein Registrierungstoken erstellen.

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.

Für die Erstellung 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 Folgendes aus:

    • 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 domänenverbundenen und nicht-domänenverbundenen Maschinen im selben Maschinenkatalog.
  • Maschinenkataloge für Remote-PC-Zugriff werden nur für domänenverbundene Maschinen unterstützt und nicht für nicht-domänenverbundene 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: Erstellen eines VDA-Registrierungstokens

Um einen nicht-domänenverbundenen VDA mit Easy Install zu erstellen, benötigen Sie eine Token-Datei, um den VDA bei einem Maschinenkatalog zu registrieren und den VDA bei der Citrix Cloud™-Steuerungsebene zu authentifizieren. Der Linux-VDA unterstützt die Verwendung einer Token-Datei für die Registrierung bei einem energieverwalteten Maschinenkatalog nicht.

Um ein Registrierungstoken zu erstellen, senden Sie eine HTTP-POST-Nachricht, ähnlich der folgenden, an die URL: [DdcServerAddress]/citrix/orchestration/api/techpreview/{customerid}/{siteid}/enrollments.

POST https://[DdcServerAddress]/citrix/orchestration/api/techpreview/[customerid]/[siteid]/enrollments HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
Authorization: Bearer <bearer-token>

{
  "TokenName": "string",
  "IssuedToUser": "string",
  "ExpirationDate": "2023-10-13T08:00:25.796Z",
  "NotValidBeforeDate": "2023-10-13T08:00:25.796Z",
  "NumMachinesAllowed": number,
  "CatalogId": "string"
}
<!--NeedCopy-->

Legen Sie in der HTTP-POST-Nachricht CatalogId auf die UUID des zuvor erstellten Maschinenkatalogs und [DdcServerAddress] je nach Bedarf auf einen der folgenden Werte fest:

  • Kommerziell https://[customerid].xendesktop.net
  • Japan https://[customerid].apps.citrixworkspacesapi.jp
  • Regierung https://[customerid].xendesktop.us

Schritt 3: .NET installieren

Installieren Sie .NET vor der Installation des Linux VDA gemäß den Systemanforderungen.

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

Legen Sie basierend auf der Befehlsausgabe 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: Linux VDA-Paket herunterladen

  1. Rufen Sie die Citrix Virtual Apps and Desktops-Downloadseite auf.
  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 5: Linux VDA-Paket installieren

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

Für Amazon Linux 2-, CentOS-, 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.3/9.2/9.0 und Rocky Linux 9.3/9.2/9.0 installieren, aktualisieren Sie das Paket libsepol auf Version 3.4 oder höher.

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

Hinweis:

Nachdem Sie den Linux VDA unter RHEL 8.x/9.x und Rocky Linux 8.x/9.x, die auf GCP gehostet werden, installiert haben, kann die Ethernet-Verbindung verloren gehen und der Linux VDA nach einem VM-Neustart unerreichbar sein. Um dieses 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 20.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.5 auf AWS, Azure und GCP Folgendes sicher:

    • Sie verwenden libstdc++6 Version 12 oder höher.
    • Der Parameter Default_WM in /etc/sysconfig/windowmanager ist auf “gnome” gesetzt.
  2. Führen Sie den folgenden Befehl aus, um den Linux VDA zu installieren:

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

Schritt 6: NVIDIA GRID-Treiber installieren

Zum Aktivieren von HDX™ 3D Pro müssen Sie die NVIDIA GRID-Treiber auf Ihrem Hypervisor und auf der VDA-Maschine installieren.

Informationen zum Installieren und Konfigurieren des NVIDIA GRID Virtual GPU Manager (des Hosttreibers) auf den spezifischen Hypervisoren finden Sie in den folgenden Anleitungen:

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

  1. Stellen Sie sicher, dass die Gast-VM heruntergefahren ist.
  2. Weisen Sie im Hypervisor-Bedienfeld der VM 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 7: Zu verwendende Datenbank angeben

Sie können SQLite oder PostgreSQL zur Verwendung angeben, indem Sie nach der Installation des Linux VDA-Pakets die Datei /etc/xdl/db.conf bearbeiten.

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

Hinweis:

  • Wir empfehlen die Verwendung von SQLite nur für den VDI-Modus.
  • Für die einfache Installation und MCS können Sie SQLite oder PostgreSQL zur Verwendung angeben, ohne sie manuell installieren zu müssen. Sofern nicht anders über /etc/xdl/db.conf angegeben, verwendet der Linux VDA standardmäßig PostgreSQL.
  • Sie können /etc/xdl/db.conf auch verwenden, um die Portnummer für PostgreSQL zu konfigurieren.

Schritt 8: Easy Install ausführen, um die Umgebung und den VDA zu konfigurieren und die Installation abzuschließen

Nach der Installation des Linux VDA-Pakets konfigurieren Sie die Laufzeitumgebung mit dem Skript ctxinstall.sh.

Hinweis:

Stellen Sie vor dem Einrichten der Laufzeitumgebung 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.

ctxinstall.sh

ctxinstall.sh ist das Easy-Install-Skript für einige Vorkonfigurationen und die Einrichtung 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, Einrichtung 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:

  • Gemäß dem Prinzip der geringsten Rechte stellen Sie 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=’<path-to-token-file-on-vda-machine>‘ – Um einen nicht domänengebundenen 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 in einer Datei mit den geringsten Rechten unter einem geeigneten Pfad.

  • CTX_XDL_VDI_MODE=’y|n’ – Gibt an, 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 ‘y’.
  • 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 von grafikintensiven 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 Maschinenstart 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_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.

Überlegungen

  • Sie können die Desktopumgebung für einen Ziel-Sitzungsbenutzer auch ändern, indem Sie die folgenden Schritte ausführen:

    1. Erstellen Sie eine .xsession- oder .Xclients-Datei im Verzeichnis $HOME/<username> auf dem VDA. Wenn Sie Amazon Linux 2 verwenden, erstellen Sie eine .Xclients-Datei. Wenn Sie andere Distributionen verwenden, erstellen Sie eine .xsession-Datei.
    2. Bearbeiten Sie die Datei .xsession oder .Xclients, um eine Desktopumgebung basierend auf den Distributionen anzugeben.

      • Für MATE-Desktop

         MSESSION="$(type -p mate-session)"
         if [ -n "$MSESSION" ]; then
         exec mate-session
         fi
         <!--NeedCopy-->
        
      • Für GNOME Classic-Desktop

         GSESSION="$(type -p gnome-session)"
         if [ -n "$GSESSION" ]; then
         export GNOME_SHELL_SESSION_MODE=classic
         exec gnome-session --session=gnome-classic
         fi
         <!--NeedCopy-->
        
      • Für GNOME-Desktop

         GSESSION="$(type -p gnome-session)"
         if [ -n "$GSESSION" ]; then
         exec gnome-session
         fi
         <!--NeedCopy-->
        
    3. Teilen Sie die Dateiberechtigung 700 mit dem Ziel-Sitzungsbenutzer.

    Ab Version 2209 können Sitzungsbenutzer ihre Desktopumgebungen anpassen. Um diese Funktion zu aktivieren, müssen Sie im Voraus umschaltbare Desktopumgebungen auf dem VDA installieren. Weitere Informationen finden Sie unter Benutzerdefinierte Desktopumgebungen durch Sitzungsbenutzer.

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 an 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 mit /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 oder einige Werte ungültig sind, bricht ctxinstall.sh die Ausführung ab, es sei denn, es gibt Standardwerte.

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 | mate | '<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, eine Shell-Skriptdatei aus den vorhergehenden Befehlen mit #!/bin/bash als erster Zeile zu erstellen.

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

Um die VDA-Laufzeitumgebungsvariablen (die mit ‘CTX_XDL_’ beginnenden Variablen) einzurichten, können Sie ctxinstall.sh -s ausführen (beachten Sie, dass der Buchstabe s hier kleingeschrieben ist).

Schritt 9: XDPing ausführen

Führen Sie sudo /opt/Citrix/VDA/bin/xdping aus, um häufige Konfigurationsprobleme in einer Linux VDA-Umgebung zu überprüfen. Weitere Informationen finden Sie unter XDPing.

Schritt 10: Linux VDA ausführen

Starten Sie den Linux VDA:

So starten Sie die Linux VDA-Dienste:

sudo systemctl start ctxhdx.service

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

Linux VDA anhalten:

So halten Sie die Linux VDA-Dienste an:

sudo systemctl stop ctxvda.service

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

Hinweis:

Bevor Sie die Dienste ctxvda und ctxhdx anhalten, führen Sie den Befehl systemctl stop ctxmonitord aus, um den Überwachungsdienst-Daemon anzuhalten. Andernfalls startet der Überwachungsdienst-Daemon die von Ihnen angehaltenen 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 11: 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 von nicht authentifizierten (anonymen) Benutzern nicht zu.
  • Mischen Sie die Bereitstellungsgruppe nicht mit Maschinenkatalogen, die Windows-Maschinen enthalten.

Wichtig:

Das Veröffentlichen von Anwendungen wird ab Linux VDA Version 1.4 und höher unterstützt. Allerdings unterstützt der Linux VDA die Bereitstellung von Desktops und Apps auf demselben Computer nicht.

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