> For the complete documentation index, see [llms.txt](https://docs.ecommerce-integrator.de/magento2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ecommerce-integrator.de/magento2/installation.md).
# Installation
## Vorbereitungen
{% hint style="warning" %}
Hinweis: Diese Installationsdokumentation bezieht sich explizit auf die eCI Magento 2 Plugin Version 2020.11 und höher! Solltest du noch die Version 2020.10.3 nutzen, so erfolgt die Installation noch über den API Benutzer, welcher automatisch angelegt wird nach der Installation des eCI Magento 2 Plugins.
{% endhint %}
Stelle vor der Installation des eCI Magento 2 Plugins sicher, dass die [Systemanforderungen](/magento2/systemanforderungen.md) erfüllt sind und die [Kompatibilität](/magento2/kompatibilitaet.md) mit den anzuschließenden Systemen gewährleistet ist.
### Serverseitige Vorbereitungen
* Bitte stelle sicher, dass der Magento-Cronjob ordnungsgemäß eingerichtet ist und arbeitet.
* Bitte beachte, dass der Magento Cronjob als serverseitiger Prozess auf der Kommandozeile arbeitet! Stelle daher unbedingt sicher, dass die dort verwendete PHP Version zur Version über den Browser (HTTPs) identisch ist!
### Vorbereitung des Magento-Systems
* Stelle sicher, dass Magento für den deutschen Markt konfiguriert ist und alle notwendigen Steuerregeln angelegt sind.
* Stelle sicher, dass der Zugriff auf die REST-API gegeben ist. Dies kannst du durch folgenden Aufruf testen: `https://deine-shopdomain.tld/rest/V1` Hier muss nun einen XML Datei mit der Ausgabe `Request does not match any route.` erscheinen. Ist dies nicht der Fall, prüfe bitte die .htaccess von Magento oder wende dich an deine Agentur.
{% hint style="warning" %}
Seit Magento Version 2.4.4 sind die Integrationen unter Umständen bei einer Neuinstallation von Magento nicht mehr wie gewohnt aktiv. Dies muss jedoch für den eCI gegeben sein.
Du kannst die Integrationen mit folgendem Befehl in deinem Magento 2 Verzeichnis aktivieren:
`bin/magento config:set oauth/consumer/enable_integration_as_bearer 1`
{% endhint %}
## Download des Installationspakets
Die jeweils aktuelle Version des eCI Magento 2 Plugins findest du im Kundenbereich direkt an den jeweiligen Bestellungen. Bei jeder Abrechnung des Abos (in der Regel im monatlichen Intervall) wird eine neue Bestellung erzeugt. Im Kundenbereich findest du diese unter dem Menüpunkt "Bestellungen".
Erweitere die Bestelldetails in der Bestellübersicht durch einen Klick auf den Button "Anzeigen".
## Neuinstallation
Entpacke das ZIP-Archiv. Lade anschließend zur Installation des Plugins den Inhalt des soeben entpackten Ordners in das Wurzelverzeichnis deines Shops (dort muss sich bereits ein gleichnamiger Ordner "app" befinden).
Die Installation erfolgt exakt nach der offiziellen Anleitung der Herstellers:
```bash
# löschen der kompilierten Systemdaten und des Caches
rm -rf var/cache/ var/page_cache/ var/di/ var/generation/
# Aktivierung des Produktiv Modus
php -d memory_limit=-1 bin/magento deploy:mode:set production
# Aktivierung des Moduls
php -d memory_limit=-1 bin/magento module:enable Sysgrade_Eci
# Aktualisierung der Magentomudule und Abhängigkeiten
php -d memory_limit=-1 bin/magento setup:upgrade
# Neukompilierung des Systems
php -d memory_limit=-1 bin/magento setup:di:compile
# Leeren des Caches
php -d memory_limit=-1 bin/magento cache:clean
# Erstellen der statischen Templatedateien (optional, nur im Livebetrieb erforderlich)
php -d memory_limit=-1 bin/magento setup:static-content:deploy
# Neuaufbau des Indexes
php -d memory_limit=-1 bin/magento indexer:reindex
```
### Konfiguration der Magento 2 Integration
Mit Beginn der Version 2020.11 des eCommerce Integrators wird dieser direkt als Integration in Magento 2 angebunden. Dafür sind einige Schritte notwendig.
* Melde dich im Magento 2 Backend an
* Wähle unter *System* > *Extensions* den Punkt *Integrations* aus
* Sofern keine weiteren Extensions eine Integration eingerichtet haben oder du diese nicht eingerichtet hast, sieht die Übersicht wie folgt aus:
* Wähle den Punkt *Add New Integration* aus und trage die entsprechenden Daten bei *Integration Info* ein. Dabei sind nur die Felder *Name*, *Email* und *Your Password* wichtig. Alle anderen Felder sind aktuell nicht notwendig und müssen leer gelassen werden.
* Wechsle auf den Register *API* und wähle unter *Resource Access* den Punkt *All* aus, sofern dieser nicht auf *Custom* stehen sollte.
{% hint style="info" %}
Bitte wähle hier nicht einzelne Punkte aus. Magento 2 ist ein komplexes System und bedarf verschiedener Berechtigungen. So führt der Produkt Import unter Umständen dazu, dass Reports generiert oder Statistiken erneuert oder beim Anlegen von Versandinformationen automatisch Rechnungen in Magento erstellt werden müssen. All diese Berechtigungen benötigt dann eine Integration des eCommerce Integrators!
{% endhint %}
* Drücke nun auf *Save*, wodurch du automatisch zurück zu Übersicht kommst. Dort siehst du nun die neue Integration des eCommerce Integrators. Dabei ist der *Status* noch auf *Inactive*.
* Durch einen Klick auf Activate in der Übersicht startest du die Aktivierung der eCI Integration. Es erscheint eine neue Maske, in der nochmals alle API Zugriffsrechte aufgeführt werden. Bestätige dies über den Button *Allow*.
* Nachdem du *Allow* gedrückt hast, erscheint nun ein Fenster, in denen du die Tokens der Integration siehst. Diese bestehen immer aus einem Key/Token und einem Secret, also einer Art Benutzername und Kennwort. Notiere dir bitte die entsprechenden Schlüssel an einem sicheren Ort. Du kannst die Daten später jedoch auch nochmals kontrollieren bzw. abfragen.
* Danach bestätigst du über *Done* die Einrichtung und Aktivierung und kehrst automatisch zur Übersicht der Integrationen zurück.
{% hint style="danger" %}
Gib diese Daten niemals an unbekannte Dritte weiter! Durch diese Schlüsselpaare können Fremde entsprechend auf deine Magento 2 Installation und somit alle Daten, darunter Kundendaten, zugreifen! Solltest du der Meinung sein, dass unbefugte Dritte Zugriff auf diese Schlüssel haben, so ändere diese umgehend. Weitere Informationen findest Du in der [FAQ](/magento2/faq.md#aenderung-der-schluessel-fuer-die-integration).
{% endhint %}
Damit ist die Integration des eCommerce Integrators in Magento abgeschlossen.
## Update
{% hint style="danger" %}
WICHTIG
Beim Update einer früheren Plugin Version (<= 2020.10) ist es erforderlich, die Plugindateien auf Dateisystembasis zu löschen. Dabei handelt es sich um das Verzeichnis: \/app/code/Sysgrade/, welches zu entfernen ist.
Anschließend kopierst du die Dateien der neuen Version in das Pluginverzeichnis und kompilierst neu.
Danach erstellst du wie obenstehend beschrieben eine Magento 2 Integration.
In der eCI JTL-Wawi App deaktivierst du zuerst alle zeitgesteuerten Abgleich unter "Zeitplanung". Danach ist die Konfiguration der Webshop-Verbindung zu überarbeiten. Eine Anleitung zu diesem Thema findest du unter [Verbindung mit JTL Wawi](/magento2/jtl-wawi/verbindung.md).
Nachdem du die neue Konfiguration gespeichert hast, führst du einen erstmaligen Kategorieabgleich durch.
Als nächstes führst du einen Vollabgleich aller Produkte aus.
Diese Schritte sind aufgrund des Wechsels auf die Magento-API notwendig.
{% endhint %}
Das Update auf eine neue Version verläuft identisch mit der oben beschriebenen Vorgehensweise bei der Neuinstallation.
Du musst keine Änderungen an der Integration vornehmen.
##
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.ecommerce-integrator.de/magento2/installation.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.