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 24, 2025
Contribuição de: 
C

Nota:

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

Introdução

Você pode atualizar determinadas implantações para versões mais recentes sem precisar primeiro configurar novas máquinas ou sites. Isso é chamado de atualização in-loco.

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

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

Para iniciar uma atualização, você executa o instalador a partir da nova versão para atualizar os componentes principais, VDAs e alguns outros componentes instalados anteriormente. Em seguida, você atualiza os bancos de dados e o site.

Você pode atualizar qualquer componente que possa ser instalado com o instalador completo do produto (e os instaladores autônomos do VDA), se houver uma versão mais recente fornecida. Para outros componentes que não estão instalados com o instalador completo do produto (como Citrix Provisioning and 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 no 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 tarefa relacionada ao grupo de provisionamento e 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 de direitos híbridos

As licenças Hybrid Rights são licenças de assinatura por prazo que são fornecidas, além da assinatura do serviço em nuvem, quando um cliente faz a transição ou troca de uma licença perpétua para uma assinatura de serviço em nuvem. Você também pode comprar um complemento Hybrid Rights com suas assinaturas de 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 torna 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 servidor de licenças para a versão mais recente.

Se você tiver acesso a uma licença de direitos híbridos sem atributo SaaS, siga estas etapas para obter acesso à nova licença de direitos híbridos com o atributo SaaS:

Nota:

  • Você recebe um e-mail com um novo código de licença. Para obter mais informações, consulte Use o código de acesso à licença.
  • Suas licenças existentes foram rescindidas. As licenças rescindidas devem ser excluídas dos servidores de licenças, seguidas pela instalação de uma nova licença. Para obter mais informações, consulte Excluindo arquivos de licença.

  1. Acesse 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 Incrementos.

    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 broker para definir a edição e o modelo e, em seguida, iniciar a atualização local. 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 à nuvem pública com as versões atuais e de serviços 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 do software.

Para usar os instaladores:

  • Para executar a interface gráfica completa do instalador do produto, faça login na máquina e, em seguida, 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 Instale usando a linha de comando.

Etapa 1: Preparar

Antes de começar um upgrade, verifique se você está pronto. Leia e conclua todas as tarefas necessárias:

Etapa 2: Atualizar o servidor de licenças

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

Se você ainda não determinou com o se o seu Servidor de Licenças é compatível com a nova versão, é essencial que você execute o instalador no Servidor de Licenças 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: Upgrade 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 com os controladores restantes. Pode haver momentos em que o site tenha capacidade reduzida porque há menos controladores disponíveis. A atualização causa apenas uma breve interrupção no estabelecimento de novas conexões de clientes 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 controlador, ele ficará inoperante durante a atualização.

Testes preliminares no local são executados no primeiro controlador, 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 ele 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, acesse 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 tarefa relacionada ao grupo de provisionamento e 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 Preparação para obter 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 Atualize 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 do administrador do 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 ativam e desativam 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 Atualize o banco de dados e o site manualmente.
  • Se você tiver uma implantação em várias zonas 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 poderá falhar.

A Citrix recomenda fortemente que você faça backup do banco de dados antes da atualização. Consulte CTX135207. Durante uma atualização do banco de dados, os serviços do produto são desativados. Durante esse período, os controladores não podem intermediar novas conexões para o site, portanto, planeje com cuidado.

Atualize o banco de dados e o site automaticamente

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

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

Atualize o banco de dados e o site manualmente

  1. Inicie o Studio recém-atualizado.
  2. Indique que você deseja atualizar o site manualmente. O assistente verifica a compatibilidade com o Servidor de Licenças e solicita confirmação.

  3. Confirme se 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 atualização da versão do produto, esse script não será gerado. Por exemplo, se o esquema do banco de dados de registro não mudar, o script UpgradeLoggingDatabase.sql não será gerado.

  4. Execute os scripts a seguir na ordem mostrada.

    • DisableServices.ps1: O usuário do Studio executa esse script do PowerShell em um controlador para desativar os serviços do produto.
    • UpgradeSiteDatabase.sql: O administrador do banco de dados executa esse script SQL no servidor que contém o banco de dados do site
    • UpgradeMonitorDatabase.sql: O administrador do banco de dados executa esse script SQL no servidor que contém o banco de dados Monitor.
    • UpgradeLoggingDatabase.sql: O administrador do banco de dados executa esse script SQL no servidor que contém o banco de dados do Configuration Logging. Execute esse script somente se esse banco de dados mudar (por exemplo, depois de aplicar um hotfix).
    • EnableServices.ps1: O usuário do Studio executa esse script do PowerShell em um controlador para habilitar os serviços do produto.

    Depois que a atualização do banco de dados for concluída e os serviços do produto forem habilitados, o Studio testa automaticamente o ambiente e a configuração e, em seguida, gera um relatório HTML. Se forem identificados problemas, você poderá restaurar o backup do banco de dados. Depois de resolver os problemas, você pode atualizar o banco de dados novamente.

  5. Depois de concluir as tarefas da lista de verificação, clique em Concluir atualização.

Etapa 10: Atualizar os Delivery Controllers restantes

No Studio recém-atualizado, selecione Citrix Studio site-name no painel de navegação. Na guia Tarefas comuns , selecione Atualizar os controladores de entrega restantes.

Nota:

Para disponibilizar o Upgrade restante dos Delivery Controllers , crie pelo menos um catálogo de máquinas e um grupo de entrega para o site.

Depois de 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 criar um ID de zona, caso ele não exista.

Etapa 11: atualizar os VDAs

Importante:

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

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

Se você usou o Machine Creation Services e uma imagem mestre para criar máquinas, acesse seu host e atualize o VDA na imagem mestre. Você pode usar qualquer um dos instaladores de 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 o SQL Server Express LocalDB.

Atualização do Dbschema

Quando você atualiza 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 Dbschema

Definição dos termos:

  • Site: Site Datastore. A atualização do Dbschema é feita no Site Datastore.
  • Monitor: Monitore o Datastore. A atualização do Dbschema é feita no Monitor Datastore.
  • Configuração: Tabela de configuração. A versão do Desktop Studio, as informações de licenciamento ou ambas são atualizadas na tabela de configuração.
  • Registro: Registrando o Datastore. A atualização do Dbschema é feita no Logging Datastore.

Atualize os VDAs para 2203 ou posterior

Se o componente Personal vDisk (PvD) já tiver sido instalado em um VDA, esse VDA não poderá 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 do VDA, o PvD era uma opção na página Additional Components .
  • Na linha de comando, a opção /baseimage instalou o PvD. Se você especificou essa opção ou usou um script que continha essa opção, o PvD foi instalado.

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

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

O que fazer

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

Se o VDA tiver o PvD instalado:

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

Se você quiser continuar usando o PvD em seus computadores Windows 10 (1607 e anteriores, sem atualizações), o VDA 7.15 LTSR é a versão mais recente com suporte.

Nota:

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

A Citrix excluiu o Personal vDisk (PvD) do XenApp e do XenDesktop 7.6 LTSR, anunciados 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 do XenDesktop 7.15 LTSR. No entanto, para ajudar os clientes com implantações PvD existentes no Windows 7 a migrarem 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 do 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 do PvD para Windows 7 após 14 de janeiro de 2020 tornará os sites LTSR não compatíveis. Além disso, o PvD para Windows 10 continua excluído do 7.15 LTSR. Portanto, os clientes não devem usá-lo em seus sites 7.15 LTSR.

Remova PvD, AppDisks e hosts não suportados

As seguintes tecnologias e tipos de host não são suportados nas implantações da versão atual do Citrix Virtual Apps and Desktops 7:

  • Personal vDisks (PvD) para armazenar dados ao lado das VMs dos usuários em catálogos. O recurso da camada de personalização do usuário agora lida com a persistência do usuário.
  • AppDisks para gerenciar aplicativos usados em grupos de entrega.
  • Tipos de host: Azure Classic, CloudPlatform (o produto Citrix original).
    • Para os tipos de host suportados nesta versão, consulte Requisitos do sistema.
    • Para obter informações sobre formas alternativas de continuar usando o ARM e a AWS, consulte CTX270373.

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 depois de remover itens que usam essas tecnologias. Se sua implantação atual usa conexões de hospedagem em nuvem pública (por exemplo, AWS), certifique-se de ter uma Licença de Direitos Híbridos antes de fazer o upgrade. Quando o instalador detecta uma ou mais das tecnologias não suportadas ou conexões de host sem a Licença de Direitos Híbridos, a atualização é pausada ou interrompida e uma mensagem explicativa é exibida. Os registros 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, os 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 compatível posterior), 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 Atualizando VDAs que têm 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 PvD. Isso afeta catálogos e grupos de entrega.

