Citrix Virtual Apps and Desktops™ 7 2203 LTSR

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 da 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 estiver inacessível, 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 Desktop devem ser desabilitadas.

Nota:

Para garantir que o licenciamento no nível DG esteja desabilitado, use Get-brokerdesktopgroup e LicenseModel deve ser “None”.

Nota:

Instale o .NET Framework 4.8 no Delivery Controller antes de iniciar a atualização para 2203 LTSR CU7. Isso garante que as ferramentas de Verificação de Compatibilidade de Licenciamento sejam executadas corretamente e evita avisos de licenciamento falsos.

Considerações

  • Todos os Delivery Controllers devem ser compatíveis com o LAS antes que o Citrix Studio solicite a ativação. Um site de controlador único pode usar licenças legadas ou LAS.
  • Você pode ter vários Servidores de Licença 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ça.

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 Citrix Studio.

Etapas principais

  1. Instale ou atualize o Servidor de Licença para a versão 11.17.2 build 53100 ou posterior e configure o LAS conforme as instruções mencionadas em Como configurar o Servidor de Licença para o Serviço de Ativação de Licença.
  2. Instale o Citrix Virtual Apps and Desktops versão 2203 LTSR CU7 ou posterior. Instale os componentes principais, como Citrix Delivery Controller, Citrix Studio e Citrix Director.

    Nota:

    Todos os Delivery Controllers no site do Citrix Virtual Apps and Desktops devem ser compatíveis com o LAS.

  3. Após instalar os componentes necessários, use o Citrix Studio para criar um site. Para obter informações sobre como criar um site, consulte Criar um site. Se o Servidor de Licença estiver configurado para usar o LAS, o Metainstaller exibirá os direitos. Os direitos são fornecidos juntamente com suas respectivas datas de expiração de licença.

    O Metainstaller exibe os direitos do LAS

    Nota:

    Se o Servidor de Licença 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.

  4. Verificar detalhes de licenciamento.
  5. Migrar licenciamento legado para LAS.

Verificar detalhes de licenciamento

Após criar o site, verifique os detalhes de licenciamento usando o Citrix Studio.

  1. No Citrix Studio, selecione o nó Licenciamento.
  2. Na página Visão geral do licenciamento, verifique se o site do Citrix Virtual Apps and Desktops tem a licença apropriada ou se a licença expirou ao usar os recursos do LAS.

    Verificar detalhes de licenciamento

    Se o LAS não estiver acessível, você poderá ver uma mensagem de erro:

    LAS não acessível

    Se o seu License Server ainda estiver usando uma licença herdada antiga e o site do Citrix Virtual Apps and Desktops for compatível com LAS, o Citrix Studio solicitará que você registre seu License Server no Citrix Cloud.

    Registrar License Server para usar LAS

Migrar licenciamento herdado para LAS

Se você já registrou seu License Server no Citrix Cloud e tem 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 herdado para o LAS sem impactar as sessões do usuário.

  1. Atualizar License Server: Atualize o License Server para a versão mínima suportada.
  2. Atualizar Delivery Controllers: Atualize todos os Delivery Controllers no site para uma versão compatível com LAS.
  3. 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).
  4. Confirmar Alocações: Verifique se as alocações do LAS estão precisas.
  5. Clique em Migrar para LAS:

    • Assim que as etapas anteriores estiverem concluídas, clique em Migrar para LAS.

      Migrar de licença herdada 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 assim 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:

  1. Execute o seguinte comando PowerShell.

    Set-ConfigSite -UseLicenseActivationService $false
    <!--NeedCopy-->
    
  2. Configure as licenças herdadas no Citrix Studio.

Nota:

Estas 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 2203 LTSR CU7 e posterior, atualize o Servidor de Licenças 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 Servidor de Licenças:

      Erro de versão

    • Se houver incompatibilidades, como um License Server desatualizado ou indisponibilidade de licenças:

      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):

  1. Execute o seguinte:

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

    Se você copiou os binários de Licenciamento para qualquer uma das unidades locais, então execute o seguinte comando:

    \x64\Licensing\CitrixLicensing.exe /quiet /l install.log
    <!--NeedCopy-->
    
  2. 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, então siga a mesma ordem para desinstalar:

  1. Desinstale o License Server usando a linha de comando:

    CitrixLicensing.exe /quiet /uninstall /l uninstall.log
    <!--NeedCopy-->
    
  2. 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, então limpe a entrada do registro e os arquivos restantes.

Para limpar as entradas do registro :

  1. Procure pela chave de registro Citrix Licensing e 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-->
    
  2. 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:

  1. No Citrix Cloud, navegue até Licenciamento > Implantações licenciadas > Servidores de Licença.
  2. Clique no botão de expansão > em Citrix Virtual Apps and Desktops para ver a lista de Delivery Controllers que foram ativados.

    cvad-list of Delivery Controllers activated

  3. 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:

    Exibir detalhes para solução de problemas

    • 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.
    • UUID do Controlador: 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 um 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 de BrokerServiceGroupUid exibido na tela com a saída BrokerServiceGroupId do comando.
  • Get-BrokerController: Para comparar o valor de 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 com sucesso o servidor de licenças.
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 esteja funcionando corretamente e que os detalhes de identificação do servidor de licenças estejam 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ça porque não conseguiu contatar o servidor de licenças. Você tem 2 hora(s) restantes antes que este controlador pare de fornecer sessões de desktop e aplicativo.
1155 O Serviço Citrix Broker 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ça 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 Citrix Broker está se comunicando com sucesso com o servidor de licenças. Este controlador não está mais no modo de cache de licença.
1157 A versão do servidor de licenças em execução é mais antiga que a versão do Serviço Citrix Broker 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 Citrix Broker 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 sobrecarga.
1159 O Serviço Citrix Broker 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 Citrix Broker 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 Citrix Broker também pode resolver o problema. Se o problema persistir, reinstale o Citrix XenDesktop Controller. Consulte o artigo CTX126990 da Base de Conhecimento da Citrix.
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 desnecessárias ou adicione mais licenças.
1164 Erro ao fazer check-out 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 pronto para uso, já que nenhuma licença adequada foi encontrada no servidor de licenças. Você tem 2 hora(s) restantes 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 pronto para uso.
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 pelo 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 funcionando 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 o 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 o 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 de desktop teve o 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 de desktop teve o lançamento recusado.
1196 Este controlador entrou em modo de interrupção 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 Citrix Broker Service agora 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 Citrix Broker Service 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 Citrix Broker Service agora 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 seu certificado de licença Citrix é inválido.
1300 O Citrix Broker Service agora deixará de fornecer sessões de desktop e aplicativo. Há um problema com o relógio do sistema do servidor de licenças.
1301 Problemas com o relógio do sistema do servidor de licenças foram corrigidos. O Citrix Broker Service agora retomará 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 da Citrix contatou o LAS com sucesso.
1305 O Serviço de Broker da 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:

Para obter informações detalhadas sobre os comandos, consulte: