Documentação de produtos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Atualizar uma implantação

January 23, 2026
Contribuição de: 
C

Nota:

O sistema de licenciamento baseado em arquivo, tradicionalmente usado para ativar vários componentes locais, terá seu Fim de Vida (EOL) em 15 de abril de 2026. O License Activation Service (LAS) é a tecnologia de próxima geração para ativações de produtos em todo o conjunto de produtos Citrix. O LAS será a única maneira de ativar e licenciar componentes locais da Citrix após 15 de abril de 2026. Para permanecer compatível, sua implantação do Citrix Virtual Apps and Desktops deve estar em uma versão compatível com LAS. As versões mínimas de CVAD compatíveis com LAS são:

  • CVAD 2203 LTSR CU7
  • CVAD 2402 LTSR CU3
  • CVAD 2507 LTSR
  • CVAD 2411

Se tiver dúvidas ou preocupações, entre em contato com o Suporte ao Cliente. A Citrix pode limitar ou suspender sua Manutenção Citrix por não conformidade com esses requisitos, sem responsabilidade, além de quaisquer outros recursos que a Citrix possa ter por lei ou equidade. Esses requisitos não se aplicam onde proibido por lei ou regulamento.

Introdução

Nota:

Este artigo aborda atualizações para implantações que envolvem o Web Studio. Para obter informações sobre atualizações que envolvem o Citrix Studio, consulte o artigo equivalente no Citrix Virtual Apps and Desktops™ 7 2212 ou anterior.

É possível atualizar certas implantações para versões mais recentes sem precisar configurar novas máquinas ou sites primeiro. Isso é chamado de atualização in-loco.

Para saber quais versões do Citrix Virtual Apps and Desktops você pode atualizar, consulte Versões que você pode atualizar.

Antes de atualizar para qualquer uma das versões do Citrix Virtual Apps and Desktops, certifique-se de que suas datas atuais de Customer Success Services sejam válidas e não tenham expirado. Para obter mais informações, consulte o artigo Licenças de renovação do Customer Success Services.

Para iniciar uma atualização, execute o instalador da nova versão para atualizar os componentes principais, VDAs e outros componentes instalados anteriormente. Em seguida, atualize o banco de dados e o site.

Você pode atualizar qualquer componente que possa ser instalado com o instalador completo do produto (e os instaladores VDA autônomos), se houver uma versão mais recente disponível. Para outros componentes que não são instalados com o instalador completo do produto (como Citrix Provisioning™ e Profile Management), consulte a documentação desse componente para obter orientação. Para atualizações de host, consulte a documentação apropriada.

Revise todas as informações neste artigo antes de iniciar uma atualização.

Sequência de atualização

O diagrama a seguir mostra as etapas da sequência de atualização. O Procedimento de atualização contém detalhes de cada etapa do diagrama.

Diagrama de fluxo da sequência de atualização

Nota:

Para evitar falhas, você deve atualizar todos os Delivery Controllers e o banco de dados antes de executar qualquer uma das tarefas relacionadas ao provisionamento e ao grupo de entrega, como criar um novo catálogo de máquinas, excluir um catálogo de máquinas, atualizar uma máquina em um grupo de entrega e assim por diante.

Licenças Hybrid Rights

As licenças Hybrid Rights são licenças de assinatura baseadas em prazo que são fornecidas, além da assinatura do serviço de nuvem, quando um cliente faz a transição ou upgrade de uma licença perpétua para uma assinatura de serviço de nuvem. Você também pode adquirir um complemento Hybrid Rights com suas assinaturas DaaS.

Se você tiver uma licença Hybrid Rights com um atributo SaaS, ao atualizar para o Citrix Virtual Apps and Desktops LTSR 2203 e posterior, você se tornará elegível para acessar recursos não disponíveis com o Citrix Virtual Apps and Desktops LTSR 1912. Esses recursos incluem provisionamento e hospedagem de cargas de trabalho em nuvens públicas, como Microsoft Azure, AWS EC2 e Google Cloud. Antes de implantar o novo arquivo de licença, atualize seu License Server para a versão mais recente. A falha em atender a esse pré-requisito bloqueará as atualizações do site do Citrix Virtual Apps and Desktops e a criação do site.

Se você tiver acesso a uma licença Hybrid Rights sem atributo SaaS, siga estas etapas para obter acesso à nova licença Hybrid Rights com atributo SaaS:

Nota:

  • Você receberá um e-mail com um novo código de licença. Para obter mais informações, consulte Usar código de acesso de licença.
  • Suas licenças existentes são rescindidas. As licenças rescindidas devem ser excluídas dos License Servers, seguidas pela instalação de novas licenças. Para obter mais informações, consulte Excluir arquivos de licença.

  1. Acesse o portal citrix.com Gerenciar Licenças e baixe o novo arquivo de licença Hybrid Rights com direitos de provisionamento de nuvem habilitados (atributo SaaS). Para obter mais informações, consulte Baixar licenças. A imagem a seguir mostra o arquivo de licença Hybrid Rights com o atributo SaaS na seção Increments.

    Atributo SaaS no arquivo de licença

  2. Instale o arquivo de licença Hybrid Rights no License Server. Para obter mais informações, consulte Instalar licenças.
  3. Se houver uma alteração nas edições ou no modelo da licença, certifique-se de executar o comando do broker para definir a edição e o modelo e, em seguida, iniciar a atualização in-loco. Para obter mais informações sobre os comandos do Broker, consulte a seção Broker PowerShell SDK.

Para obter mais informações sobre o suporte a nuvem pública com as versões atuais e de serviço de longo prazo do Citrix Virtual Apps and Desktops, consulte CTX270373.

Procedimento de atualização

A maioria dos principais componentes do produto pode ser atualizada executando o instalador do produto na máquina que contém o componente.

Se uma máquina contiver mais de um componente (por exemplo, Studio e License Server), todos os componentes dessa máquina serão atualizados, se a mídia do produto contiver versões mais recentes de seu software.

Para usar os instaladores:

  • Para executar a interface gráfica do instalador completo do produto, faça logon na máquina e insira a mídia ou monte a unidade ISO para a nova versão. Clique duas vezes em AutoSelect.
  • Para usar a interface de linha de comando, emita o comando apropriado. Consulte Instalar usando a linha de comando.

Etapa 1: Preparar