Para remover o 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. Do Studio, exclua todos os catálogos contendo máquinas que usam PvD.

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

Se você planeja usar o App Layering em vez do PvD, consulte Migrando o PvD para o App Layering para obter informações sobre a movimentação de dados.

Remover AppDisks

Uma atualização de implantação não pode continuar até que você remova os AppDisks de todos os grupos de entrega 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 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 de implantação não detecta se os VDAs têm os componentes AppDisk ou PvD instalados. No entanto, os instaladores de VDA o fazem. Para obter detalhes, consulte VDAs que têm 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 compatível posterior) não pode continuar se o site tiver conexões com tipos de host não suportados, como Citrix CloudPlatform ou Microsoft Azure Classic. Conclua as tarefas a seguir antes de tentar uma atualização.

Do estúdio:

VDAs que têm 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 instalar o novo VDA. Nesta versão, você será perguntado se 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 de VDA, a página Additional Components continha a opção Citrix AppDisk/ Personal vDisk . A 7.15 LTSR e as versões 7.x anteriores habilitaram essa opção por padrão. Portanto, se você aceitou os padrões (ou ativou explicitamente a opção em qualquer versão que a oferecesse), esse componente foi instalado.
  • CLI: especificar a opção /baseimage instalou o componente.

O que fazer

