Preparação

Last published : Nov 13, 2026
Antes de iniciar uma atualização, revise as seguintes informações e conclua as tarefas necessárias.
Observação:
Embora a atualização de VDAs ocorra mais tarde no procedimento 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.
Related information
Atualizar uma implantação

Lista de verificação pré-atualização

Conclua as seguintes tarefas antes de iniciar a atualização. Cada item se vincula aos seus detalhes:

Escolha um instalador e interface

Use o instalador completo do produto a partir da ISO do produto para atualizar componentes. Você pode atualizar 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).
  • Instalar/atualizar componentes principais usando a interface gráfica
  • Instalar/atualizar componentes principais usando a linha de comando
  • Instalar/atualizar VDAs usando a interface gráfica
  • Instalar/atualizar VDAs usando a linha de comando
Para sistemas operacionais de sessão única, quatro instaladores diferentes estão disponíveis. A Citrix recomenda usar um tipo de instalador consistente durante todo o ciclo de vida de um VDA Citrix — incluindo instalação, atualização e desinstalação. Para obter mais informações, consulte Melhores práticas para usar instaladores VDA de sessão única
Ao atualizar um VDA para a versão atual, uma reinicialização da máquina ocorre durante o processo de atualização. (Este requisito começou com a versão 7.17.) A reinicialização não pode ser evitada. A atualização é retomada automaticamente após a reinicialização (a menos que você especifique /noresume na linha de comando).

Verifique seu licenciamento Citrix

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 de 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 2021.11.15.

Verificar a compatibilidade do License Server

Certifique-se de que seu Citrix License Server seja compatível com a nova versão. Existem duas maneiras de verificar a compatibilidade:
  • 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 problemas de incompatibilidade, o instalador os relatará com as etapas recomendadas para resolvê-los.
  • No diretório XenDesktop Setup da 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.

Atualizar licenças Hybrid Rights

As licenças de Direitos Híbridos são licenças de assinatura baseadas em termo 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 de Direitos Híbridos com suas assinaturas DaaS.

Licença Hybrid Rights com um atributo SaaS

Ao atualizar para o Citrix Virtual Apps and Desktops™ LTSR 2203 e posterior, você se torna elegível para recursos não disponíveis com o 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. Se você ignorar este pré-requisito, a atualização bloqueará as atualizações e a criação de sites do Citrix Virtual Apps and Desktops.

Licença Hybrid Rights sem atributo SaaS