Antes de iniciar uma atualização, certifique-se de estar pronto. Leia e conclua todas as tarefas necessárias:

Etapa 2: Atualizar o License Server

Se a instalação tiver uma nova versão do software Citrix License Server, atualize este componente primeiro, antes de qualquer outro componente.

Se você ainda não determinou se seu License Server é compatível com a nova versão, é essencial que você execute o instalador no License Server antes de atualizar quaisquer outros componentes principais.

Etapa 3: Atualizar o StoreFront™

Se a mídia de instalação contiver uma nova versão do software StoreFront, execute o instalador na máquina que contém o servidor StoreFront.

  • Na interface gráfica, escolha Citrix StoreFront na seção Extend deployment.
  • Na linha de comando, execute CitrixStoreFront-x64.exe, que está disponível na pasta x64 da mídia de instalação do Citrix Virtual Apps and Desktops.

Etapa 4: Atualizar o Director

Se a mídia de instalação contiver uma nova versão do software Director, execute o instalador na máquina que contém o Director.

Etapa 5: Atualizar o Citrix Provisioning

A mídia de instalação do Citrix Provisioning está disponível separadamente da mídia de instalação do Citrix Virtual Apps and Desktops. Para saber como instalar e atualizar o servidor Citrix Provisioning e o software do dispositivo de destino, consulte a documentação do produto Citrix Provisioning.

Etapa 6: Atualizar metade dos Delivery Controllers

Por exemplo, se seu site tiver quatro Controllers, execute o instalador em dois deles.

Deixar metade dos Controllers ativos permite que os usuários acessem o site. Os VDAs podem se registrar nos Controllers restantes. Pode haver momentos em que o site tenha capacidade reduzida porque menos Controllers estão disponíveis. A atualização causa apenas uma breve interrupção no estabelecimento de novas conexões de cliente durante as etapas finais de atualização do banco de dados. Os Controllers atualizados não podem processar solicitações até que todo o site seja atualizado.

Se seu site tiver apenas um Controller, ele ficará inoperável durante a atualização.

Os testes preliminares do site são executados no primeiro Controller, antes do início da atualização real. Para obter detalhes, consulte Testes preliminares do site.

Etapa 7: Atualizar o Studio

Se você ainda não atualizou o Web Studio (porque estava na mesma máquina que outro componente), execute o instalador na máquina que contém o Studio.

Nota:

Depois de atualizar o Web Studio, as informações da versão podem não ser atualizadas imediatamente. Você pode ser solicitado a atualizar o Web Studio mesmo que ele já esteja atualizado. Para resolver o problema, vá para o servidor Web Studio, abra o Gerenciador de Serviços de Informações da Internet (IIS), navegue até Página Inicial > Sites > Site Padrão e selecione Reiniciar no painel Gerenciar Site.

Etapa 8: Reiniciar o Studio

Reinicie o Web Studio atualizado. O processo de atualização é retomado automaticamente.

Etapa 9: Atualizar o banco de dados e o site

Nota:

Para evitar falhas, você deve atualizar todos os Delivery Controllers e o banco de dados antes de executar qualquer uma das tarefas relacionadas ao provisionamento e ao grupo de entrega, como criar um novo catálogo de máquinas, excluir um catálogo de máquinas, atualizar uma máquina em um grupo de entrega e assim por diante.

Verifique a seção Preparação para as permissões necessárias para atualizar o esquema dos bancos de dados do SQL Server.

  • Se você tiver permissão suficiente para atualizar o esquema do banco de dados do SQL Server, poderá iniciar uma atualização automática do banco de dados. Continue com Atualizar o banco de dados e o site automaticamente.
  • Se você não tiver permissões de banco de dados suficientes, poderá iniciar uma atualização manual que usa scripts e prosseguir com a ajuda de seu administrador de banco de dados (alguém que tenha as permissões necessárias). Para uma atualização manual, o usuário do Studio gera os scripts e, em seguida, executa os scripts que habilitam e desabilitam os serviços. O administrador do banco de dados executa outros scripts que atualizam o esquema do banco de dados, usando o utilitário SQLCMD ou o SQL Server Management Studio no modo SQLCMD. Continue com Atualizar o banco de dados e o site manualmente.
  • Se você tiver uma implantação multi-zona e quiser atualizar o banco de dados e o site automaticamente, a Citrix recomenda que a atualização do dbschema seja realizada na mesma zona que hospeda os bancos de dados do SQL Server do site. Caso contrário, a atualização automática do banco de dados e do site pode falhar.

A Citrix recomenda fortemente que você faça backup do banco de dados antes de atualizar. Consulte CTX135207. Durante uma atualização do banco de dados, os serviços do produto são desabilitados. Durante esse tempo, os Controllers não podem intermediar novas conexões para o site, portanto, planeje cuidadosamente.

Atualizar o banco de dados e o site automaticamente

  1. Inicie o Studio recém-atualizado.
  2. Indique que deseja iniciar a atualização do site automaticamente e confirme que está pronto.

A atualização do banco de dados e do site prossegue.

Atualizar o banco de dados e o site manualmente

  1. Inicie o Studio recém-atualizado.
  2. Indique que deseja atualizar o site manualmente. O assistente verifica a compatibilidade do License Server e solicita confirmação.

  3. Confirme que você fez backup do banco de dados.

    O assistente gera e exibe os scripts e uma lista de verificação das etapas de atualização. Se o esquema de um banco de dados não tiver sido alterado desde a versão do produto que está sendo atualizada, esse script não será gerado. Por exemplo, se o esquema do banco de dados de log não for alterado, o script UpgradeLoggingDatabase.sql não será gerado.

  4. Execute os seguintes scripts na ordem mostrada.

    • DisableServices.ps1: O usuário do Studio executa este script PowerShell em um Controller para desabilitar os serviços do produto.
    • UpgradeSiteDatabase.sql: O administrador do banco de dados executa este script SQL no servidor que contém o banco de dados do Site.
    • UpgradeMonitorDatabase.sql: O administrador do banco de dados executa este script SQL no servidor que contém o banco de dados do Monitor.
    • UpgradeLoggingDatabase.sql: O administrador do banco de dados executa este script SQL no servidor que contém o banco de dados de Log de Configuração. Execute este script somente se este banco de dados for alterado (por exemplo, após a aplicação de um hotfix).
    • EnableServices.ps1: O usuário do Studio executa este script PowerShell em um Controller para habilitar os serviços do produto.

    Após a conclusão da atualização do banco de dados e a habilitação dos serviços do produto, o Studio testa automaticamente o ambiente e a configuração e, em seguida, gera um relatório HTML. Se problemas forem identificados, você pode restaurar o backup do banco de dados. Após resolver os problemas, você pode atualizar o banco de dados novamente.

  5. Após concluir as tarefas da lista de verificação, clique em Finish upgrade.

