Atualizar o banco de dados e o site

Last published : Nov 13, 2026
Você atualiza o banco de dados e o site depois de atualizar os Delivery Controllers. Para uma visão geral de alto nível, consulte Etapa 8: Atualizar banco de dados e site.
Verifique Verificar suas permissões para as permissões necessárias para atualizar o esquema dos bancos de dados do SQL Server. Escolha um método de atualização com base nas suas permissões de banco de dados:
  • Atualização automática. Se você tiver permissão para atualizar o esquema do banco de dados do SQL Server, execute uma atualização automática. Consulte Atualizar o banco de dados e o site automaticamente.
  • Atualização manual. Se você não tiver essas permissões, execute uma atualização manual que usa scripts. Trabalhe com seu administrador de banco de dados, que tem as permissões necessárias. Consulte Atualizar o banco de dados e o site manualmente.
    Em uma atualização manual, as tarefas são divididas entre duas funções:
    • O usuário do Site Manager gera os scripts. O usuário então executa os scripts que habilitam e desabilitam os serviços.
    • O administrador do banco de dados executa os scripts que atualizam o esquema do banco de dados. O administrador usa o utilitário SQLCMD ou o SQL Server Management Studio no modo SQLCMD.
Observação:
Em uma implantação multizona, execute a atualização automática do esquema de banco de dados na mesma zona que hospeda os bancos de dados do SQL Server do site. Caso contrário, a atualização automática pode falhar.
Antes de atualizar, faça backup do banco de dados. Consulte CTX135207. Durante uma atualização de banco de dados, os serviços do produto são desabilitados. Durante o período de desativação, os Controllers não podem intermediar novas conexões para o site, portanto, planeje cuidadosamente.
Related information
Atualizar uma implantação

Revisar atualizações de esquema de banco de dados

Ao atualizar sua implantação, vários esquemas de banco de dados podem ser atualizados. A tabela a seguir lista os esquemas que são atualizados:
Atualizações do Dbschema
A tabela usa estes termos:
  • Site: O Site Datastore. A atualização do esquema é feita no Site Datastore.
  • Monitor: O Monitor Datastore. A atualização do esquema é feita no Monitor Datastore.
  • Config: A tabela de Configuração. A versão do Studio, informações de licenciamento, ou ambos são atualizados na tabela de Configuração.
  • Registro: O Datastore de Registro. A atualização do esquema é feita no Datastore de Registro.

Atualizar o banco de dados e o site automaticamente

Você pode atualizar o banco de dados e o site automaticamente usando o Site Manager ou o cmdlet do PowerShell SDK.

Atualizar automaticamente usando o Site Manager

  1. Inicie o Site Manager nos Delivery Controllers atualizados.
  2. Indique que deseja iniciar a atualização do site automaticamente e confirme que está pronto.

Atualizar automaticamente usando o cmdlet do PowerShell

Como alternativa ao uso do Site Manager, use o cmdlet do PowerShell SDK Update-XDSite para atualizar automaticamente o banco de dados e o site. Para mais informações, consulte Guia do SDK do Citrix Virtual Apps and Desktops.
  1. No segundo Delivery Controller, abra uma sessão do PowerShell.
  2. Execute o cmdlet Update-XDSite.
O cmdlet detecta automaticamente todos os componentes que exigem atualização e executa as seguintes ações:
  • Desconecta as conexões do banco de dados, atualiza as tabelas de banco de dados necessárias e reconecta os serviços. Se o banco de dados já foi atualizado por outros scripts ou ferramentas autônomas, esta etapa é ignorada.
  • Executa quaisquer etapas de atualização adicionais necessárias para o ambiente. As atualizações de nível global que já estão concluídas são ignoradas.

Atualizar o banco de dados e o site manualmente

  1. Inicie o Site Manager nos Delivery Controllers atualizados.
  2. Indique que deseja atualizar o site manualmente. O assistente verifica a compatibilidade do License Server e solicita confirmação.
  3. Confirme que você fez backup do banco de dados.
    O assistente gera e exibe os scripts e uma lista de verificação das etapas de atualização. Se o esquema de um banco de dados não tiver sido alterado desde a versão do produto que está sendo atualizada, esse script não será gerado. Por exemplo, se o esquema do banco de dados de log não for alterado, o script UpgradeLoggingDatabase.sql não será gerado.
  4. Execute os seguintes scripts na ordem mostrada.
    • DisableServices.ps1: O usuário do Site Manager executa este script do PowerShell em um Controller para desabilitar os serviços do produto.
    • UpgradeSiteDatabase.sql: O administrador do banco de dados executa este script SQL no servidor que contém o banco de dados do Site.
    • UpgradeMonitorDatabase.sql: O administrador do banco de dados executa este script SQL no servidor que contém o banco de dados do Monitor.
    • UpgradeLoggingDatabase.sql: O administrador do banco de dados executa este script SQL no servidor que contém o banco de dados de Log de Configuração. Execute este script somente se este banco de dados for alterado (por exemplo, após aplicar um hotfix).
    • EnableServices.ps1: O usuário do Site Manager executa este script do PowerShell em um Controller para habilitar os serviços do produto.
    Após a conclusão da atualização do banco de dados e a ativação dos serviços do produto, o Site Manager testa automaticamente o ambiente e a configuração e, em seguida, gera um relatório HTML. Se problemas forem identificados, você poderá restaurar o backup do banco de dados. Após resolver os problemas, você poderá atualizar o banco de dados novamente.
  5. Após concluir as tarefas da lista de verificação, clique em Concluir atualização.

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 forma autônoma. O Cache de Host Local não requer nenhum componente do SQL Server Express além do SQL Server Express LocalDB.
Ao atualizar os Delivery Controllers para o Citrix Virtual Apps and Desktops versão 2203 LTSR ou versões posteriores, a versão suportada é SQL Server Express LocalDB 2019 ou SQL Server Express LocalDB 2022.
Existem duas maneiras de atualizar o SQL Server Express LocalDB:

