Linux Virtual Delivery Agent

Nicht domänengebundenen Linux VDA mit Easy Install erstellen (Preview)

In diesem Artikel erfahren Sie, wie Sie mit Easy Install einen nicht domänengebundenen Linux VDA in Citrix DaaS erstellen.

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 zu erstellen, der Ihr-Katalogname heißt und Einzelsitzungs-OS-Maschinen 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 der traditionellen Windows VDA-Methode. Umfassendere Informationen zu diesen Prozessen finden Sie unter Erstellen von Maschinenkatalogen und Verwalten von Maschinenkatalogen.

Beim Erstellen von Maschinenkatalogen mit Linux VDA-Maschinen gibt es einige Einschränkungen, durch die sich der Prozess von der Maschinenkatalogerstellung für Windows VDA-Maschinen unterscheidet:

  • Auswahl des Betriebssystems:

    • Die Option Multisitzungs-OS für ein Bereitstellungsmodell mit gehosteten, freigegebenen Desktops.
    • Die Option Betriebssystem für Einzelsitzungen für ein VDI-dediziertes Desktopbereitstellungsmodell.
  • In einem Maschinenkatalog darf sich keine Mischung aus Linux und Windows VDA-Maschinen befinden.
  • Kombinieren Sie keine domänengebundenen und nicht domänengebundenen Maschinen im gleichen Maschinenkatalog.
  • Remote-PC-Zugriff-Maschinenkataloge werden nur für domänengebundene Maschinen unterstützt und nicht für Maschinen, die nicht in Domänen eingebunden sind.

Hinweis:

In früheren Citrix Studio-Versionen wurde Linux als Betriebssystem nicht unterstützt. Durch die Auswahl von Windows-Serverbetriebssystem oder Serverbetriebssystem wird jedoch ein äquivalentes gehostetes, freigegebenes Desktopbereitstellungsmodell bereitgestellt. Durch die Auswahl von Windows-Desktopbetriebssystem oder Desktopbetriebssystem wird ein Bereitstellungsmodell für Einzelbenutzermaschinen bereitgestellt.

Schritt 2: VDA-Registrierungstoken erstellen

Für einen nicht domänengebundenen VDA benötigen Sie eine Tokendatei, um den VDA bei einem Maschinenkatalog zu registrieren und bei der Citrix Cloud-Steuerungsebene zu authentifizieren.

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-->

Setzen Sie in der HTTP-POST-Nachricht CatalogId auf die UUID des Maschinenkatalogs, den Sie zuvor erstellt haben, und setzen Sie [DdcServerAddress] je nach Bedarf auf einen der folgenden Werte:

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

Schritt 3: .NET Runtime 6.0 installieren

Installieren Sie .NET Runtime 6.0 vor der Installation von Linux VDA gemäß den Anweisungen unter https://docs.microsoft.com/en-us/dotnet/core/install/linux-package-managers.

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

Legen Sie basierend auf der Ausgabe des Befehls den Binärpfad für die .NET-Laufzeitumgebung fest. Wenn die Befehlsausgabe beispielsweise /aa/bb/dotnet ist, verwenden Sie /aa/bb als .NET-Binärpfad.

Schritt 4: Herunterladen des Linux VDA-Pakets

  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 Komponenten, 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

    Überprüfen der 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: Installieren des Linux VDA-Pakets

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

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/en-US/epel/.

  • Aktualisieren Sie das libsepol-Paket auf Version 3.4 oder höher, bevor Sie den Linux VDA unter RHEL 9.2/9.0 und Rocky Linux 9.2/9.0 installieren.

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

Hinweis:

Nach der Installation des Linux VDA auf RHEL 8.x/9.x oder Rocky Linux 8.x/9.x, das auf GCP gehostet wird, wird die Ethernetverbindung möglicherweise unterbrochen und der Linux VDA ist nach einem VM-Neustart u. U. nicht erreichbar. Um das Problem zu umgehen, legen Sie ein Root-Kennwort fest, wenn Sie sich das erste Mal an der VM anmelden, und stellen sicher, dass Sie sich als Root-Benutzer 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
service NetworkManager restart
<!--NeedCopy-->

