Citrix Virtual Apps and Desktops 7 2203 LTSR

VDAs mithilfe von Skripten installieren

Hinweis:

Citrix ist nicht verantwortlich für Probleme, die durch Skripte verursacht werden, die an die Produktionsumgebung des Kunden angepasst wurden. Bei Citrix-Problemen im Zusammenhang mit der Installation öffnen Sie einen technischen Supportfall mit den entsprechenden Installationsprotokollen über das Citrix Support-Portal.

Dieser Artikel gilt für die Installation von VDAs auf Maschinen mit Windows-Betriebssystemen. Informationen zu VDAs für Linux-Betriebssysteme finden Sie in der Dokumentation zum Linux Virtual Delivery Agent.

Das Installationsmedium enthält Beispielskripte, die Virtual Delivery Agents (VDAs) für Maschinen in Active Directory installieren, aktualisieren oder entfernen. Sie können die Skripte auch zur Wartung von Masterimages verwenden, die von Machine Creation Services™ und Citrix Provisioning (ehemals Provisioning Services) genutzt werden.

Erforderlicher Zugriff:

  • Die Skripte benötigen Lesezugriff für „Jeder“ auf die Netzwerkfreigabe, auf der sich der VDA-Installationsbefehl befindet. Der Installationsbefehl ist XenDesktopVdaSetup.exe in der vollständigen Produkt-ISO oder VDAWorkstationSetup.exe oder VDAServerSetup.exe in einem eigenständigen Installationsprogramm.
  • Protokolldetails werden auf jeder lokalen Maschine gespeichert. Um Ergebnisse zentral zur Überprüfung und Analyse zu protokollieren, benötigen die Skripte Lese- und Schreibzugriff für „Jeder“ auf die entsprechende Netzwerkfreigabe.

Um die Ergebnisse der Skriptausführung zu überprüfen, untersuchen Sie die zentrale Protokollfreigabe. Die erfassten Protokolle umfassen das Skriptprotokoll, das Installationsprotokoll und die MSI-Installationsprotokolle. Jeder Installations- oder Entfernungsversuch wird in einem Ordner mit Zeitstempel aufgezeichnet. Der Ordnername gibt das Ergebnis des Vorgangs mit dem Präfix PASS oder FAIL an. Sie können Standard-Verzeichnissuchwerkzeuge verwenden, um eine fehlgeschlagene Installation oder Entfernung in der zentralen Protokollfreigabe zu finden. Diese Tools bieten eine Alternative zur lokalen Suche auf den Zielmaschinen.

Lesen und erledigen Sie vor Beginn einer Installation die Aufgaben unter Vorbereiten der Installation.

VDAs mithilfe des Skripts installieren oder aktualisieren

  1. Rufen Sie das Beispielskript InstallVDA.bat von \Support\AdDeploy\ auf dem Installationsmedium ab. Citrix empfiehlt, eine Sicherungskopie des Originalskripts zu erstellen, bevor Sie es anpassen.
  2. Skript bearbeiten:
    • Geben Sie die zu installierende VDA-Version an: SET DESIREDVERSION. Beispielsweise kann Version 7 als 7.0 angegeben werden. Der vollständige Wert ist auf dem Installationsmedium in der Datei ProductVersion.txt zu finden. Eine vollständige Übereinstimmung ist jedoch nicht erforderlich.
    • Geben Sie die Netzwerkfreigabe an, von der das Installationsprogramm aufgerufen wird. Zeigen Sie auf das Stammverzeichnis des Layouts (den höchsten Punkt des Baums). Die entsprechende Version des Installationsprogramms (32-Bit oder 64-Bit) wird automatisch aufgerufen, wenn das Skript ausgeführt wird. Beispiel: SET DEPLOYSHARE=\\fileserver1\share1.
    • Geben Sie optional einen Netzwerkspeicherort für die Speicherung zentralisierter Protokolle an. Beispiel: SET LOGSHARE=\\fileserver1\log1).
    • Geben Sie die VDA-Konfigurationsoptionen an, wie unter Installation über die Befehlszeile beschrieben. Die Optionen /quiet und /noreboot sind standardmäßig im Skript enthalten und erforderlich: SET COMMANDLINEOPTIONS=/QUIET /NOREBOOT.
  3. Weisen Sie das Skript mithilfe von Gruppenrichtlinien-Startskripten der OU zu, die Ihre Maschinen enthält. Diese OU sollte nur Maschinen enthalten, auf denen Sie den VDA installieren möchten. Wenn die Maschinen in dieser OU neu gestartet werden, wird das Skript auf allen ausgeführt. Auf jeder Maschine mit einem unterstützten Betriebssystem wird ein VDA installiert.

