VDAs mit SCCM installieren
Hinweis:
Citrix ist nicht verantwortlich für Probleme, die durch die Bereitstellung eines Virtual Delivery Agent (VDA) mittels Softwareverteilungstools wie Microsoft System Center Configuration Manager (SCCM) entstehen, die an die Produktionsumgebungen des Kunden angepasst wurden. Bei installationsbezogenen Citrix-Problemen öffnen Sie einen technischen Supportfall mit den relevanten Installationsprotokollen über das Citrix Support-Portal.
Übersicht
Um einen Virtual Delivery Agent (VDA) erfolgreich mit Microsoft System Center Configuration Manager (SCCM) oder ähnlichen Softwareverteilungstools bereitzustellen, empfiehlt Citrix®, den VDA-Installer in einer Abfolge von Schritten zu verwenden.
Citrix empfiehlt nicht, das VDA Cleanup Utility als Teil einer VDA-Installation oder eines Upgrades zu verwenden. Verwenden Sie das VDA Cleanup Utility nur in dem begrenzten Fall, dass die VDA-Installation zuvor fehlgeschlagen ist.
Neustarts
Die erforderliche Anzahl von Neustarts während der Installation des VDA hängt von der Umgebung ab. Zum Beispiel:
- Ein Neustart kann für ausstehende Updates oder Neustarts von früheren Softwareinstallationen erforderlich sein.
- Dateien, die zuvor von anderen Prozessen gesperrt wurden, benötigen möglicherweise Updates, was einen zusätzlichen Neustart erzwingt.
- Einige optionale Komponenten im VDA-Installer (wie Citrix Profile Management und Citrix Files) erfordern möglicherweise einen Neustart.
Der SCCM Task Sequencer verwaltet alle erforderlichen Neustarts.
Tasksequenz definieren
Nachdem alle Voraussetzungen und Neustarts identifiziert wurden, verwenden Sie den SCCM Task Sequencer, um Folgendes abzuschließen:
-
Der VDA kann von einer zugänglichen Kopie des Installationsmediums oder von einem der eigenständigen VDA-Installer installiert werden:
VDAWorkstationSetup_XXXX.exeVDAServerSetup_XXXX.exeVDAWorkstationCoreSetup_XXXX.exe
Weitere Informationen zu VDA-Installationsprogrammen finden Sie unter Installationsprogramme.
- Beim Upgrade eines VDA muss der Computer, auf dem er installiert ist, sich im Wartungsmodus befinden, ohne aktive Sitzungen.
- Wenn eine VDA-Installation zum ersten Mal auf einem Computer ausgeführt wird, wird das verwendete VDA-Installationsprogramm auf diesen Computer kopiert.
- Wenn Sie ein anderes VDA-Installationsprogramm als
VDAWorkstationCoreSetup_XXXX.exeverwenden, wird das VDA-Installationsprogramm nach%ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exekopiert. - Bei Verwendung von
VDAWorkstationCoreSetup_XXXX.exewird das VDA-Installationsprogramm nach%ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exekopiert. `
- Wenn Sie ein anderes VDA-Installationsprogramm als
- Der Verzeichnisspeicherort des VDA-Installationsprogramms wird auch in der Registrierung
“HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\MetaInstall” “MetaInstallerInstallLocation”gespeichert. - Fügen Sie die Befehlszeilenoptionen
/NOREBOOT,/NORESUMEund/QUIETzu Ihren Befehlszeilenoptionen hinzu.-
/QUIET: Zeigt die Benutzeroberfläche während der Installation nicht an, damit SCCM die Kontrolle über den Installationsprozess hat. -
/NOREBOOT: Verhindert, dass das VDA-Installationsprogramm automatisch neu startet. SCCM löst bei Bedarf Neustarts aus. -
/NORESUME: Normalerweise, wenn während der Installation ein Neustart erforderlich ist, setzt das VDA-Installationsprogramm einen Registrierungsschlüsselrunonce(\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce). Wenn der Computer neu startet, verwendet Windows den Schlüssel, um das VDA-Installationsprogramm zu starten. Dies ist ein Problem für SCCM, da SCCM die Installation nicht überwachen und den Exitcode nicht erfassen kann.
-
Beispiel für eine Installationssequenz mit SCCM
Das folgende Beispiel zeigt die Installationssequenz.
- SCCM TASK1: Bereiten Sie die Maschine durch einen Neustart vor.
-
SCCM TASK2: Starten Sie die VDA-Installation.
- Fügen Sie die Optionen
/quiet,/norebootund/noresumezu Ihren Befehlszeilenoptionen hinzu. - Führen Sie das VDA-Installationsprogramm Ihrer Wahl aus (lokales Image oder eines der Minimal-Installationsprogramme).
- SCCM muss den Rückgabecode erfassen.
- Wenn der Rückgabecode 0 oder 8 ist, ist die Installation abgeschlossen und ein Neustart ist erforderlich.
- Wenn ein Rückgabecode 3 ist, starten Sie die Maschine neu und übergeben Sie dann die Kontrolle an SCCM TASK3.
- Fügen Sie die Optionen
-
SCCM TASK3: VDA-Installation fortsetzen.
- Wenn SCCM TASK2 keine 0 oder 8 zurückgibt, muss die Installation nach Abschluss des Neustarts fortgesetzt werden.
- SCCM TASK3 wird wiederholt, bis das VDA-Installationsprogramm eine 0 oder 8 (was eine erfolgreiche Installation anzeigt) oder eine 3 (was anzeigt, dass SCCM TASK3 wiederholt werden muss) zurückgibt. Behandeln Sie jeden anderen Rückgabecode als Fehler, und SCCM TASK3 sollte einen Fehler melden und anhalten.
- Setzen Sie die VDA-Installation fort, indem Sie das entsprechende VDA-Installationsprogramm (
XenDesktopVdaSetup.exein den meisten Fällen oderXenDesktopRemotePCSetup.exe, wennVDAWorkstationCoreSetup_XXXX.exeverwendet wurde) von dem Speicherort ausführen, an den es kopiert wurde (wie unter Definieren der Tasksequenz beschrieben), ohne Befehlszeilenparameter. (Das VDA-Installationsprogramm verwendet die Parameter, die es beim ersten Ausführen des Installationsprogramms gespeichert hat.) - Achten Sie auf den Rückgabecode des VDA-Installationsprogramms.
- 0 oder 8: Erfolg, Installation abgeschlossen, Neustart erforderlich.
- 3: Installation ist nicht abgeschlossen. Starten Sie die Maschine neu und wiederholen Sie SCCM TASK3, bis eine 0 oder 8 zurückgegeben wird. Behandeln Sie jeden anderen Rückgabecode als Fehler, und SCCM TASK3 sollte einen Fehler melden und beenden.
Weitere Informationen zu Rückgabecodes finden Sie unter Citrix Installations-Rückgabecodes.
Beispiele für VDA-Installationsbefehle
Die verfügbaren Installationsoptionen variieren je nach verwendetem Installationsprogramm. Details zu den Befehlszeilenoptionen finden Sie in den folgenden Artikeln.
Installationsbefehle für Remote-PC-Zugriff
-
Der folgende Befehl verwendet das Single-Session-Core-VDA-Installationsprogramm (
VDAWorkstationCoreSetup.exe):VDAWorkstationCoreSetup.exe /quiet /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot -
Der folgende Befehl verwendet das Single-Session-Full-VDA-Installationsprogramm (
VDAWorkstationSetup.exe):VDAWorkstationSetup.exe /quiet /remotepc /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot
Installationsbefehl für dedizierte VDI
-
Der folgende Befehl verwendet das Single-Session-Full-VDA-Installationsprogramm (
VDAWorkstationSetup.exe):VDAWorkstationSetup.exe /quiet /components vda /controllers “control.domain.com” /enable_hdx_ports /enable_remote_assistance /noresume /noreboot