Citrix Virtual Apps and Desktops

Atualizar uma implantação

November 5, 2024

Contribuição de:

Introdução

Você pode atualizar determinadas implantações para versões mais recentes sem precisar primeiro configurar novas máquinas, computadores ou sites. Isso é chamado de atualização no local ou atualização in-loco. Para saber quais versões do Citrix Virtual Apps and Desktops você pode atualizar, consulte o Citrix Upgrade Guide.

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

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

Leia todas as informações contidas 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.

Fluxograma da sequência de atualização

Observação:

Para evitar falhas, você deve atualizar todos os Delivery Controllers e o banco de dados antes de executar qualquer tarefa relacionada a provisionamento e 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.

Procedimento de atualização

A maioria dos componentes principais do produto pode ser atualizada executando o instalador do produto no computador que contém o componente.

Se um computador contiver mais de um componente (por exemplo, Studio e License Server), todos os componentes do computador sã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 do produto completo, faça logon no computador 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, execute o comando apropriado. Consulte Instale usando a linha de comando.

Etapa 1: Preparar

Antes de iniciar uma atualização, prepare-se adequadamente. Leia, entenda e conclua todas as tarefas necessárias:

Atualizar VDAs para 1912 ou posterior
Limitações
Considerações sobre ambientes mistos
Sistemas operacionais anteriores
Preparação
Testes preliminares do site
Verificação da versão do SQL Server

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 antes de quaisquer outros componentes.

Se você ainda não determinou se o License Server é 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 no computador que contém o servidor StoreFront.

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

Etapa 4: Atualizar o Director

Se a mídia de instalação contiver uma nova versão do software Director, execute o instalador no computador 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 do Citrix Provisioning e o software de dispositivo de destino, consulte a documentação do produto Citrix Provisioning.

Etapa 6: Atualizar metade dos Delivery Controllers

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

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

Se o seu site tiver apenas um Controller, ele estará inoperante durante a atualização.

Os testes preliminares do site são executados no primeiro Controller, antes que a atualização seja realmente iniciada. Para obter detalhes, consulte Testes preliminares do site.

Etapa 7: Atualizar o Studio

Se você ainda não atualizou o Studio (porque estava no mesmo computador que outro componente), execute o instalador no computador que contém o Studio.

Etapa 8: Reiniciar o Studio

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

Etapa 9: Atualizar o banco de dados e o site

Observação:

Para evitar falhas, você deve atualizar todos os Delivery Controllers e o banco de dados antes de executar qualquer tarefa relacionada a provisionamento e 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.

Em Preparação, veja quais são as permissões necessárias para atualizar o esquema de bancos de dados do SQL Server.

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

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

Atualizar o banco de dados e o site automaticamente

Inicie o Studio recém-atualizado.
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.

Atualizar o banco de dados e o site manualmente

Inicie o Studio recém-atualizado.
Indique que você deseja atualizar o site manualmente. O assistente verifica a compatibilidade do License Server e solicita a confirmação.
Confirme que você fez backup do banco de dados.

O assistente gera e exibe os scripts e uma lista de verificação das etapas de atualização. Se o esquema de um banco de dados não tiver sido alterado desde a versão do produto que está sendo atualizada, o script não é gerado. Por exemplo, se o esquema do banco de dados de registro não mudar, o script UpgradeLoggingDatabase.sql não será gerado.
Execute os seguintes scripts 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 este script somente se este 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 de produtos 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.
Depois de concluir as tarefas da lista de verificação, clique em Finish upgrade.

Etapa 10: Atualizar os Delivery Controllers restantes

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

Depois de concluir a atualização e confirmar a conclusão, feche e abra o Studio novamente. O Studio pode solicitar uma atualização adicional do site para registrar os serviços do Controller no site ou para criar um ID de zona se ainda não existir.

Etapa 11: Atualizar VDAs

Importante:

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

Execute o instalador do produto em computadores contendo VDAs.

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

Para obter orientação sobre a interface gráfica, consulte Instalar VDAs.
Para obter orientação sobre a linha de comando, consulte Instalar usando a linha de comando.

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

Assista a este vídeo para e saiba mais:

Etapa 12: Atualizar catálogos de máquinas e Grupos de Entrega

Etapa 13: Após a atualização