Etapa 10: Atualizar os Delivery Controllers restantes

No Studio recém-atualizado, selecione o nome-do-site do Citrix Studio no painel de navegação. Na guia Common Tasks, selecione Upgrade remaining Delivery Controllers.

Nota:

Para que a opção Upgrade remaining Delivery Controllers esteja disponível, crie pelo menos um catálogo de máquinas e um grupo de entrega para o site.

Após concluir a atualização e confirmar a conclusão, feche e reabra o Studio. O Studio pode solicitar uma atualização extra do site para registrar os serviços do Controller no site ou para criar um ID de zona se ele não existir.

Etapa 11: Atualizar VDAs

Importante:

Se você estiver atualizando um VDA para a versão 1912 ou posterior, consulte Atualizar VDAs para 1912 ou posterior.

Execute o instalador do produto nas máquinas que contêm VDAs.

Se você usou o Machine Creation Services™ e uma imagem mestre para criar máquinas, vá para seu host e atualize o VDA na imagem mestre. Você pode usar qualquer um dos instaladores VDA disponíveis.

Se você usou o Citrix Provisioning para criar máquinas, consulte a documentação do produto Citrix Provisioning para obter orientação sobre a atualização.

Etapa 12: Atualizar catálogos de máquinas e grupos de entrega

Etapa 13: Após a atualização

Atualize outros componentes em sua implantação. Para obter orientação, consulte a seguinte documentação do produto:

Se você precisar substituir o software Microsoft SQL Server Express LocalDB por uma versão posterior, consulte Substituir SQL Server Express LocalDB.

Atualização do esquema do banco de dados (Dbschema)

Ao atualizar sua implantação, vários esquemas de banco de dados podem ser atualizados. A tabela a seguir lista quais esquemas de banco de dados são atualizados no processo:

Atualizações do esquema do banco de dados

Definição de termos:

  • Site: Datastore do Site. A atualização do esquema do banco de dados é feita no Datastore do Site.
  • Monitor: Datastore do Monitor. A atualização do esquema do banco de dados é feita no Datastore do Monitor.
  • Config: Tabela de Configuração. A versão do Desktop Studio, informações de licenciamento ou ambos são atualizados na tabela de Configuração.
  • Logging: Datastore de Log. A atualização do esquema do banco de dados é feita no Datastore de Log.

Atualizar VDAs para 2203 ou posterior

Se o componente Personal vDisk (PvD) foi instalado em um VDA, esse VDA não pode ser atualizado para a versão 2203 ou posterior. Para usar o novo VDA, você deve desinstalar o VDA atual e, em seguida, instalar o novo VDA.

Esta instrução se aplica mesmo que você nunca tenha usado o PvD.

Veja como o componente PvD pode ter sido instalado em versões anteriores:

  • Na interface gráfica do instalador VDA, o PvD era uma opção na página Additional Components.
  • Na linha de comando, a opção /baseimage instalava o PvD. Se você especificou esta opção ou usou um script que continha esta opção, o PvD foi instalado.

Se você não sabe se seu VDA tem o PvD instalado, execute o instalador para o novo VDA (2203 ou posterior) na máquina ou imagem.

  • Se o PvD estiver instalado, uma mensagem aparecerá, indicando que há um componente incompatível.
    • Na interface gráfica, clique em Cancel na página que contém a mensagem e, em seguida, confirme que deseja fechar o instalador.
    • Na CLI, o comando simplesmente falha com a mensagem exibida.
  • Se o PvD não estiver instalado, a atualização prossegue.

O que fazer

Se o VDA não tiver o PvD instalado, siga o procedimento de atualização usual.

Se o VDA tiver o PvD instalado:

  1. Desinstale o VDA atual.
  2. Instale o novo VDA.

Se você deseja continuar usando o PvD em suas máquinas Windows 10 (1607 e anteriores, sem atualizações), o VDA 7.15 LTSR é a versão mais recente suportada.

Nota:

Posso usar o Personal vDisk com desktops Windows 7 no XenApp e XenDesktop 7.15 LTSR?

A Citrix excluiu o Personal vDisk (PvD) do XenApp e XenDesktop 7.6 LTSR, que foi anunciado em janeiro de 2016. Além disso, a Citrix anunciou a descontinuação da tecnologia PvD e recomenda que os clientes comecem a usar o Citrix App Layering daqui para frente. O Citrix App Layering (versão 4.4 e posterior) é um componente compatível do XenApp e XenDesktop 7.15 LTSR. No entanto, para ajudar os clientes com implantações PvD existentes no Windows 7 a migrar para a tecnologia Citrix App Layering, a Citrix decidiu fornecer suporte por tempo limitado para implantações PvD para desktops Windows 7 por meio das Atualizações Cumulativas (CUs) do XenApp e XenDesktop 7.15 LTSR até 14 de janeiro de 2020. O componente PvD será removido das CUs LTSR e não será suportado após 14 de janeiro de 2020. Além disso, o uso de PvD para Windows 7 após 14 de janeiro de 2020 tornará os sites LTSR não conformes. Além disso, o PvD para Windows 10 permanece excluído do 7.15 LTSR. Portanto, os clientes não devem usá-lo com seus sites 7.15 LTSR.

Remover PvD, AppDisks e hosts não suportados

As seguintes tecnologias e tipos de host não são suportados em implantações do Citrix Virtual Apps and Desktops 7 Current Release:

  • Personal vDisks (PvD) para armazenar dados próximos às VMs dos usuários em catálogos. O recurso de camada de personalização do usuário agora lida com a persistência do usuário.
  • AppDisks para gerenciar aplicativos usados em Delivery Groups.
  • Tipos de host: Azure Classic, CloudPlatform (o produto Citrix original).

