Installieren von Adobe Commerce
Führen Sie zuerst die folgenden Schritte aus:
-
Überprüfen Sie, ob Ihr System die in den Systemanforderungen beschriebenen Anforderungen erfüllt.
-
Führen Sie alle Aufgaben für Voraussetzung aus.
-
Führen Sie die ersten Installationsschritte aus. Siehe Ihren Installations- oder Aktualisierungspfad.
-
Nachdem Sie sich beim Anwendungsserver angemeldet haben, wechseln Sie zum Dateisysteminhaber.
-
Überprüfen Sie die Übersicht über die Erste Schritte mit der Befehlszeileninstallation .
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.
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
: Auf1
setzen--base-url-secure
: Auf eine sichere URL festlegen (d. h., beginnend mithttps://
)--use-secure-admin
Auf1
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:
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 beschrieben, z. B. Installationsbefehle. Siehe Beispiel für lokale Host-Installationen.
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.
--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 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.--backend-frontname
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.--db-host
- 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
--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. 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.
--db-ssl-key
--db-ssl-cert
--db-ssl-ca
--language
magento info:language:list
aus dem Ordner bin eingeben.)--currency
magento info:currency:list
aus dem Ordner bin anzeigen.)--timezone
magento info:timezone:list
aus dem Ordner 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 die Standardeinstellung.--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.--base-url-secure
http[s]://<host or ip>/<your install dir>/
--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.--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 ü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 .--key
--cleanup-database
--db-init-statements
Der Standardwert ist
SET NAMES utf8;
.--sales-order-increment-prefix
Suchmaschinenkonfigurationsoptionen:
--search-engine
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.--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
-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.
--amqp-port
--amqp-user
guest
.--amqp-password
guest
.--amqp-virtualhost
/
.--amqp-ssl
false
. Informationen zum Einrichten von SSL für RabbitMQ finden Sie unter RabbitMQ .--consumers-wait-for-messages
Remote-Speicheroptionen:
remote-storage-driver
Mögliche Werte:
file: Deaktiviert den Remote-Speicher 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 Sperranbieter:
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
festlegen--lock-zookeeper-path
Der Standardpfad lautet:
/magento/locks
--lock-file-path
--lock-provider=file
festlegenKonfigurationsoptionen für Verbraucher:
--consumers-wait-for-messages
-
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 Befehlqueue: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 auf1
.
--consumers-wait-for-messages
ist eine globale Option und kann nicht für jeden Verbraucher einzeln konfiguriert werden.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 beidemagento
-
Verwendet Server-Neuschreibungen
-
Der Administrator verfügt über die folgenden Eigenschaften:
- Vor- und Nachnamen lauten
Commerce User
- Benutzername ist
admin
und das Kennwort istadmin123
- E-Mail-Adresse ist
user@example.com
- Vor- und Nachnamen lauten
-
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 unterlocalhost
installiert und der Pfad zum Admin istadmin
. 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 beidemagento
-
Der Administrator verfügt über die folgenden Eigenschaften:
- Vor- und Nachnamen lauten
Commerce User
- Benutzername ist
admin
und das Kennwort istadmin123
- E-Mail-Adresse ist
user@example.com
- Vor- und Nachnamen lauten
-
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
\
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