Linux Virtual Delivery Agent

Erstellen von Linux-VDAs auf Google Cloud Platform (GCP) mithilfe von Machine Creation Services™ (MCS)

Um Linux-VDAs auf GCP mithilfe von MCS zu erstellen, führen Sie die folgenden Schritte aus:

Schritt 3: Erste Schritte mit der API

Schritt 1: Erstellen einer Linux Virtual Machine (VM) auf GCP

Schritt 2: Erstellen eines GCP-Dienstkontos

Schritt 3: Erstellen einer Hostverbindung zu GCP in Citrix Studio

Schritt 4: Vorbereiten eines Linux-VDA-Masterimages

Schritt 5: Erstellen eines Maschinenkatalogs

Schritt 1b: Klicken Sie auf der Seite „VM-Instanzen“ auf INSTANZ ERSTELLEN, um eine VM-Instanz zu erstellen.

Registerkarte INSTANZ ERSTELLEN

Schritt 1c: Nehmen Sie die folgenden Konfigurationen vor und belassen Sie andere Konfigurationen als Standard:

  • Geben Sie einen Namen für Ihre VM-Instanz ein.
  • Wählen Sie eine Region und Zone zum Hosten Ihrer VM aus.
  • (Optional) Fügen Sie Ihrer VM eine GPU hinzu. Weitere Informationen finden Sie später in diesem Artikel unter Schritt 4c.
  • Wählen Sie im Abschnitt Startlaufwerk das Betriebssystem und die Festplattengröße für Ihre VM aus. Beispiel:

    Startlaufwerk

  • Navigieren Sie zu Erweiterte Optionen > Netzwerk und legen Sie das Feld Hostname auf einen FQDN fest.

    Feld Hostname festlegen

Schritt 1d: Klicken Sie auf Erstellen, um die VM-Instanz zu erstellen.

Schritt 1e: Nachdem die VM erstellt wurde, kehren Sie zum Dashboard Compute Engine zurück, suchen Sie Ihre VM-Instanz in der Liste und klicken Sie auf die Schaltfläche SSH, um eine Verbindung zu Ihrer VM herzustellen.

Klicken Sie auf die SSH-Schaltfläche, um eine Verbindung zu Ihrer VM auf GCP herzustellen

Schritt 1f: Laden Sie das Linux-VDA-Paket über den webbasierten SSH-Client auf Ihre VM hoch.

Laden Sie das Linux-VDA-Paket auf Ihre VM auf GCP hoch

Schritt 1g: Verhindern Sie Fehler beim Zugriff auf die VM über SSH.

Die VM ist nach einem Neustart möglicherweise nicht erreichbar. 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-->
  • Verbindung zur seriellen Konsole herstellen

Schritt 2: Erstellen eines GCP-Dienstkontos

Dieser Abschnitt führt Sie durch die Erstellung eines GCP-Dienstkontos, einschließlich der Erstellung eines Dienstkontoschlüssels und der Zuweisung der erforderlichen Rollen zum Dienstkonto.

Hinweis:

Um ein GCP-Dienstkonto zu erstellen, stellen Sie sicher, dass Ihnen die IAM-Rolle Dienstkontoadministrator (roles/iam.serviceAccountAdmin) zugewiesen ist.

Schritt 2a: Navigieren Sie in der Google Cloud Console zu IAM & Admin > Dienstkonten und klicken Sie dann auf die Registerkarte Dienstkonto erstellen.

Registerkarte Dienstkonto erstellen

Schritt 2b: Geben Sie im Schritt Details zum Dienstkonto die Werte in die Felder ein und klicken Sie dann auf Erstellen und fortfahren.

Details zum Dienstkonto

Schritt 2c: Überspringen Sie die optionalen Schritte und klicken Sie unten auf Fertig.

Fertig mit der Erstellung eines GCP-Dienstkontos

Schritt 2d: Navigieren Sie erneut zu IAM & Admin > Dienstkonten und klicken Sie dann auf die Registerkarte Dienstkonten. Suchen Sie das neu erstellte Dienstkonto, navigieren Sie zur Registerkarte Schlüssel und klicken Sie dann auf Schlüssel hinzufügen > Neuen Schlüssel erstellen > JSON > Erstellen.