Für Ubuntu/Debian-Distributionen:

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

Hinweis:

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

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

SUSE-Distributionen:

  1. Für SUSE 15.5 in AWS, Azure und GCP ist Folgendes sicherzustellen:

    • 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: Installieren von NVIDIA GRID-Treibern

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 (Hosttreiber) auf den jeweiligen Hypervisoren finden Sie in den folgenden Handbüchern:

Zum Installieren und Konfigurieren der NVIDIA GRID-Gast-VM-Treiber führen Sie die folgenden allgemeinen Schritte aus:

  1. Stellen Sie sicher, dass die Gast-VM heruntergefahren ist.
  2. Weisen Sie der VM in der Hypervisor-Systemsteuerung eine GPU zu.
  3. Starten Sie die VM.
  4. Installieren Sie den Gast-VM-Treiber auf der VM.

Schritt 7: Angeben einer zu verwendenden Datenbank

Sie können die Verwendung von SQLite oder PostgreSQL angeben, 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.
  • Bei Easy Install und den Maschinenerstellungsdiensten (MCS) können Sie SQLite oder PostgreSQL zur Verwendung angeben, ohne die Systeme manuell installieren zu müssen. Sofern nicht anders durch /etc/xdl/db.conf angegeben, verwendet der Linux VDA standardmäßig PostgreSQL.
  • Sie können auch /etc/xdl/db.conf verwenden, um die Portnummer für PostgreSQL zu konfigurieren.

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

Nach der Installation des Linux VDA-Pakets müssen Sie die Laufzeitumgebung konfigurieren, indem Sie das Skript ctxinstall.sh ausführen.

Hinweis:

Stellen Sie vor dem Einrichten der Laufzeitumgebung sicher, dass das Gebietsschema en_US.UTF-8 in Ihrem Betriebssystem installiert ist. Wenn das Gebietsschema im Betriebssystem nicht verfügbar ist, führen Sie den Befehl sudo locale-gen en_US.UTF-8 aus. Für Debian bearbeiten Sie die Datei /etc/locale.gen durch Auskommentierung der Zeile # en_US.UTF-8 UTF-8. Führen Sie dann den Befehl sudo locale-gen aus.

ctxinstall.sh

ctxinstall.sh ist das einfache Installationsskript, mit dem Sie einige Vorkonfigurationen vornehmen und die VDA-Umgebungsvariablen einrichten können.

  • Nur root kann dieses Skript ausführen.

  • Mit der Konfigurationsdatei /opt/Citrix/VDA/sbin/ctxinstall.conf werden die Werte aller Umgebungsvariablen festgelegt, gespeichert und synchronisiert, die für GUI und ctxinstall.sh erforderlich sind. Es wird empfohlen, die Vorlage (ctxinstall.conf.tmpl) sorgfältig zu lesen und dann Ihre eigene ctxinstall.conf anzupassen. Verwenden Sie eine der folgenden Methoden, wenn Sie die Konfigurationsdatei zum ersten Mal erstellen:
    • Kopieren Sie die Vorlagendatei /opt/Citrix/VDA/sbin/ctxinstall.conf.tmpl und speichern Sie sie unter /opt/Citrix/VDA/sbin/ctxinstall.conf.
    • Führen Sie ctxinstall.sh aus. Jedes Mal, wenn Sie ctxinstall.sh ausführen, wird Ihre Eingabe in /opt/Citrix/VDA/sbin/ctxinstall.conf gespeichert.
  • Die einfache Installation unterstützt den modularen Betrieb. Die Module umfassen Vorabprüfung, Installation, Domänenkonfiguration, Einrichtung und Überprüfung.

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

Weitere Informationen erhalten Sie durch Eingabe des Hilfebefehls ctxinstall.sh -h.

