Installieren von Adobe Commerce

Führen Sie zuerst die folgenden Schritte aus:

NOTE
Sie müssen die Anwendung aus dem Unterverzeichnis bin installieren.

Sie können das Installationsprogramm mehrmals mit verschiedenen Optionen ausführen, um Installationsaufgaben wie die folgenden abzuschließen:

  • In Phasen installieren - Nachdem Sie beispielsweise Ihren Webserver für Secure Sockets Layer (SSL) konfiguriert haben, können Sie das Installationsprogramm erneut ausführen, um SSL-Optionen festzulegen.

  • Korrigieren Sie Fehler in früheren Installationen.

  • Installieren Sie die Anwendung in einer anderen Datenbankinstanz.

NOTE
Standardmäßig überschreibt das Installationsprogramm die Datenbank nicht, wenn Sie die Commerce-Software in derselben Datenbankinstanz installieren. Sie können den optionalen Parameter cleanup-database verwenden, um dieses Verhalten zu ändern.

Siehe auch Aktualisieren, Neuinstallieren, Deinstallieren.

Sichere Installation

Um Secure Sockets Layer (SSL), auch HTTPS genannt, sowohl für Admin als auch für die Storefront zu verwenden, müssen Sie alle folgenden Parameter festlegen:

  • --use-secure: Auf 1 setzen
  • --base-url-secure: Auf eine sichere URL festlegen (d. h., beginnend mit https://)
  • --use-secure-admin Auf 1 setzen

Weitere Informationen zu diesen Parametern finden Sie weiter unten in diesem Thema.

Hilfebefehle für Installationsprogramme

Sie können die folgenden Befehle ausführen, um Werte für einige erforderliche Argumente zu finden:

Installationsargument
Befehl
Sprache
magento info:language:list
Währung
magento info:currency:list
Zeitzone
magento info:timezone:list
NOTE
Wenn beim Ausführen dieser Befehle ein Fehler angezeigt wird, überprüfen Sie, ob Sie die Installationsabhängigkeiten aktualisiert haben, wie unter Aktualisieren der Installationsabhängigkeiten beschrieben.

Installieren über die Befehlszeile

Der Installationsbefehl verwendet das folgende Format:

magento setup:install --<option>=<value> ... --<option>=<value>

In den folgenden Tabellen werden die Namen und Werte der Installationsoptionen beschrieben, z. B. Installationsbefehle. Siehe Beispiel für lokale Host-Installationen.

NOTE
Alle Optionen, die Leerzeichen oder Sonderzeichen enthalten, müssen in einfache oder doppelte Anführungszeichen gesetzt werden.

Administratorberechtigungen:

Die folgenden Optionen geben die Benutzerinformationen und Anmeldeinformationen für den Admin-Benutzer an.

In Adobe Commerce-Version 2.2.8 und höher können Sie den Admin-Benutzer während oder nach der Installation erstellen. Wenn Sie den Benutzer während der Installation erstellen, sind alle Variablen mit Administratorberechtigungen erforderlich. Siehe Beispiel für lokale Host-Installationen.

Name
Wert
Erforderlich?
--admin-firstname
Vorname des Administratorbenutzers.
Ja
--admin-lastname
Nachname des Administratorbenutzers.
Ja
--admin-email
E-Mail-Adresse des Administrators.
Ja
--admin-user
Administrator-Benutzername.
Ja
--admin-password
Administratorkennwort. Das Kennwort muss mindestens 7 Zeichen lang sein und mindestens ein alphabetisches und ein numerisches Zeichen enthalten. Wir empfehlen ein längeres, komplexeres Passwort. Schließen Sie die gesamte Kennwortzeichenfolge in einfache Anführungszeichen ein. Beispiel: --admin-password='A0b9%t3g'
Ja

Site- und Datenbankkonfigurationsoptionen:

Name
Wert
Erforderlich?
--base-url
Basis-URL für den Zugriff auf Ihren Admin und Ihre Storefront in einem der folgenden Formate:

http[s]://<host or ip>/<your install dir>/.

Hinweis: Das Schema (http:// oder https://) und ein Schrägstrich sind beide erforderlich.

<your install dir> ist der docroot-relative Pfad, in dem die Anwendung installiert werden soll. Je nachdem, wie Sie Ihren Webserver und virtuelle Hosts einrichten, kann der Pfad magento2 sein oder leer sein.

Um auf die Anwendung auf localhost zuzugreifen, können Sie entweder http://127.0.0.1/<your install dir>/ oder http://127.0.0.1/<your install dir>/ verwenden.

- {{base_url}} , was eine Basis-URL darstellt, die von einer virtuellen Host-Einstellung oder einer Virtualisierungsumgebung wie Docker definiert wird. Wenn Sie beispielsweise einen virtuellen Host mit dem Hostnamen commerce.example.com einrichten, können Sie die Anwendung mit --base-url={{base_url}} installieren und mit einer URL wie http://commerce.example.com/admin auf den Admin zugreifen.
Ja
--backend-frontname
Uniform Resource Identifier (URI) für den Zugriff auf den Admin. Sie können diesen Parameter weglassen, damit die Anwendung einen zufälligen URI für Sie mit dem folgenden Muster generiert: admin_jkhgdfq.

Aus Sicherheitsgründen empfehlen wir einen zufälligen URI. Eine zufällige URI ist für Hacker oder böswillige Software schwieriger zu nutzen.

Der URI wird am Ende der Installation angezeigt. Sie können es jederzeit mit dem Befehl magento info:adminuri anzeigen.

Wenn Sie einen Wert eingeben möchten, empfehlen wir, kein gemeinsames Wort wie "admin", "backend"zu verwenden. Der Admin-URI kann nur alphanumerische Werte und das Unterstrichzeichen (_) enthalten.
Nein
--db-host
Verwenden Sie einen der folgenden Schritte:

- Der vollständig qualifizierte Hostname oder die IP-Adresse des Datenbankservers.

- localhost (Standard) oder 127.0.0.1 , wenn sich Ihr Datenbankserver auf demselben Host wie Ihr Webserver befindet. localhost bedeutet, dass die MySQL-Client-Bibliothek UNIX-Sockets verwendet, um eine Verbindung zur Datenbank herzustellen. 127.0.0.1 bewirkt, dass die Client-Bibliothek das TCP-Protokoll verwendet. Weitere Informationen zu Sockets finden Sie in der PHP PDO_MYSQL-Dokumentation.

Hinweis: Sie können optional den Datenbankserver-Port in seinem Hostnamen angeben, z. B. www.example.com:9000
Ja
--db-name
Name der Datenbankinstanz, in der Sie die Datenbanktabellen installieren möchten.

Der Standardwert ist magento2.
Ja
--db-user
Benutzername des Eigentümers der Datenbankinstanz.

Der Standardwert ist root.
Ja
--db-password
Passwort des Inhabers der Datenbankinstanz.
Ja
--db-prefix
Verwenden Sie dies nur, wenn Sie die Datenbanktabellen in einer Datenbankinstanz installieren, in der bereits Adobe Commerce-Tabellen enthalten sind.

Verwenden Sie in diesem Fall ein Präfix, um die Tabellen für diese Installation zu identifizieren. Einige Kunden haben mehrere Adobe Commerce-Instanzen, die auf einem Server mit allen Tabellen in derselben Datenbank ausgeführt werden.

Das Präfix kann maximal fünf Zeichen lang sein. Sie muss mit einem Brief beginnen und darf nur Buchstaben, Zahlen und Unterstriche enthalten.

Mit dieser Option können diese Kunden den Datenbankserver für mehrere Installationen freigeben.
Nein
--db-ssl-key
Pfad zum Client-Schlüssel.
Nein
--db-ssl-cert
Pfad zum Client-Zertifikat.
Nein
--db-ssl-ca
Pfad zum Serverzertifikat.
Nein
--language
Sprachcode für die Verwendung in Admin und Storefront. (Wenn Sie dies noch nicht getan haben, können Sie die Liste der Sprachcodes anzeigen, indem Sie magento info:language:list aus dem Ordner bin eingeben.)
Nein
--currency
Standardwährung für die Verwendung in der Storefront. (Wenn Sie dies noch nicht getan haben, können Sie die Liste der Währungen durch Eingabe von magento info:currency:list aus dem Ordner bin anzeigen.)
Nein
--timezone
Standardzeitzone zur Verwendung in der Admin- und Storefront. (Wenn Sie dies noch nicht getan haben, können Sie die Liste der Zeitzonen anzeigen, indem Sie magento info:timezone:list aus dem Ordner bin eingeben.)
Nein
--use-rewrites
1 bedeutet, dass Sie Webserver-Neuschreibungen für generierte Links in der Storefront und in Admin verwenden.

0 deaktiviert die Verwendung von Webserver-Neuschreibungen. Dies ist die Standardeinstellung.
Nein
--use-secure
1 ermöglicht die Verwendung von Secure Sockets Layer (SSL) in Storefront-URLs. Stellen Sie sicher, dass Ihr Webserver SSL unterstützt, bevor Sie diese Option auswählen.

0 deaktiviert die Verwendung von SSL. In diesem Fall wird angenommen, dass alle anderen sicheren URL-Optionen ebenfalls 0 sind. Dies ist die Standardeinstellung.
Nein
--base-url-secure
Sichere Basis-URL für den Zugriff auf Ihren Admin und Ihre Storefront im folgenden Format: http[s]://<host or ip>/<your install dir>/
Nein
--use-secure-admin
1 bedeutet, dass Sie SSL verwenden, um auf den Admin zuzugreifen. Stellen Sie sicher, dass Ihr Webserver SSL unterstützt, bevor Sie diese Option auswählen.

0 bedeutet, dass Sie SSL nicht mit dem Administrator verwenden. Dies ist die Standardeinstellung.
Nein
--admin-use-security-key
1 bewirkt, dass die Anwendung einen zufällig generierten Schlüsselwert verwendet, um auf Seiten in Admin und in Formularen zuzugreifen. Diese Schlüsselwerte helfen dabei, siteübergreifende Skriptfälschungsangriffe zu verhindern. Dies ist die Standardeinstellung.

0 deaktiviert die Verwendung des Schlüssels.
Nein
--session-save
Verwenden Sie einen der folgenden Schritte:

- db , um Sitzungsdaten in der Datenbank zu speichern. Wählen Sie Datenbankspeicher, wenn Sie über eine Clusterdatenbank verfügen. Andernfalls hat der dateibasierte Speicher möglicherweise keinen großen Vorteil.

- files , um Sitzungsdaten im Dateisystem zu speichern. Eine dateibasierte Sitzungsspeicherung ist angemessen, es sei denn, der Dateisystemzugriff ist langsam, Sie haben eine Clusterdatenbank oder Sie möchten Sitzungsdaten in Redis speichern.

- redis , um Sitzungsdaten in Redis zu speichern. Wenn Sie Redis für Standard- oder Seiten-Caching verwenden, muss Redis bereits installiert sein. Weitere Informationen zum Konfigurieren der Unterstützung für Redis finden Sie unter Verwenden von Redis für die Sitzungsspeicherung .
Nein
--key
Wenn Sie einen Schlüssel haben, geben Sie einen Schlüssel an, um vertrauliche Daten in der Datenbank zu verschlüsseln. Wenn Sie keine haben, generiert das Programm eine für Sie.
Ja
--cleanup-database
Um Datenbanktabellen vor der Installation der Anwendung abzulegen, geben Sie diesen Parameter ohne Wert an. Andernfalls bleibt die Datenbank intakt.
Nein
--db-init-statements
Erweiterter MySQL-Konfigurationsparameter. Verwendet Anweisungen zur Datenbankinitialisierung, die beim Herstellen einer Verbindung zur MySQL-Datenbank ausgeführt werden. Lesen Sie einen ähnlichen Verweis wie diesen, bevor Sie Werte festlegen.

Der Standardwert ist SET NAMES utf8;.
Nein
--sales-order-increment-prefix
Geben Sie einen Zeichenfolgenwert an, der als Präfix für Verkaufsaufträge verwendet werden soll. Normalerweise wird dies verwendet, um eindeutige Bestellnummern für Zahlungsverarbeiter zu garantieren.
Nein
TIP
Informationen zum Aktivieren von Remote-Speicherdiensten während der Installation finden Sie unter Remote-Speicher konfigurieren im Konfigurationshandbuch .

Suchmaschinenkonfigurationsoptionen:

Name
Wert
Erforderlich?
--search-engine
Die Version der Suchmaschine. Mögliche Werte sind elasticsearch7, elasticsearch6 und elasticsearch5. Der Standardwert ist elasticsearch7. Wenn Sie OpenSearch als Suchmaschine installiert haben, geben Sie den Wert elasticsearch7 an. Elasticsearch 5 wird nicht mehr empfohlen.
Nein
--elasticsearch-host
Der Hostname oder die IP-Adresse, unter der die Suchmaschine ausgeführt wird. Der Standardwert ist localhost.
Nein
--elasticsearch-port
Der Port für eingehende HTTP-Anforderungen. Der Standardwert ist 9200.
Nein
--elasticsearch-index-prefix
Ein Präfix, das den Suchindex angibt. Der Standardwert ist magento2.
Nein
--elasticsearch-timeout
Die Anzahl der Sekunden, bevor das System eine Zeitüberschreitung aufweist. Der Standardwert ist 15.
Nein
--elasticsearch-enable-auth
Aktiviert die Authentifizierung auf dem Suchmaschinenserver. Der Standardwert ist false.
Nein
--elasticsearch-username
Die zu authentifizierende Benutzer-ID
Nein, sofern die Authentifizierung nicht aktiviert ist
--elasticsearch-password
Das zu authentifizierende Kennwort
Nein, sofern die Authentifizierung nicht aktiviert ist

RabbitMQKonfigurationsoptionen:

Name
Wert
Erforderlich?
--amqp-host
Verwenden Sie die --amqp -Optionen nur, wenn Sie bereits eine Installation von RabbitMQ eingerichtet haben. Weitere Informationen zum Installieren und Konfigurieren von RabbitMQ finden Sie unter RabbitMQ Installation .

Der Hostname, auf dem RabbitMQ installiert ist.
Nein
--amqp-port
Der Anschluss, über den eine Verbindung zu RabbitMQ hergestellt werden soll. Der Standardwert ist 5672.
Nein
--amqp-user
Der Benutzername für die Verbindung mit RabbitMQ. Verwenden Sie nicht den Standardbenutzer guest.
Nein
--amqp-password
Das Kennwort für die Verbindung mit RabbitMQ. Verwenden Sie nicht das Standardkennwort guest.
Nein
--amqp-virtualhost
Der virtuelle Host für die Verbindung mit RabbitMQ. Der Standardwert ist /.
Nein
--amqp-ssl
Gibt an, ob eine Verbindung zu RabbitMQ hergestellt werden soll. Der Standardwert ist false. Informationen zum Einrichten von SSL für RabbitMQ finden Sie unter RabbitMQ .
Nein
--consumers-wait-for-messages
Sollten Verbraucher auf eine Nachricht aus der Warteschlange warten? 1 - Ja, 0 - Nein
Nein

Remote-Speicheroptionen:

Name
Beschreibung
Erforderlich?
remote-storage-driver
Adaptername
Mögliche Werte:
file: Deaktiviert den Remote-Speicher und verwendet das lokale Dateisystem
aws-s3: Verwenden Sie den Amazon Simple Storage Service (Amazon S3)
Nein
remote-storage-bucket
Objektspeicherung oder Containername
Nein
remote-storage-prefix
Optionales Präfix (Speicherort innerhalb des Objektspeichers)
Nein
remote-storage-region
Regionsname
Nein
remote-storage-key
Optionaler Zugriffsschlüssel
Nein
remote-storage-secret
Optionaler geheimer Schlüssel
Nein

Konfigurationsoptionen sperren:

Name
Wert
Erforderlich?
--lock-provider
Name des Anbieters sperren.

Verfügbare Sperranbieter: db, zookeeper, file.

Der standardmäßige Sperranbieter: db
Nein
--lock-db-prefix
Das spezifische db-Präfix, um Sperrkonflikte bei der Verwendung des db -Sperranbieters zu vermeiden.

Der Standardwert: NULL
Nein
--lock-zookeeper-host
Hosten und Anschluss für die Verbindung mit dem Zookeeper-Cluster bei Verwendung des zookeeper-Sperranbieters.

Beispiel: 127.0.0.1:2181
Ja, wenn Sie --lock-provider=zookeeper festlegen
--lock-zookeeper-path
Der Pfad, in dem Zookeeper Sperren speichert.

Der Standardpfad lautet: /magento/locks
Nein
--lock-file-path
Der Pfad, in dem Dateisperren gespeichert werden.
Ja, wenn Sie --lock-provider=file festlegen

Konfigurationsoptionen für Verbraucher:

Name
Beschreibung
Wert
Erforderlich
--consumers-wait-for-messages
Bestimmt, ob Verbraucher auf eine Nachricht aus der Warteschlange warten.
1 - Ja, 0 - Nein
Nein
  • 0: Die Verbraucher verarbeiten verfügbare Nachrichten in der Warteschlange, schließen die TCP-Verbindung und beenden sie. Die Verbraucher warten nicht darauf, dass zusätzliche Nachrichten in die Warteschlange gelangen, selbst wenn die Anzahl der verarbeiteten Nachrichten kleiner ist als der beim Start der Verbraucher festgelegte Wert --max_messages .

  • 1: Verbraucher verarbeiten weiterhin Nachrichten aus der Nachrichtenwarteschlange, bis sie die maximale Anzahl von Nachrichten erreichen (der für --max_messages beim Befehl queue:consumers:start angegebene Wert), bevor sie die TCP-Verbindung schließen und den Verbraucherprozess beenden. Wenn die Warteschlange vor Erreichen von --max_messages geleert wird, wartet der Verbraucher, bis weitere Nachrichten eintreffen. Wenn Sie Sekundäre verwenden, um Verbraucher anstatt eines Cron-Auftrags auszuführen, setzen Sie diese Variable auf 1.

WARNING
Die Option --consumers-wait-for-messages ist eine globale Option und kann nicht für jeden Verbraucher einzeln konfiguriert werden.
NOTE
Informationen zum Aktivieren oder Deaktivieren von Modulen nach der Installation der Anwendung finden Sie unter Module aktivieren und deaktivieren.

Vertrauliche Daten:

Adobe Commerce verschlüsselt Folgendes mit Ihrem Verschlüsselungsschlüssel:

  • Kreditkarteninformationen
  • Benutzernamen und Kennwörter, die in der Admin-Konfiguration angegeben sind (z. B. Anmeldungen bei Payment Gateways)
  • CAPTCHA-Werte, die über das Netzwerk gesendet werden

Adobe Commerce verschlüsselt nicht:

  • Administrations- und Kundenbenutzernamen und -kennwörter (diese Kennwörter werden gehasht)
  • Adresse
  • Telefonnummer
  • Sonstige Arten von persönlich identifizierbaren Informationen außer Kreditkartennummern

Beispiele für lokale Host-Installationen

Die folgenden Beispiele zeigen die Befehle zur lokalen Installation von Adobe Commerce mit verschiedenen Optionen.

Beispiel 1: Grundlegende Installation mit einem Administratorkonto

Im folgenden Beispiel wird die Anwendung mit den folgenden Optionen installiert:

  • Das Programm wird im Ordner "magento2" relativ zum Basisverzeichnis des Webservers unter "localhost" installiert und der Pfad zum Admin ist "admin". Daher gilt:

    Ihre Storefront-URL lautet http://127.0.0.1

  • Der Datenbankserver befindet sich auf demselben Host wie der Webserver.

    Der Datenbankname ist magento und der Benutzername und das Kennwort sind beide magento

  • Verwendet Server-Neuschreibungen

  • Der Administrator verfügt über die folgenden Eigenschaften:

    • Vor- und Nachnamen lauten Commerce User
    • Benutzername ist admin und das Kennwort ist admin123
    • E-Mail-Adresse ist user@example.com
  • Die Standardsprache ist en_US (US-Englisch).

  • Die Standardwährung ist US-Dollar.

  • Die standardmäßige Zeitzone ist US Central (Amerika/Chicago).

  • Elasticsearch 7 wird auf es-host.example.com installiert und verbindet sich mit Port 9200

magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--admin-firstname=Commerce --admin-lastname=User --admin-email=user@example.com \
--admin-user=admin --admin-password=admin123 --language=en_US \
--currency=USD --timezone=America/Chicago --use-rewrites=1 \
--search-engine=elasticsearch7 --elasticsearch-host=es-host.example.com \
--elasticsearch-port=9200

Meldungen, die der folgenden Anzeige ähneln, zeigen eine erfolgreiche Installation an:

Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q

Beispiel 2: Grundlegende Installation ohne Administratorkonto

Sie können die Anwendung installieren, ohne den Administrator-Benutzer zu erstellen, wie im folgenden Beispiel gezeigt.

magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--language=en_US --currency=USD --timezone=America/Chicago --use-rewrites=1 \
--search-engine=elasticsearch7 --elasticsearch-host=es-host.example.com \
--elasticsearch-port=9200

Meldungen wie die folgende werden bei erfolgreicher Installation angezeigt:

Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q

Nach der Installation können Sie einen Admin-Benutzer mithilfe des Befehls admin:user:create erstellen:
Erstellen oder Bearbeiten eines Administrators

Beispiel 3: Installation mit zusätzlichen Optionen

Im folgenden Beispiel wird die Anwendung mit den folgenden Optionen installiert:

  • Die Magapplication wird im Verzeichnis magento2 relativ zum Basisverzeichnis des Webservers unter localhost installiert und der Pfad zum Admin ist admin. Daher gilt:

    Ihre Storefront-URL lautet http://127.0.0.1

  • Der Datenbankserver befindet sich auf demselben Host wie der Webserver.

    Der Datenbankname ist magento und der Benutzername und das Kennwort sind beide magento

  • Der Administrator verfügt über die folgenden Eigenschaften:

    • Vor- und Nachnamen lauten Commerce User
    • Benutzername ist admin und das Kennwort ist admin123
    • E-Mail-Adresse ist user@example.com
  • Die Standardsprache ist en_US (US-Englisch).

  • Die Standardwährung ist US-Dollar.

  • Die standardmäßige Zeitzone ist US Central (Amerika/Chicago).

  • Das Installationsprogramm bereinigt zunächst die Datenbank, bevor die Tabellen und das Schema installiert werden

  • Sie verwenden ein "ORD$"-Inkrementierungs-Präfix (da es das Sonderzeichen "[$]" enthält, muss der Wert in doppelte Anführungszeichen gesetzt werden)

  • Sitzungsdaten werden in der Datenbank gespeichert

  • Verwendet Server-Neuschreibungen

  • Elasticsearch 7 wird auf es-host.example.com installiert und verbindet sich mit Port 9200

magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--admin-firstname=Commerce --admin-lastname=User --admin-email=user@example.com \
--admin-user=admin --admin-password=admin123 --language=en_US \
--currency=USD --timezone=America/Chicago --cleanup-database \
--sales-order-increment-prefix="ORD$" --session-save=db --use-rewrites=1 \
--search-engine=elasticsearch7 --elasticsearch-host=es-host.example.com \
--elasticsearch-port=9200
NOTE
Sie müssen den Befehl entweder in einer einzelnen Zeile oder, wie im vorangehenden Beispiel, mit dem Zeichen \ am Ende jeder Zeile eingeben.

Meldungen wie die folgende werden bei erfolgreicher Installation angezeigt:

Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q
TIP
Wenn Sie über ein Benutzerkonto für den Zugriff auf den Anwendungsserver verfügen, finden Sie weitere Informationen unter Einrichten einer Umfrage. Dieser Einrichtungstyp ist typisch für freigegebenes Hosting.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995