Depois de concluir uma atualização, você pode testar o site recém-atualizado. No Studio, selecione Citrix Studio nome-do-site no painel de navegação. Na guia Common Tasks, selecione Test Site. Esses testes são executados automaticamente depois de atualizar o banco de dados, mas você pode executá-los novamente a qualquer momento.

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

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

Atualize outros componentes na sua implantação. Para obter orientações, 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

Quando você atualiza sua implantação para uma nova UC, vários esquemas de banco de dados podem ser atualizados. A tabela a seguir lista quais esquemas de bancos de dados são atualizados no processo:

Atualizações do Dbschema

Definição de termos:

Site: Site Datastore. A atualização do Dbschema é feita no Site Datastore.
Monitor: Monitor Datastore. A atualização do Dbschema é feita no Monitor Datastore.
Config: tabela Configuration. Versão do Desktop Studio, informações do Licensing ou ambos são atualizados na tabela Configuration.
Logging: Logging Datastore. A atualização do Dbschema é feita no Logging Datastore.

Atualizar VDAs para 1912 ou posterior

Se o componente Personal vDisk (PvD) já tiver sido instalado em um VDA, esse VDA não pode ser atualizado para a versão 1912 LTSR ou posterior. Para usar o novo VDA, você deve desinstalar o VDA atual e instalar o novo VDA.