Se sua implantação atual usa PvDs ou AppDisks, ou tem conexões com tipos de host não suportados (por exemplo, Microsoft Azure Classic), você pode atualizar para a versão 2006 (ou versões posteriores suportadas) somente após remover os itens que usam essas tecnologias. Se sua implantação atual usa conexões de host de nuvem pública (por exemplo, AWS), certifique-se de ter a licença Hybrid Rights antes de atualizar. Quando o instalador detecta uma ou mais das tecnologias não suportadas ou conexões de host sem a licença Hybrid Rights, a atualização pausa ou para, e uma mensagem explicativa aparece. Os logs do instalador contêm detalhes.

Para ajudar a garantir uma atualização bem-sucedida, revise e siga as orientações aplicáveis para remover os itens não suportados.

Mesmo que você não tenha usado PvD ou AppDisks em sua implantação, MSIs relacionados podem ter sido incluídos em uma instalação ou atualização anterior do VDA. Antes de poder atualizar seus VDAs para a versão 2006 (ou uma versão posterior suportada), você deve remover esse software, mesmo que nunca o tenha usado. Ao usar a interface gráfica, essa remoção pode ser feita para você, ou você pode incluir opções de remoção ao usar a CLI. Para obter detalhes, consulte Atualizar VDAs que possuem componentes PvD ou AppDisks.

Remover PvD

Uma atualização de implantação não pode ser bem-sucedida até que você remova todas as máquinas configuradas para usar o PvD. Isso afeta catálogos e Delivery Groups.

Para remover o PvD de grupos e catálogos:

  1. No Studio, se um Delivery Group contiver máquinas de um catálogo que usa PvD, remova essas máquinas do grupo.
  2. No Studio, exclua todos os catálogos que contêm máquinas que usam PvD.

Atualizações de VDA: A atualização da implantação não detecta se os VDAs têm os componentes AppDisk ou PvD instalados. No entanto, os instaladores VDA o fazem. Para obter detalhes, consulte VDAs que possuem componentes PvD ou AppDisks.

Se você planeja usar o App Layering em vez do PvD, consulte Migrar PvD para App Layering para obter informações sobre como mover dados.

Remover AppDisks

Uma atualização de implantação não pode prosseguir até que você remova os AppDisks de todos os Delivery Groups que os usam e, em seguida, remova os próprios AppDisks.

  1. Selecione Delivery Groups no painel de navegação do Studio.
  2. Selecione um grupo e clique em Manage AppDisks no painel Action.
  3. Clique na ação que remove o AppDisk do grupo.
  4. Repita as etapas 2 e 3 para cada Delivery Group que usa AppDisks.
  5. Selecione AppDisks no painel de navegação do Studio.
  6. Selecione um AppDisk e clique na ação que exclui o AppDisk.
  7. Repita as etapas 5 e 6 para cada AppDisk.

Atualizações de VDA: A atualização da implantação não detecta se os VDAs têm os componentes AppDisk ou PvD instalados. No entanto, os instaladores VDA o fazem. Para obter detalhes, consulte VDAs que possuem componentes PvD ou AppDisks.

Remover itens de host não suportados

Uma atualização de implantação para a versão 2006 (ou versão posterior suportada) não pode prosseguir se o site tiver conexões com tipos de host não suportados, como Citrix CloudPlatform ou Microsoft Azure Classic. Conclua as seguintes tarefas antes de tentar uma atualização.

No Studio:

VDAs que possuem componentes PvD ou AppDisks

Se os componentes que habilitam as tecnologias PvD e AppDisks estiverem instalados em um VDA, esse VDA não poderá ser atualizado até que esses componentes sejam removidos.

Nota:

Ao atualizar para a versão 1912, você precisava desinstalar o VDA atual e, em seguida, instalar o novo VDA. Nesta versão, você é perguntado se deseja que a Citrix remova o componente e, em seguida, continue a atualização.

Os componentes AppDisk e PvD podem ter sido instalados em versões anteriores do VDA, mesmo que você nunca tenha usado essas tecnologias:

  • Interface gráfica: Nos instaladores VDA, a página Additional Components continha a opção Citrix AppDisk / Personal vDisk. As versões 7.15 LTSR e anteriores 7.x habilitavam esta opção por padrão. Portanto, se você aceitou os padrões (ou habilitou explicitamente a opção em qualquer versão que a oferecesse), esse componente foi instalado.
  • CLI: A especificação da opção /baseimage instalava o componente.

O que fazer

Se o instalador VDA não detectar os componentes AppDisks ou PvD no VDA atualmente instalado, a atualização prossegue normalmente.

Se o instalador detectar componentes AppDisks ou PvD no VDA atualmente instalado:

  • Interface gráfica: A atualização pausa. Uma mensagem pergunta se você deseja que os componentes não suportados sejam removidos automaticamente. Se você clicar em OK, os componentes são removidos automaticamente e a atualização prossegue.

  • CLI: Para evitar falha de comando, inclua as seguintes opções no comando:

    • /remove_appdisk_ack
    • /remove_pvd_ack

Limitações

As seguintes limitações se aplicam às atualizações:

  • Instalação seletiva de componentes: Se você instalar ou atualizar quaisquer componentes para a nova versão, mas optar por não atualizar outros componentes (em máquinas diferentes) que exigem atualização, o Studio o lembrará. Por exemplo, digamos que uma atualização inclua novas versões do Controller e do Studio. Você atualiza o Controller, mas não executa o instalador na máquina onde o Studio está instalado. O Studio não permitirá que você continue a gerenciar o site até que você atualize o Studio.

    Você não precisa atualizar os VDAs, mas a Citrix recomenda atualizar todos os VDAs para permitir que você use todos os recursos disponíveis.

  • Versões Early Release ou Technology Preview: Você não pode atualizar de uma versão Early Release, Technology Preview ou de pré-visualização.

  • Componentes em sistemas operacionais anteriores: Você não pode instalar VDAs atuais em sistemas operacionais que não são mais suportados pela Microsoft ou Citrix. Para obter mais informações, consulte Sistemas operacionais anteriores.

  • Ambientes/sites mistos: Se você precisar continuar executando sites de versões anteriores e sites de versões atuais, consulte Considerações sobre ambientes mistos.

  • Seleção de produto: Ao atualizar de uma versão anterior, você não escolhe ou especifica o produto (Citrix Virtual Apps ou Citrix Virtual Apps and Desktops) que foi definido durante a instalação.

Considerações sobre ambientes mistos

