Installieren von Adobe Commerce
Erstellt für:
- Experte
- Admin
- Entwickler
Bevor Sie beginnen, führen Sie die folgenden Schritte aus:
-
Stellen Sie sicher, dass Ihr System die unter (Systemanforderungen beschriebenen Anforderungen.
-
Alle () Aufgaben.
-
Führen Sie die ersten Installationsschritte aus. Siehe Ihr Installations- oder Aktualisierungspfad.
-
Wechseln Sie nach der Anmeldung beim Anwendungsserver zum Dateisystembesitzer.
-
Lesen Sie Übersicht über „Erste Schritte mit der Befehlszeileninstallation.
bin
-Unterverzeichnis installieren.Sie können das Installationsprogramm mehrmals mit verschiedenen Optionen ausführen, um Installationsaufgaben wie die folgenden durchzuführen:
-
Die Installation erfolgt in Phasen. Nachdem Sie beispielsweise Ihren Webserver für SSL (Secure Sockets Layer) konfiguriert haben, können Sie das Installationsprogramm erneut ausführen, um SSL-Optionen festzulegen.
-
Fehler in früheren Installationen korrigieren.
-
Installieren Sie die Anwendung in einer anderen Datenbankinstanz.
cleanup-database
können Sie dieses Verhalten ändern.Siehe auch Aktualisieren, Neu installieren, Deinstallieren.
Sichere Installation
Um Secure Sockets Layer (SSL), auch als HTTPS bezeichnet, sowohl für die Admin- als auch für die Storefront zu verwenden, müssen Sie alle folgenden Parameter festlegen:
--use-secure
: Auf1
festlegen--base-url-secure
: Auf eine sichere URL festlegen (d. h., mithttps://
beginnen)--use-secure-admin
festgelegt auf1
Weitere Informationen zu diesen Parametern finden Sie weiter unten in diesem Thema.
Hilfe-Befehle des Installationsprogramms
Sie können die folgenden Befehle ausführen, um Werte für einige erforderliche Argumente zu finden:
magento info:language:list
magento info:currency:list
magento info:timezone:list
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, z. B. Installationsbefehle, beschrieben. Siehe Beispiel für localhost-Installationen.
Admin-Anmeldedaten:
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 localhost-Installationen.
--admin-firstname
--admin-lastname
--admin-email
--admin-user
--admin-password
--admin-password='A0b9%t3g'
Site- und Datenbankkonfigurationsoptionen:
--base-url
http[s]://<host or ip>/<your install dir>/
.Hinweis: Das Schema (http:// oder https://) und ein Schrägstrich am Ende 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 die virtuellen Hosts einrichten, kann der Pfad Magento2 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}}
, die eine Basis-URL darstellt, die durch eine Virtual-Host-Einstellung oder eine Virtualisierungsumgebung wie Docker definiert ist. Wenn Sie beispielsweise einen virtuellen Host mit dem Host-Namen 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.--backend-frontname
admin_jkhgdfq
.Aus Sicherheitsgründen wird ein zufälliger URI empfohlen. Ein zufälliger URI ist für Hacker oder bösartige Software schwieriger auszunutzen.
Der URI wird am Ende der Installation angezeigt. Sie können ihn jederzeit mithilfe des Befehls
magento info:adminuri
anzeigen.Wenn Sie einen Wert eingeben möchten, empfehlen wir, kein gängiges Wort wie „admin“ oder „backend“ zu verwenden. Der Admin-URI kann nur alphanumerische Werte und den Unterstrich (
_
) enthalten.--db-host
- Der voll 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
verwendet die Client-Bibliothek das TCP-Protokoll. Weitere Informationen zu Sockets finden Sie in der PHP PDO_MYSQL-Dokumentation.Hinweis: Sie können optional den Datenbank-Server-Port in seinem Hostnamen wie www.example.com:9000 angeben
--db-name
Der Standardwert ist
magento2
.--db-user
Der Standardwert ist
root
.--db-password
--db-prefix
Verwenden Sie in diesem Fall ein Präfix, um die Tabellen für diese Installation zu identifizieren. Bei einigen Kunden wird mehr als eine Adobe Commerce-Instanz auf einem Server ausgeführt, wobei alle Tabellen in derselben Datenbank vorhanden sind.
Das Präfix darf maximal fünf Zeichen lang sein. Sie muss mit einem Buchstaben beginnen und darf nur Buchstaben, Zahlen und Unterstriche enthalten.
Mit dieser Option können diese Kunden den Datenbank-Server für mehr als eine Installation freigeben.
--db-ssl-key
--db-ssl-cert
--db-ssl-ca
--language
magento info:language:list
aus dem Verzeichnis bin eingeben.)--currency
magento info:currency:list
aus dem Verzeichnis bin eingeben.)--timezone
magento info:timezone:list
aus dem Verzeichnis bin eingeben.)--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 der Standardwert.--use-secure
1
ermöglicht die Verwendung von SSL (Secure Sockets Layer) 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 davon ausgegangen, dass alle anderen sicheren URL-Optionen ebenfalls 0 sind. Dies ist der Standardwert.--base-url-secure
http[s]://<host or ip>/<your install dir>/
--use-secure-admin
1
bedeutet, dass Sie SSL verwenden, um auf den Administrator 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 der Standardwert.--admin-use-security-key
0
Deaktiviert die Verwendung des Schlüssels.--session-save
-
db
, um Sitzungsdaten in der Datenbank zu speichern. Wählen Sie Datenbankspeicher, wenn Sie eine geclusterte Datenbank haben. Andernfalls gibt es möglicherweise keinen großen Vorteil gegenüber dateibasiertem Speicher.-
files
, Sitzungsdaten im Dateisystem zu speichern. Die dateibasierte Sitzungsspeicherung ist geeignet, es sei denn, der Dateisystemzugriff ist langsam, Sie verfügen über eine geclusterte Datenbank oder Sie möchten Sitzungsdaten in Redis speichern.-
redis
zum Speichern von Sitzungsdaten in Redis. Wenn Sie Redis für das 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 den Sitzungsspeicher .--key
--cleanup-database
--db-init-statements
Der Standardwert ist
SET NAMES utf8;
.--sales-order-increment-prefix
Konfigurationsoptionen für Suchmaschinen:
--search-engine
elasticsearch7
, elasticsearch6
und elasticsearch5
. Der Standardwert lautet elasticsearch7
. Wenn Sie OpenSearch als Suchmaschine installiert haben, geben Sie den Wert elasticsearch7
an. Elasticsearch 5 wird nicht mehr unterstützt und wird nicht empfohlen.--elasticsearch-host
localhost
.--elasticsearch-port
9200
.--elasticsearch-index-prefix
magento2
.--elasticsearch-timeout
15
.--elasticsearch-enable-auth
false
.--elasticsearch-username
--elasticsearch-password
RabbitMQKonfigurationsoptionen:
--amqp-host
--amqp
nur, wenn Sie bereits eine Installation von RabbitMQ eingerichtet haben. Weitere Informationen RabbitMQ Installieren und Konfigurieren von RabbitMQ finden Sie unter Installation .Der Hostname, auf dem RabbitMQ installiert ist.
--amqp-port
--amqp-user
guest
.--amqp-password
guest
Standardkennwort.--amqp-virtualhost
/
.--amqp-ssl
false
. Siehe RabbitMQ für Informationen zum Einrichten von SSL für RabbitMQ.--consumers-wait-for-messages
Remote-Speicheroptionen:
remote-storage-driver
Mögliche Werte:
file: Deaktiviert den Remotespeicher und verwendet das lokale Dateisystem
aws-s3: Verwenden Sie den Amazon Simple Storage Service (Amazon S3)
remote-storage-bucket
remote-storage-prefix
remote-storage-region
remote-storage-key
remote-storage-secret
Konfigurationsoptionen sperren:
--lock-provider
Verfügbare Schlossanbieter:
db
, zookeeper
, file
.Der standardmäßige Sperranbieter:
db
--lock-db-prefix
db
Sperranbieters zu vermeiden.Der Standardwert:
NULL
--lock-zookeeper-host
zookeeper
Sperranbieters.Beispiel:
127.0.0.1:2181
--lock-provider=zookeeper
--lock-zookeeper-path
Der Standardpfad lautet:
/magento/locks
--lock-file-path
--lock-provider=file
Konfigurationsoptionen für Verbraucher:
--consumers-wait-for-messages
-
0
: Privatkunden verarbeiten verfügbare Nachrichten in der Warteschlange, schließen die TCP-Verbindung und beenden sie. Verbraucher warten nicht auf den Eintritt zusätzlicher Nachrichten in die Warteschlange, selbst wenn die Anzahl der verarbeiteten Nachrichten kleiner ist als der beim Starten von Verbrauchern angegebene--max_messages
. -
1
: Verbraucher verarbeiten weiterhin Nachrichten aus der Nachrichtenwarteschlange, bis die maximale Anzahl von Nachrichten erreicht ist (der Wert, der für--max_messages
imqueue:consumers:start
-Befehl angegeben wurde), bevor sie die TCP-Verbindung schließen und den Verbraucherprozess beenden. Wenn die Warteschlange geleert wird, bevor--max_messages
erreicht wird, wartet der Verbraucher auf den Eingang weiterer Nachrichten. Wenn Sie Worker verwenden, um Verbraucher auszuführen, anstatt einen Cron-Auftrag zu verwenden, setzen Sie diese Variable auf1
.
--consumers-wait-for-messages
Option ist eine globale Option und kann nicht für jeden Verbraucher separat konfiguriert werden.Sensible Daten:
Adobe Commerce verwendet Ihren Verschlüsselungsschlüssel, um Folgendes zu verschlüsseln:
- Kreditkartenangaben
- In der Admin-Konfiguration angegebene Benutzernamen und Kennwörter (z. B. Anmeldungen bei Zahlungs-Gateways)
- Über das Netzwerk gesendete CAPTCHA-Werte
Adobe Commerce Folgendes nicht:
- Administrative und kundenspezifische Benutzernamen und Kennwörter (diese Kennwörter werden gehasht)
- Adresse
- Telefonnummer
- Andere Arten von personenbezogenen Daten außer Kreditkartennummern
Beispiele für localhost-Installationen
Die folgenden Beispiele zeigen die Befehle zum lokalen Installieren von Adobe Commerce mit verschiedenen Optionen.
Beispiel 1: Einfache Installation mit Administrator-Benutzerkonto
Im folgenden Beispiel wird die Anwendung mit den folgenden Optionen installiert:
-
Die Anwendung wird im
magento2
-Verzeichnis relativ zum Webserver-Stammverzeichnis auflocalhost
installiert und der Pfad zum Admin wirdadmin
. Daher:Ihre Storefront-URL ist
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 beidemagento
-
Verwendet Server-Neuschreibungen
-
Der Administrator verfügt über die folgenden Eigenschaften:
- Vor- und Nachnamen sind
Commerce User
- Benutzername ist
admin
und das Kennwortadmin123
- E-Mail-Adresse ist
user@example.com
- Vor- und Nachnamen sind
-
Die Standardsprache ist
en_US
(Englisch (USA)) -
Die Standardwährung ist US-Dollar
-
Die standardmäßige Zeitzone ist US Central (America/Chicago)
-
Elasticsearch 7 ist 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 ähnlich der folgenden werden angezeigt, um eine erfolgreiche Installation anzuzeigen:
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: Standardinstallation 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 angezeigt, wenn die Installation erfolgreich war:
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 mit dem Befehl admin:user:create
einen Admin-Benutzer 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 Anwendung Maga wird im
magento2
-Verzeichnis relativ zum Webserver-Basisverzeichnis auflocalhost
installiert. Der Pfad zum Administrator wirdadmin
. Daher:Ihre Storefront-URL ist
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 beidemagento
-
Der Administrator verfügt über die folgenden Eigenschaften:
- Vor- und Nachnamen sind
Commerce User
- Benutzername ist
admin
und das Kennwortadmin123
- E-Mail-Adresse ist
user@example.com
- Vor- und Nachnamen sind
-
Die Standardsprache ist
en_US
(Englisch (USA)) -
Die Standardwährung ist US-Dollar
-
Die standardmäßige Zeitzone ist US Central (America/Chicago)
-
Das Installationsprogramm bereinigt zunächst die Datenbank, bevor die Tabellen und das Schema installiert werden
-
Sie verwenden ein Inkrementpräfix für
ORD$
Kundenaufträge (da es ein [$
] enthält, muss der Wert in doppelte Anführungszeichen gesetzt werden) -
Sitzungsdaten werden in der Datenbank gespeichert
-
Verwendet Server-Neuschreibungen
-
Elasticsearch 7 ist 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
\
am Ende jeder Zeile eingeben.Meldungen wie die folgende werden angezeigt, wenn die Installation erfolgreich war:
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