Citrix Virtual Apps and Desktops™ 7 2203 LTSR

Servizio di attivazione licenze

Il Servizio di attivazione licenze (LAS) è una nuova soluzione di licenze basata su cloud che offre un’alternativa alle tradizionali licenze legacy Citrix®. LAS introduce nuovi moduli per l’attivazione, garantendo un approccio moderno e senza interruzioni alla gestione delle licenze.

Il LAS semplifica l’esperienza di gestione delle licenze Citrix. Non ci sono più codici di accesso o file di licenza da generare, scaricare o installare sul server licenze. È sufficiente aggiornare il server licenze e registrarsi a Citrix Cloud. Una volta che i prodotti compatibili sono indirizzati al server licenze, possono essere attivati automaticamente.

Dopo l’attivazione, il server licenze comunica regolarmente con il Servizio di attivazione licenze per mantenere aggiornata la sua attivazione. Il LAS è costruito con tecnologia cloud, che migliora le prestazioni e garantisce l’assenza di tempi di inattività. Se, per qualsiasi motivo, il server licenze o il LAS non sono raggiungibili, il sistema entra in modalità di caching delle licenze, progettata per proteggere il sistema dalla perdita di licenza ed evitare un’interruzione. Per maggiori informazioni, vedere Modalità di caching delle licenze.

Per maggiori dettagli sul LAS, consultare la documentazione sulle licenze Servizio di attivazione licenze.

Prerequisiti

  • Installare o aggiornare il server licenze alla versione 11.17.2 build 53100 o successiva.
  • Connessione Internet affidabile e continua per il server licenze.
  • Le impostazioni di licenza a livello di gruppo di desktop devono essere disabilitate.

Nota:

Per verificare che le licenze a livello di DG siano disabilitate, utilizzare Get-brokerdesktopgroup e LicenseModel dovrebbe essere “None”.

Nota:

Installare .NET Framework 4.8 sul Delivery Controller prima di avviare l’aggiornamento a 2203 LTSR CU7. Ciò garantisce che gli strumenti di verifica della compatibilità delle licenze vengano eseguiti correttamente e previene avvisi di licenza errati.

Considerazioni

  • Tutti i Delivery Controller devono essere compatibili con LAS prima che Citrix Studio richieda l’attivazione. Un singolo sito controller può utilizzare licenze legacy o LAS.
  • È possibile registrare più Server licenze con lo stesso ID Citrix Cloud (CCID) o OrgID. Tuttavia, un sito può essere configurato per puntare a un solo server licenze.

Limitazioni

  • La migrazione a LAS imposta l’Edizione del prodotto su Premium e il Modello di licenza su Concorrente, ma questo potrebbe cambiare in futuro. Non modificare la configurazione della licenza utilizzando PowerShell, poiché ciò potrebbe influire sulla registrazione e sull’avvio della sessione.
  • È possibile migrare il sito Citrix Virtual Apps and Desktops™ dalla licenza legacy esistente a LAS utilizzando solo Citrix Studio.

Passaggi chiave

  1. Installare o aggiornare il Server licenze alla versione 11.17.2 build 53100 o successiva e configurare LAS secondo le istruzioni menzionate in Come configurare il Server licenze per il servizio di attivazione delle licenze.
  2. Installare Citrix Virtual Apps and Desktops versione 2203 LTSR CU7 o successiva. Installare i componenti principali, come Citrix Delivery Controller, Citrix Studio e Citrix Director.

    Nota:

    Tutti i Delivery Controller nel sito Citrix Virtual Apps and Desktops devono essere compatibili con LAS.

  3. Dopo aver installato i componenti richiesti, utilizzare Citrix Studio per creare un sito. Per informazioni sulla creazione di un sito, vedere Creare un sito. Se il Server licenze è configurato per utilizzare LAS, il Metainstaller visualizza i diritti. I diritti vengono forniti insieme alle rispettive date di scadenza della licenza.

    Il Metainstaller visualizza i diritti LAS

    Nota:

    Se il Server licenze non viene aggiornato alla versione 53100 o successiva, si verificheranno errori di licenza. Ignorare questi errori e procedere con l’aggiornamento del sito CVAD renderà il sito non funzionante.

  4. Verificare i dettagli della licenza.
  5. Migrare le licenze legacy a LAS.

