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 migreert, 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.dist
configuratiebestand 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 Edition
naarMagento 2 Open Source
migreert: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 opslag M1 douaneveranderingen heeft, zou u de rest van uw configuratiedossiers aan uw Magento 1 opslagaanpassingen moeten in kaart brengen. 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.xml
van het opgegeven voorbeeld te maken:code language-bash cp config.xml.dist config.xml
-
Open
config.xml
in 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
root
met wachtwoordpass
is en u het voorvoegselmagento1
gebruikt in de database van Magento 1, 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_ca
ssl_cert
ssl_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
-
De overdracht van gegevens van een veld aanpassen aan de indeling Magento 2
Toewijzingsbestanden voor ondersteunde versies van Magento's 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
- Hoofdmapafhankelijk relatief bestandspad van Magento:
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.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
table.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
U kunt naar Data Migration Tool Technische Specificatievoor meer details verwijzen.