Citrix Virtual Apps and Desktops

Atualizar uma implantação

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 local.

Para iniciar uma atualização, execute o instalador da nova versão para atualizar componentes principais instalados anteriormente, VDAs e certos outros componentes. Depois 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 são instalados com o instalador completo do produto (como o Citrix Provisioning and Profile Management), consulte a documentação do 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. Procedimento de atualização contém detalhes de cada etapa no diagrama.

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

Observação:

Para evitar falhas, você deve atualizar todos os Controladores de Entrega e o banco de dados antes de executar qualquer tarefa relacionada 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 de direitos híbridos

Se você atualizar do Citrix Virtual Apps and Desktops LTSR 1912 para o LTSR 2203 e tiver direito a novas licenças de Direitos Híbridos com uma conexão Azure, AWS ou Google Cloud, siga estas etapas. Caso contrário, o meta instalador 2203 bloqueará sua atualização:

Observação:

  • Você recebe um e-mail com um novo código de licença. Para mais informações, veja Use o código de acesso à licença.
  • Suas licenças existentes foram rescindidas. Licenças revogadas devem ser excluídas dos Servidores de Licenças e, em seguida, uma nova licença deve ser instalada. Para obter mais informações, consulte Excluindo arquivos de licença.
  1. Acesse o portal Gerenciar licenças citrix.com e baixe o novo arquivo de licença de direitos híbridos com direitos de provisionamento em nuvem habilitados (atributo SaaS). Para 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 License Server. Para 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 versões 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 do software.

Para usar os instaladores:

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

Etapa 1: Preparar

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

Etapa 2: Atualizar o servidor de licença

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 Servidor de Licença é compatível com a nova versão, é essencial que você execute o instalador no Servidor de Licença 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 Estender implantação .
  • 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 Diretor

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 software do servidor Citrix Provisioning e do dispositivo de destino, consulte a documentação do produto Citrix Provisioning .

Etapa 6: Atualize metade dos controladores de entrega

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

Deixar metade dos Controladores ativos permite que os usuários acessem o site. Os VDAs podem se registrar com os demais Controladores. 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 Controladores atualizados não podem processar solicitações até que todo o site seja atualizado.

Se o 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 mais detalhes, veja Testes preliminares do site.

Etapa 7: Atualizar o Studio

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

Etapa 8: Reinicie o Studio

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

Etapa 9: Atualizar banco de dados e site

Observação:

Para evitar falhas, você deve atualizar todos os Controladores de Entrega e o banco de dados antes de executar qualquer tarefa relacionada 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 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 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 Atualize o banco de dados e o site manualmente.
  • Se você tiver uma implantação multizona e quiser atualizar o banco de dados e o site automaticamente, a Citrix recomenda que a atualização do dbschema seja executada 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 de atualizar. Veja CTX135207. Durante uma atualização de banco de dados, os serviços do produto são desabilitados. Durante esse período, os Controladores não podem intermediar novas conexões para o site, então planeje com cuidado.

Atualizar 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 prossegue.

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 do License Server 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 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 do PowerShell em um controlador para desabilitar 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 Monitor.
    • UpgradeLoggingDatabase.sql: O administrador do banco de dados executa este script SQL no servidor que contém o banco de dados de registro de configuração. Execute este script somente se este banco de dados for alterado (por exemplo, após aplicar um hotfix).
    • EnableServices.ps1: O usuário do Studio executa este script do PowerShell em um controlador para habilitar serviços de produto.

    Após a conclusão da atualização do banco de dados e a ativaçã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 forem identificados problemas, você pode restaurar o backup do banco de dados. Depois de resolver os problemas, você pode atualizar o banco de dados novamente.

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

Etapa 10: Atualizar os controladores de entrega restantes

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

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 Controlador no site ou para criar uma ID de zona, caso ela não exista.

Etapa 11: Atualizar 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 contenham VDAs.

Se você usou o Machine Creation Services e uma imagem mestre para criar máquinas, vá até 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ções sobre atualização.

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

Etapa 13: Após a atualização