Siga estas etapas para obter a nova licença Hybrid Rights com um atributo SaaS:
Observação:
  • Você recebe 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 Servidores de Licenças, seguidas pela instalação de novas licenças. Para obter mais informações, consulte Excluir arquivos de licença.
  1. Vá para o portal citrix.com Gerenciar Licenças e baixe o novo arquivo de licença Hybrid Rights com os direitos de provisionamento de nuvem ativados (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 Servidor de Licenças. 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 SDK do Broker PowerShell.
Para obter mais informações sobre o suporte à nuvem pública com o Citrix Virtual Apps and Desktops Current Releases e Long Term Service Releases, consulte CTX270373.

Fazer backup dos bancos de dados

Faça backup dos bancos de dados de site, monitoramento e registro 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 como atualizar versões do SQL Server que não são mais suportadas, consulte Verificar a versão do SQL Server. (A verificação da versão do SQL Server refere-se ao SQL Server que é usado para os bancos de dados de site, monitor e registro 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 o SQL Server Express LocalDB 2019. Para obter detalhes sobre como substituir o SQL Server Express LocalDB pela nova versão após a atualização dos componentes e do site, consulte Substituir SQL Server Express LocalDB.

Verificar a versão do SQL Server

Uma implantação bem-sucedida do Citrix Virtual Apps and Desktops requer uma versão compatível do Microsoft SQL Server para os bancos de dados de site, monitoramento e registro de configuração. Fazer o upgrade de uma implantação Citrix com uma versão do SQL Server que não é mais compatível pode resultar em problemas de funcionalidade, e o site não será compatível.
Para saber quais versões do SQL Server são suportadas para a versão do Citrix para a qual você está atualizando, consulte o artigo Requisitos do sistema para essa versão.
Ao atualizar um Controller, o instalador do Citrix verifica a versão do SQL Server atualmente instalada usada para os bancos de dados de site, monitoramento e registro 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 do Citrix para a qual você está atualizando:
    • Interface gráfica: A atualização é interrompida com uma mensagem. Clique em Entendi e depois em Cancelar para fechar o instalador do 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 do Citrix novamente.
  • Se a verificação não conseguir 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 é interrompida com uma mensagem.
      • Se a versão do SQL Server atualmente instalada for suportada, clique em Entendi para fechar a mensagem e, em seguida, clique em Avançar para continuar com a atualização do Citrix.
      • Se a versão do SQL Server atualmente instalada não for suportada, clique em Entendi para fechar a mensagem e, em seguida, clique em Cancelar para encerrar a atualização do Citrix. Atualize seu SQL Server para uma versão suportada e, em seguida, inicie a atualização do Citrix novamente.
    • Interface de linha de comando: O comando falha com uma mensagem. Após 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 do Citrix.

Atualizar 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 atualmente usa SQL Server Express para o banco de dados do site (que o 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 Configurando cadeias de conexão e a documentação do produto Microsoft SQL Server.

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.

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).
    • Para tipos de host suportados nesta versão, consulte Requisitos do sistema.
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 suportadas posteriores) 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 uma Licença de Direitos Híbridos antes de atualizar. Quando o instalador detecta uma ou mais das tecnologias não suportadas ou conexões de host sem uma Licença de Direitos Híbridos, a atualização é pausada ou interrompida, 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 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 Remover componentes PvD ou AppDisks de VDAs.

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 PvD. Essa remoção afeta catálogos e Delivery Groups.
Para remover PvD de grupos e catálogos:
  1. No Studio, se um Grupo de Entrega 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 do VDA detectam. Para obter detalhes, consulte Remover componentes PvD ou AppDisks de VDAs.
Se você planeja usar o App Layering em vez de PvD, consulte Migrando 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 Grupos de Entrega que os utilizam e, em seguida, remova os próprios AppDisks.
  1. Selecione Grupos de Entrega no painel de navegação do Studio.
  2. Selecione um grupo e clique em Gerenciar AppDisks no painel Ação.
  3. Clique na ação que remove o AppDisk do grupo.
  4. Repita as etapas 2 e 3 para cada Grupo de Entrega 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 do VDA detectam. Para obter detalhes, consulte Remover componentes PvD ou AppDisks de VDAs.

Remover itens de host não suportados

Uma atualização de implantação para a versão 2006 (ou versão posterior compatível) 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:
  • Exclua todas as conexões para hosts não suportados.
  • Se um Delivery Group contiver máquinas de um catálogo criado com uma imagem mestre de um host não suportado, remova essas máquinas do grupo.
  • Exclua todos os catálogos que foram criados usando uma imagem mestre de um host não suportado.

Remover componentes PvD ou AppDisks de VDAs

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. Essa restrição se aplica mesmo que você nunca tenha usado PvD ou AppDisks.
Observação:
Ao atualizar para a versão 1912, você precisava desinstalar o VDA atual e, em seguida, instalar o novo VDA. Nesta versão, é perguntado se você deseja que a Citrix remova o componente e 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 do VDA, a página Componentes Adicionais continha a opção Citrix AppDisk / Personal vDisk. As versões 7.15 LTSR e anteriores 7.x habilitavam essa 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 instalou o componente.

Remover os componentes

Se o instalador do 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 é pausada. 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 no comando, inclua as seguintes opções no comando:
    • /remove_appdisk_ack
    • /remove_pvd_ack

Continuar usando PvD em versões anteriores do Windows

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.
Observação:
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 existentes de PvD no Windows 7 a migrar para a tecnologia Citrix App Layering, a Citrix decidiu fornecer suporte por tempo limitado para implantações de PvD para desktops Windows 7 por meio das Atualizações Cumulativas (CUs) do XenApp e XenDesktop 7.15 LTSR até Jan 14, 2020. O componente PvD será removido das CUs do LTSR e não será suportado após Jan 14, 2020. Além disso, o uso de PvD para Windows 7 após Jan 14, 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.

Feche aplicativos e consoles

Antes de iniciar uma atualização, feche todos os programas que possam causar bloqueios de arquivo, incluindo consoles de administração e sessões do 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 desative quaisquer serviços de agente de monitoramento de terceiros.

Verificar suas permissões

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 gerará scripts. O usuário do Studio executa alguns dos scripts a partir do Studio. O administrador do banco de dados executa outros scripts, usando uma ferramenta como o SQL Server Management Studio.

Executar testes preliminares do site

Ao atualizar os Delivery Controllers e um site, os 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 de Direitos Híbridos se quiser adicionar conexões de host de nuvem pública (por exemplo, AWS). Caso contrário, o teste preliminar do site será pausado ou interrompido, e uma mensagem explicativa aparecerá.
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 fazer o upgrade, 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 êxito, clique em Avançar para continuar com o assistente.
  • Ao usar a interface de linha de comando para fazer o upgrade, os testes são executados automaticamente. Por padrão, se um teste falhar, o upgrade não será realizado. 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 com o upgrade 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 fazer o upgrade com a interface gráfica, você pode optar por pular os testes e continuar com o upgrade.
  • Ao atualizar pela 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 Verificar a versão do SQL Server para exceções.)

Atualizar vários Controllers

Quando você inicia um upgrade em um Controller e, em seguida, inicia um upgrade de outro Controller no mesmo site (antes que o primeiro upgrade seja concluído):
  • 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 o upgrade 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 dos testes do primeiro Controller serão mantidos.

Resolver falhas de teste não relacionadas à integridade do site

  • Se os testes preliminares do site falharem devido a memória insuficiente, disponibilize mais memória e, em seguida, execute os testes novamente.
  • Se você tiver permissão para fazer o upgrade, 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.

Concluir outras tarefas de preparação

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