Se o instalador do VDA não detectar os componentes AppDisks ou PvD no VDA atualmente instalado, a atualização prosseguirá 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 serão removidos automaticamente e a atualização continuará.

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

    • /remove_appdisk_ack
    • /remove_pvd_ack

Limitações

As seguintes limitações se aplicam aos upgrades:

  • Instalação seletiva de componentes: Se você instalar ou atualizar algum componente para a nova versão, mas optar por não atualizar outros componentes (em máquinas diferentes) que precisem de atualização, o Studio o lembra. 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 em que o Studio está instalado. O Studio não permitirá que você continue gerenciando 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 de lançamento antecipado ou prévia de tecnologia: Você não pode atualizar de uma versão de lançamento antecipado, prévia de tecnologia ou versão prévia.

  • Componentes em sistemas operacionais anteriores: Você não pode instalar os VDAs atuais em sistemas operacionais que não são mais suportados pela Microsoft ou pela 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 nem 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 fazer o upgrade, a Citrix recomenda que você atualize todos os componentes e VDAs para poder acessar todos os recursos novos e aprimorados em sua edição e versão.

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

Em alguns ambientes, talvez você não consiga 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 padrão da versão mínima 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 do VDA e níveis funcionais.

Vários sites com versões diferentes

Quando seu ambiente contém sites com diferentes versões do 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 do produto. Para obter detalhes, consulte a documentação do StoreFront .

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

Sistemas operacionais anteriores

Digamos que você tenha instalado uma versão anterior de um componente em uma máquina que estava executando uma versão compatível do sistema operacional (SO). Agora, você deseja usar uma versão mais recente do componente, mas esse sistema operacional não é mais compatível com a versão atual do componente.

Por exemplo, suponha que você tenha instalado um servidor VDA em uma máquina Windows Server 2008 R2. Agora você quer atualizar esse VDA para a versão atual, mas o Windows Server 2008 R2 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 “Não pode ser instalado neste sistema operacional”.

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

Siga os links para saber quais sistemas operacionais são compatíveis:

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. Indica a última versão válida do componente suportada por cada sistema operacional listado e a versão do 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 Component/feature Última versão válida A instalação/atualização não foi 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   Versões do Windows 10 anteriores a 1607 VDA 7.15 LTSR 7.16   Versão Windows 10 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 VDI do servidor 7,15 LTSR 7,16

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

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

O que você pode fazer