Ao atualizar, a Citrix recomenda que você atualize todos os componentes e VDAs para que possa acessar todos os recursos novos e aprimorados em sua edição e versão.

Por exemplo, embora você possa usar VDAs atuais em implantações que contêm versões anteriores do Controller, novos recursos na versão atual podem não estar disponíveis. Problemas de registro de VDA também podem ocorrer ao usar versões não atuais.

Em alguns ambientes, você pode não conseguir atualizar todos os VDAs para a versão mais atual. Nesse caso, ao criar um catálogo de máquinas, você pode especificar a versão do VDA instalada nas máquinas. (Isso é chamado de nível funcional.) Por padrão, essa configuração especifica a versão mínima recomendada do VDA. O valor padrão é suficiente para a maioria das implantações. Considere alterar a configuração para uma versão anterior somente se o catálogo contiver VDAs anteriores ao padrão. Não é recomendável misturar versões de VDA em um catálogo de máquinas.

Se um catálogo for criado com a configuração de versão mínima padrão do VDA, e uma ou mais máquinas tiverem um VDA anterior à versão padrão, essas máquinas não poderão se registrar no Controller e não funcionarão.

Para obter mais informações, consulte Versões VDA e níveis funcionais.

Vários sites com versões diferentes

Quando seu ambiente contém sites com diferentes versões de produto (por exemplo, um site XenDesktop 7.18 e um site Citrix Virtual Apps and Desktops 1909), a Citrix recomenda usar o StoreFront para agregar aplicativos e desktops de diferentes versões de produto. Para obter detalhes, consulte a documentação do StoreFront.

Em um ambiente misto, continue usando as versões do Studio e do Director para cada versão, mas certifique-se de que as diferentes versões estejam instaladas em máquinas separadas.

Sistemas operacionais anteriores

Digamos que você instalou uma versão anterior de um componente em uma máquina que estava executando uma versão de sistema operacional (SO) suportada. Agora, você deseja usar uma versão mais recente do componente, mas esse SO não é mais suportado para a versão atual do componente.

Por exemplo, suponha que você instalou um VDA de servidor em uma máquina Windows Server 2016. Agora você deseja atualizar esse VDA para a versão atual, mas o Windows Server 2016 não é suportado na versão atual para a qual você está atualizando.

Se você tentar instalar ou atualizar um componente em um sistema operacional que não é mais permitido, uma mensagem de erro será exibida, como “Cannot be installed on this operating system”.

Essas considerações se aplicam à atualização de versões Current Release e Long Term Service Release. (Não afeta a aplicação de CUs a uma versão LTSR.)

Siga os links para saber quais sistemas operacionais são suportados:

Sistemas operacionais inválidos

A tabela a seguir lista os sistemas operacionais anteriores que não são válidos para instalar/atualizar componentes na versão atual. Ela indica a versão de componente válida mais recente suportada para cada SO listado e a versão de componente quando a instalação e a atualização se tornaram inválidas.

Os sistemas operacionais na tabela incluem service packs e atualizações.

Sistema operacional Componente/recurso Última versão válida Instalação/atualização não possível a partir da versão
Windows 7 e Windows 8 VDA 7.15 LTSR 7.16
Windows 7 e Windows 8 Outros componentes do instalador 7.17 7.18
Windows 10 versões anteriores a 1607 VDA 7.15 LTSR 7.16
Windows 10 versão x86 VDA 1906.2.0 1909
Windows Server 2008 R2 VDA 7.15 LTSR 7.16
Windows Server 2008 R2 Outros componentes do instalador 7.17 7.18
Windows Server 2012 VDA 7.15 LTSR 7.16
Windows Server 2012 Outros componentes do instalador 7.17 7.18
Windows Server 2012 R2 Outros componentes do instalador * 1912 LTSR 2003
Windows Server 2012 R2 Server VDI 7.15 LTSR 7.16
Windows Server 2016 Server VDI 7.15 LTSR 7.16

Windows XP e Windows Vista não são válidos para nenhum componente ou tecnologia 7.x.

* Aplica-se a Delivery Controller, Studio, Director e VDAs.

O que você pode fazer

Você tem escolhas. Você pode:

Continuar com o SO atual

Esses métodos são viáveis para VDAs. Se você deseja continuar usando máquinas com o SO anterior, pode escolher uma das seguintes opções:

  • Continuar usando a versão do componente instalada.
  • Baixar a versão válida mais recente do componente e, em seguida, atualizar o componente para essa versão. (Isso pressupõe que a versão válida mais recente do componente ainda não esteja instalada.)

Por exemplo, você tem um VDA 7.14 em uma máquina Windows 7 SP1. A versão VDA válida mais recente em máquinas com SO Windows 7 é XenApp e XenDesktop 7.15 LTSR. Você pode continuar usando o 7.14 ou baixar um VDA 7.15 LTSR e, em seguida, atualizar seu VDA para essa versão. Essas versões anteriores do VDA funcionam em implantações que contêm Delivery Controllers com versões mais recentes. Por exemplo, um VDA 7.15 LTSR pode se conectar a um Controller Citrix Virtual Apps and Desktops 7 1808.

Reimagear ou atualizar a máquina

Esses métodos são viáveis para VDAs e outras máquinas que não possuem componentes principais (como Delivery Controllers) instalados. Escolha uma das seguintes opções:

  • Depois de retirar a máquina de serviço (ativando o modo de manutenção e permitindo que todas as sessões sejam encerradas), você pode reimageá-la para uma versão suportada do SO Windows e, em seguida, instalar a versão mais recente do componente.
  • Para atualizar o SO em uma máquina VDA sem reimagear, você deve primeiro instalar a versão do VDA suportada no SO para o qual você está atualizando ou atualizar o VDA após atualizar o SO. Caso contrário, o software Citrix não será suportado. Você pode atualizar para as seguintes versões mínimas de SO ao realizar uma atualização in-loco sem desinstalar o VDA:
  • Se a versão do Windows para a qual você planeja atualizar não estiver alinhada com a diretriz mencionada, você deve desinstalar o VDA antes de atualizar o SO e, em seguida, instalar uma versão suportada do VDA após a conclusão da atualização do SO.

Adicionar novas máquinas e, em seguida, remover máquinas antigas

Este método é viável se você precisar atualizar o SO em máquinas que contêm um Delivery Controller™ ou outro componente principal.