GCP-Dienstkontoschlüssel hinzufügen

Schlüsseldatei herunterladen

Hinweis:

Nachdem Sie die Schlüsseldatei heruntergeladen haben, können Sie sie nicht erneut herunterladen.

Schritt 2e: Navigieren Sie in der Google Cloud Console zu IAM & Admin > IAM und klicken Sie dann auf Hinzufügen. Suchen und wählen Sie das neu erstellte Dienstkonto im Feld Neue Mitglieder aus und wählen Sie dann eine Rolle für das Dienstkonto aus, um ihm Zugriff auf Ihre Ressourcen zu gewähren. Fahren Sie fort, Rollen zuzuweisen, indem Sie auf Weitere Rolle hinzufügen klicken, um sicherzustellen, dass Sie alle folgenden Rollen dem neu erstellten Dienstkonto zuweisen.

  • Compute-Administrator
    • Speicher-Administrator
      • Cloud Build-Editor
    • Dienstkontobenutzer
      • Cloud Datastore-Benutzer
    • Compute-Instanz-Administrator (Beta)
      • Inhaber

      • Beispiel:

      • Rollen für das GCP-Dienstkonto zuweisen

Schritt 3: Erstellen einer Hostverbindung zu GCP in Citrix Studio

Richten Sie Ihre GCP-Umgebung gemäß den Virtualisierungsumgebungen der Google Cloud Platform ein und führen Sie dann die folgenden Schritte aus, um eine Hostverbindung zu GCP zu erstellen.

  1. Für lokale Delivery Controller wählen Sie in Citrix Studio vor Ort Konfiguration > Hosting > Verbindung und Ressourcen hinzufügen, um eine Hostverbindung zu erstellen. Für Cloud Delivery Controller wählen Sie in der webbasierten Studio-Konsole auf Citrix Cloud™ Verwalten > Hosting > Verbindung und Ressourcen hinzufügen, um eine Hostverbindung zu erstellen.

  2. Wählen Sie im Assistenten Verbindung und Ressourcen hinzufügen die Option Google Cloud Platform als Verbindungstyp aus.

    Beispiel: In der webbasierten Studio-Konsole auf Citrix Cloud:

    • Verbindung hinzufügen Bild

      1. Importieren Sie den Dienstkontoschlüssel Ihres GCP-Kontos und geben Sie Ihren Verbindungsnamen ein.
  3. Der Assistent führt Sie durch die Seiten. Der spezifische Seiteninhalt hängt vom ausgewählten Verbindungstyp ab. Nachdem Sie jede Seite ausgefüllt haben, wählen Sie Weiter, bis Sie die Seite Zusammenfassung erreichen. Weitere Informationen finden Sie unter Schritt 2: Erstellen einer Hostverbindung im Artikel Erstellen von nicht in die Domäne eingebundenen Linux-VDAs mit MCS.

Schritt 4: Vorbereiten eines Linux-VDA-Masterimages

Schritt 4a: (Für RHEL 8.x/9.x und Rocky Linux 8.x/9.x) Ethernet-Verbindung konfigurieren.

Nachdem Sie den Linux-VDA auf 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-->

Mit der seriellen Konsole verbinden

        -  **Schritt 4b:** Installieren Sie das Linux-VDA-Paket auf der Vorlagen-VM.

    -  Führen Sie auf der Vorlagen-VM die folgenden Schritte aus, um das Linux-VDA-Paket zu installieren:

    -  1.  Installieren Sie .NET Runtime 6.0:

```
sudo yum install dotnet-sdk-6.0
<!--NeedCopy--> ```
  1. Installieren Sie das Linux-VDA-Paket:

    sudo yum –y localinstall <PATH>/<Linux VDA RPM>
    <!--NeedCopy-->
    
  2. Aktivieren Sie das EPEL-Repository:

    sudo rpm -ivh  https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
    <!--NeedCopy-->
    

