Citrix DaaS™

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 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 SDK do Citrix PowerShell. O SDK do PowerShell está disponível no instalador do Citrix Delivery Controller™.

Observação:

  • 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 Citrix Virtual Apps and Desktops no site de downloads.
  • No site local, recomendamos que o ACT seja instalado no DDC. O ACT pode ser iniciado por meio do ícone da área de trabalho.
  • Se o ACT for usado a partir da janela padrão do PowerShell, execute o seguinte comando: 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 de suas configurações da nuvem para o local:

  1. Fazer backup da configuração da nuvem.
  2. Modificar arquivos YML.
  3. Importar configurações para o 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 backup de suas configurações da nuvem.

    Observação:

    • Depois de executar qualquer cmdlet pela primeira vez, uma pasta de backup 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:

Arquivo YML Parâmetro Descrição Exemplos
CustomerInfo.yml Environment Altere o Ambiente para OnPrem. O valor do parâmetro de ambiente diferencia maiúsculas de minúsculas.  
ZoneMapping.yml DaaS:CVAD Mapeie seus locais de recurso da nuvem para suas zonas locais. Deve ser zonas antigas:novas
CvadAcSecurity.yml Hypervisor: ConnectionType: ‘ ‘ Username: ‘ ’ Password: ‘ ‘ Adicione o nome de usuário e as senhas do hipervisor. Se o hipervisor for XenServer,XenServer: ConnectionType: ‘XenServer’ Username: ‘root’ Password: ‘ ‘

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.

Migrar configurações da nuvem para o local