VDAs mithilfe von Skripten installieren

Hinweis:

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

Dieser Artikel bezieht sich auf 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.

Die Installationsmedien enthalten Beispielskripte, die Virtual Delivery Agents (VDAs) für Maschinen in Active Directory installieren, aktualisieren oder entfernen. Sie können die Skripte auch verwenden, um Masterimages zu verwalten, die von Machine Creation Services™ und Citrix Provisioning (ehemals Provisioning Services) verwendet 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. Erfasste Protokolle umfassen das Skriptprotokoll, das Installationsprogrammprotokoll 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.

Bevor Sie mit der Installation beginnen, lesen und erledigen Sie die Aufgaben unter Vorbereitung der Installation.

VDAs mithilfe des Skripts installieren oder aktualisieren

1. Rufen Sie das Beispielskript InstallVDA.bat von \Support\AdDeploy\ auf den Installationsmedien 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. Der vollständige Wert ist auf den Installationsmedien in der Datei ProductVersion.txt zu finden. Eine vollständige Übereinstimmung ist jedoch nicht erforderlich.
   • Geben Sie die Netzwerkfreigabe an, von der aus 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.
   • Optional können Sie einen Netzwerkspeicherort für die Speicherung zentralisierter Protokolle angeben. Zum 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 /NORESUME.
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, eine Sicherungskopie des Originalskripts zu erstellen, bevor Sie es anpassen.
2. Bearbeiten Sie das Skript.
   • Geben Sie die zu entfernende VDA-Version an: SET CHECK\_VDA\_VERSION. 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.
   • Optional können Sie einen Netzwerkspeicherort für die Speicherung zentralisierter Protokolle angeben.
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.

Fehlerbehebung

• 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.
  • Das Zielbetriebssystem ordnungsgemäß erkennen.
  • 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 ist der Eintrag Installierte VDA-Version im Bereich Details möglicherweise nicht die auf den Maschinen installierte Version. Die Anzeige der Programme und Funktionen der Maschine zeigt die tatsächliche VDA-Version an.

• Nach der Installation eines VDA kann er Benutzern keine Anwendungen 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.