Schritt 4c: Fügen Sie der Vorlagen-VM auf GCP eine Grafikprozessoreinheit (GPU) hinzu (optional).

        -  1.  Fügen Sie in der Google Cloud Console der Vorlagen-VM eine oder mehrere GPUs hinzu. Informationen zum Hinzufügen und Entfernen von GPUs auf GCP finden Sie unter <https://cloud.google.com/compute/docs/gpus/add-remove-gpus>.

        -  ![Fügen Sie einer VM auf GCP eine oder mehrere GPUs hinzu](/en-us/linux-virtual-delivery-agent/2402-ltsr/media/add-gpus-to-vm-on-gcp.png)

    -  1.  Installieren Sie den entsprechenden GPU-Treiber auf der Vorlagen-VM. Weitere Informationen finden Sie unter <https://cloud.google.com/compute/docs/gpus/install-drivers-gpu>.

    -  **Erforderliche NVIDIA-Treiberversionen:**

    -  NVIDIA-GPUs, die auf Compute Engine ausgeführt werden, müssen die folgenden NVIDIA-Treiberversionen verwenden:

    -  Für L4-GPUs:
    -  Linux : 525.60.13 oder höher

    -  Für A100-GPUs:
    -  Linux : 450.80.02 oder höher

-  Für T4-, P4-, P100- und V100-GPUs:
    -  Linux : 410.79 oder höher