Essa 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. O 7.15 LTSR e versões 7.x anteriores habilitavam essa opção por padrão. Portanto, se você aceitou os padrões (ou ativou explicitamente a opção em alguma versão), o PvD foi instalado.
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 (1912 LTSR 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 Cancel 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 continuará.

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:

Desinstale o VDA atual. Para obter detalhes, consulte Remover componentes.
Instale o novo VDA.

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

Limitações

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

Instalação de componente seletiva: se você instalar ou atualizar um componente para uma nova versão, mas optar por não atualizar outros componentes (em máquinas diferentes) que exigem atualização, o Studio lembrará você. Por exemplo, digamos que uma atualização inclua novas versões do Controller e 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 atualize o Studio.

Você não precisa atualizar os VDAs, mas a Citrix recomenda atualizar todos os VDAs para permitir que você use todos os recursos disponíveis.
Versões Early Release ou Technology Preview: não é possível atualizar a partir de uma versão Early Release, Technology Preview ou versão prévia.
Componentes em sistemas operacionais anteriores: você não pode instalar VDAs atuais em sistemas operacionais que não são mais suportados pela Microsoft ou Citrix. Para obter mais informações, consulte Sistemas operacionais anteriores.
Ambientes/sites mistos: se você precisa continuar executando sites da versão anterior e sites da versão atual, 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

Quando você faz uma atualização, a Citrix recomenda que você atualize todos os componentes e VDAs para que possa acessar todos os recursos novos e melhorados em sua edição e versão.

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

Em alguns ambientes, talvez você não consiga atualizar todos os VDAs para a versão mais atual. Nesse caso, quando cria um catálogo de máquina, você pode especificar a versão VDA instalada nas máquinas. (Isso é chamado de nível funcional.) Por padrão, esta 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. Misturar versões de VDA em um catálogo de máquinas não é recomendado.

Se um catálogo for criado com a configuração de versão mínima de VDA padrão 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 diferentes versões

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

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

Sistemas operacionais anteriores

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

Por exemplo, suponha que você instalou um VDA de servidor em uma máquina Windows Server 2008 R2. Agora você deseja 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 é exibida, como “Não é possível instalar neste sistema operacional”.

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

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

Para LTSRs, selecione sua versão LTSR na página principal de documentação do produto Citrix Virtual Apps and Desktops .
- Requisitos do sistema.
- Listas de componentes em artigos na categoria What’s new .
Para CRs (versões atuais):
- Delivery Controller, Studio, Director, VDAs, servidor de impressão universal
- Serviço de autenticação federada
- Para StoreFront, Self-Service Password Reset e Session Recording, consulte o artigo de requisitos do sistema para a versão atual.

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. Ele indica a versão de componente válida mais recente suportada, para 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	Instalar/atualizar não é possível a partir da versão
Windows 7 e Windows 8	VDA	7.15 LTSR	7,16
Windows 7 e Windows 8	Outros componentes do instalador	7,17	7,18
Versões do Windows 10 anteriores a 1607	VDA	7.15 LTSR	7,16
Windows 10 versão x86	VDA	1906.2.0	1909
Windows Server 2008 R2	VDA	7.15 LTSR	7,16
Windows Server 2008 R2	Outros componentes do instalador	7,17	7,18
Windows Server 2012	VDA	7.15 LTSR	7,16
Windows Server 2012	Outros componentes do instalador	7,17	7,18
Windows Server 2012 R2	Outros componentes do instalador *	1912 LTSR	2003
Windows Server 2012 R2	Server VDI	7.15 LTSR	7,16

Windows XP e Windows Vista não são válidos para componentes ou tecnologias 7.x.

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

O que você pode fazer

Você tem opções. Você pode:

Continuar com o sistema operacional atual
Recriar a imagem ou atualizar a máquina
Adicionar novas máquinas e depois remover máquinas antigas

Continuar com o sistema operacional atual

Estes métodos são viáveis para VDAs. Se você quiser continuar usando máquinas com o sistema operacional anterior, você pode optar entre:

Continuar usando a versão do componente instalada.
Baixar a versão do componente válida mais recente e atualizar o componente para essa versão. (Pressupondo-se que a versão do componente válida mais recente ainda não esteja instalada.)

Por exemplo, você tem um 7.14 VDA em uma máquina Windows 7 SP1. A versão VDA válida mais recente em máquinas com SO Windows 7 é XenApp e XenDesktop 7.15 LTSR. Você pode continuar usando o 7.14 ou baixar um VDA 7.15 LTSR e 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 7.15 LTSR pode se conectar a um Controller do Citrix Virtual Apps and Desktops 7 1808.

Recriar a imagem ou atualizar a máquina

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

Depois de retirar a máquina de serviço (ativar o modo de manutenção e permitir que todas as sessões sejam fechadas), você pode recriar a imagem para uma versão do sistema operacional Windows suportada e, em seguida, instalar a versão mais recente do componente.
Para atualizar o sistema operacional sem recriar imagens, desinstale o software Citrix antes de atualizar o sistema operacional. Caso contrário, o software Citrix ficará em um estado sem suporte. Em seguida, instale o novo componente.

Adicionar novas máquinas e depois remover máquinas antigas

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

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

Faça um instantâneo de todos os Delivery Controllers no site e, em seguida, faça backup do banco de dados do site.
Instale novos Delivery Controllers em servidores limpos com sistemas operacionais suportados. Por exemplo, instale um Controller em duas máquinas Windows Server 2016.
Adicione os novos Controllers ao site.
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 de duas máquinas Windows Server 2008 R2. Siga as recomendações para remover os Controladores em Delivery Controllers.

Preparação

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

Escolher um instalador e a interface

Use o instalador de produto completo no ISO do produto para atualizar os componentes. Você pode atualizar os VDAs usando o instalador de produto completo ou um dos instaladores autônomos de 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 que concluir os trabalhos de preparação e assim que estiver 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 esta versão, ocorre uma reinicialização da máquina durante o processo de atualização. (Este requisito começou com a versão 7.17.) Isso não pode ser evitado. A atualização é retomada automaticamente após a reinicialização (a menos que você especifique /noresume na linha de comando).

Ações com bancos de dados

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

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

O Microsoft SQL Server Express LocalDB é instalado automaticamente, para uso com o cache de host local. Se você precisar substituir uma versão anterior, a nova versão deve ser pelo menos SQL Server Express 2017 LocalDB CU16. Para obter detalhes sobre como substituir o SQL Server Express LocalDB por uma nova versão depois de atualizar os componentes e o site, consulte Substituir o SQL Server Express LocalDB.

Confirme que o Citrix Licensing está atualizado

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

Você pode usar o instalador de produto completo para atualizar o servidor de licenças. Ou pode baixar e atualizar os componentes da licença separadamente. Consulte Upgrade.

Antes de atualizar, certifique-se de que a data em Customer Success Services / Software Maintenance / Subscription Advantage seja válida para a nova versão do produto. Se você estiver atualizando de uma versão anterior do produto 7.x, a data deverá ser pelo menos 2019.1115.

Confirme que o Citrix License Server é compatível

Confirme que o Citrix License Server é compatível com a nova versão. Existem 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 informa com as etapas recomendadas para resolver os problemas.
No diretório XenDesktop Setup na mídia de instalação, execute o comando: . \ LicServVerify.exe -h <license-server-fqdn> -p 27000 -v.A exibição indica se o servidor de licenças é compatível. Se o servidor de licenças for incompatível, atualize o servidor de licenças.

Faça backup das modificações do StoreFront

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

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 os bloqueios de arquivos sejam eliminados e que não haja atualizações do Windows pendentes.

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

Confirme que você tem as permissões adequadas

Além de ser usuário de um domínio, você deve ser um 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 automaticamente ou manualmente. Para uma atualização automática do banco de dados, as permissões do usuário do Studio devem incluir a capacidade de atualizar o esquema do banco de dados do SQL Server (por exemplo, a função de banco de dados db_securityadmin ou db_owner ). Para obter detalhes, consulte Databases.

Se o usuário do Studio não tiver essas permissões, iniciar uma atualização manual do banco de dados gerará scripts. O usuário do Studio executa alguns dos scripts 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 as outras tarefas de preparação ditadas pelo seu plano de continuidade de negócios.

Testes preliminares do site

Quando você atualiza os Delivery Controllers e um site, os testes preliminares do site são executados antes que a atualização seja realmente iniciada. Estes testes verificam:

O banco de dados do site pode ser acessado e o backup foi realizado
As conexões com serviços essenciais da Citrix estão funcionando corretamente
O endereço do Citrix License Server está disponível
O banco de dados do log de configuração pode ser acessado

Após a execução dos testes, você pode exibir um relatório dos resultados. Em seguida, você pode corrigir os problemas que foram detectados e executar os testes novamente. Deixar de executar os testes preliminares do site e resolver os problemas pode afetar a forma como seu site funciona.

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á substituído.

Execute os testes

Quando você estiver usando a interface gráfica do instalador para atualizar, o assistente inclui uma página onde você pode iniciar os testes e exibir o relatório. Depois que os testes forem executados e você examinar o relatório e resolver os problemas encontrados, pode 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 é executada. Depois de examinar o relatório e resolver os problemas, execute novamente o comando.

A Citrix recomenda sempre executar os testes preliminares do site e, em seguida, resolver os problemas antes de continuar a atualização do Controller e do site. O benefício potencial compensa o tempo dedicado a executar os testes. No entanto, você pode ignorar esta ação recomendada.

Ao atualizar com a interface gráfica, você pode optar por ignorar os testes e continuar com a atualização.
Ao atualizar com a linha de comando, você não pode ignorar os testes. Por padrão, um teste de site com falha faz com que o instalador falhe, sem executar 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.)

