1. Introductie

Versie 2.x van Magento, ontwikkeld door Netresearch, heeft het einde van zijn levensduur bereikt. Als je deze versie nog gebruikt, moet je overstappen naar Magento 2.x, ontwikkeld door onze erkende provider Limegrow. Zo blijf je PCI-conform en kun je profiteren van nieuwe Magento-ontwikkelingen.

Overschakelen op de versie van Limegrow betekent dat je jouw instellingen (configuraties, SHA-wachtwoordzinnen, instellingen voor betalingsmethoden etc.) en aliassen van de ene versie naar de andere moet verplaatsen.

Dankzij onze handleiding is dat geen enkel probleem!

2. Kies je migratiemethode

Je kunt de instellingen/aliassen op twee manieren migreren. Zorg er eerst voor dat je Magento 2 hebt geïnstalleerd en geconfigureerd.

Kies hierna een migratiemethode:

  1. Via het Magento-admin panel: gebruik een speciaal hiervoor gemaakte plug-in met de vertrouwde Magento-gebruikersinterface. Er zijn twee eenvoudige knoppen en enkele php-opdrachten waarmee je jouw instellingen en/of aliassen kunt importeren/exporteren. Je kunt de instellingen/aliassen afzonderlijk of tegelijk migreren.
  2. Via de CLI (command-line interface): voer een paar php-opdrachten uit om je instellingen/aliassen te exporteren/importeren met het Explorer-/importeerprogramma dat in 1 werd beschreven. We bevelen deze methode aan als je meer dan 100,00 aliassen moet migreren en/of als je een oplossing gebruikt (m.a.w. Cloudflare) die de webaanvraagtijd tot 30 seconden beperkt.

    3. Het Magento-configuratiepaneel gebruiken

    Importeer eerst je instellingen/aliassen via de vertrouwde Magento 2-interface en exporteer ze dan.

    Exporteer de instellingen/aliassen uit je oude Magento-versie:

    • Download onze Migration-m2-m2-plug-in.
    • Pak de plug-in uit in de map /app/code/Ingenico/Migration van je verouderde Netresearch Magento 2-module. Zorg ervoor dat het bestand "php" in de map /app/code/Ingenico/Migration/ zit.
    • Navigeer in je shell/terminal naar Magento Voer de volgende opdrachten uit.
    
    php bin/magento module:enable Ingenico_Migration –-clear-
    static-content
    php bin/magento setup:upgrade
    php bin/magento cache:clean
        
    • Meld je aan bij je Magento 2-configuratiepaneel. Ga naar Stores > Configuration > Ingenico Migration > Export. Geef een waarde in voor "Password". Onthoud deze waarde, je zult deze nodig hebben wanneer je de gegevens exporteert.
    • Klik op "Export". Er wordt een bestand gedownload dat tijdens de tweede stap voor importeren wordt gebruikt.

    Importeer de gegevens uit het door jou gedownloade bestand:

    • Installeer de bovengenoemde plug-in in je Limegrow Magento 2-module zoals hierboven wordt beschreven.
    • Meld je aan bij je Magento 2-admin panel. Ga naar Stores > Configuration > Ingenico Migration > Import. Geef het wachtwoord op dat je tijdens de eerste stap bij "Password" hebt gedefinieerd. Klik op "Choose file" om het bestand te selecteren dat je tijdens de eerste stap hebt geëxporteerd. Klik op "Import".
    • De module verwerkt het bestand. Zodra het bestand is verwerkt, wordt het bericht "Data successfully imported!" weergegeven.
    • Ga naar Stores > General > Connection / Settings om te controleren of al je instellingen op de juiste wijze zijn gemigreerd.

    Als je meer technische hulp nodig hebt om de migratie uit te voeren, kun je contact opnemen met onze erkende provider Limegrow. Houd er rekening mee dat hieraan kosten verbonden kunnen zijn, aangezien deze ondersteuning niet van Ingenico afkomstig is.

    4. CLI gebruiken

    Importeer eerst je instellingen/aliassen via de command-line interface (CLI) en exporteer ze dan.

    Zorg ervoor dat je SSH-toegang hebt voor het gebruiken van opdrachten.

    Exporteer de instellingen/aliassen uit je oude Magento-versie:

      • Download onze Migration-m2-m2-plug-in.
      • Pak de plug-in uit in de map /app/code/Ingenico/Migration van je verouderde Netresearch Magento 2-module. Zorg ervoor dat het bestand "php" in de map /app/code/Ingenico/Migration/ zit.
      • Ga via je opdrachtregel naar de map Magento 2
      • Typ deze opdracht voor assistentie van de exporttool:
    
    bin/magento ingenico:migration:export --help
        
      • Het resultaat is als volgt:
    
    Description:
    Export Ingenico data (aliases, settings) into the file.
    Usage:
    ingenico:migration:export [options] Options:
    --file=FILE File
    --password=PASSWORD Password
    -h, --help Display this help message
    .......
        
      • Exporteer door de volgende opdracht in te geven:
    
    php bin/magento ingenico:migration:export --file=./data1.dat --password=password123
    
      • Als het exporteren start, zegt de opdrachtregel het volgende:

    
    Starting export...
    

    Er wordt een bestand gedownload dat tijdens de tweede stap voor importeren wordt gebruikt.

    Importeer de gegevens uit het door jou gedownloade bestand. We gebruiken tijdens de volgende stap de plaatshouder "dump.data"

      • Installeer de bovengenoemde plug-in in je Limegrow Magento 2-module zoals hierboven wordt beschreven.
      • Verplaats data naar de server waarop je Limegrow Magento 2 hebt geïnstalleerd.
      • Verander de map in die van de Magento 2 root.
      • Typ deze opdracht voor assistentie van de exporttool:
    
    bin/magento ingenico:migration:import --help
        
      • Het resultaat is als volgt:
    
    Description: 
    Imports Ingenico data (aliases, settings) into the database. 
    Usage: 
    ingenico:migration:import [options] 
    Options: 
    --file=FILE File 
    --password=PASSWORD Password 
    -h, --help Display this help message 
    .......
        
      • Importeer door de volgende opdracht in te geven:
    
    php bin/magento ingenico:migration:import --file=./data1.dat --password=password123
        

    Het resultaat is als volgt:

    
    Loading the file... Decrypting... Initializing import ...... Importing configuration...Importing aliases... 0 [->--------------------------]Data successfully imported!
    
    • Als je meer technische hulp nodig hebt om de migratie uit te voeren, kun je contact opnemen met onze erkende provider Limegrow. Houd er rekening mee dat hieraan kosten verbonden kunnen zijn, aangezien deze ondersteuning niet van Ingenico afkomstig is.