Você tem escolhas. Você pode:

Continue com o sistema operacional atual

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

  • Continue usando a versão do componente instalado.
  • Faça o download da versão válida mais recente do componente e atualize o componente para essa versão. (Isso pressupõe que a versão mais recente do componente válido ainda não esteja instalada.)

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

Recrie a imagem ou atualize a máquina

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

  • Depois de tirar a máquina de serviço (ativando o modo de manutenção e permitindo que todas as sessões sejam fechadas), você pode recriá-la para uma versão compatível do sistema operacional Windows e, em seguida, instalar a versão mais recente do componente.
  • Para atualizar o sistema operacional sem refazer a imagem, desinstale o software Citrix antes de atualizar o sistema operacional (isso inclui atualizações internas para seu sistema operacional). Por exemplo, do Windows 10 versão 1903 ao Windows 10 versão 1909). Caso contrário, o software Citrix não será suportado. Em seguida, instale o novo componente.
  • Para atualizar o sistema operacional em uma máquina VDA sem refazer a imagem, você deve primeiro instalar a versão do VDA compatível com o sistema operacional para o qual você está atualizando ou atualizar o VDA após atualizar o sistema operacional. Caso contrário, o software Citrix não será suportado. Você pode atualizar para as seguintes versões mínimas do sistema operacional ao realizar uma atualização no local sem desinstalar o VDA:
  • Se a versão do Windows para a qual você planeja atualizar não estiver alinhada com a diretriz mencionada acima, desinstale o VDA antes de atualizar o sistema operacional e, em seguida, instale uma versão compatível do VDA após a conclusão da atualização do sistema operacional.

Adicione novas máquinas e, em seguida, remova as máquinas antigas

Esse método é viável se você precisar atualizar o sistema operacional em máquinas contendo um Delivery Controller ou outro componente principal.

A Citrix recomenda que todos os controladores em um site tenham o mesmo sistema operacional. A sequência de atualização a seguir minimiza o intervalo em que controladores diferentes têm sistemas operacionais diferentes.

  1. Faça um instantâneo 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 compatíveis. Por exemplo, instale um controlador em duas máquinas Windows Server 2016.
  3. Adicione os novos Controllers ao site.
  4. Remova os Controllers que estão sendo executados em sistemas operacionais que não são válidos para a versão atual. Por exemplo, remova dois Controllers em duas máquinas Windows Server 2008 R2. Siga as recomendações para remover os Controladores em Delivery Controllers.

Preparação

Antes de iniciar um upgrade, revise as informações a seguir e conclua as tarefas necessárias.

Nota:

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

Escolha um instalador e uma interface

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

Para obter mais informações, consulte Installers.

