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 del Magento Open Source 1 al 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 del 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.dist
del 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 Edition
aMagento 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.xml
a partir del ejemplo proporcionado:code language-bash cp config.xml.dist config.xml
-
Abra
config.xml
en 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 en 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
root
con la contraseñapass
y utiliza el prefijomagento1
en la base de datos del Magento 1, utilice 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_ca
ssl_cert
ssl_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 del Magento 2
Los archivos de asignación para las versiones de Magento admitidas 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 relativo a la raíz del 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.dist
config.xml.dist
customer-attr-document-groups.xml.dist
customer-attr-map.xml.dist
deltalog.xml.dist
eav-attribute-groups.xml.dist
eav-document-groups.xml.dist
log-document-groups.xml.dist
map-eav.xml.dist
map-log.xml.dist
map-sales.xml.dist
map.xml.dist
settings.xml.dist
core_config_data
.customer-attribute-groups.xml.dist
customer-document-groups.xml.dist
map-customer.xml.dist
order-grids-document-groups.xml.dist
map-document-groups.xml.dist
map-stores.xml.dist
map-tier-price.xml.dist
visual_merchandiser_map.xml.dist
visual_merchandiser_attribute_groups.xml.dist
visual_merchandiser_document_groups.xml.dist
Puede consultar Data Migration Tool Especificación técnica para obtener más detalles.