-  Für K80-GPUs ([Ende des Lebenszyklus](https://cloud.google.com/compute/docs/eol/k80-eol)):
    -  Linux : 410.79 – neueste R470-Version

Für K80-GPUs hat NVIDIA angekündigt, dass der [R470-Treiberzweig](https://docs.nvidia.com/datacenter/tesla/index.html#r470-driver-release-notes) die letzte Treiberversion ist, die Debug-Unterstützung erhält. Um dieses Update zu überprüfen, siehe [NVIDIA Software Support Matrix](https://docs.nvidia.com/datacenter/tesla/drivers/index.html#cuda-arch-matrix).

**Installationsskript:**

Sie können das folgende Skript verwenden, um den Installationsprozess zu automatisieren:

```
https://raw.githubusercontent.com/GoogleCloudPlatform/compute-gpu-installation/main/linux/install_gpu_driver.py --output install_gpu_driver.py
<!--NeedCopy--> ```

**Unterstützte Betriebssysteme:**

Das Installationsskript wurde auf den folgenden Linux-Distributionen getestet:

-  CentOS 7/8
-  Debian 10/11
-  Red Hat Enterprise Linux (RHEL) 7/8
-  Rocky Linux 8
-  Ubuntu 18/20/22

Wenn Sie dieses Skript auf anderen Linux-Distributionen verwenden, schlägt die Installation fehl. Für Linux-VMs installiert dieses Skript nur den NVIDIA-Treiber.

1.  Laden Sie das Installationsskript herunter.

    ```
    curl https://raw.githubusercontent.com/GoogleCloudPlatform/compute-gpu-installation/main/linux/install_gpu_driver.py --output install_gpu_driver.py
    <!--NeedCopy--> ```

-  1.  Gewähren Sie dem Skript vollständigen Zugriff.

    ```
    chmod 777 install_gpu_driver.py
    <!--NeedCopy--> ```

1.  Führen Sie das Installationsskript aus.

    ```
    python3 install_gpu_driver.py
    <!--NeedCopy--> ```

1.  Deaktivieren Sie Wayland in gdm3.

    -  Suchen Sie die Wayland-Konfigurationsdatei Ihrer Distribution an einem der folgenden Speicherorte:
        -  /etc/gdm3/custom.conf (Ubuntu)
        -  /etc/gdm/custom.conf (CentOS, RHEL, Rocky Linux)

    -  Öffnen Sie die Datei mit sudo-/Root-Berechtigungen.
    -  Kommentieren Sie **WaylandEnable=false** aus, indem Sie das **#** am Anfang der Zeile löschen.
    -  Starten Sie die VM neu.
1.  Wenn Sie einen NVIDIA 510- oder neueren Treiber installiert haben, deaktivieren Sie die GSP-Firmware.

    Wenn die GSP-Firmware aktiviert ist, deaktivieren Sie sie, indem Sie den NVIDIA-Modulparameter **NVreg_EnableGpuFirmware** auf 0 setzen.

    Legen Sie diesen Parameter fest, indem Sie den folgenden Eintrag zur Datei /etc/modprobe.d/nvidia.conf hinzufügen:

    -  options nvidia NVreg_EnableGpuFirmware=0

    -  Wenn die Datei /etc/modprobe.d/nvidia.conf nicht existiert, erstellen Sie sie.

     Beachten Sie bei diesem Schritt Folgendes:

    -  Verwenden Sie sudo, um die Befehle zum Erstellen und Aktualisieren der Konfigurationsdatei auszuführen.

    -  Um die VM neu zu starten, können Sie **sudo reboot** im Linux-Terminal verwenden oder die VM anhalten und starten.

Schritt 4d: MCS-Variablen konfigurieren.

Konfigurieren Sie MCS-Variablen, indem Sie die Datei /etc/xdl/mcs/mcs.conf bearbeiten. Die folgenden MCS-Variablen können Sie für Szenarien ohne Domänenbeitritt und mit Domänenbeitritt konfigurieren:

  • Für Szenarien ohne Domänenbeitritt

    Sie können die Standardwerte der Variablen verwenden oder die Variablen bei Bedarf anpassen (optional):

    DOTNET_RUNTIME_PATH=Pfad-zum-Installationsverzeichnis-des-dotnet-runtimes \ DESKTOP_ENVIRONMENT= **gnome | mate \** REGISTER_SERVICE=**J | N** ADD_FIREWALL_RULES=**J | N** VDI_MODE=**J | N** START_SERVICE=**J | N**

    MCS-Variablen für Szenarien ohne Domänenbeitritt

  • Für Szenarien mit Domänenbeitritt

    • Use_AD_Configuration_Files_Of_Current_VDA: Legt fest, ob die vorhandenen AD-bezogenen Konfigurationsdateien (/etc/krb5.conf, /etc/sssd.conf und /etc/samba/smb.conf) des aktuell ausgeführten VDA verwendet werden sollen. Wenn auf Y gesetzt, sind die Konfigurationsdateien auf von MCS erstellten Maschinen identisch mit denen des aktuell ausgeführten VDA. Sie müssen jedoch weiterhin die Variablen dns und AD_INTEGRATION konfigurieren. Der Standardwert ist N, was bedeutet, dass die Konfigurationsvorlagen auf dem Masterimage die Konfigurationsdateien auf von MCS erstellten Maschinen bestimmen. Um einen aktuell ausgeführten VDA als Vorlagen-VM zu verwenden, setzen Sie den Wert auf Y. Andernfalls setzen Sie ihn auf N.

    • dns: Legt die IP-Adresse für jeden DNS-Server fest. Sie können bis zu vier DNS-Server einrichten.

    • NTP_SERVER: Legt die IP-Adresse für Ihren NTP-Server fest. Sofern nicht anders angegeben, ist dies die IP-Adresse Ihres Domänencontrollers.

    • WORKGROUP: Legt den Arbeitsgruppennamen auf den NetBIOS-Namen (Groß-/Kleinschreibung beachten) fest, den Sie in AD konfiguriert haben. Andernfalls verwendet MCS den Teil des Domänennamens, der unmittelbar auf den Maschinen-Hostnamen folgt, als Arbeitsgruppennamen. Wenn das Maschinenkonto beispielsweise user1.lvda.citrix.com lautet, verwendet MCS lvda als Arbeitsgruppennamen, während citrix die richtige Wahl wäre. Stellen Sie sicher, dass Sie den Arbeitsgruppennamen korrekt festlegen.

    • AD_INTEGRATION: Legt Winbind, SSSD, PBIS oder Centrify fest. Eine Matrix der von MSC unterstützten Linux-Distributionen und Domänenbeitrittsmethoden finden Sie unter Unterstützte Distributionen.

    • CENTRIFY_DOWNLOAD_PATH: Legt den Pfad zum Herunterladen des Server Suite Free (ehemals Centrify Express)-Pakets fest. Der Wert wird nur wirksam, wenn Sie die Variable AD_INTEGRATION auf Centrify setzen.

    • CENTRIFY_SAMBA_DOWNLOAD_PATH: Legt den Pfad zum Herunterladen des Centrify Samba-Pakets fest. Der Wert wird nur wirksam, wenn Sie die Variable AD_INTEGRATION auf Centrify setzen.

    • PBIS_DOWNLOAD_PATH: Legt den Pfad zum Herunterladen des PBIS-Pakets fest. Der Wert wird nur wirksam, wenn Sie die Variable AD_INTEGRATION auf PBIS setzen.

    • UPDATE_MACHINE_PW: Aktiviert oder deaktiviert die Automatisierung von Kennwortaktualisierungen für Maschinenkonten. Weitere Informationen finden Sie unter Automatisieren von Kennwortaktualisierungen für Maschinenkonten.

    • Linux VDA-Konfigurationsvariablen:

      DOTNET_RUNTIME_PATH=Pfad-zum-Installationsverzeichnis-des-dotnet-runtimes \ DESKTOP_ENVIRONMENT= **gnome | mate \** SUPPORT_DDC_AS_CNAME=**J | N** VDA_PORT=Portnummer REGISTER_SERVICE=**J | N** ADD_FIREWALL_RULES=**J | N** HDX_3D_PRO=**J | N** VDI_MODE=**J | N** SITE_NAME=**DNS-Sitenamen | ‘<keine>’** LDAP_LIST=**‘Liste-der-LDAP-Server’ | ‘<keine>’** SEARCH_BASE=**Suchbasis-Satz | ‘<keine>’** FAS_LIST=**‘Liste-der-FAS-Server’ | ‘<keine>’** START_SERVICE=**J | N** TELEMETRY_SOCKET_PORT=Portnummer TELEMETRY_PORT=Portnummer

Schritt 4e: Masterimage erstellen

  1. (Nur für SSSD + RHEL 8.x/9.x oder Rocky Linux 8.x/9.x) Führen Sie den Befehl update-crypto-policies --set DEFAULT:AD-SUPPORT aus und starten Sie anschließend die Vorlagen-VM neu.

  2. Führen Sie /opt/Citrix/VDA/sbin/deploymcs.sh aus.

    Bei Szenarien ohne Domänenbeitritt ist der folgende Fehler normal und hindert Sie nicht daran, fortzufahren.

    MCS-Bereitstellung für Szenarien ohne Domänenbeitritt

  3. Installieren Sie Anwendungen auf der Vorlagen-VM und fahren Sie die Vorlagen-VM herunter. Erstellen und benennen Sie einen Snapshot Ihres Masterimages.

Schritt 5: Maschinenkatalog erstellen

  1. Melden Sie sich bei Citrix Cloud an. Wählen Sie im oberen linken Menü Meine Dienste > DaaS aus.
  2. Wählen Sie unter Verwalten > Vollständige Konfiguration im linken Bereich Maschinenkataloge aus.
  3. Wählen Sie in der Aktionsleiste Maschinenkatalog erstellen aus.
  4. Wählen Sie auf der Seite Maschinentyp die Option Multi-Session-OS oder Single-Session-OS und anschließend Weiter aus.

    Maschinentyp

  5. Wählen Sie auf der Seite Maschinenverwaltung die Optionen Energieverwaltete Maschinen und Citrix Machine Creation Services und anschließend Weiter aus. Wenn mehrere Ressourcen vorhanden sind, wählen Sie eine aus dem Menü aus.

    Maschinenverwaltung

  6. Wählen Sie auf der Seite Masterimage das zuvor erstellte Masterimage aus.

    Masterimage auswählen

    Masterimage ausgewählt

  7. Wählen Sie auf der Seite Maschinenidentitäten die Option Nicht domänengebunden aus, wenn das Masterimage keiner Domäne beigetreten ist, oder wählen Sie ein Active Directory-Konto aus, wenn Sie das Masterimage einer Domäne beigetreten haben.

    Für Szenarien ohne Domänenbeitritt:

    Typen von Maschinenidentitäten

    Für domänengebundene Szenarien:

    Option zum Auswählen eines Active Directory-Kontos

    • Wenn Sie Neue Active Directory-Konten erstellen auswählen, wählen Sie eine Domäne aus und geben Sie dann die Zeichenfolge ein, die das Benennungsschema für die in Active Directory erstellten bereitgestellten VM-Computerkonten darstellt. Das Kontobenennungsschema kann 1–64 Zeichen enthalten und darf keine Leerzeichen, Nicht-ASCII-Zeichen oder Sonderzeichen enthalten.
    • Wenn Sie Vorhandene Active Directory-Konten verwenden auswählen, wählen Sie Durchsuchen aus, um zu den vorhandenen Active Directory-Computerkonten für die ausgewählten Maschinen zu navigieren.
    • Wählen Sie auf der Seite Domänenanmeldeinformationen die Option Anmeldeinformationen eingeben, geben Sie Benutzername und Kennwort ein, wählen Sie Speichern und anschließend Weiter aus. Die eingegebenen Anmeldeinformationen müssen über die Berechtigung zum Ausführen von Active Directory-Kontovorgängen verfügen.
  8. Konfigurieren Sie zusätzliche Einstellungen auf den anderen Seiten. Weitere Informationen finden Sie unter Erstellen eines Google Cloud Platform-Katalogs.
  9. Bestätigen Sie auf der Seite Zusammenfassung die Informationen, geben Sie einen Namen für den Katalog an und wählen Sie anschließend Fertig stellen aus.

    Zusammenfassung der Maschinenkatalogeinrichtung

Das Erstellen des Maschinenkatalogs kann lange dauern. Nach Abschluss wird der Katalog aufgelistet. Sie können überprüfen, ob die Maschinen in den Zielknotengruppen in der Google Cloud Console erstellt wurden.

Schritt 6: Bereitstellungsgruppe erstellen

Eine Bereitstellungsgruppe ist eine Sammlung von Maschinen, die aus einem oder mehreren Maschinenkatalogen ausgewählt wurden. Sie gibt an, welche Benutzer diese Maschinen verwenden können und welche Anwendungen und Desktops diesen Benutzern zur Verfügung stehen.

Weitere Informationen finden Sie unter Erstellen von Bereitstellungsgruppen in der Citrix DaaS-Dokumentation.

  1. Melden Sie sich bei Citrix Cloud an. Wählen Sie im oberen linken Menü Meine Dienste > DaaS aus.
  2. Wählen Sie unter Verwalten > Vollständige Konfiguration im linken Bereich Bereitstellungsgruppen aus.
  3. Wählen Sie in der Aktionsleiste Bereitstellungsgruppe erstellen aus. Der Assistent zum Erstellen von Bereitstellungsgruppen wird geöffnet.

    Die angezeigten Assistentenseiten können je nach Ihren Auswahlen variieren.

  4. Wählen Sie auf der Seite Maschinen einen Maschinenkatalog und die Anzahl der Maschinen aus, die Sie aus diesem Katalog verwenden möchten.

    Bereitstellungsgruppe erstellen

  5. Konfigurieren Sie zusätzliche Einstellungen auf den anderen Seiten. Weitere Informationen finden Sie unter Bereitstellungsgruppen erstellen.

  6. Geben Sie auf der Seite Zusammenfassung einen Namen für die Bereitstellungsgruppe ein. Sie können auch (optional) eine Beschreibung eingeben, die in der Citrix Workspace™-App und in der Verwaltungsoberfläche Vollständige Konfiguration angezeigt wird. Beispiel:

    Geben Sie einen Namen für die Bereitstellungsgruppe ein:

    Bereitstellungsgruppe benennen

    Liste der Bereitstellungsgruppen in der Verwaltungsoberfläche Vollständige Konfiguration:

    Liste der Bereitstellungsgruppen in der Verwaltungsoberfläche „Vollständige Konfiguration“

    Bereitgestellte Maschine in der Citrix Workspace-App

    Bereitgestellte Maschine in der Citrix Workspace-App

Erstellen von Linux-VDAs auf Google Cloud Platform (GCP) mithilfe von Machine Creation Services™ (MCS)