A Citrix recomenda que todos os Controllers em um site tenham o mesmo SO. A seguinte sequência de atualização minimiza o intervalo em que diferentes Controllers têm SOs diferentes.

  1. Faça um snapshot de todos os Delivery Controllers no site e, em seguida, faça backup do banco de dados do site.
  2. Instale novos Delivery Controllers em servidores limpos com sistemas operacionais suportados.
  3. Adicione os novos Controllers ao site.
  4. Remova os Controllers que estão executando sistemas operacionais que não são válidos para a versão atual. Siga as recomendações para remover Controllers em Delivery Controllers.

Preparação

Antes de iniciar uma atualização, revise as seguintes informações e conclua as tarefas necessárias.

Nota:

Embora a atualização de VDAs ocorra mais tarde na sequência de atualização, é uma boa ideia escolher um instalador e revisar o procedimento antes de iniciar a atualização, para que você saiba o que esperar.

Escolher um instalador e interface

Use o instalador completo do produto do ISO do produto para atualizar os componentes. Você pode atualizar os VDAs usando o instalador completo do produto ou um dos instaladores VDA autônomos. Todos os instaladores oferecem interfaces gráficas e de linha de comando.

Para obter mais informações, consulte Instaladores.

Especificidades da instalação: Depois de concluir qualquer trabalho de preparação e estar pronto para iniciar o instalador, o artigo de instalação mostra o que você verá (se estiver usando a interface gráfica) ou o que digitar (se estiver usando a interface de linha de comando).

Se você instalou originalmente um VDA de sessão única com o instalador VDAWorkstationCoreSetup.exe, a Citrix recomenda usar esse instalador para atualizá-lo. Se você usar o instalador VDA completo do produto ou o instalador VDAWorkstationSetup.exe para atualizar o VDA, os componentes que foram originalmente excluídos podem ser instalados, a menos que você os omita/exclua expressamente da atualização.

Ao atualizar um VDA para a versão atual, ocorre uma reinicialização da máquina durante o processo de atualização. (Este requisito começou com a versão 7.17.) Isso não pode ser evitado. A atualização é retomada automaticamente após a reinicialização (a menos que você especifique /noresume na linha de comando).

Ações do banco de dados

Faça backup dos bancos de dados de site, monitoramento e log de configuração. Siga as instruções em CTX135207. Se algum problema for descoberto após a atualização, você poderá restaurar o backup.

Para obter informações sobre a atualização de versões do SQL Server que não são mais suportadas, consulte Verificação da versão do SQL Server. (Isso se refere ao SQL Server que é usado para os bancos de dados de site, monitor e log de configuração.)

O Microsoft SQL Server Express LocalDB é instalado automaticamente, para uso com o Local Host Cache. Se você precisar substituir uma versão anterior, a nova versão deve ser SQL Server Express LocalDB 2019. Para obter detalhes sobre como substituir o SQL Server Express LocalDB pela nova versão após atualizar os componentes e o site, consulte Substituir SQL Server Express LocalDB.

Certifique-se de que seu licenciamento Citrix esteja atualizado

Para uma visão abrangente do gerenciamento de licenciamento Citrix, consulte Ativar, atualizar e gerenciar licenças Citrix.

Você pode usar o instalador completo do produto para atualizar o License Server. Ou, você pode baixar e atualizar os componentes da licença separadamente. Consulte Atualizar.

Antes de atualizar, certifique-se de que a data do seu Customer Success Services / Software Maintenance / Subscription Advantage seja válida para a nova versão do produto. A data deve ser pelo menos 15/11/2021.

Certifique-se de que seu Citrix License Server seja compatível

Certifique-se de que seu Citrix License Server seja compatível com a nova versão. Existem duas maneiras de fazer isso:

  • Antes de atualizar quaisquer outros componentes Citrix, execute o instalador XenDesktopServerSetup.exe do layout ISO na máquina que contém um Delivery Controller. Se houver algum problema de incompatibilidade, o instalador o relatará com as etapas recomendadas para resolver os problemas.

  • No diretório XenDesktop Setup na mídia de instalação, execute o comando: .\LicServVerify.exe -h <license-server-fqdn> -p 27000 -v. A exibição indica se o License Server é compatível. Se o License Server for incompatível, atualize o servidor de licenças.

Faça backup de quaisquer modificações do StoreFront

Antes de iniciar uma atualização, se você modificou arquivos em C:\inetpub\wwwroot\Citrix\<StoreName>\App_Data, como default.ica e usernamepassword.tfrm, faça backup deles para cada loja. Após a atualização, você pode restaurá-los para restabelecer suas modificações.

Fechar aplicativos e consoles

Antes de iniciar uma atualização, feche todos os programas que possam potencialmente causar bloqueios de arquivo, incluindo consoles de administração e sessões PowerShell.

Reiniciar a máquina garante que quaisquer bloqueios de arquivo sejam liberados e que não haja atualizações pendentes do Windows.

Antes de iniciar uma atualização, pare e desabilite quaisquer serviços de agente de monitoramento de terceiros.

Certifique-se de ter as permissões adequadas

Além de ser um usuário de domínio, você deve ser um administrador local nas máquinas onde está atualizando os componentes do produto.

O banco de dados do site e o site podem ser atualizados automaticamente ou manualmente. Para uma atualização automática do banco de dados, as permissões do usuário do Studio devem incluir a capacidade de atualizar o esquema do banco de dados do SQL Server (por exemplo, a função de banco de dados db_securityadmin ou db_owner). Para obter detalhes, consulte Bancos de dados.

Se o usuário do Studio não tiver essas permissões, iniciar uma atualização manual do banco de dados gera scripts. O usuário do Studio executa alguns dos scripts do Studio. O administrador do banco de dados executa outros scripts, usando uma ferramenta como o SQL Server Management Studio.

Outras tarefas de preparação

  • Faça backup de modelos e atualize hipervisores, se necessário.
  • Conclua quaisquer outras tarefas de preparação ditadas pelo seu plano de continuidade de negócios.

Testes preliminares do site

Ao atualizar Delivery Controllers e um site, testes preliminares do site são executados antes do início da atualização real. Esses testes verificam:

  • O banco de dados do site pode ser acessado e foi feito backup.
  • As conexões com os serviços essenciais da Citrix estão funcionando corretamente.
  • O endereço do Citrix License Server está disponível.
  • O banco de dados de log de configuração pode ser acessado.
  • Certifique-se de ter a licença Hybrid Rights se quiser adicionar conexões de host de nuvem pública (por exemplo, AWS). Caso contrário, o teste preliminar do site pausa ou para, e uma mensagem explicativa aparece.

