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 da 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: configurazione e script per la migrazione da 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 di Magento 2.
- 
                  
Creare un modulo di 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.distdalla 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 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 - 
                  
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 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.xmldal campione fornito:code language-bash cp config.xml.dist config.xml - 
                  
Apri
config.xmlin 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 è
rootcon passwordpasse si utilizza il prefissomagento1nel 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_cassl_certssl_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 di Magento 1 e 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 directory principale di 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.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.distPer ulteriori informazioni, consulta Data Migration Tool Specifiche tecniche.