Hinweis:

  • Gemäß dem Prinzip der geringsten Privilegien sollten Sie sicherstellen, dass nur der Root-Benutzer /opt/Citrix/VDA/sbin/ctxinstall.conf lesen kann, da das Kennwort für den Domänenbeitritt möglicherweise in der Datei festgelegt ist.
  • Durch die Deinstallation des Linux VDA werden Dateien unter /opt/Citrix/VDA entfernt. Wir empfehlen, ein Backup von /opt/Citrix/VDA/sbin/ctxinstall.conf zu erstellen, bevor Sie den VDA deinstallieren.

Sie können ctxinstall.sh im interaktiven Modus oder im automatischen Modus ausführen. Legen Sie die folgenden Umgebungsvariablen fest, bevor Sie das Skript ausführen:

  • **CTX_XDL_NON_DOMAIN_JOINED=’y|n’** − Verbindung der Maschine zu einer Domäne. Der Standardwert ist “n”. Für domänengebundene Szenarien setzen Sie es ihn auf “y”.

  • CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE=’<path-to-token-file-on-vda-machine>’ – Um einen nicht domänenverbundenen VDA mit Easy Install zu erstellen, benötigen Sie eine Tokendatei zur Registrierung des VDAs in einem Maschinenkatalog des Delivery Controllers. Speichern Sie das Token in einer Datei mit den geringsten Rechten unter einem geeigneten Pfad.

  • CTX_XDL_VDI_MODE=’y|n’: Ermöglicht die Konfiguration der Maschine als dediziertes Desktopbereitstellungsmodell (VDI) oder als gehostetes, freigegebenes Desktopbereitstellungsmodell. Legen Sie den Wert bei Umgebungen mit HDX 3D Pro auf ‘y’ fest.
  • CTX_XDL_HDX_3D_PRO=’y|n’: Der Linux VDA unterstützt HDX 3D Pro – GPU-Beschleunigungstechnologien zum Optimieren der Virtualisierung reichhaltiger Grafikanwendungen. Bei aktiviertem HDX 3D Pro wird der VDA für VDI-Desktopmodus (Einzelsitzungen) konfiguriert (d. h. CTX_XDL_VDI_MODE=’y’).

  • CTX_XDL_START_SERVICE=’y|n’: Legt fest, ob die Linux VDA-Dienste nach Abschluss der Konfiguration gestartet werden.

  • CTX_XDL_REGISTER_SERVICE=’y|n’: Die Linux Virtual Desktop-Dienste werden nach dem Systemstart gestartet.

  • CTX_XDL_ADD_FIREWALL_RULES=’y|n’: Für die Linux VDA-Dienste muss die Systemfirewall eingehende Netzwerkverbindungen zulassen. Sie können die erforderlichen Ports (standardmäßig Port 80 und 1494) in der Systemfirewall automatisch für Linux Virtual Desktop öffnen.

  • CTX_XDL_DESKTOP_ENVIRONMENT=gnome/gnome-classic/mate: Legt die GNOME-, GNOME Classic- oder MATE-Desktopumgebung zur Verwendung in Sitzungen fest. Wenn Sie die Variable nicht angeben, wird der auf dem VDA konfigurierte Standarddesktop verwendet.

  • CTX_XDL_DOTNET_RUNTIME_PATH=’<path-to-install-dotnet-runtime>’: Der Pfad für die Installation von .NET Runtime 6.0 zur Unterstützung des neuen Brokeragentdiensts (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 Sitzungsbenutzer auch über die folgenden Schritte ändern:

    1. Erstellen Sie die Datei .xsession oder .Xclients auf dem VDA im Verzeichnis $HOME/<username>. Wenn Sie Amazon Linux 2 verwenden, erstellen Sie die Datei .Xclients. Wenn Sie andere Distributionen verwenden, erstellen Sie die Datei .xsession.
    2. Geben Sie in der Datei .xsession oder .Xclients eine auf Distributionen basierende Desktopumgebung an.

      • 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 700-Dateiberechtigung mit dem Zielsitzungsbenutzer.

    Ab Version 2209 können Sitzungsbenutzer ihre Desktopumgebung anpassen. Um dieses Feature zu aktivieren, müssen Sie umschaltbare Desktopumgebungen vorher auf dem VDA installieren. Weitere Informationen finden Sie unter Benutzerdefinierte Desktopumgebungen nach Sitzungsbenutzern.

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 an jeder Eingabeaufforderung der Befehlszeilenschnittstelle den entsprechenden Variablenwert ein. Falls eine Variable bereits festgelegt ist, werden Sie in ctxinstall.sh aufgefordert, Änderungen zu bestätigen.

Automatischer Modus

Im automatischen Modus müssen Sie die vorherigen Variablen mithilfe von /opt/Citrix/VDA/sbin/ctxinstall.conf oder dem Befehl zum Exportieren festlegen. Führen Sie danach ctxinstall.sh -S aus (S muss hier groß geschrieben werden). Wenn nicht alle erforderlichen Variablen festgelegt sind oder ein Wert ungültig ist, bricht ctxinstall.sh die Ausführung ab, sofern keine Standardwerte vorhanden sind.

Wenn Sie den exportierten Wert festlegen, überschreibt er 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-->

Sie müssen die Option -E mit dem Befehl “sudo” angeben, damit die vorhandenen Umgebungsvariablen an die neu erstellte Shell weitergegeben werden. Wir empfehlen, dass Sie mit den oben aufgeführten Befehlen eine Shellskriptdatei erstellen, deren erste Zeile #!/bin/bash enthält.

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

Um die VDA-Laufumgebungsvariablen einzurichten (sie beginnen mit CTX_XDL_), können Sie ctxinstall.sh -s ausführen (der Buchstabe s wird hier klein geschrieben).

Schritt 9: Ausführen von XDPing

Mit sudo /opt/Citrix/VDA/bin/xdping können Sie Linux VDA-Umgebungen auf häufige Konfigurationsprobleme überprüfen. Weitere Informationen finden Sie unter XDPing.

Schritt 10: Ausführen des Linux VDA

Starten Sie den Linux VDA:

Starten der Linux VDA-Dienste:

sudo systemctl start ctxhdx.service

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

Halten Sie den Linux VDA an:

Anhalten der Linux VDA-Dienste:

sudo systemctl stop ctxvda.service

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

Hinweis:

Beenden Sie erst den Monitor Service Daemon mit dem Befehl service ctxmonitorservice stop, bevor Sie die Dienste ctxvda und ctxhdx anhalten. Andernfalls startet der Monitor Service Daemon die angehaltenen Dienste neu.

Starten Sie den Linux VDA neu:

Neustarten der Linux VDA-Dienste:

sudo systemctl stop ctxvda.service

sudo systemctl restart ctxhdx.service

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

Überprüfen Sie den Linux VDA-Status:

Überprüfen des Ausführungsstatus der Linux VDA-Dienste:

sudo systemctl status ctxvda.service

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

Schritt 11: Bereitstellungsgruppen erstellen

Die Prozesse zum Erstellen einer Bereitstellungsgruppe und zum Hinzufügen von Maschinenkatalogen mit Linux VDA- bzw. Windows VDA-Maschinen sind fast identisch. Umfassendere Informationen zu diesen Prozessen finden Sie unter Erstellen von Bereitstellungsgruppen.

Beim Erstellen von Bereitstellungsgruppen mit Linux VDA-Maschinenkatalogen gelten die folgenden Einschränkungen:

  • Stellen Sie sicher, dass die ausgewählten Active Directory-Benutzer und -Gruppen für die Anmeldung an Linux VDA-Maschinen richtig konfiguriert wurden.
  • Lassen Sie nicht die Anmeldung nicht authentifizierter (anonymer) Benutzer zu.
  • Die Bereitstellungsgruppe darf keine Maschinenkataloge mit Windows Maschinen enthalten.

Wichtig:

Die Veröffentlichung von Anwendungen wird unter Linux VDA-Version 1.4 und höher unterstützt. Der Linux VDA unterstützt jedoch keine Bereitstellung von Desktops und Anwendungen für dieselbe Maschine.

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