Após a execução dos testes, você pode visualizar um relatório dos resultados. Você pode então corrigir quaisquer problemas detectados e executar os testes novamente. A falha em executar os testes preliminares do site e, em seguida, resolver quaisquer problemas pode afetar o funcionamento do seu site.

O relatório contendo os resultados do teste é um arquivo HTML (PreliminarySiteTestResult.html) no mesmo diretório dos logs de instalação. Esse arquivo é criado se não existir. Se o arquivo existir, seu conteúdo será sobrescrito.

Executar os testes

  • Ao usar a interface gráfica do instalador para atualizar, o assistente inclui uma página onde você pode iniciar os testes e, em seguida, exibir o relatório. Depois que os testes forem executados e você tiver visualizado o relatório e resolvido quaisquer problemas encontrados, você poderá executar os testes novamente. Quando os testes forem concluídos com sucesso, clique em Next para continuar com o assistente.
  • Ao usar a interface de linha de comando para atualizar, os testes são executados automaticamente. Por padrão, se um teste falhar, a atualização não será realizada. Depois de visualizar o relatório e resolver os problemas, execute o comando novamente.

A Citrix recomenda sempre executar os testes preliminares do site e, em seguida, resolver quaisquer problemas antes de continuar a atualização do Controller e do site. O benefício potencial vale bem os poucos momentos para executar os testes. No entanto, você pode substituir esta ação recomendada.

  • Ao atualizar com a interface gráfica, você pode optar por pular os testes e continuar com a atualização.
  • Ao atualizar a partir da linha de comando, você não pode pular os testes. Por padrão, um teste de site com falha faz com que o instalador falhe, sem realizar a atualização. Geralmente, se você incluir a opção /ignore_site_test_failure, quaisquer falhas de teste são ignoradas e a atualização prossegue. (Consulte Verificação da versão do SQL Server para exceções.)

Ao atualizar vários Controllers

Quando você inicia uma atualização em um Controller e, em seguida, inicia uma atualização de outro Controller no mesmo site (antes que a primeira atualização seja concluída):

  • Se os testes preliminares do site forem concluídos no primeiro Controller, a página de testes preliminares do site não aparecerá no assistente no outro Controller.
  • Se os testes no primeiro Controller estiverem em andamento quando você iniciar a atualização no outro Controller, a página de testes do site aparecerá no assistente no outro Controller. No entanto, se os testes no primeiro Controller terminarem, apenas os resultados do teste do primeiro Controller serão retidos.

Falhas de teste não relacionadas à saúde do site

  • Se os testes preliminares do site falharem devido a memória insuficiente, disponibilize mais memória e execute os testes novamente.
  • Se você tiver permissão para atualizar, mas não para executar testes de site, os testes preliminares do site falharão. Para resolver isso, execute o instalador novamente com uma conta de usuário que tenha permissão para executar os testes.

Verificação da versão do SQL Server

Uma implantação bem-sucedida do Citrix Virtual Apps and Desktops requer uma versão suportada do Microsoft SQL Server para os bancos de dados de site, monitor e log de configuração. A atualização de uma implantação Citrix com uma versão do SQL Server que não é mais suportada pode resultar em problemas de funcionalidade, e o site não será suportado.

Para saber quais versões do SQL Server são suportadas para a versão Citrix para a qual você está atualizando, consulte o artigo Requisitos do sistema para essa versão.

Ao atualizar um Controller, o instalador Citrix verifica a versão do SQL Server atualmente instalada usada para os bancos de dados de site, monitor e log de configuração.

  • Se a verificação determinar que a versão do SQL Server atualmente instalada não é uma versão suportada na versão Citrix para a qual você está atualizando:

    • Interface gráfica: A atualização para com uma mensagem. Clique em I understand e, em seguida, clique em Cancel para fechar o instalador Citrix. (Você não pode continuar com a atualização.)
    • Interface de linha de comando: o comando falha (mesmo que você tenha incluído a opção /ignore_db_check_failure com o comando).

    Atualize a versão do SQL Server e, em seguida, inicie a atualização Citrix novamente.

  • Se a verificação não puder determinar qual versão do SQL Server está atualmente instalada, veja se sua versão atualmente instalada é suportada na versão para a qual você está atualizando (Requisitos do sistema).

    • Interface gráfica: A atualização para com uma mensagem.

      • Se a versão do SQL Server atualmente instalada for suportada, clique em I understand para fechar a mensagem e, em seguida, clique em Next para continuar com a atualização Citrix.
      • Se a versão do SQL Server atualmente instalada não for suportada, clique em I understand para fechar a mensagem e, em seguida, clique em Cancel para encerrar a atualização Citrix. Atualize seu SQL Server para uma versão suportada e, em seguida, inicie a atualização Citrix novamente.

    • Interface de linha de comando: O comando falha com uma mensagem. Depois de fechar a mensagem:

      • Se a versão do SQL Server atualmente instalada for suportada, execute o comando novamente com a opção /ignore_db_check_failure.
      • Se a versão do SQL Server atualmente instalada não for suportada, atualize seu SQL Server para uma versão suportada. Execute o comando novamente para iniciar a atualização Citrix.

Atualizando o SQL Server

Se você configurar novos servidores SQL Server e migrar o banco de dados do site, as cadeias de conexão deverão ser atualizadas.

Se o site usa atualmente o SQL Server Express para o banco de dados do site (que a Citrix instalou automaticamente durante a criação do site):

  1. Instale a versão mais recente do SQL Server Express.
  2. Desanexe o banco de dados.
  3. Anexe o banco de dados ao novo SQL Server Express.
  4. Migre as cadeias de conexão.

Para obter mais informações, consulte Configurar cadeias de conexão e a documentação do produto Microsoft SQL Server.

Substituir SQL Server Express LocalDB

O Microsoft SQL Server Express LocalDB é um recurso do SQL Server Express que o Local Host Cache usa de forma autônoma. O Local Host Cache não requer nenhum componente do SQL Server Express além do SQL Server Express LocalDB.

