Configura Data Migration Tool
Dopo aver installato Data Migration Tool, la directory seguente contiene i file di mapping e di configurazione:
-
Magento Open Source:
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-opensource
: configurazione e script per la migrazione dal 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
: configurazione e script per la migrazione dal Magento Open Source 1 ad Adobe Commerce 2<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/commerce-to-commerce
: configurazione e script per la migrazione da Adobe Commerce 1 ad Adobe Commerce 2
Le directory precedenti contengono sottodirectory per ogni versione supportata.
Configurazione della migrazione
Esistono due modi per configurare Data Migration Tool:
- Configura Data Migration Tool in un modulo separato (scelta consigliata)
- Modificare la configurazione di Data Migration Tool nella directory
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/
.
Per utilizzare il controllo del codice sorgente per gestire la configurazione della migrazione e utilizzarla per la distribuzione, è necessario creare un modulo separato.
Se si prevede di eseguire Data Migration Tool solo localmente, è possibile modificare direttamente i file nella directory <your Magento 2 install dir>/vendor/magento/data-migration-tool/
.
Configurare la migrazione in un modulo separato
Prima di eseguire la migrazione dei dati, è necessario creare un modulo Magento 2.
-
Creazione di un modulo 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>
-
Copiare il file di configurazione
config.xml.dist
dalla directory appropriata di Data Migration Tool (<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>
) nel file<your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/config.xml
.Ad esempio, se esegui la migrazione di
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
-
Nel file
config.xml
è necessario impostare i dettagli di accesso ai database M1 e M2 e alla chiave di crittografia. -
Se nell'archivio M1 sono presenti modifiche personalizzate, è necessario mappare il resto dei file di configurazione alle personalizzazioni dell'archivio del Magento 1. Vedi Operazioni con i file di configurazione e mappatura.
Configura migrazione nella cartella vendor
Prima di eseguire la migrazione dei dati, è necessario creare un file di configurazione config.xml
dall'esempio fornito.
Per configurare Data Migration Tool per la migrazione:
-
Accedi al server applicazioni come proprietario del file system o passa a tale proprietario.
-
Passa alla seguente directory:
code language-bash <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>
-
Immettere il comando seguente per creare un
config.xml
dal campione fornito:code language-bash cp config.xml.dist config.xml
-
Apri
config.xml
in un editor di testo. -
Il file config.xml deve contenere almeno i dettagli di accesso ai database M1 e M2 e le chiavi di crittografia.
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>
Il tag <crypt_key> deve contenere un valore. È possibile trovarlo all'interno del tag
<key>
, che si trova nel file app/etc/local.xml nell'istanza di Magento 1.Parametri facoltativi:
- Password utente database:
password=<password>
- Porta personalizzata del database:
port=<port>
- Prefisso tabella:
<source_prefix>
,<dest_prefix>
Se ad esempio il nome utente del proprietario del database è
root
con passwordpass
e si utilizza il prefissomagento1
nel database di Magento 1, utilizzare quanto segue inconfig.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>
- Password utente database:
Al termine, salvare le modifiche apportate a config.xml
e uscire dall'editor di testo.
Connetti utilizzando il protocollo TLS
È inoltre possibile connettersi a un database utilizzando il protocollo TLS, ovvero le chiavi di crittografia pubbliche/private. Aggiungere i seguenti attributi facoltativi all'elemento database
:
ssl_ca
ssl_cert
ssl_key
Ad esempio:
<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>
Utilizzare i file di configurazione e mappatura
Data Migration Tool utilizza file di mapping per consentire l'esecuzione di mapping di database personalizzati tra i database del Magento 1 e del Magento 2, inclusi:
-
Modifica dei nomi delle tabelle
-
Modifica dei nomi dei campi
-
Ignorare tabelle o campi
-
Adattare il trasferimento dei dati di un campo al formato Magento 2
I file di mapping per le versioni di Magento supportate si trovano nelle sottodirectory di <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc
Per utilizzare i file di mappatura:
-
Copiarli da
<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>/
e rimuovere l'estensione.dist
. -
Aggiornare il percorso del file appena copiato nel nodo
<options>
diconfig.xml
. Il percorso aggiornato deve essere uno dei seguenti:- Percorso assoluto del file, ad esempio
/var/www/html/app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml
- percorso file relativo del modulo magento/data-migration-tool:
etc/opensource-to-opensource/1.9.4.1/map.xml
- Percorso file relativo alla radice del Magento:
app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml
- Percorso assoluto del file, ad esempio
Le directory <Magento 2 dir>/vendor/magento/data-migration-tool/etc
e <Magento 2 dir>/vendor/magento/data-migration-tool/etc/<ce version>
contengono i seguenti file di configurazione:
Anche se si utilizza il file map.xml.dist
nella maggior parte dei casi, nella tabella seguente vengono descritti i mapping e gli altri file.
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
Per ulteriori informazioni, consulta Data Migration Tool Specifiche tecniche.