Configurar Data Migration Tool
Después de instalar Data Migration Tool, el siguiente directorio contiene los archivos de asignación y configuración:
-
Magento Open Source:
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-opensource: configuración y scripts para migrar de Magento Open Source 1 a Magento Open Source 2
-
Adobe Commerce:
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-commerce: configuración y scripts para migrar de Magento Open Source 1 a Adobe Commerce 2<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/commerce-to-commerce: configuración y scripts para migrar de Adobe Commerce 1 a Adobe Commerce 2
Los directorios anteriores contienen subdirectorios para cada versión admitida.
Configuración de la migración
Hay dos formas de configurar Data Migration Tool:
- Configurar Data Migration Tool en un módulo independiente (recomendado)
- Cambie la configuración de Data Migration Tool en el directorio
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/.
Para utilizar el control de código fuente para administrar la configuración de migración y utilizarla en la implementación, debe crear un módulo independiente.
Si planea ejecutar Data Migration Tool solo localmente, puede editar los archivos en el directorio <your Magento 2 install dir>/vendor/magento/data-migration-tool/ directamente.
Configuración de la migración en un módulo independiente
Antes de migrar datos, debe crear un módulo de Magento 2.
-
Cree un módulo de Magento 2.
<your Magento 2 install dir>/app/code/Vendor/Migration/composer.json
code language-json { "name": "vendor/migration", "description": "Providing config for migration", "config": { "sort-packages": true }, "require": { "magento/framework": "*", "magento/data-migration-tool": "*" }, "type": "magento2-module", "autoload": { "files": [ "registration.php" ], "psr-4": { "Vendor\\Migration\\": "" } }, "version": "1.0.0" }<your Magento 2 install dir>/app/code/Vendor/Migration/registration.php
code language-php <?php \Magento\Framework\Component\ComponentRegistrar::register( \Magento\Framework\Component\ComponentRegistrar::MODULE, 'Vendor_Migration', __DIR__ );<your Magento 2 install dir>/app/code/Vendor/Migration/etc/module.xml
code language-xml <?xml version="1.0"?> <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd"> <module name="Vendor_Migration" setup_version="1.0.0"> <sequence> <module name="Magento_DataMigrationTool"/> </sequence> </module> </config> -
Copie el archivo de configuración
config.xml.distdel directorio apropiado de Data Migration Tool (<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>) en el archivo<your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/config.xml.Por ejemplo, si migra
Magento 1.9.3.6 Community EditionaMagento 2 Open Source:code language-bash cd <your Magento 2 install dir>code language-bash cp vendor/magento/data-migration-tool/etc/opensource-to-opensource/1.9.3.6/config.xml.dist app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.3.6/config.xml -
En el archivo
config.xml, debe establecer los detalles de acceso en las bases de datos M1 y M2, así como la clave de cifrado. -
Si el almacén M1 tiene cambios personalizados, debe asignar el resto de los archivos de configuración a las personalizaciones del almacén Magento 1. Consulte Trabajar con archivos de configuración y asignación.
Configurar la migración en la carpeta vendor
Antes de migrar datos, debe crear un archivo de configuración de config.xml a partir del ejemplo proporcionado.
Para configurar Data Migration Tool para la migración:
-
Inicie sesión en el servidor de aplicaciones como propietario del sistema de archivos o cambie a él.
-
Cambie al siguiente directorio:
code language-bash <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version> -
Escriba el siguiente comando para crear un
config.xmla partir del ejemplo proporcionado:code language-bash cp config.xml.dist config.xml -
Abra
config.xmlen un editor de texto. -
Como mínimo, el archivo config.xml debe contener detalles de acceso a las bases de datos M1 y M2 y claves de cifrado.
code language-xml <source> <database host="127.0.0.1" name="magento1" user="root"/> </source> <destination> <database host="127.0.0.1" name="magento2" user="root"/> </destination> <options> <crypt_key /> </options>La etiqueta <crypt_key> debe contener un valor. Puede encontrarlo dentro de la etiqueta
<key>, que se encuentra en el archivo app/etc/local.xml de su instancia de Magento 1.Parámetros opcionales:
- Contraseña de usuario de base de datos:
password=<password> - Puerto personalizado de base de datos:
port=<port> - Prefijo de tabla:
<source_prefix>,<dest_prefix>
Por ejemplo, si el nombre de usuario del propietario de la base de datos es
rootcon la contraseñapassy usa el prefijomagento1en la base de datos de Magento 1, use lo siguiente enconfig.xml:code language-xml <source> <database host="127.0.0.1" name="magento1" user="root" password="pass"/> </source> <destination> <database host="127.0.0.1" name="magento2" user="root" password="pass"/> </destination> <options> <source_prefix>magento1</source_prefix> <crypt_key>f3e25abe619dae2387df9fs594f01985</crypt_key> </options> - Contraseña de usuario de base de datos:
Cuando termine, guarde los cambios en config.xml y salga del editor de texto.
Conexión mediante el protocolo TLS
También puede conectarse a una base de datos utilizando el protocolo TLS (es decir, utilizando claves criptográficas públicas/privadas). Agregue los siguientes atributos opcionales al elemento database:
ssl_cassl_certssl_key
Por ejemplo:
<source>
<database host="localhost" name="magento1" user="root" ssl_ca="/path/to/file" ssl_cert="/path/to/file" ssl_key="/path/to/file"/>
</source>
<destination>
<database host="localhost" name="magento2" user="root" ssl_ca="/path/to/file" ssl_cert="/path/to/file" ssl_key="/path/to/file"/>
</destination>
Trabajo con archivos de configuración y asignación
Data Migration Tool usa archivos de asignación para permitirle realizar asignaciones de base de datos personalizadas entre las bases de datos de Magento 1 y Magento 2, entre las que se incluyen:
-
Cambio de nombres de tabla
-
Cambio de nombres de campo
-
Omitir tablas o campos
-
Adaptar la transferencia de datos de un campo al formato Magento 2
Los archivos de asignación para las versiones de Magento compatibles se encuentran en los subdirectorios de <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc
Para utilizar los archivos de asignación:
-
Cópielos de
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>/a<your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/y quite la extensión.dist. -
Actualice la ruta al archivo recién copiado en el nodo
<options>deconfig.xml. La ruta actualizada debe ser una de las siguientes:- Ruta absoluta del archivo, p. ej.
/var/www/html/app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml - ruta de archivo relativa del módulo magento/data-migration-tool:
etc/opensource-to-opensource/1.9.4.1/map.xml - Ruta de acceso del archivo relativa a la raíz de Magento:
app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml
- Ruta absoluta del archivo, p. ej.
Los directorios <Magento 2 dir>/vendor/magento/data-migration-tool/etc y <Magento 2 dir>/vendor/magento/data-migration-tool/etc/<ce version> contienen los siguientes archivos de configuración:
Aunque esté trabajando con el archivo map.xml.dist la mayor parte del tiempo, la siguiente tabla describe cada asignación y otros archivos.
class-map.xml.distconfig.xml.distcustomer-attr-document-groups.xml.distcustomer-attr-map.xml.distdeltalog.xml.disteav-attribute-groups.xml.disteav-document-groups.xml.distlog-document-groups.xml.distmap-eav.xml.distmap-log.xml.distmap-sales.xml.distmap.xml.distsettings.xml.distcore_config_data.customer-attribute-groups.xml.distcustomer-document-groups.xml.distmap-customer.xml.distorder-grids-document-groups.xml.distmap-document-groups.xml.distmap-stores.xml.distmap-tier-price.xml.distvisual_merchandiser_map.xml.distvisual_merchandiser_attribute_groups.xml.distvisual_merchandiser_document_groups.xml.distPuede consultar Data Migration Tool Especificación técnica para obtener más detalles.