Ao atualizar Delivery Controllers para o Citrix Virtual Apps and Desktops versão 2203 LTSR ou versões posteriores, a versão suportada é SQL Server Express LocalDB 2019 ou SQL Server Express LocalDB 2022.

Existem duas maneiras de atualizar o SQL Server Express LocalDB:

Atualização automática

Ao atualizar Delivery Controllers, o metainstalador instala automaticamente a versão compatível mais recente do SQL Server Express LocalDB. O metainstalador não desinstala a versão antiga do LocalDB. Você deve desinstalar manualmente a versão antiga depois de confirmar que a nova versão funciona corretamente.

Verificar a nova instalação do SQL Server Express LocalDB

Antes de desinstalar a versão antiga, verifique se a nova instalação do SQL Server Express LocalDB está funcionando corretamente:

  1. Use o Prompt de Comando para navegar até a instância do SqlLocalDB:

    • Para SQL LocalDB 2014: cd C:\Program Files\Microsoft SQL Server\120\Tools\Binn
    • Para SQL LocalDB 2017: cd C:\Program Files\Microsoft SQL Server\140\Tools\Binn
    • Para SQL LocalDB 2019: cd C:\Program Files\Microsoft SQL Server\150\Tools\Binn
    • Para SQL LocalDB 2022: cd C:\Program Files\Microsoft SQL Server\160\Tools\Binn

  2. Execute SqlLocalDB i.

    Você deve ver dois arquivos: CitrixHA e MSSQLLocalDB.

Atualização manual

Pré-requisitos

  • A mídia de instalação do Citrix Virtual Apps and Desktops.
  • A ferramenta PsExec da caixa de ferramentas Windows Sysinternals.

Procedimento

  1. Conclua a atualização dos componentes, bancos de dados e site do Citrix Virtual Apps and Desktops. (Essas atualizações de banco de dados afetam os bancos de dados de site, monitoramento e log de configuração. Elas não afetam o banco de dados Local Host Cache que usa SQL Server Express LocalDB.)
  2. Faça logon no Delivery Controller, onde você gostaria de atualizar o SQL Server Express LocalDB.
  3. Baixe o PsExec da Microsoft e coloque-o em um local de fácil acesso nesse Delivery Controller, como C:\Temp.
  4. Pare o Citrix High Availability Service no Delivery Controller nos Serviços do Sistema Windows.

  5. Abra o Prompt de Comando no Delivery Controller, navegue até o local com o PsExec (exemplo, C:\Temp) e, em seguida, execute o seguinte comando para elevar o prompt de comando com a conta Network Service:

    psexec -i -u "NT AUTHORITY\NETWORKSERVICE" cmd
<!--NeedCopy-->
  6. Execute whoami para confirmar que o prompt de comando está sendo executado como a conta Network Service. Você deve obter a seguinte saída: nt authority\networkservice.

  7. Use o prompt de comando para navegar até a instância do SQL LocalDB:

    • Se estiver atualizando do SQL LocalDB 2014:

       cd "C:\Program Files\Microsoft SQL Server\120\Tools\Binn"
 <!--NeedCopy-->

    • Se estiver atualizando do SQL LocalDB 2017:

       cd "C:\Program Files\Microsoft SQL Server\140\Tools\Binn"
 <!--NeedCopy-->

    • Se estiver atualizando do SQL LocalDB 2019:

       cd "C:\Program Files\Microsoft SQL Server\150\Tools\Binn"
 <!--NeedCopy-->

  8. Pare e exclua a instância do SQL LocalDB: CitrixHA.

    SqlLocalDB stop CitrixHA

SqlLocalDB delete CitrixHA
<!--NeedCopy-->

  9. Remova os seguintes arquivos do Delivery Controller:

    C:\Windows\ServiceProfiles\NetworkService\HADatabaseName.*
C:\Windows\ServiceProfiles\NetworkService\HADatabaseName_log.*
C:\Windows\ServiceProfiles\NetworkService\HAImportDatabaseName.* (se existir)
C:\Windows\ServiceProfiles\NetworkService\HAImportDatabaseName_log.* (se existir)
<!--NeedCopy-->
  10. Desinstale seu SQL LocalDB SQL Server Express existente do Delivery Controller usando o recurso nativo do Windows para remover programas.
  11. Reinicie o Delivery Controller após a conclusão da desinstalação.
  12. Pare o Citrix High Availability Service no Delivery Controller nos Serviços do Sistema Windows.
  13. Monte a mídia de instalação do Citrix Virtual Apps and Desktops em seu Delivery Controller.

  14. Instale o SQL Server Express LocalDB 2022 como administrador no Delivery Controller.

    1. Use o arquivo sqllocaldb.msi na pasta Support > SQLLocalDB da mídia de instalação do Citrix Virtual Apps and Desktops. Por exemplo, se a mídia de instalação estiver montada na letra da unidade E, o arquivo pode ser encontrado em E:\Support\SQLLocalDB\sqllocaldb.msi. Uma reinicialização é necessária para concluir a instalação.
    2. O novo SQL LocalDB deve estar em C:\Program Files\Microsoft SQL Server\160\Tools\Binn.
  15. Inicie o Citrix High Availability Service no Delivery Controller nos Serviços do Sistema Windows.

  16. No Prompt de Comando do Delivery Controller, navegue até C:\Program Files\Microsoft SQL Server\160\Tools\Binn e execute SqlLocalDB i para confirmar que a instância CitrixHA foi criada. O CitrixHA deve ser incluído na lista de instâncias retornadas.

    Nota:

    Pode levar até 15 minutos para que o banco de dados CitrixHA seja criado após o início do Citrix High Availability Service.

  17. Certifique-se de que os arquivos do banco de dados Local Host Cache sejam criados para confirmar que o High Availability Service (broker secundário) pode assumir o controle, se necessário.

    1. No Delivery Controller, navegue até C:\Windows\ServiceProfiles\NetworkService.
    2. Verifique se HaDatabaseName.mdf e HaDatabaseName_log.ldf foram criados.
  18. Repita as etapas nos Delivery Controllers restantes.
Atualizar uma implantação
January 23, 2026
Contribuição de: 
C
January 23, 2026
Contribuição de: 
C

Neste artigo

Feedback do site | Your privacy choices footer linkSuas escolhas de privacidade | Privacidade e termos legais | Preferências de cookies | Configurações de consentimento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.