Migrar configurações da nuvem para o local

Este artigo descreve o backup e a migração de suas configurações da nuvem para sites locais.

Pré-requisitos para migrar sua configuração

• Ambiente local do Citrix Virtual Apps and Desktops™ com pelo menos um VDA registrado.
• Ambiente local do Citrix Virtual Apps and Desktops executando uma das seguintes versões:
  • A versão mais recente do Long-Term Service Release (LTSR) - 2402.
  • Qualquer uma das versões do Current Releases (CR) - 2308, 2311.
• Execute os comandos da ferramenta de Configuração Automatizada (ACT) em uma máquina ingressada no domínio com a versão .Net 4.7.2 ou superior.
• Uma máquina com o SDK do Citrix PowerShell. O SDK do PowerShell está disponível no instalador do Citrix Delivery Controller™.

Nota:

• Se você estiver executando o ACT em uma máquina diferente, ela deve estar ingressada no domínio e o Studio deve ter os snap-ins corretos do PowerShell instalados. Para obter o instalador, acesse o site de downloads Citrix Virtual Apps and Desktops.
• No site local, recomendamos que o ACT seja instalado no Delivery Controller. O ACT pode ser iniciado através do ícone da área de trabalho.
• Se o ACT for destinado a ser usado a partir da janela padrão do Powershell, o seguinte comando deve ser executado: Import-Module Citrix.AutoConfig.Commands

O ACT não faz parte do caminho do PowerShell do sistema, portanto, deve ser importado explicitamente

Etapas principais

Siga as instruções para concluir a migração das suas configurações da Nuvem para o ambiente local:

1. Fazer backup da configuração da Nuvem
2. Modificar arquivos YML
3. Importar configurações para o ambiente local

Fazer backup da configuração da Nuvem

1. Instale o Automated Configuration.
2. Clique duas vezes no ícone Auto Config. Uma janela do PowerShell é exibida.
3. Execute New-CvadAcCustomerInfoFile para criar um arquivo CustomerInfo.yml. Para obter mais informações, consulte Preencher arquivo de informações do cliente.
4. Execute o comando Backup-CvadAcToFile para fazer um backup das suas configurações da Nuvem.

   Nota:

   • Depois de executar qualquer cmdlet pela primeira vez, uma pasta de exportação com os arquivos de configuração .yml e logs é criada. A pasta está em %HOMEPATH%\Documents\Citrix\AutoConfig.
   • Se você encontrar erros ou exceções, consulte a seção Fixups no arquivo de log.
   • Backup-CvadToFile não oferece suporte aos parâmetros IncludeByName ou ExcludeByName.

Importante:

A Citrix recomenda fazer backup de todos os componentes juntos.

Modificar arquivos YML

Modifique os arquivos .yml localizados em %HOMEPATH%\Documents\Citrix\AutoConfig para incluir os detalhes locais, conforme descrito na tabela a seguir:

Importar configurações para o local

1. Execute um dos seguintes comandos em seu site local com base em seus requisitos:
   1. Merge-CvadAcToSite - se houver um site local em execução e você quiser mesclar as configurações da Nuvem a ele.
   2. Import-CvadAcToSite -Environment OnPrem - Se as configurações locais não estiverem disponíveis e você estiver importando as configurações da Nuvem para criar uma.

Importante:

A Citrix recomenda importar um componente por vez para evitar conflitos.