Serviço de Ativação de Licença

O Serviço de Ativação de Licença (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ça 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ça, 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ça.

Para obter mais detalhes sobre o LAS, consulte a documentação de Licenciamento Serviço de Ativação de Licença.

Pré-requisitos

  • Instale ou atualize o Servidor de Licenças para a versão 11.17.2 build 51000 ou posterior.
  • Conexão de internet confiável e contínua para o Servidor de Licenças.

Considerações

  • Todos os Delivery Controllers devem ser compatíveis com o LAS antes que o Web Studio solicite a ativação. Um único site 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

  1. Instale ou atualize o License Server para a versão 11.17.2 build 51000 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.
  2. Instale o Citrix Virtual Apps and Desktops versão 2411 ou posterior. Instale os componentes principais, como Citrix Delivery Controller, Citrix Studio, Web 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 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 de licença.

    O Metainstaller exibe os direitos do LAS

    Nota:

    Se o License Server não for atualizado para a versão mais recente do License Server, você receberá uma mensagem de erro.

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

Verificar detalhes de licenciamento

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

  1. No Web Studio, selecione o nó Licenciamento.
  2. 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.

    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 Servidor de Licenças não estiver disponível, você poderá ver uma mensagem de erro:

    Servidor de Licenças não disponível

    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.

    Registrar Servidor de Licenças para usar LAS

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 dos usuários.

  1. Atualizar Servidor de Licenças: Atualize o Servidor de Licenças 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 forem concluídas, clique em Migrar para LAS.

      Migrar de licença legada 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 legado

Faça o seguinte para reverter do LAS para o licenciamento legado:

  1. Execute o seguinte comando PowerShell.

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

Nota:

Estas etapas são fornecidas apenas para solução de problemas temporária. Os arquivos de licença legados 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 a 2411 e posterior, atualize o Servidor de Licenças para a versão mais recente (versão 11.2.17 build 51000 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 Servidor de Licenças desatualizado ou indisponibilidade de licenças:

      Servidor de Licenças 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, 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, 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, limpe a entrada do registro e os arquivos restantes.

Para limpar as entradas do registro:

  1. Procure a 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-lista de Delivery Controllers ativados

  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:

    Ver detalhes para solução de problemas

    • Produto e Versão: O Product_Edition_Model e a Data de Gravação (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 Controller: 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 Citrix Broker falhou ao intermediar uma conexão do 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 Citrix Broker contatou o servidor de licenças com sucesso.
1151 O Serviço Citrix Broker 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 Citrix Broker 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) restantes antes que este controlador pare de fornecer sessões de desktop e aplicativo.
1155 O Citrix Broker Service agora parará de fornecer sessões de desktop e aplicativo. Este controlador não está mais ou não conseguiu entrar em um 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 Citrix Broker Service 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 Citrix Broker Service 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 Citrix Broker Service 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 Citrix Broker Service 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 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 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ças 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 aplicativos.
1170 O Serviço de Broker Citrix detectou licenças adequadas no servidor de licenças. Este controlador não está mais no modo de cache de licenças 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 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 do 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 do 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 várias 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 da área de trabalho 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 várias sessões (SO de servidor). O recurso da área de trabalho teve o lançamento recusado.
1196 Este controlador entrou em modo de intermitência 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 parará de fornecer sessões de desktop e aplicativo. Este controlador não está mais ou não pôde entrar em modo de intermitência 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 do servidor de licenças com sucesso. Há licenças suficientes no servidor para atender à demanda atual. Este controlador não está mais em modo de estouro de licença causado pelo esgotamento da licença.
1199 O Citrix Broker Service agora deixará de fornecer sessões de desktop e aplicativos. Este controlador não está mais ou não conseguiu 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 aplicativos. 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 Citrix Broker Service agora retomará a operação normal.
1302 Este controlador falhou novamente ao fazer check-in ou check-out de uma licença de conexão. Falhas detectadas anteriormente ainda existem. Para evitar o registro excessivo de eventos, o serviço está suprimindo mensagens relacionadas (ID 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 (ID de evento 1163, 1164, 1165).
1304 O Citrix Broker Service contatou o LAS com sucesso.
1305 O Citrix Broker Service 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: