Configurações de migração de dados

Última atualização: 15 de julho de 2024

Criado para:

  • Experiente
  • Administrador
  • Desenvolvedor

O modo Settings migra lojas, sites e configurações do sistema, como configurações de remessa, pagamento e imposto. De acordo com nossa ordem de migração de dados, você deve migrar as configurações primeiro.

Antes de começar, siga as etapas abaixo para se preparar:

  1. Faça logon no servidor de aplicativos como o proprietário do sistema de arquivos.

  2. Altere para o diretório /bin ou verifique se ele foi adicionado ao sistema PATH.

NOTE
Verifique se o Magento 2 está implantado no modo default. O modo de desenvolvedor pode causar erros de validação na ferramenta de migração.

Consulte a seção primeiras etapas para obter mais detalhes.

Execute o comando de migração de configurações

Para iniciar a migração das configurações, execute:

bin/magento migrate:settings [-r|--reset] [-a|--auto] {<path to config.xml>}

Onde:

  • [-r|--reset] é um argumento opcional que inicia a migração desde o início. Você pode usar esse argumento para testar a migração

  • [-a|--auto] é um argumento opcional que impede que a migração pare quando encontrar erros de verificação de integridade.

  • {<path to config.xml>} é o caminho absoluto do sistema de arquivos para o arquivo config.xml da ferramenta de migração. Esse argumento é obrigatório.

NOTE
Este comando não migra todas as configurações. Verifique todas as configurações no Magento 2 Admin antes de continuar.

A mensagem Migration completed é exibida após as configurações serem transferidas com êxito.

Configurar regras de migração personalizadas

Você pode ignorar, renomear ou alterar as configurações do sistema ao migrar as configurações. Para isso, especifique suas regras personalizadas no arquivo settings.xml.

  1. Faça logon no servidor de aplicativos como ou alterne para o proprietário do sistema de arquivos.

  2. Altere para o seguinte diretório:

    cd <your application 2 install dir>/vendor/magento/data-migration-tool/etc/<edition-to-edition>

    Por exemplo, se o aplicativo estiver instalado em /var/www/html, o arquivo settings.xml.dist estará em um dos seguintes diretórios:

    • /var/www/html/vendor/magento/data-migration-tool/etc/opensource-to-commerce

    • /var/www/html/vendor/magento/data-migration-tool/etc/commerce-to-commerce

    • /var/www/html/vendor/magento/data-migration-tool/etc/opensource-to-opensource

  3. Para criar um arquivo settings.xml a partir da amostra fornecida, execute:

    cp settings.xml.dist settings.xml

  4. Faça as alterações em settings.xml.

  5. Para especificar o novo nome do arquivo de configurações para mapeamento, altere a marca <settings_map_file> no arquivo path/to/config.xml.

Para obter mais detalhes, consulte a seção Modo de migração das configurações da especificação da ferramenta.