Especificações 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 de VDA completo do produto ou o instalador VDAWorkstationSetup.exe para atualizar o VDA, os componentes que foram originalmente excluídos poderão ser instalados, a menos que você os omita ou 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. (Esse 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 registro do site, do monitoramento e da 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 de versão do SQL Server. (Isso se refere ao SQL Server que é usado para os bancos de dados de registro do site, do monitor e da 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 deverá ser o SQL Server Express LocalDB 2019. Para obter detalhes sobre como substituir o SQL Server Express LocalDB pela nova versão depois de atualizar os componentes e o site, consulte Substituir o SQL Server Express LocalDB.

Certifique-se de que seu licenciamento Citrix esteja atualizado

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

Você pode usar o instalador completo do produto para atualizar o Servidor de Licenças. Ou você pode baixar e atualizar os componentes da licença separadamente. Veja Upgrade.

Antes de fazer o upgrade, certifique-se de que a data do 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.

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. Há duas maneiras de fazer isso:

  • Antes de atualizar qualquer outro componente Citrix, execute o instalador XenDesktopServerSetup.exe a partir do layout ISO na máquina que contém um Delivery Controller. Se houver algum problema de incompatibilidade, o instalador o reporta 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. O display indica se o Servidor de Licenças é compatível. Se o Servidor de Licenças for incompatível, atualize o servidor de licenças.

Faça backup de todas as modificações do StoreFront

Antes de iniciar uma atualização, se você tiver feito modificações nos arquivos em C:\inetpub\wwwroot\Citrix\&#060; StoreName&#062;\ 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.

Feche aplicativos e consoles

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

Reiniciar a máquina garante que todos os bloqueios de arquivos sejam eliminados e que não haja atualizações pendentes do Windows.

Antes de iniciar uma atualização, interrompa e desative qualquer serviço de agente de monitoramento de terceiros.

Verifique se você tem as permissões adequadas

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

O banco de dados do site e o site podem ser atualizados automática 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 Databases.

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 todas as outras tarefas de preparação ditadas pelo seu plano de continuidade de negócios.

Testes preliminares no local

Quando você atualiza 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 registro de configuração pode ser acessado
  • Certifique-se de ter uma Licença de Direitos Híbridos se quiser adicionar conexões de host em nuvem pública (por exemplo, AWS). Caso contrário, o teste preliminar do site será pausado ou interrompido e uma mensagem explicativa será exibida.

Depois que os testes forem executados, você poderá ver um relatório dos resultados. Em seguida, você pode corrigir os 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 site.

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

Execute os testes

  • Quando você usa a interface gráfica do instalador para atualizar, o assistente inclui uma página na qual você pode iniciar os testes e depois exibir o relatório. Depois que os testes forem executados e você tiver visualizado o relatório e resolvido os problemas encontrados, você poderá executar novamente os testes. Quando os testes forem concluídos com êxito, clique em Avançar para continuar com o assistente.
  • Quando você usa 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á executada. Depois de visualizar o relatório e resolver problemas, execute o comando novamente.

A Citrix recomenda sempre executar os testes preliminares do local e, em seguida, resolver quaisquer problemas antes de continuar com o controlador e a atualização do site. O benefício potencial vale a pena dedicar alguns minutos para realizar os testes. No entanto, você pode ignorar essa 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, uma falha no teste do site faz com que o instalador falhe, sem realizar a atualização. Na maioria dos casos, se você incluir a opção /ignore_site_test_failure , qualquer falha no teste será ignorada e a atualização continuará. (Consulte Verificação da versão do SQL Server para ver as exceções.)

Ao atualizar vários controladores

Quando você inicia uma atualização em um Controller e, em seguida, inicia um upgrade de outro Controller no mesmo site (antes da conclusão da primeira atualização):

  • Se os testes preliminares do site tiverem sido concluídos no primeiro Controlador, a página de testes preliminares do site não aparecerá no assistente do outro Controlador.
  • 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 do outro Controller. No entanto, se os testes no primeiro Controlador terminarem, somente os resultados do primeiro Controlador serão retidos.

Falhas de teste não relacionadas à integridade do site

  • Se os testes preliminares do local falharem devido à memória insuficiente, disponibilize mais memória e execute novamente os testes.
  • Se você tiver permissão para atualizar, mas não executar testes do site, os testes preliminares do site falharão. Para resolver isso, execute novamente o instalador 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 compatível do Microsoft SQL Server para os bancos de dados de registro de sites, monitores e configurações. Atualizar 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 terá suporte.

Para saber quais versões do SQL Server são compatíveis com a versão Citrix para a qual você está atualizando, consulte o artigo System requirements dessa versão.

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

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

    • Interface gráfica: a atualização é interrompida com uma mensagem. Clique em Eu entendo e, em seguida, clique em Cancelar para fechar o instalador Citrix. (Você não pode continuar com a atualização.)
    • Interface de linha de comando: o comando falha (mesmo se você incluiu 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 puder determinar qual versão do SQL Server está instalada atualmente, veja se sua versão atualmente instalada é compatível com a 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 atualmente instalada do SQL Server for suportada, clique em Eu entendo para fechar a mensagem e, em seguida, clique em Avançar para continuar com a atualização do Citrix.
      • Se a versão atualmente instalada do SQL Server não for suportada, clique em Eu entendo para fechar a mensagem e, em seguida, clique em Cancelar para finalizar a atualização do Citrix. Atualize seu SQL Server para uma versão compatível e, em seguida, inicie a atualização do Citrix novamente.

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

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

Atualizando o SQL Server

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

Se o site atualmente usa 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 cadeias de conexão.

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

Substitua o SQL Server Express LocalDB

O Microsoft SQL Server Express LocalDB é um recurso do SQL Server Express que o Local Host Cache usa de forma independente. O cache de host local não exige nenhum componente do SQL Server Express além do SQL Server Express LocalDB.

Se você instalou uma versão do Delivery Controller anterior à 1912 e depois atualizou sua implantação para a versão 1912 ou posterior, a Citrix não atualiza automaticamente a versão do SQL Server Express LocalDB. Por que não? Porque você pode ter componentes não Citrix que dependem do SQL Server Express LocalDB. Se você tiver componentes que não sejam da Citrix que estejam usando o SQL Server Express LocalDB, certifique-se de que a atualização do SQL Server Express LocalDB não interrompa esses componentes. Para atualizar (substituir) a versão do SQL Server Express LocalDB, siga as orientações nesta seção.

  • Ao atualizar os Delivery Controllers para as versões 2402 LTSR ou posteriores do Citrix Virtual Apps and Desktops: A versão suportada é o SQL Server Express LocalDB 2022.

    Nota:

    As versões 2017, 2019 e 2022 do SQL Server Express LocalDB são todas compatíveis entre si. Portanto, não é obrigatório atualizar o SQL Server Express LocalDB para que o LHC funcione.

O que você precisa:

  • A mídia de instalação do Citrix Virtual Apps and Desktops contendo uma cópia do Microsoft SQL Server Express LocalDB 2022.
  • A ferramenta PsExec da caixa de ferramentas Windows Sysinternals que você pode baixar da Microsoft. Consulte o documento da Microsoft PsExec v2.43.

Procedimento:

  1. Conclua a atualização de seus componentes, bancos de dados e site do Citrix Virtual Apps and Desktops. (Essas atualizações do banco de dados afetam os bancos de dados do site, do monitoramento e do registro de configurações. Eles não afetam o banco de dados do Local Host Cache que usa o SQL Server Express LocalDB.)
  2. Faça login no Delivery Controller que está sendo usado para recriar o banco de dados do LHC.
  3. Nesse Delivery Controller, baixe PsExec da Microsoft e coloque-o em C:\Temp.
  4. Pare o Citrix High Availability Service.

  5. Abra o prompt de comando, navegue até C:\Tempe, em seguida, execute o seguinte comando para elevar a conta do prompt de comando com serviço de rede:

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

  7. Use o prompt de comando para navegar até a instância 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 SQL LocalDB: CitrixHA.

      SqlLocalDB stop CitrixHA

  SqlLocalDB delete CitrixHA
<!--NeedCopy-->

  9. Remova os arquivos relacionados em C:\Windows\ServiceProfiles\NEtworkService.

      HADatabaseName.*
  HADatabaseName_log.*
  HAImportDatabaseName.* (if exists)
  HAImportDatabaseName_log.* (if exists)
<!--NeedCopy-->
  10. Desinstale seu SQL LocalDB SQL Server Express existente do servidor usando o recurso do Windows para remover programas.
  11. Instale o SQL Server Express LocalDB 2022. Na pasta Support > SQLLocalDB na mídia de instalação do Citrix Virtual Apps and Desktops, clique duas vezes em sqllocaldb.msi. Uma reinicialização pode ser solicitada para concluir a instalação. O novo SQL LocalDB reside em C:\Program Files\ Microsoft SQL Server\ 160\Tools\ Binn.
  12. Inicie o Citrix High Availability Service no Delivery Controller onde você desinstalou a versão antiga do SQL LocalDB.
  13. No prompt de comando, execute SQLLocalDB i para confirmar se CitrixHA foi criado novamente ou não.
  14. Repita as etapas nos controladores de entrega restantes.

  15. Certifique-se de que o banco de dados do Local Host Cache seja criado em cada Delivery Controller. Isso confirma que o Serviço de Alta Disponibilidade (corretor secundário) pode assumir o controle, se necessário.

    1. No servidor do controlador, navegue até C:\Windows\ServiceProfiles\NetworkService.
    2. Verifique se HadatabaseName.mdf e HadatabaseName_log.ldf foram criados.
Atualizar uma implantação
January 24, 2025
Contribuição de: 
C
January 24, 2025
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.