Controlla i dettagli della licenza

Dopo aver creato il sito, controlla i dettagli della licenza utilizzando Citrix Studio.

  1. In Citrix Studio, seleziona il nodo Licensing.
  2. Nella pagina Licensing Overview, verifica se il sito Citrix Virtual Apps and Desktops dispone della licenza appropriata o se la licenza è scaduta durante l’utilizzo delle funzionalità LAS.

    Controlla i dettagli della licenza

    Se il LAS non è raggiungibile, potresti visualizzare un messaggio di errore:

    LAS non raggiungibile

    Se il tuo License Server utilizza ancora una vecchia licenza legacy e il sito Citrix Virtual Apps and Desktops è compatibile con LAS, Citrix Studio ti chiederà di registrare il tuo License Server con Citrix Cloud.

    Registra il License Server per usare LAS

Migra la licenza legacy a LAS

Se hai già registrato il tuo License Server con Citrix Cloud e disponi del diritto necessario, devi seguire la sequenza specifica riportata di seguito per migrare il tuo sito Citrix Virtual Apps and Desktops esistente dalla licenza legacy a LAS senza influire sulle sessioni utente.

  1. Aggiorna License Server: Aggiorna il License Server alla versione minima supportata.
  2. Aggiorna Delivery Controllers: Aggiorna tutti i Delivery Controller nel sito a una versione supportata da LAS.
  3. Rimuovi assegnazioni di licenza del gruppo di consegna:

    • Prima di fare clic su Migrate to LAS, rimuovi manualmente tutte le assegnazioni di licenza impostate al di sotto del livello del sito (ovvero, rimuovi l’assegnazione di licenza a livello di gruppo di consegna).
  4. Conferma allocazioni: Verifica che le allocazioni LAS siano accurate.
  5. Fai clic su Migra a LAS:

    • Una volta completati i passaggi precedenti, fai clic su Migra a LAS.

      Migra da licenza legacy a LAS

    • L’edizione della licenza del sito Citrix Virtual Apps and Desktops è impostata su Citrix Virtual Apps and Desktops Premium e il modello di licenza è configurato su Concorrente una volta eseguita la migrazione a LAS.

Ripristino da LAS a licenze legacy

Per ripristinare da LAS a licenze legacy, procedere come segue:

  1. Eseguire il seguente comando PowerShell.

    Set-ConfigSite -UseLicenseActivationService $false
    <!--NeedCopy-->
    
  2. Configurare le licenze legacy in Citrix Studio.

Nota:

Questi passaggi sono forniti solo per la risoluzione temporanea dei problemi. I file di licenza legacy si stanno avvicinando alla fine del ciclo di vita (EOL) e non funzioneranno oltre il 15 aprile 2026. Per garantire un servizio ininterrotto, si consiglia di eseguire la migrazione al servizio di attivazione delle licenze (LAS). Per i dettagli, consultare l’annuncio.

Considerazioni importanti per l’aggiornamento

Quando si esegue l’aggiornamento da qualsiasi versione precedente di Citrix Virtual Apps and Desktops alla 2203 LTSR CU7 e successive, aggiornare il License Server alla versione più recente (versione 11.2.17 build 53100 o successiva).

  • Si verificano i seguenti errori nella pagina Errori di licenza durante l’aggiornamento tramite l’interfaccia utente del metainstaller:

    • Se non si esegue l’aggiornamento alla versione più recente di License Server:

      Errore di versione(/it-it/citrix-virtual-apps-desktops/2203-ltsr/media/version-licensing-error.png)

    • In caso di incompatibilità, ad esempio un License Server obsoleto o l’indisponibilità delle licenze:

      License Server obsoleto o indisponibilità delle licenze(/it-it/citrix-virtual-apps-desktops/2203-ltsr/media/outdated-license-server-error.png)

  • Se si esegue l’aggiornamento tramite la riga di comando, eseguire i seguenti comandi per evitare errori di aggiornamento (supponendo di trovarsi all’interno della cartella \x64 nell’ISO montata):

  1. Eseguire quanto segue:

    \x64\Licensing\CitrixLicensing.exe /quiet
    <!--NeedCopy-->
    

    Se sono stati copiati i binari di licenza in una delle unità locali, eseguire il seguente comando:

    \x64\Licensing\CitrixLicensing.exe /quiet /l install.log
    <!--NeedCopy-->
    
  2. Eseguire quanto segue:

    \x64\XenDesktop Setup\XenDesktopServerSetup.exe  /components "CONTROLLER,DESKTOPSTUDIO,DESKTOPDIRECTOR" /CONFIGURE_FIREWALL
    <!--NeedCopy-->
    

