De Data Migration Tool configureren
Nadat u Data Migration Tool hebt geïnstalleerd, bevat de volgende map toewijzings- en configuratiebestanden:
-
Magento Open Source:
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-opensource: Configuratie en scripts voor migratie van Magento Open Source 1 naar Magento Open Source 2
-
Adobe Commerce:
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/opensource-to-commerce: Configuratie en scripts voor migratie van Magento Open Source 1 naar Adobe Commerce 2<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/commerce-to-commerce: Configuratie en scripts voor migratie van Adobe Commerce 1 naar Adobe Commerce 2
De voorgaande mappen bevatten submappen voor elke ondersteunde versie.
De migratie configureren
Er zijn twee manieren om Data Migration Tool te configureren:
- Configureer de Data Migration Tool in een aparte module (aanbevolen)
- Wijzig de Data Migration Tool -configuratie in de
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/-map.
Om broncontrole te gebruiken om uw migratieconfiguratie te beheren en het voor plaatsing te gebruiken, moet u een afzonderlijke module tot stand brengen.
Als u Data Migration Tool alleen lokaal wilt uitvoeren, kunt u bestanden in de map <your Magento 2 install dir>/vendor/magento/data-migration-tool/ rechtstreeks bewerken.
Migratie configureren in een aparte module
Voordat u gegevens kunt migreren, moet u een Magento 2-module maken.
-
Maak een Magento 2-module.
<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> -
Kopieer het
config.xml.distconfiguratiebestand uit de juiste map van Data Migration Tool (<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>) naar het<your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/config.xml-bestand.Als u bijvoorbeeld
Magento 1.9.3.6 Community EditionnaarMagento 2 Open Sourcemigreert: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 -
In het
config.xml-bestand moet u toegangsgegevens instellen voor de M1- en M2-databases en de coderingssleutel. -
Als uw M1-winkel aangepaste wijzigingen heeft, moet u de rest van uw configuratiebestanden toewijzen aan uw Magento 1-winkel-aanpassingen. Zie Werk met configuratie en kaartdossiers .
Migratie configureren in map vendor
Voordat u gegevens migreert, moet u een config.xml -configuratiebestand maken op basis van het opgegeven voorbeeld.
U kunt als volgt de Data Migration Tool for migration configureren:
-
Login aan uw toepassingsserver als, of schakelaar aan, de eigenaar van het dossiersysteem .
-
Ga naar de volgende map:
code language-bash <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version> -
Voer de volgende opdracht in om een
config.xmlvan het opgegeven voorbeeld te maken:code language-bash cp config.xml.dist config.xml -
Open
config.xmlin een teksteditor. -
Het bestand config.xml moet ten minste toegangsgegevens bevatten voor de databases M1 en M2 en de coderingssleutels.
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>De tag <crypt_key> moet een waarde bevatten. U vindt deze in de tag
<key>, die zich bevindt in het bestand app/etc/local.xml op uw Magento 1-exemplaar.Optionele parameters:
- Wachtwoord databasegebruiker:
password=<password> - Aangepaste poort database:
port=<port> - Tabelvoorvoegsel:
<source_prefix>,<dest_prefix>
Als de gebruikersnaam van de eigenaar van de database bijvoorbeeld
rootmet wachtwoordpassis en u het voorvoegselmagento1gebruikt in de Magento 1-database, gebruikt u het volgende 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> - Wachtwoord databasegebruiker:
Als u klaar bent, slaat u de wijzigingen op in config.xml en sluit u de teksteditor.
Verbinding maken via het TLS-protocol
U kunt ook verbinding maken met een database met behulp van het TLS-protocol (dat wil zeggen met cryptografische openbare/persoonlijke sleutels). Voeg de volgende optionele kenmerken toe aan het element database :
ssl_cassl_certssl_key
Bijvoorbeeld:
<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>
Werken met configuratie- en toewijzingsbestanden
Data Migration Tool gebruikt kaartdossiers om u toe te laten om douanedatabatstoewijzing tussen uw Magento 1 en Magento 2 gegevensbestanden uit te voeren, die omvatten:
-
Tabelnamen wijzigen
-
Veldnamen wijzigen
-
Tabellen of velden negeren
-
Gegevens van een veld naar Magento 2-indeling overdragen
Toewijzingsbestanden voor ondersteunde Magento-versies bevinden zich in submappen van <your Magento 2 install dir>/vendor/magento/data-migration-tool/etc
De toewijzingsbestanden gebruiken:
-
Kopieer deze uit
<your Magento 2 install dir>/vendor/magento/data-migration-tool/etc/<migration edition>/<ce or version>/naar<your Magento 2 install dir>/app/code/Vendor/Migration/etc/<migration edition>/<ce or version>/en verwijder de extensie.dist. -
Werk het pad naar het zojuist gekopieerde bestand bij in het knooppunt
<options>vanconfig.xml. Het bijgewerkte pad moet een van de volgende zijn:- Absoluut bestandspad, bijvoorbeeld
/var/www/html/app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml - magento/data-migration-tool module relatief bestandspad:
etc/opensource-to-opensource/1.9.4.1/map.xml - Magento-pad naar hoofdmapafhankelijk bestand:
app/code/Vendor/Migration/etc/opensource-to-opensource/1.9.4.1/map.xml
- Absoluut bestandspad, bijvoorbeeld
De mappen <Magento 2 dir>/vendor/magento/data-migration-tool/etc en <Magento 2 dir>/vendor/magento/data-migration-tool/etc/<ce version> bevatten de volgende configuratiebestanden:
Hoewel u het grootste deel van de tijd met het map.xml.dist dossier werkt, bespreekt de volgende lijst elke afbeelding en andere dossiers.
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 table.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.distU kunt naar Data Migration Tool Technische Specificatie voor meer details verwijzen.