Quando atualizar vários Controllers

Quando você inicia a atualização em um Controller e depois inicia a atualização de outro Controller no mesmo local (antes que a primeira atualização termine):

Se os testes preliminares do site tiverem sido concluídos no primeiro Controller, a página de testes preliminares do site não aparece no assistente do outro Controller.
Se os testes no primeiro Controller estiverem em andamento quando você iniciar a atualização no outro Controller, a página de testes do site aparece no assistente do outro Controller. Contudo, se os testes no primeiro Controller terminarem, somente os resultados do teste do primeiro Controller são mantidos.

Falhas de teste não relacionadas à integridade do site

Se os testes preliminares do site falharem devido à falta de memória, disponibilize mais memória e, em seguida, execute novamente os testes.
Se você tiver permissão para atualizar, mas não executar os 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 bancos de dados de site, monitoramento e log de configuração. A atualização de uma implantação da Citrix com uma versão do SQL Server que não é mais suportada pode resultar em problemas de funcionalidade, e o site ficará sem 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 Controller, o instalador da Citrix verifica a versão do SQL Server atualmente instalada que é usada para os bancos de dados de site, monitoramento e log de configuração.

Se a verificação determinar que a versão do SQL Server atualmente instalada não é suportada na versão do Citrix para a qual você está atualizando:
- Interface gráfica: a atualização para com uma mensagem. Clique em I understand e, em seguida, clique em Cancel para fechar o instalador da 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 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 para com uma mensagem.
  - Se a versão do SQL Server atualmente instalada for suportada, clique em I understand para fechar a mensagem e, em seguida, clique em Next para continuar com a atualização do Citrix.
  - Se a versão do SQL Server atualmente instalada não for suportada, clique em I understand para fechar a mensagem e clique em Cancel para encerrar a atualização do Citrix. Atualize seu SQL Server para uma versão compatível e 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 do SQL Server atualmente instalada não for suportada, atualize o SQL Server para uma versão suportada. Execute o comando novamente para iniciar a atualização do Citrix.