Disinstallare i componenti principali

Durante l’aggiornamento, se è stato installato prima il Server licenze utilizzando i comandi \x64\Licensing\CitrixLicensing.exe /quiet o \x64\Licensing\CitrixLicensing.exe /quiet /l install.log e poi i componenti principali, seguire lo stesso ordine per la disinstallazione:

  1. Disinstallare il Server licenze tramite la riga di comando:

    CitrixLicensing.exe /quiet /uninstall /l uninstall.log
    <!--NeedCopy-->
    
  2. Disinstallare i componenti tramite la GUI o la riga di comando. Per informazioni, vedere Rimuovere i componenti.

Se si disinstallano il Server licenze e i componenti tramite la riga di comando XenDesktopServerSetup.exe o removeall, pulire la voce del registro e i file rimanenti.

Per pulire le voci del registro:

  1. Cercare la chiave del registro Citrix Licensing ed eliminare tale voce. Nella maggior parte dei casi, la voce si trova nella seguente posizione:

    "Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\
    <!--NeedCopy-->
    
  2. Eliminare la cartella indicata dalla Uninstall String nella chiave del registro.

Risoluzione dei problemi

Se lo stato del server licenze in Citrix Cloud non è verde, eseguire le seguenti operazioni per comprendere i dettagli granulari delle attivazioni che potrebbero presentare problemi:

  1. In Citrix Cloud, passare a Licensing > Licensed deployments > License Servers.
  2. Fare clic sul pulsante di espansione > accanto a Citrix Virtual Apps and Desktops per visualizzare l’elenco dei Delivery Controller attivati.

    Elenco dei Delivery Controller attivati di CVAD

  3. Fare clic su View details accanto all’attivazione per visualizzare i dettagli granulari.

    ID è l’identificatore univoco per identificare le attivazioni.

    Vengono forniti i seguenti dettagli:

    Visualizza dettagli per la risoluzione dei problemi

    • Prodotto e versione: Product_Edition_Model e la data di burn-in che il prodotto è configurato per utilizzare durante l’attivazione con LAS. BurnInDate è solitamente la data di rilascio del prodotto.
    • BrokerServiceGroupUid: L’UID per il gruppo di servizi Broker.
    • Controller UUID: L’UUID del Delivery Controller.
    • LasUniqueEnvId: L’ID univoco dell’istanza fornito da LAS per l’attivazione.
    • HA-Broker: Vero o Falso, indica se si tratta di un broker HA o di un broker principale.

Per mappare i dettagli dell’host attivato con l’host effettivo, eseguire i seguenti comandi sull’host.

  • Get-BrokerSite: Per confrontare il valore BrokerServiceGroupUid visualizzato sullo schermo con l’output BrokerServiceGroupId del comando.
  • Get-BrokerController: Per confrontare il valore Controller UUID visualizzato sullo schermo con l’output UUID del comando.

Log del Visualizzatore eventi relativi agli eventi di licenza

