Installare i VDA utilizzando SCCM

Nota:

Citrix non è responsabile per i problemi che sorgono a causa della distribuzione di un Agente di distribuzione virtuale (VDA) utilizzando strumenti di distribuzione software come Microsoft System Center Configuration Manager (SCCM) adattati per corrispondere agli ambienti di produzione del cliente. Per qualsiasi problema Citrix relativo all’installazione, aprire un caso di supporto tecnico con i log di installazione pertinenti utilizzando il portale di supporto Citrix.

Panoramica

Per distribuire correttamente un Agente di distribuzione virtuale (VDA) utilizzando Microsoft System Center Configuration Manager (SCCM) o strumenti di distribuzione software simili, Citrix® consiglia di utilizzare il programma di installazione VDA in una sequenza di passaggi.

Citrix non consiglia di utilizzare l’Utility di pulizia VDA come parte di un’installazione o di un aggiornamento VDA. Utilizzare l’Utility di pulizia VDA solo nel caso limitato in cui il programma di installazione VDA abbia precedentemente fallito.

Riavvi

Il numero di riavvii richiesti durante l’installazione del VDA dipende dall’ambiente. Ad esempio:

• Potrebbe essere necessario un riavvio per aggiornamenti in sospeso o riavvii da installazioni software precedenti.
• I file precedentemente bloccati da altri processi potrebbero richiedere aggiornamenti, forzando un riavvio aggiuntivo.
• Alcuni componenti opzionali nel programma di installazione VDA (come Citrix Profile Management e Citrix Files) potrebbero richiedere un riavvio.

Il Task Sequencer di SCCM gestisce tutti i riavvii richiesti.

Definire la sequenza di attività

Dopo aver identificato tutti i prerequisiti e i riavvii, utilizzare il Task Sequencer di SCCM per completare quanto segue:

• Il VDA può essere installato da una copia accessibile del supporto di installazione o da uno dei programmi di installazione VDA autonomi:

  • VDAWorkstationSetup_XXXX.exe
  • VDAServerSetup_XXXX.exe
  • VDAWorkstationCoreSetup_XXXX.exe

  Per maggiori informazioni sui programmi di installazione VDA, vedere Programmi di installazione.

• Quando si aggiorna un VDA, la macchina su cui è installato deve essere in modalità di manutenzione, senza sessioni.
• Quando un’installazione VDA viene eseguita per la prima volta su una macchina, il programma di installazione VDA utilizzato viene copiato su tale macchina.
  • Quando si utilizza un programma di installazione VDA diverso da VDAWorkstationCoreSetup_XXXX.exe, il programma di installazione VDA viene copiato in %ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exe.
  • Quando si utilizza VDAWorkstationCoreSetup_XXXX.exe, il programma di installazione VDA viene copiato in %ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exe. `
• La posizione della directory del programma di installazione VDA viene anche memorizzata nel registro di sistema “HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\MetaInstall” “MetaInstallerInstallLocation”.
• Aggiungere le opzioni della riga di comando /NOREBOOT, /NORESUME e /QUIET alle opzioni della riga di comando.
  • /QUIET: Non mostrare l’interfaccia utente durante l’installazione, in modo che SCCM abbia il controllo del processo di installazione.
  • /NOREBOOT: Impedire al programma di installazione VDA di riavviarsi automaticamente. SCCM attiva i riavvii quando necessario.
  • /NORESUME: Di solito, quando è necessario un riavvio durante l’installazione, il programma di installazione VDA imposta una chiave di registro runonce (\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce). Quando la macchina si riavvia, Windows utilizza la chiave per avviare il programma di installazione VDA. Questo è un problema per SCCM, perché SCCM non può monitorare l’installazione e acquisire il codice di uscita.

Esempio di sequenza di installazione tramite SCCM

L’esempio seguente mostra la sequenza di installazione.

1. Riavvia il computer: Prepara la macchina riavviandola.
2. Primo tentativo di installazione VDA: Avvia l’installazione VDA.
   1. Aggiungi le opzioni /quiet, /noreboot e /noresume alle opzioni della riga di comando.
   2. Esegui il programma di installazione VDA di tua scelta (immagine locale o uno dei programmi di installazione minimi).
   3. SCCM deve acquisire il codice di ritorno.
      • Se il codice di ritorno è 0 o 8, l’installazione è completa ed è necessario un riavvio.
      • Se un codice di ritorno è 3, riavvia la macchina e poi passa il controllo a Secondo tentativo di installazione VDA.
3. Secondo tentativo di installazione VDA: Continua l’installazione VDA.
   1. Dopo il Primo tentativo di installazione VDA, se il file %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml esiste, l’installazione non è completa e deve essere continuata dopo il completamento del riavvio.
   2. Secondo tentativo di installazione VDA si ripete finché il file %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml non esiste o non viene restituito un codice di ritorno diverso da 0 o 8. Tratta qualsiasi altro codice di ritorno come un errore e INSTALL VDA SECOND ATTEMPT dovrebbe segnalare un errore e fermarsi.
   3. Riprendi l’installazione VDA eseguendo il programma di installazione VDA appropriato (XenDesktopVdaSetup.exe per la maggior parte dei casi, o XenDesktopRemotePCSetup.exe se è stato utilizzato VDAWorkstationCoreSetup_XXXX.exe) dalla directory del file %programdata%\ Citrix\XenDesktopSetup\ senza parametri della riga di comando. (Il programma di installazione VDA utilizza i parametri salvati durante la prima esecuzione del programma di installazione).
   4. Controlla il codice di ritorno dal programma di installazione VDA.
      • 0 o 8: Successo, installazione completa, riavvio richiesto.
      • 3: L’installazione non è completa. Riavvia la macchina e ripeti INSTALL VDA SECOND ATTEMPT finché il file %programdata%\ Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml non esiste o finché non viene restituito 0 o 8. Tratta qualsiasi altro codice di ritorno come un errore e INSTALL VDA SECOND ATTEMPT dovrebbe segnalare un errore e terminare.

Per maggiori informazioni sui codici di ritorno, consulta Codici di ritorno dell’installazione Citrix.

Esempi di comandi di installazione VDA

Le opzioni di installazione disponibili variano a seconda del programma di installazione utilizzato. Consultare i seguenti articoli per i dettagli sulle opzioni della riga di comando.

• Installare i VDA
• Installare utilizzando la riga di comando

Comandi di installazione per l’accesso remoto al PC

• Il seguente comando utilizza il programma di installazione VDA core a sessione singola (VDAWorkstationCoreSetup.exe):

  VDAWorkstationCoreSetup.exe /quiet /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot

• Il seguente comando utilizza il programma di installazione VDA completo a sessione singola (VDAWorkstationSetup.exe):

  VDAWorkstationSetup.exe /quiet /remotepc /physicalmachine /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot

Comando di installazione per VDI dedicato

• Il seguente comando utilizza il programma di installazione VDA completo a sessione singola (VDAWorkstationSetup.exe):

  VDAWorkstationSetup.exe /quiet /components vda /controllers “control.domain.com” /enable_hdx_ports /enable_remote_assistance /noresume /noreboot