Atualização automática

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

Verificar nova instalação do SQL Server Express LocalDB

Antes de desinstalar a versão antiga, verifique se a nova instalação do SQL Server Express LocalDB está funcionando corretamente:
  1. Use o Prompt de Comando para navegar até a instância do SqlLocalDB:
    • Para SQL LocalDB 2014: cd C:\Program Files\Microsoft SQL Server\120\Tools\Binn
    • Para SQL LocalDB 2017: cd C:\Program Files\Microsoft SQL Server\140\Tools\Binn
    • Para SQL LocalDB 2019: cd C:\Program Files\Microsoft SQL Server\150\Tools\Binn
    • Para SQL LocalDB 2022: cd C:\Program Files\Microsoft SQL Server\160\Tools\Binn
  2. Execute SqlLocalDB i.
    Você deve ver dois arquivos: CitrixHA e MSSQLLocalDB.

Atualização manual

Pré-requisitos

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

Procedimento

  1. Conclua a atualização dos seus componentes, bancos de dados e site do Citrix Virtual Apps and Desktops. (Essas atualizações de banco de dados afetam os bancos de dados do site, monitoramento e registro de configuração. Elas não afetam o banco de dados do Cache de Host Local que usa SQL Server Express LocalDB.)
  2. Faça logon no Delivery Controller, onde você gostaria de atualizar o SQL Server Express LocalDB.
  3. Baixe o PsExec da Microsoft e coloque-o em um local de fácil acesso nesse Delivery Controller, como C:\Temp.
  4. Interrompa o Serviço de Alta Disponibilidade do Citrix no Delivery Controller a partir dos Serviços do Sistema Windows.
  5. Abra o Prompt de Comando no Delivery Controller, navegar até o local com o PsExec (exemplo, C:\Temp), e então execute o seguinte comando para elevar o prompt de comando com a conta de Serviço de Rede:
    psexec -i -u "NT AUTHORITY\NETWORKSERVICE" cmd
  6. Execute whoami para confirmar que o prompt de comando está sendo executado como a conta de 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 do SQL LocalDB:
    • Se estiver atualizando do SQL LocalDB 2014:
      cd "C:\Program Files\Microsoft SQL Server\120\Tools\Binn"
    • Se estiver atualizando do SQL LocalDB 2017:
      cd "C:\Program Files\Microsoft SQL Server\140\Tools\Binn"
    • Se estiver atualizando do SQL LocalDB 2019:
      cd "C:\Program Files\Microsoft SQL Server\150\Tools\Binn"
  8. Pare e exclua a instância do SQL LocalDB: CitrixHA.
    SqlLocalDB stop CitrixHA

    SqlLocalDB delete CitrixHA
  9. Remova os seguintes arquivos do Delivery Controller:
    C:\Windows\ServiceProfiles\NetworkService\HADatabaseName.*
    C:\Windows\ServiceProfiles\NetworkService\HADatabaseName_log.*
    C:\Windows\ServiceProfiles\NetworkService\HAImportDatabaseName.* (if exists)
    C:\Windows\ServiceProfiles\NetworkService\HAImportDatabaseName_log.* (if exists)
  10. Desinstale seu SQL LocalDB SQL Server Express existente do Delivery Controller usando o recurso nativo do Windows para remover programas.
  11. Reinicie o Delivery Controller após a conclusão da desinstalação.
  12. Interrompa o Serviço de Alta Disponibilidade do Citrix no Delivery Controller a partir dos Serviços do Sistema Windows.
  13. Monte a mídia de instalação do Citrix Virtual Apps and Desktops no seu Delivery Controller.
  14. Instale o SQL Server Express LocalDB 2022 como administrador no Delivery Controller.
    1. Use o arquivo sqllocaldb.msi na pasta Support > SQLLocalDB da mídia de instalação do Citrix Virtual Apps and Desktops. Por exemplo, se a mídia de instalação estiver montada na letra E drive, o arquivo pode ser encontrado em E:\Support\SQLLocalDB\sqllocaldb.msi. É necessário reiniciar para concluir a instalação.
    2. O novo SQL LocalDB deve estar em C:\Program Files\Microsoft SQL Server\160\Tools\Binn.
  15. Inicie o Serviço de Alta Disponibilidade do Citrix no Delivery Controller a partir dos Serviços do Sistema Windows.
  16. No Prompt de Comando do Delivery Controller, navegar até C:\Program Files\Microsoft SQL Server\160\Tools\Binn e execute SqlLocalDB i para confirmar que a instância CitrixHA foi criada. O CitrixHA deve ser incluído na lista de instâncias retornadas.
    Observação:
    Pode levar até 15 minutos para que o banco de dados CitrixHA seja criado após o início do Serviço de Alta Disponibilidade do Citrix.
  17. Certifique-se de que os arquivos do banco de dados Local Host Cache sejam criados para confirmar que o Serviço de Alta Disponibilidade (broker secundário) pode assumir o controle, se necessário.
    1. No Delivery Controller, navegue até C:\Windows\ServiceProfiles\NetworkService.
    2. Verifique se HaDatabaseName.mdf e HaDatabaseName_log.ldf foram criados.
  18. Repita os passos nos Delivery Controllers restantes.