Migrar configurações da nuvem para on-premises

Este artigo descreve como fazer backup e migrar suas configurações da nuvem para sites on-premises.

Pré-requisitos para migrar sua configuração

• Ambiente on-premises do Citrix Virtual Apps and Desktops™ com pelo menos um VDA registrado.
• Ambiente on-premises do Citrix Virtual Apps and Desktops executando em uma das seguintes versões:
  • A versão mais recente do Long-Term Service Release (LTSR) - 2402.
  • Qualquer uma das versões Current Releases (CR) - 2308, 2311.
• Execute os comandos da ferramenta Automated Configuration (ACT) em uma máquina ingressada no domínio com a versão .Net 4.7.2 ou superior.
• Uma máquina com o Citrix PowerShell SDK. O PowerShell SDK está disponível no instalável 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 do PowerShell corretos instalados. Para obter o instalador, acesse o Citrix Virtual Apps and Desktopssite de downloads.
• No site on-prem, 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 explicitamente importado

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 a Configuração Automatizada.
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 os 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ê deseja 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.