Atualizar o SQL Server

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

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

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

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

Substituir SQL Server Express LocalDB

O Microsoft SQL Server Express LocalDB é um recurso do SQL Server Express que o cache de host local usa de modo autônomo. O cache de host local não requer nenhum componente do SQL Server Express que não seja o SQL Server Express LocalDB.

Se você instalou uma versão do Delivery Controller anterior à 1912 e, em seguida, atualizou sua implantação para a versão 1912 ou posterior, o 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 não 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 1912 LTSRdo Citrix Virtual Apps and Desktops: A versão suportada é o SQL Server Express LocalDB 2017.

Observação:

As versões 2017, 2019 e 2022 do SQL Server Express LocalDB são todas compatíveis entre si.

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 2017.
A ferramenta PsExec da caixa de ferramentas Windows Sysinternals que você pode baixar da Microsoft. Consulte o documento da Microsoft PsExec v2.43.

Procedimento:

Conclua a atualização dos componentes, bancos de dados e site do Citrix Virtual Apps and Desktops. (Essas atualizações de bancos de dados afetam os bancos de dados de site, monitoramento e log de configuração. Elas não afetam o banco de dados de cache de host local que usa o SQL Server Express LocalDB.)
Faça login no Delivery Controller que está sendo usado para recriar o banco de dados do LHC.
Nesse Delivery Controller, baixe PsExec da Microsoft e coloque-o em C:\Temp.
Pare o Citrix High Availability Service.
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 "AUTORIDADE NT\NETWORKSERVICE" cmd

```
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.
Use o prompt de comando para navegar até a instância SQL LocalDB:
- Se estiver atualizando do SQL LocalDB 2014:
```
 cd "C:\Arquivos de programas\Microsoft SQL Server\120\Tools\Binn"
 
```

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

SqlLocalDB pare CitrixHA

SqlLocalDB exclua CitrixHA
<!--NeedCopy-->

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

HADatabaseName.*
HADatabaseName_log.*
HAImportDatabaseName.* (se existir)
HAImportDatabaseName_log.* (se existir)
<!--NeedCopy-->

Desinstale seu SQL LocalDB SQL Server Express existente do servidor usando o recurso do Windows para remover programas.
Instale o SQL Server Express LocalDB 2017. Na pasta Support > SQLLocalDB na mídia de instalação do Citrix Virtual Apps and Desktops, clique duas vezes em sqllocaldb.msi. A reinicialização pode ser necessária para concluir a instalação. O novo SQL LocalDB reside em C:\Program Files\ Microsoft SQL Server\ 140\Tools\ Binn.
Inicie o Citrix High Availability Service no Delivery Controller onde você desinstalou a versão antiga do SQL LocalDB.
No prompt de comando, execute SQLLocalDB i para confirmar se CitrixHA foi criado novamente ou não.
Repita as etapas nos controladores de entrega restantes.
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 (agente 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.

A versão oficial deste conteúdo está em inglês. Parte do conteúdo da documentação da Cloud Software Group é traduzida automaticamente para sua conveniência. A Cloud Software Group não tem controle sobre o conteúdo traduzido automaticamente, que pode conter erros, imprecisões ou linguagem inadequada. Nenhuma garantia de qualquer tipo, expressa ou implícita, é fornecida quanto à precisão, confiabilidade, adequação ou correção de quaisquer traduções feitas do original em inglês para qualquer outro idioma, ou quanto à conformidade do seu produto ou serviço Cloud Software Group com qualquer conteúdo traduzido automaticamente, e nenhuma garantia fornecida sob o contrato de licença de usuário final aplicável ou os termos de serviço, ou qualquer outro contrato com a Cloud Software Group, de que o produto ou serviço esteja em conformidade com qualquer documentação será aplicável na medida em que essa documentação tenha sido traduzida automaticamente. A Cloud Software Group não se responsabiliza por quaisquer danos ou problemas que possam surgir em decorrência do uso de conteúdo traduzido automaticamente.

Isso foi útil?

Atualizar uma implantação

November 5, 2024

Contribuição de:

November 5, 2024

Contribuição de:

Isso foi útil?