ID evento Descrizione
1112 Il servizio Citrix Broker non è riuscito a mediare una connessione tra utente e risorsa. La configurazione delle licenze di prodotto e edizione per il sito non consente questo tipo di risorsa. Verificare che la licenza corretta sia stata selezionata per questo sito.
1150 Il servizio Citrix Broker ha contattato correttamente il server licenze.
1151 Il servizio Citrix Broker non può contattare il server licenze. Assicurarsi che il server licenze funzioni correttamente e che i dettagli che identificano il server licenze siano corretti nella configurazione di XenDesktop.
1152 Questo sito XenDesktop non dispone delle licenze di prodotto richieste presenti sul server licenze. Utilizzare la Console di amministrazione delle licenze per aggiungere le licenze di prodotto pertinenti al server licenze.
1153 La licenza di questo sito XenDesktop è scaduta. Il servizio Citrix Broker richiederà una nuova licenza al server licenze.
1154 Questo controller è entrato in modalità di caching delle licenze perché non è riuscito a contattare il server licenze. Rimangono 2 ore prima che questo controller smetta di fornire sessioni desktop e applicazione.
1155 Il servizio Citrix Broker smetterà ora di fornire sessioni desktop e applicazione. Questo controller non è più in modalità di caching delle licenze o non è riuscito a entrarvi a causa di un prolungato errore di comunicazione con il server licenze. Assicurarsi che il server licenze funzioni e, se necessario, utilizzare la Console di amministrazione delle licenze per aggiungere le licenze pertinenti al server licenze.
1156 Il servizio Citrix Broker sta comunicando correttamente con il server licenze. Questo controller non è più in modalità di caching delle licenze.
1157 La versione del server licenze in esecuzione è precedente alla versione del servizio Citrix Broker ed è pertanto incompatibile. Aggiornare il server licenze o specificare una posizione del server licenze con la versione corretta nella configurazione di XenDesktop.
1158 Il servizio Citrix Broker ha rilevato che è stato superato il numero di licenze disponibili per questo sito sul server licenze per questa edizione. Il server licenze ha concesso una licenza di scoperto.
1159 Il servizio Citrix Broker ha negato una connessione desktop perché è stato superato il numero massimo di licenze installate per questo sito. Sono installate tre licenze per l’edizione, ma il numero massimo consentito di licenze per questa edizione è due. Rimuovere le licenze pertinenti dal server licenze per rispettare il limite di licenze.
1160 Il servizio Citrix Broker ha riscontrato un errore interno durante la gestione delle licenze. Assicurarsi che il server licenze funzioni correttamente e che i dettagli che identificano il server licenze siano corretti nella configurazione di XenDesktop. Il riavvio del servizio Citrix Broker potrebbe anche risolvere il problema. Se il problema persiste, reinstallare il Citrix XenDesktop Controller. Vedere l’articolo della Knowledge Base Citrix CTX126990.
1161 Errore durante l’inizializzazione delle licenze. Verificare la connettività del server licenze.
1162 Errore durante l’arresto delle licenze. Verificare la connettività del server licenze.
1163 Nessuna licenza di connessione disponibile. Per risolvere, liberare le licenze chiudendo le sessioni non necessarie o aggiungere altre licenze.
1164 Errore durante il checkout di una licenza di connessione. Verificare la connettività del server licenze.
1165 Errore durante il check-in di una licenza di connessione. Verificare la connettività del server licenze.
1166 Errore durante la verifica della disponibilità delle licenze. Verificare la connettività del server licenze.
1167 Impossibile avviare le licenze. Verificare la connettività del server licenze.
1168 Errore durante la lettura delle impostazioni di notifica utente delle licenze. Verificare la connettività del server licenze.
1169 Questo controller è entrato in modalità di caching delle licenze predefinita poiché non sono state trovate licenze idonee sul server licenze. Rimangono 2 ora/e prima che questo controller smetta di fornire sessioni desktop e applicative.
1170 Il servizio Citrix Broker ha rilevato con successo licenze idonee sul server licenze. Questo controller non è più in modalità di caching delle licenze predefinita.
1171 Nessun server licenze è stato specificato. Il servizio Citrix Broker non può fornire desktop e applicazioni agli utenti finché non viene specificato un server licenze valido. È possibile specificare un server licenze in Citrix Studio o con il cmdlet Set-ConfigSite dell’SDK Citrix PowerShell.
1172 Errore durante il controllo dell’idoneità del server licenze. Il servizio broker Citrix ha ricevuto una risposta inattesa durante la verifica se una macchina è idonea per l’uso come server licenze. Verificare che la macchina possa essere contattata dal controller e che qualsiasi firewall sulla macchina consenta le connessioni dal controller. Se un server licenze è installato sulla macchina, verificare che sia configurato e funzioni correttamente.
1173 Questo sito XenDesktop non dispone delle licenze di avvio richieste presenti sul server licenze. Utilizzare la Console di amministrazione delle licenze per aggiungere le licenze pertinenti al server licenze.
1174 L’edizione del prodotto configurata per questo sito XenDesktop non supporta le applicazioni; le risorse dell’applicazione non saranno disponibili.
1176 L’edizione del prodotto configurata non supporta le macchine multi-sessione. La registrazione è stata rifiutata.
1177 L’edizione del prodotto configurata non supporta macchine a sessione singola. La registrazione è stata rifiutata.
1178 L’edizione del prodotto configurata non supporta RemotePC. La registrazione è stata rifiutata.
1179 L’edizione del prodotto configurata non supporta macchine fornite in un sistema cloud. La registrazione è stata rifiutata.
1180 L’edizione del prodotto configurata per questo sito XenDesktop non supporta applicazioni su macchine a sessione singola (OS workstation). L’avvio della risorsa applicazione è stato rifiutato.
1181 L’edizione del prodotto configurata per questo sito XenDesktop non supporta applicazioni su macchine a sessione multipla (OS server). L’avvio della risorsa applicazione è stato rifiutato.
1182 L’edizione del prodotto configurata per questo sito XenDesktop non supporta desktop su macchine a sessione singola (OS workstation). L’avvio della risorsa desktop è stato rifiutato.
1183 L’edizione del prodotto configurata per questo sito XenDesktop non supporta desktop su macchine a sessione multipla (OS server). L’avvio della risorsa desktop è stato rifiutato.
1196 Questo controller è entrato in modalità burst di licenza a causa dell’esaurimento di tutte le licenze utilizzabili sul server licenze. Aggiungere altre licenze per risolvere il problema. Rimangono 2 ora/e prima che questo controller smetta di fornire sessioni desktop e applicazione.
1197 Il servizio Citrix Broker smetterà ora di fornire sessioni desktop e applicazione. Questo controller non è più o non è riuscito a entrare in modalità burst di licenza a causa di licenze insufficienti sul server licenze. Utilizzare la Console di amministrazione delle licenze per aggiungere le licenze pertinenti al server licenze.
1198 Il servizio Citrix Broker sta consumando correttamente le licenze dal server licenze. Ci sono licenze sufficienti sul server per soddisfare la domanda attuale. Questo controller non è più in modalità burst di licenza causata dall’esaurimento delle licenze.
1199 Il servizio Citrix Broker smetterà ora di fornire sessioni desktop e applicazione. Questo controller non è più o non è riuscito a entrare in modalità di caching delle licenze poiché nessuna licenza è installata sul server licenze. Utilizzare la Console di amministrazione delle licenze per aggiungere le licenze pertinenti al server licenze.
1205 La manutenzione del software è scaduta. L’ambiente Citrix non è attualmente supportato. Controllare il server licenze per le licenze scadute e rimuoverle. È disponibile una modalità di caching delle licenze di 30 giorni prima che gli utenti inizino a ricevere messaggi di avviso.
1206 L’hash del certificato di licenza non è valido. L’hash del certificato di licenza Citrix non è valido.
1300 Il servizio Citrix Broker smetterà ora di fornire sessioni desktop e applicazione. Si è verificato un problema con l’orologio di sistema del server licenze.
1301 I problemi con l’orologio di sistema del server licenze sono stati corretti. Il servizio Citrix Broker riprenderà ora il normale funzionamento.
1302 Questo controller non è riuscito nuovamente a effettuare il check-in o il check-out di una licenza di connessione. I guasti rilevati in precedenza esistono ancora. Per evitare un’eccessiva registrazione degli eventi, il servizio sta sopprimendo i messaggi correlati (ID evento 1163, 1164, 1165) finché il problema non sarà risolto. I tentativi di licenza continueranno.
1303 Questo controller non sta più sopprimendo i messaggi correlati (ID evento 1163, 1164, 1165).
1304 Il servizio Citrix Broker ha contattato con successo LAS.
1305 Il servizio Citrix Broker non può contattare LAS. Assicurarsi che il LAS funzioni correttamente e che i dettagli che identificano il LAS siano corretti nella configurazione di XenDesktop.

Ulteriori informazioni

Per informazioni su come verificare lo stato LAS di un sito o se un sito è in modalità di caching delle licenze, vedere:

Per informazioni dettagliate sui comandi, vedere:

Servizio di attivazione licenze