Serviço de Ativação de Licenças
O Serviço de Ativação de Licenças (LAS) é uma nova solução de licenciamento baseada em nuvem que oferece uma alternativa ao licenciamento legado tradicional da Citrix®. O LAS introduz novos módulos para ativação, garantindo uma abordagem moderna e contínua para o gerenciamento de licenças.
O LAS simplifica a experiência de Licenciamento Citrix. Não há mais códigos de acesso de licença ou arquivos para gerar, baixar ou instalar no Servidor de Licenças. Você só precisa atualizar seu Servidor de Licenças e se registrar no Citrix Cloud. Uma vez que os produtos compatíveis são apontados para o Servidor de Licenças, eles podem ser ativados automaticamente.
Após a ativação, o Servidor de Licenças se comunica regularmente com o Serviço de Ativação de Licenças para manter sua ativação atualizada. O LAS é construído com tecnologia de nuvem, o que melhora o desempenho e garante que não haja tempo de inatividade. Se, por qualquer motivo, o Servidor de Licenças ou o LAS estiverem inacessíveis, o sistema entra no modo de cache de licenças, que é projetado para proteger o sistema de ficar sem licença e evitar uma interrupção. Para obter mais informações, consulte Modo de cache de licenças.
Para obter mais detalhes sobre o LAS, consulte a documentação de Licenciamento Serviço de Ativação de Licenças.
Pré-requisitos
- Instale ou atualize o Servidor de Licenças para a versão 11.17.2 build 53100 ou posterior.
- Conexão de internet confiável e contínua para o Servidor de Licenças.
- As configurações de licença no nível do Grupo de Desktops devem ser desabilitadas.
Nota:
Para garantir que o licenciamento no nível DG esteja desabilitado, use Get-brokerdesktopgroup e LicenseModel deve ser “None”.
Considerações
- Todos os Delivery Controllers devem ser compatíveis com o LAS antes que o Citrix Studio ou o Citrix Web Studio solicitem a ativação. Um site de controlador único pode usar licenças legadas ou LAS.
- Você pode ter vários Servidores de Licenças registrados com o mesmo Citrix Cloud ID (CCID) ou OrgID. No entanto, um site pode ser configurado para apontar para apenas um Servidor de Licenças.
Limitações
- A migração para o LAS define a Edição do Produto como Premium e o Modelo de Licença como Concorrente, mas isso pode mudar no futuro. Não modifique a configuração da licença usando o PowerShell, pois isso pode afetar o registro e o início da sessão.
- Você pode migrar seu site Citrix Virtual Apps and Desktops™ da licença legada existente para o LAS usando apenas o Web Studio.
Etapas principais
- Instale ou atualize o License Server para a versão 11.17.2 build 53100 ou posterior e configure o LAS conforme as instruções mencionadas em Como configurar o License Server para o Serviço de Ativação de Licenças.
-
Instale o Citrix Virtual Apps and Desktops versão 2402 LTSR CU3 ou posterior. Instale os componentes principais, como Citrix Delivery Controller, Citrix Studio, Web Studio e Citrix Director.
Nota:
Todos os Delivery Controllers no site Citrix Virtual Apps and Desktops devem ser compatíveis com o LAS.
-
Após instalar os componentes necessários, use o Citrix Site Manager para criar um site. Para obter informações sobre como criar um site, consulte Criar um site. Se o License Server estiver configurado para usar o LAS, o Metainstaller exibirá os direitos. Os direitos são fornecidos juntamente com suas respectivas datas de expiração da licença.
Nota:
Se o License Server não for atualizado para a versão 53100 ou posterior, você encontrará erros de licenciamento. Ignorar esses erros e prosseguir com a atualização do site CVAD resultará na inoperabilidade do site.
- Verificar detalhes de licenciamento.
- Migrar licenciamento legado para LAS.
Verificar detalhes de licenciamento
Após criar o site, verifique os detalhes de licenciamento usando o Web Studio.
- No Web Studio, selecione o nó Licenciamento.
-
Na guia Visão geral, verifique se o site do Citrix Virtual Apps and Desktops possui a licença apropriada ou se a licença expirou ao usar os recursos do LAS.
Se o LAS não estiver acessível, você poderá ver uma mensagem de erro:
Se o Servidor de Licenças não estiver disponível, você poderá ver uma mensagem de erro:
Se o seu Servidor de Licenças ainda estiver usando uma licença legada antiga e o site do Citrix Virtual Apps and Desktops for compatível com LAS, o Web Studio solicitará que você registre seu Servidor de Licenças no Citrix Cloud.
Migrar licenciamento legado para LAS
Se você já registrou seu Servidor de Licenças no Citrix Cloud e possui o direito necessário, deve seguir a sequência específica abaixo para migrar seu site existente do Citrix Virtual Apps and Desktops do licenciamento legado para o LAS sem impactar as sessões do usuário.
- Atualizar Servidor de Licenças: Atualize o Servidor de Licenças para a versão mínima suportada.
- Atualizar Delivery Controllers: Atualize todos os Delivery Controllers no site para uma versão compatível com LAS.
-
Remover Atribuições de Licença do Grupo de Entrega:
- Antes de clicar em Migrar para LAS, remova manualmente quaisquer atribuições de licença definidas abaixo do nível do Site (ou seja, remova a atribuição de licença no nível do grupo de entrega).
- Confirmar Alocações: Verifique se as alocações do LAS estão precisas.
-
Clique em Migrar para LAS:
-
Depois que as etapas anteriores forem concluídas, clique em Migrar para LAS.
-
A Edição da Licença do site Citrix Virtual Apps and Desktops é definida como Citrix Virtual Apps and Desktops Premium e o Modelo de Licença é configurado como Concorrente depois que você migra para o LAS.
-
Reverter do LAS para o licenciamento herdado
Faça o seguinte para reverter do LAS para o licenciamento herdado:
-
Execute o seguinte comando PowerShell.
Set-ConfigSite -UseLicenseActivationService $false <!--NeedCopy--> -
Configure as licenças herdadas no Web Studio.
Nota:
Essas etapas são fornecidas apenas para solução de problemas temporária. Os arquivos de licença herdados estão se aproximando do Fim da Vida Útil (EOL) e não funcionarão após 15 de abril de 2026. Para garantir um serviço ininterrupto, recomendamos migrar para o Serviço de Ativação de Licenças (LAS). Para obter detalhes, consulte o anúncio.
Considerações importantes para a atualização
Ao atualizar de qualquer versão anterior do Citrix Virtual Apps and Desktops para 2411 e posterior, atualize o License Server para a versão mais recente (versão 11.2.17 build 53100 ou posterior).
-
Você recebe os seguintes erros na página Erros de Licenciamento ao atualizar usando a interface do usuário do metainstaller:
-
Se você não atualizar para a versão mais recente do License Server:
-
Se houver incompatibilidades, como um License Server desatualizado ou indisponibilidade de licenças:
-
-
Se você estiver atualizando usando a linha de comando, execute os seguintes comandos para evitar falha na atualização (assumindo que você esteja dentro da pasta \x64 no ISO montado):
-
Execute o seguinte:
\x64\Licensing\CitrixLicensing.exe /quiet <!--NeedCopy-->Se você copiou os binários de Licenciamento para qualquer uma das unidades locais, execute o seguinte comando:
\x64\Licensing\CitrixLicensing.exe /quiet /l install.log <!--NeedCopy--> -
Execute o seguinte:
\x64\XenDesktop Setup\XenDesktopServerSetup.exe /components "CONTROLLER,DESKTOPSTUDIO,DESKTOPDIRECTOR" /CONFIGURE_FIREWALL <!--NeedCopy-->
Desinstalar componentes principais
Durante a atualização, se você instalou o License Server primeiro usando os comandos \x64\Licensing\CitrixLicensing.exe /quiet ou \x64\Licensing\CitrixLicensing.exe /quiet /l install.log e depois instalou os componentes principais, siga a mesma ordem para desinstalar:
-
Desinstale o License Server usando a linha de comando:
CitrixLicensing.exe /quiet /uninstall /l uninstall.log <!--NeedCopy--> -
Desinstale os componentes usando a GUI ou a linha de comando. Para obter informações, consulte Remover componentes.
Se você desinstalar o License Server e os componentes usando a linha de comando XenDesktopServerSetup.exe ou removeall, limpe a entrada do registro e os arquivos restantes.
Para limpar as entradas do registro:
-
Procure a chave de registro
Citrix Licensinge exclua essa entrada. Na maioria das vezes, você pode encontrar a entrada no seguinte local:"Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\ <!--NeedCopy--> -
Exclua a pasta apontada pela Uninstall String na chave do registro.
Solução de problemas
Se o status do servidor de licenças estiver mostrando algo diferente de verde no Citrix Cloud, faça o seguinte para entender os detalhes granulares das ativações que podem ter problemas:
- No Citrix Cloud, navegue até Licenciamento > Implantações licenciadas > Servidores de licença.
-
Clique no botão de expansão > em Citrix Virtual Apps and Desktops para ver a lista de Delivery Controllers que foram ativados.
-
Clique em Ver detalhes na ativação para ver os detalhes granulares.
ID é o identificador exclusivo para identificar as ativações.
Os seguintes detalhes são fornecidos:
- Produto e Versão: O Product_Edition_Model e a Data de Queima (Burn In Date) que o produto está configurado para usar ao ativar com o LAS. BurnInDate é geralmente a data de lançamento do produto.
- BrokerServiceGroupUid: O UID para o Grupo de Serviço do Broker.
- Controller UUID: O UUID do Delivery Controller.
- LasUniqueEnvId: O ID exclusivo da instância fornecido pelo LAS para ativação.
- HA-Broker: Verdadeiro ou Falso, indicando se é um broker HA ou o broker principal.
Para mapear os detalhes do host ativado com o host real, execute os seguintes comandos no host.
-
Get-BrokerSite: Para comparar o valor BrokerServiceGroupUid exibido na tela com a saídaBrokerServiceGroupIddo comando. -
Get-BrokerController: Para comparar o valor Controller UUID exibido na tela com a saída UUID do comando.
Logs do visualizador de eventos relacionados a eventos de licenciamento
| ID do Evento | Descrição |
|---|---|
| 1112 | O Serviço de Broker da Citrix falhou ao intermediar uma conexão para o usuário com o recurso. A configuração de licenciamento de produto e edição para o site não permite este tipo de recurso. Verifique se a licença correta foi selecionada para este site. |
| 1150 | O Serviço de Broker da Citrix contatou o servidor de licenças com sucesso. |
| 1151 | O Serviço de Broker da Citrix não consegue contatar o servidor de licenças. Certifique-se de que o servidor de licenças está funcionando corretamente e que os detalhes de identificação do servidor de licenças estão corretos na configuração do XenDesktop. |
| 1152 | Este site do XenDesktop não possui as licenças de produto necessárias presentes no servidor de licenças. Use o Console de Administração de Licenças para adicionar as licenças de produto relevantes ao servidor de licenças. |
| 1153 | A licença deste site do XenDesktop expirou. O serviço de Broker da Citrix solicitará uma nova licença ao servidor de licenças. |
| 1154 | Este controlador entrou no modo de cache de licenças porque não conseguiu contatar o servidor de licenças. Você tem 2 hora(s) restante(s) antes que este controlador pare de fornecer sessões de desktop e aplicativo. |
| 1155 | O Serviço de Broker da Citrix agora parará de fornecer sessões de desktop e aplicativo. Este controlador não está mais ou não conseguiu entrar no modo de cache de licenças devido a falha contínua na comunicação com o servidor de licenças. Certifique-se de que o servidor de licenças esteja funcionando e, se necessário, use o Console de Administração de Licenças para adicionar as licenças relevantes ao servidor de licenças. |
| 1156 | O Serviço de Broker da Citrix está se comunicando com sucesso com o servidor de licenças. Este controlador não está mais no modo de cache de licenças. |
| 1157 | A versão do servidor de licenças em execução é mais antiga do que a versão do Serviço de Broker da Citrix e, portanto, é incompatível. Atualize seu servidor de licenças ou especifique um local de servidor de licenças com a versão correta em sua configuração do XenDesktop. |
| 1158 | O Serviço de Broker da Citrix detectou que você excedeu o número de licenças disponíveis para este site no servidor de licenças para esta edição. O servidor de licenças concedeu a você uma licença de overdraft. |
| 1159 | O Serviço de Broker da Citrix negou uma conexão de desktop porque o número máximo de licenças instaladas para este site foi excedido. Há três licenças instaladas para a edição, mas o número máximo permitido de licenças para esta edição é dois. Remova as licenças relevantes do servidor de licenças para cumprir o limite de licenças. |
| 1160 | O serviço de Broker da Citrix encontrou um erro interno ao gerenciar licenças. Certifique-se de que o servidor de licenças esteja funcionando corretamente e que os detalhes de identificação do servidor de licenças estejam corretos na configuração do XenDesktop. Reiniciar o serviço de Broker da Citrix também pode resolver o problema. Se o problema persistir, reinstale o Citrix XenDesktop Controller. Consulte o artigo da Base de Conhecimento da Citrix CTX126990. |
| 1161 | Erro ao inicializar o licenciamento. Verifique a conectividade do servidor de licenças. |
| 1162 | Erro ao parar o licenciamento. Verifique a conectividade do servidor de licenças. |
| 1163 | Nenhuma licença de conexão disponível. Para resolver, libere licenças fechando sessões que não são necessárias ou adicione mais licenças. |
| 1164 | Erro ao fazer checkout de uma licença de conexão. Verifique a conectividade do servidor de licenças. |
| 1165 | Erro ao fazer check-in de uma licença de conexão. Verifique a conectividade do servidor de licenças. |
| 1166 | Erro ao verificar a disponibilidade da licença. Verifique a conectividade do servidor de licenças. |
| 1167 | Falha ao iniciar o licenciamento. Verifique a conectividade do servidor de licenças. |
| 1168 | Erro ao ler as configurações de notificação do usuário de licenciamento. Verifique a conectividade do servidor de licenças. |
| 1169 | Este controlador entrou no modo de cache de licença fora da caixa, pois nenhuma licença adequada foi encontrada no servidor de licenças. Você tem 2 hora(s) restante(s) antes que este controlador pare de fornecer sessões de desktop e aplicativo. |
| 1170 | O Serviço de Broker Citrix detectou com sucesso licenças adequadas no servidor de licenças. Este controlador não está mais no modo de cache de licença fora da caixa. |
| 1171 | Nenhum servidor de licenças foi especificado. O Serviço de Broker Citrix não pode fornecer desktops e aplicativos aos usuários até que um servidor de licenças válido seja especificado. Você pode especificar um servidor de licenças no Citrix Studio ou com o cmdlet Set-ConfigSite do SDK do Citrix PowerShell. |
| 1172 | Erro ao verificar a adequação do servidor de licenças. O serviço de broker Citrix recebeu uma resposta inesperada ao verificar se uma máquina é adequada para uso como servidor de licenças. Verifique se a máquina pode ser contatada a partir do controlador e se qualquer firewall na máquina permite conexões do controlador. Se um servidor de licenças estiver instalado na máquina, verifique se ele está configurado e operando corretamente. |
| 1173 | Este site XenDesktop não possui as licenças de inicialização necessárias presentes no servidor de licenças. Use o Console de Administração de Licenças para adicionar as licenças relevantes ao servidor de licenças. |
| 1174 | A edição do produto configurada para este site XenDesktop não oferece suporte a aplicativos; os recursos do aplicativo não estarão disponíveis. |
| 1176 | A edição do produto configurada não oferece suporte a máquinas multi-sessão. O registro foi rejeitado. |
| 1177 | A edição do produto configurada não oferece suporte a máquinas de sessão única. O registro foi rejeitado. |
| 1178 | A edição do produto configurada não oferece suporte ao RemotePC. O registro foi rejeitado. |
| 1179 | A edição do produto configurada não oferece suporte a máquinas provisionadas em um sistema de nuvem. O registro foi rejeitado. |
| 1180 | A edição do produto configurada para este site XenDesktop não oferece suporte a aplicativos em máquinas de sessão única (SO de estação de trabalho). O recurso do aplicativo teve seu lançamento recusado. |
| 1181 | A edição do produto configurada para este site XenDesktop não oferece suporte a aplicativos em máquinas de múltiplas sessões (SO de servidor). O recurso do aplicativo teve seu lançamento recusado. |
| 1182 | A edição do produto configurada para este site XenDesktop não oferece suporte a desktops em máquinas de sessão única (SO de estação de trabalho). O recurso da área de trabalho teve seu lançamento recusado. |
| 1183 | A edição do produto configurada para este site XenDesktop não oferece suporte a desktops em máquinas de múltiplas sessões (SO de servidor). O recurso da área de trabalho teve seu lançamento recusado. |
| 1196 | Este controlador entrou em modo de estouro de licença devido ao esgotamento de todas as licenças utilizáveis no servidor de licenças. Adicione mais licenças para resolver isso. Você tem 2 hora(s) restantes antes que este controlador pare de fornecer sessões de desktop e aplicativo. |
| 1197 | O Serviço de Broker Citrix deixará de fornecer sessões de desktop e aplicativo. Este controlador não está mais ou não pôde entrar em um modo de burst de licença devido a licenças insuficientes no servidor de licenças. Use o Console de Administração de Licenças para adicionar as licenças relevantes ao servidor de licenças. |
| 1198 | O Serviço de Broker Citrix está consumindo licenças com sucesso do servidor de licenças. Há licenças suficientes no servidor para satisfazer a demanda atual. Este controlador não está mais em um modo de burst de licença causado pelo esgotamento da licença. |
| 1199 | O Serviço de Broker Citrix deixará de fornecer sessões de desktop e aplicativo. Este controlador não está mais ou não pôde entrar em um modo de cache de licença, pois nenhuma licença está instalada no servidor de licenças. Use o Console de Administração de Licenças para adicionar as licenças relevantes ao servidor de licenças. |
| 1205 | Sua manutenção de software expirou. Seu ambiente Citrix não é atualmente suportado. Verifique seu servidor de licenças para licenças expiradas e remova-as. Há um modo de cache de licença de 30 dias antes que os usuários comecem a receber mensagens de aviso. |
| 1206 | O hash do certificado de licença é inválido. O hash do certificado de licença Citrix é inválido. |
| 1300 | O Serviço de Broker Citrix deixará de fornecer sessões de desktop e aplicativo. Há um problema com o relógio do sistema do servidor de licenças. |
| 1301 | Os problemas com o relógio do sistema do servidor de licenças foram corrigidos. O Serviço de Broker Citrix retomará agora a operação normal. |
| 1302 | Este controlador falhou ao verificar ou retirar uma licença de conexão novamente. Falhas detectadas anteriormente ainda existem. Para evitar o registro excessivo de eventos, o serviço está suprimindo mensagens relacionadas (IDs de evento 1163, 1164, 1165) até que o problema seja resolvido. As tentativas de licenciamento continuarão. |
| 1303 | Este controlador não está mais suprimindo mensagens relacionadas (IDs de evento 1163, 1164, 1165). |
| 1304 | O Serviço de Broker Citrix contatou o LAS com sucesso. |
| 1305 | O Serviço de Broker Citrix não consegue contatar o LAS. Certifique-se de que o LAS esteja funcionando corretamente e que os detalhes de identificação do LAS estejam corretos na configuração do XenDesktop. |
Mais informações
Para obter informações sobre como verificar o estado do LAS de um site ou verificar se um site está no modo de cache de licença, consulte:
- Como posso verificar o estado do LAS de um site?
- Como posso verificar se um site está no modo de cache de licença?
Para informações detalhadas sobre os comandos, consulte:
Neste artigo
- Pré-requisitos
- Considerações
- Limitações
- Etapas principais
- Verificar detalhes de licenciamento
- Migrar licenciamento legado para LAS
- Reverter do LAS para o licenciamento herdado
- Considerações importantes para a atualização
- Solução de problemas
- Logs do visualizador de eventos relacionados a eventos de licenciamento
- Mais informações