VDAs mit dem Skript entfernen

  1. Rufen Sie das Beispielskript UninstallVDA.bat aus \Support\AdDeploy\ auf dem Installationsmedium ab. Citrix empfiehlt, vor der Anpassung eine Sicherungskopie des Originalskripts zu erstellen.
  2. Bearbeiten Sie das Skript.
    • Geben Sie die zu entfernende VDA-Version an: SET CHECK\_VDA\_VERSION. Beispiel: Version 7 kann als 7.0 angegeben werden. Der vollständige Wert ist auf dem Installationsmedium in der Datei ProductVersion.txt zu finden (z. B. 7.0.0.3018). Eine vollständige Übereinstimmung ist jedoch nicht erforderlich.
    • Geben Sie optional einen Netzwerkspeicherort für die Speicherung zentralisierter Protokolle an.
  3. Weisen Sie das Skript mithilfe von Gruppenrichtlinien-Startskripten der OU zu, die Ihre Maschinen enthält. Diese OU sollte nur Maschinen enthalten, von denen Sie den VDA entfernen möchten. Wenn die Maschinen in der OU neu gestartet werden, wird das Skript auf allen ausgeführt. Der VDA wird von jeder Maschine entfernt.

Problembehandlung

  • Das Skript generiert interne Protokolldateien, die den Fortschritt der Skriptausführung beschreiben. Das Skript kopiert ein Kickoff_VDA_Startup_Script-Protokoll innerhalb von Sekunden nach Beginn der Bereitstellung in die zentrale Protokollfreigabe. Sie können überprüfen, ob der Gesamtprozess funktioniert. Wenn dieses Protokoll nicht wie erwartet in die zentrale Protokollfreigabe kopiert wird, beheben Sie das Problem weiter, indem Sie die lokale Maschine überprüfen. Das Skript legt zwei Debugging-Protokolldateien im Ordner %temp% auf jeder Maschine ab:

    • Kickoff_VDA_Startup_Script_<DateTimeStamp>.log
    • VDA_Install_ProcessLog_<DateTimeStamp>.log

    Überprüfen Sie diese Protokolle, um sicherzustellen, dass das Skript:

    • Wie erwartet ausgeführt wird.
    • Korrekte Erkennung des Zielbetriebssystems.
    • Korrekt konfiguriert, um auf den ROOT der DEPLOYSHARE-Freigabe zu verweisen (enthält die Datei mit dem Namen AutoSelect.exe).
    • In der Lage, sich sowohl bei der DEPLOYSHARE- als auch bei der LOG-Freigabe zu authentifizieren.
  • Informationen dazu, wie Citrix das Ergebnis von Komponenteninstallationen meldet, finden Sie unter Citrix-Installationsrückgabecodes.

  • In der Studio-Anzeige für eine Bereitstellungsgruppe entspricht der Eintrag Installierte VDA-Version im Bereich Details möglicherweise nicht der auf den Maschinen installierten Version. Die Anzeige für Programme und Funktionen der Maschine zeigt die tatsächliche VDA-Version an.

  • Nach der Installation eines VDA kann er Benutzern keine Apps oder Desktops bereitstellen, bevor er sich bei einem Delivery Controller registriert.

    Informationen zu VDA-Registrierungsmethoden und zur Behebung von Registrierungsproblemen finden Sie unter VDA-Registrierung.

VDAs mithilfe von Skripten installieren