Servizio di attivazione licenze

Il Servizio di attivazione licenze (LAS) è una nuova soluzione di licenze basata su cloud che fornisce un’alternativa alle tradizionali licenze legacy Citrix®. Il 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 sono più necessari codici di accesso o file di licenza da generare, scaricare o installare sul server licenze. È sufficiente aggiornare il server licenze e registrarlo con 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 disattivazione delle licenze ed evitare interruzioni. 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 51000 o successiva.
  • Connessione Internet affidabile e continua per il server licenze.

Considerazioni

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

Limitazioni

  • La migrazione al LAS imposta l’edizione del prodotto su Premium e il modello di licenza su Concurrent, 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 al LAS utilizzando solo Web Studio.

Passaggi chiave

  1. Installa o aggiorna il License Server alla versione 11.17.2 build 51000 o successiva e configura LAS secondo le istruzioni menzionate in Come configurare il License Server per il servizio di attivazione delle licenze.
  2. Installa Citrix Virtual Apps and Desktops versione 2411 o successiva. Installa i componenti principali, come Citrix Delivery Controller, Citrix Studio, Web 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, usa Citrix Site Manager per creare un sito. Per informazioni sulla creazione di un sito, consulta Creare un sito. Se il License Server è configurato per usare LAS, il Metainstaller visualizza i diritti. I diritti sono forniti insieme alle rispettive date di scadenza della licenza.

    Il Metainstaller visualizza i diritti LAS

    Nota:

    Se il License Server non viene aggiornato all’ultima versione del License Server, viene visualizzato un messaggio di errore.

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

Controllare i dettagli della licenza

Dopo aver creato il sito, controllare i dettagli della licenza usando Web Studio.

  1. In Web Studio, selezionare il nodo Licenze.
  2. Nella scheda Panoramica, verificare se il sito Citrix Virtual Apps and Desktops dispone della licenza appropriata o se la licenza è scaduta durante l’utilizzo delle funzionalità LAS.

    Controllare i dettagli della licenza

    Se il LAS non è raggiungibile, potrebbe apparire un messaggio di errore:

    LAS non raggiungibile

    Se il License Server non è disponibile, potrebbe apparire un messaggio di errore:

    License Server non disponibile

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

    Registrare il License Server per usare LAS

Migrare le licenze legacy a LAS

Se il License Server è già stato registrato con Citrix Cloud e si dispone del diritto necessario, è necessario seguire la sequenza specifica riportata di seguito per migrare il sito Citrix Virtual Apps and Desktops esistente dalle licenze legacy a LAS senza influire sulle sessioni utente.

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

    • Prima di fare clic su Migra a LAS, rimuovere manualmente tutte le assegnazioni di licenza impostate al di sotto del livello del sito (ovvero, rimuovere l’assegnazione di licenza a livello di gruppo di consegna).
  4. Confermare le allocazioni: Verificare che le allocazioni LAS siano accurate.
  5. Fare clic su Migra a LAS:

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

      Migrare dalla licenza legacy a LAS(/it-it/citrix-virtual-apps-desktops/2411/media/migrate-to-las.png)

    • 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.

Ripristinare la licenza legacy da LAS

Per ripristinare la licenza legacy da LAS, eseguire le seguenti operazioni:

  1. Eseguire il seguente comando PowerShell.

    Set-ConfigSite -UseLicenseActivationService $false
    <!--NeedCopy-->
    
  2. Configurare le licenze legacy in Web 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 versione 2411 e successive, aggiornare il License Server alla versione più recente (versione 11.2.17 build 51000 o successiva).

  • Vengono visualizzati 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/2411/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/2411/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 nella cartella \x64 nell’ISO montata):

  1. Eseguire quanto segue:

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

    Se sono stati copiati i file binari di Licensing su 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 License Server utilizzando i comandi \x64\Licensing\CitrixLicensing.exe /quiet o \x64\Licensing\CitrixLicensing.exe /quiet /l install.log e poi sono stati installati i componenti principali, seguire lo stesso ordine per la disinstallazione:

  1. Disinstallare License Server utilizzando la riga di comando:

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

Se si disinstallano License Server e i componenti utilizzando 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 di 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 stringa di disinstallazione nella chiave di registro.

Risoluzione dei problemi

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

  1. In Citrix Cloud, accedere 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.

    cvad-elenco dei Delivery Controller attivati

  3. Fare clic su Visualizza dettagli 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: Il Product_Edition_Model e la Burn In Date 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.
    • UUID controller: L’UUID del Delivery Controller.
    • LasUniqueEnvId: L’ID univoco dell’istanza fornito da LAS per l’attivazione.
    • HA-Broker: Vero o Falso, che 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 stabilire una connessione tra l’utente e la risorsa. La configurazione di licenza del prodotto e dell’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 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 dal 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 applicative. Questo controller non è più o non è riuscito a entrare in modalità di caching delle licenze a causa di un prolungato errore di comunicazione con il server licenze. Assicurarsi che il server licenze sia funzionante e, se necessario, utilizzare la Console di amministrazione delle licenze per aggiungere le licenze pertinenti al server licenze.
1156 Il servizio Citrix Broker comunica 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 controller Citrix XenDesktop. Vedere l’articolo CTX126990 della Knowledge Base di Citrix.
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à della licenza. Verificare la connettività del server licenze.
1167 Impossibile avviare la gestione delle 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 correttamente 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 la verifica dell’idoneità del server licenze. Il servizio Citrix Broker 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 le 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 le macchine di cui è stato eseguito il provisioning in un sistema cloud. La registrazione è stata rifiutata.
1180 L’edizione del prodotto configurata per questo sito XenDesktop non supporta le applicazioni su macchine a sessione singola (OS workstation). L’avvio della risorsa applicativa è stato rifiutato.
1181 L’edizione del prodotto configurata per questo sito XenDesktop non supporta le applicazioni su macchine a sessione multipla (OS server). L’avvio della risorsa applicativa è stato rifiutato.
1182 L’edizione del prodotto configurata per questo sito XenDesktop non supporta i 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 i 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 ore prima che questo controller smetta di fornire sessioni desktop e applicative.
1197 Il servizio Citrix Broker smetterà ora di fornire sessioni desktop e applicative. 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 applicative. 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. C’è 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 applicative. C’è 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 registrare o a prelevare 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) fino a quando 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 correttamente LAS.
1305 Il servizio Citrix Broker non riesce a contattare LAS. Assicurarsi che LAS funzioni correttamente e che i dettagli che identificano LAS siano corretti nella configurazione di XenDesktop.

Ulteriori informazioni

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

Per informazioni dettagliate sui comandi, vedere:

Servizio di attivazione licenze