Após concluir uma atualização, você pode testar o site recém-atualizado. No Studio, selecione Citrix Studio site-name no painel de navegação. Na aba Tarefas Comuns , selecione Site de Teste. Esses testes são executados automaticamente após a atualização do banco de dados, mas você pode executá-los novamente a qualquer momento.

Os testes podem falhar para um Controlador no Windows Server 2016 quando um Microsoft SQL Server Express local é usado para o banco de dados do site, se o Serviço do Navegador do SQL Server não for iniciado. Para evitar isso:

  • Habilite o SQL Server Browser Service (se necessário) e inicie-o.
  • Reinicie o serviço do SQL Server (SQLEXPRESS).

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 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 Dbschema

Definição dos termos:

  • Site: Armazenamento de dados do site. A atualização do Dbschema é feita no Site Datastore.
  • Monitor: Monitorar armazenamento de dados. A atualização do Dbschema é feita no Monitor Datastore.
  • Config: 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: Armazenamento de dados de registro. A atualização do Dbschema é feita no Logging Datastore.

Atualize VDAs para 2203 ou posterior

Se o componente Personal vDisk (PvD) 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 depois instalar o novo VDA.

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

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

  • Na interface gráfica do instalador do VDA, PvD era uma opção na página Componentes Adicionais . As versões 7.15 LTSR e 7.x anteriores habilitaram essa opção por padrão. Então, se você aceitou os padrões (ou habilitou explicitamente a opção em qualquer versão), o PvD foi instalado.
  • Na linha de comando, a opção /baseimage instalou 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 o seu VDA tem o PvD instalado, execute o instalador do novo VDA (2203 ou posterior) na máquina ou 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 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ê quiser continuar usando o PvD em suas máquinas com Windows 10 (1607 e anteriores, sem atualizações), o VDA 7.15 LTSR é a versão mais recente com suporte.

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 do XenDesktop 7.6 LTSR, 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 do XenDesktop 7.15 LTSR. No entanto, para ajudar os clientes com implantações de 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 XenDesktop 7.15 LTSR até 14 de janeiro de 2020. O componente PvD será removido das CUs do LTSR e não terá mais suporte após 14 de janeiro de 2020. Além disso, o uso do PvD no 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 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:

  • vDisks pessoais (PvD) para armazenar dados próximos às 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 original da Citrix).
    • Para tipos de host suportados nesta versão, consulte Requisitos do sistema.
    • Para obter informações sobre maneiras alternativas de continuar usando ARM e AWS, consulte CTX270373.

Se sua implantação atual usar PvDs ou AppDisks, ou tiver conexões com tipos de host não suportados (por exemplo, Microsoft Azure Classic), você poderá atualizar para a versão 2006 (ou versões suportadas posteriores) somente após remover 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 tecnologias não suportadas ou conexões de host sem Licença de Direitos Híbridos, a atualização é pausada ou interrompida, e uma mensagem explicativa é exibida. 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 sem suporte.

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 com suporte), 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 possuem componentes PvD ou AppDisks.

Remover PvD

Uma atualização de implantação não poderá 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 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 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 do 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 Migrando o PvD para o App Layering para obter informações sobre como mover dados.

Remover AppDisks

Uma atualização de implantação não poderá 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 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 Componente/recurso Última versão válida A instalação/atualização não é possível a partir da versão
Windows 7 e Windows 8 VDA 7,15 L 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 L 7,16
Versão Windows 10 x86 VDA 1906,2,0 1909
Windows Server 2008 R2 VDA 7,15 L 7,16
Windows Server 2008 R2 Outros componentes do instalador 7,17 7,18
Windows Server 2012 VDA 7,15 L 7,16
Windows Server 2012 Outros componentes do instalador 7,17 7,18
Windows Server 2012 R2 Outros componentes do instalador\ * 1912 LITROS 2003
Windows Server 2012 R2 Servidor VDI 7,15 L 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 o Citrix Virtual Apps and Desktops versões 2203 LTSR ou versões até 2311: A versão suportada é o SQL Server Express LocalDB 2019.

    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 2019.
  • 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-->
      
  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 2019. 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\ 150\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.