DocumentatieCommerceInstallatiehandleiding

Adobe Commerce installeren

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ervaren
  • Beheerder
  • Ontwikkelaar

Voer de volgende stappen uit voordat u begint:

NOTE
U moet de toepassing installeren vanuit de submap bin .

U kunt het installatieprogramma meerdere keren uitvoeren met verschillende opties om installatietaken zoals de volgende uit te voeren:

  • Installeren in fasen—Nadat u bijvoorbeeld uw webserver hebt geconfigureerd voor SSL (Secure Sockets Layer), kunt u het installatieprogramma opnieuw uitvoeren om SSL-opties in te stellen.

  • Corrigeer fouten in eerdere installaties.

  • Installeer de toepassing in een andere database-instantie.

NOTE
Standaard overschrijft het installatieprogramma de database niet als u de Commerce-software in dezelfde database-instantie installeert. U kunt de optionele parameter cleanup-database gebruiken om dit gedrag te wijzigen.

Zie ook Update, herinstalleer, desinstalleer.

Beveiligde installatie

Als u SSL (Secure Sockets Layer) wilt gebruiken, ook wel HTTPS genoemd, voor zowel Admin als storefront, moet u alle volgende parameters instellen:

  • --use-secure: Instellen op 1
  • --base-url-secure: Instellen op een beveiligde URL (te beginnen met https://)
  • --use-secure-admin Instellen op 1

Meer details over deze parameters kunnen later in dit onderwerp worden gevonden.

Opdrachten voor Help bij de installateur

U kunt de volgende opdrachten uitvoeren om naar waarden voor bepaalde vereiste argumenten te zoeken:

Installatieargument
Opdracht
Taal
magento info:language:list
Valuta
magento info:currency:list
Tijdzone
magento info:timezone:list
NOTE
Als een foutenvertoningen wanneer u deze bevelen in werking stelt, verifieer dat u installatiegebiedsdelen zoals besproken in de installatiegebiedsdelen van de Updatebijwerkte.

Installeren vanaf de opdrachtregel

Voor de installatieopdracht wordt de volgende indeling gebruikt:

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

In de volgende tabellen worden de namen en waarden van de installatieopties beschreven, zoals installatieopdrachten. Zie installaties van de Steekproef localhost.

NOTE
Alle opties die spaties of speciale tekens bevatten, moeten tussen enkele of dubbele aanhalingstekens staan.

geloofsbrieven Admin:

Met de volgende opties geeft u de gebruikersgegevens en gebruikersgegevens voor de beheerder op.

In Adobe Commerce versie 2.2.8 en hoger kunt u tijdens of na de installatie de beheerder-gebruiker maken. Als u de gebruiker tijdens de installatie creeert, zijn alle admin credentievariabelen vereist. Zie installaties van de Steekproef localhost.

Naam
Waarde
Vereist?
--admin-firstname
Voornaam van beheerder.
Ja
--admin-lastname
Achternaam van beheerder.
Ja
--admin-email
E-mailadres van de beheerder.
Ja
--admin-user
Gebruikersnaam beheerder.
Ja
--admin-password
Beheerderswachtwoord. Het wachtwoord moet ten minste 7 tekens lang zijn en ten minste één alfabetisch en numeriek teken bevatten. We raden een langer, complexer wachtwoord aan. Plaats de gehele wachtwoordtekenreeks tussen enkele aanhalingstekens. Bijvoorbeeld: --admin-password='A0b9%t3g'
Ja

de configuratieopties van de Plaats en van het gegevensbestand:

Naam
Waarde
Vereist?
--base-url
Basis URL aan gebruik om tot uw Admin en opslag in om het even welke volgende formaten toegang te hebben:

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

Nota: de regeling (http:// of https://) en een het slepen schuine streep worden allebei vereist.

<your install dir> is het documentafhankelijke relatieve pad waarin de toepassing wordt geïnstalleerd. Afhankelijk van hoe u opstelling uw Webserver en virtuele gastheren, de weg magento2 zou kunnen zijn of het zou leeg kunnen zijn.

om tot de toepassing op localhost toegang te hebben, kunt u of http://127.0.0.1/<your install dir>/ of http://127.0.0.1/<your install dir>/ gebruiken.

- {{base_url}} die een basis-URL vertegenwoordigt die wordt gedefinieerd door een virtuele hostinstelling of door een virtualisatieomgeving zoals Docker. Als u bijvoorbeeld een virtuele host instelt met de hostnaam commerce.example.com, kunt u de toepassing installeren met --base-url={{base_url}} en toegang krijgen tot de beheerder met een URL zoals http://commerce.example.com/admin .
Ja
--backend-frontname
Uniform Resource Identifier (URI) voor toegang tot de beheerder. U kunt deze parameter weglaten om de toepassing willekeurige URI voor u met het volgende patroon te laten produceren admin_jkhgdfq.

wij adviseren willekeurige URI voor veiligheidsdoeleinden. Willekeurige URI is moeilijker voor hakkers of kwaadwillige software om te exploiteren.

de vertoningen van URI aan het eind van de installatie. U kunt deze later op elk gewenst moment weergeven met de opdracht magento info:adminuri .

als u verkiest om een waarde in te gaan, adviseren wij u geen gemeenschappelijk woord zoals admin, backend. De Admin-URI kan alleen alfanumerieke waarden en het onderstrepingsteken (_) bevatten.
Nee
--db-host
Gebruik om het even welk van het volgende:

- de volledig gekwalificeerde hostname van de gegevensbestandserver of IP adres.

- localhost (standaardwaarde) of 127.0.0.1 als uw databaseserver zich op dezelfde host bevindt als uw webserver.localhost betekent dat de MySQL-clientbibliotheek gebruikmaakt van UNIX-sockets om verbinding te maken met de database. 127.0.0.1 zorgt ervoor dat de clientbibliotheek het TCP-protocol gebruikt. Voor meer informatie over contactdozen, zie de PHP documentatie BOB_MYSQL.

Nota: U kunt naar keuze de haven van de gegevensbestandserver in zijn hostname als www.example.com:9000 specificeren
Ja
--db-name
Naam van de database-instantie waarin u de databasetabellen wilt installeren.

Standaard is magento2.
Ja
--db-user
Gebruikersnaam van de eigenaar van de databaseinstantie.

Standaard is root.
Ja
--db-password
Het wachtwoord van de eigenaar van de databaseinstantie.
Ja
--db-prefix
Gebruik het slechts als u de gegevensbestandlijsten in een gegevensbestandinstantie installeert die Adobe Commerce lijsten in het reeds heeft.

In dat geval, gebruik een prefix om de lijsten voor deze installatie te identificeren. Sommige klanten hebben meer dan één Adobe Commerce-instantie die op een server met alle tabellen in dezelfde database wordt uitgevoerd.

de prefix kan een maximum van vijf karakters in lengte zijn. De naam moet met een letter beginnen en mag alleen letters, cijfers en onderstrepingstekens bevatten.

Deze optie laat die klanten toe om de gegevensbestandserver met meer dan één installatie te delen.
Nee
--db-ssl-key
Pad naar de clientsleutel.
Nee
--db-ssl-cert
Pad naar het clientcertificaat.
Nee
--db-ssl-ca
Pad naar het servercertificaat.
Nee
--language
Taalcode die moet worden gebruikt in Admin en storefront. (Als u dit nog niet hebt gedaan, kunt u de lijst met taalcodes weergeven door magento info:language:list in te voeren in de map bin.)
Nee
--currency
Standaardvaluta voor gebruik in de winkel. (Als u dit nog niet hebt gedaan, kunt u de lijst met valuta's weergeven door magento info:currency:list in te voeren in de map bin.)
Nee
--timezone
Standaardtijdzone die moet worden gebruikt in Admin en Storage. (Als u dit nog niet hebt gedaan, kunt u de lijst met tijdzones weergeven door magento info:timezone:list in te voeren in de map bin.)
Nee
--use-rewrites
1 betekent dat u herschrijvingen van webservers gebruikt voor gegenereerde koppelingen in de winkel en in Admin.

0 schakelt het gebruik van herschrijven van webservers uit. Dit is de standaardinstelling.
Nee
--use-secure
1 maakt het gebruik van SSL (Secure Sockets Layer) in winkel-URL's mogelijk. Zorg ervoor dat uw webserver SSL ondersteunt voordat u deze optie selecteert.

0 schakelt het gebruik van SSL uit. In dit geval wordt aangenomen dat alle andere veilige URL-opties ook 0 zijn. Dit is de standaardinstelling.
Nee
--base-url-secure
Beveilig basis-URL voor toegang tot uw beheerder en winkel in de volgende indeling: http[s]://<host or ip>/<your install dir>/
Nee
--use-secure-admin
1 betekent dat u SSL gebruikt om toegang te krijgen tot Admin. Zorg ervoor dat uw webserver SSL ondersteunt voordat u deze optie selecteert.

0 betekent dat u geen SSL gebruikt met de Admin. Dit is de standaardinstelling.
Nee
--admin-use-security-key
1 zorgt ervoor dat de toepassing een willekeurig gegenereerde sleutelwaarde gebruikt om toegang te krijgen tot pagina's in de Admin en in formulieren. Deze zeer belangrijke waarden helpen dwars-plaats manuscriptvervalsingsaanvallen verhinderen. Dit is de standaardinstelling.

0 schakelt het gebruik van de toets uit.
Nee
--session-save
Gebruik om het even welke volgend:

- db om zittingsgegevens in het gegevensbestand op te slaan. Kies gegevensbestandopslag als u een gegroepeerd gegevensbestand hebt; anders, zou er niet veel voordeel over op dossier-gebaseerde opslag kunnen zijn.

- files om sessiegegevens op te slaan in het bestandssysteem. De op dossier-gebaseerde zittingsopslag is aangewezen tenzij de toegang van het dossiersysteem langzaam is, hebt u een gegroepeerd gegevensbestand, of u wilt zittingsgegevens in Redis opslaan.

- redis om sessiegegevens op te slaan in Redis. Als u Redis gebruikt als standaardinstelling of als u pagina's in cache plaatst, moet Redis al zijn geïnstalleerd. Zie Redis gebruiken voor sessieopslag voor aanvullende informatie over het configureren van ondersteuning voor Redis.
Nee
--key
Als u er een hebt, geeft u een sleutel op om vertrouwelijke gegevens in de database te coderen. Als u er geen hebt, genereert de toepassing er een voor u.
Ja
--cleanup-database
Als u databasetabellen wilt neerzetten voordat u de toepassing installeert, geeft u deze parameter zonder waarde op. Anders blijft de database intact.
Nee
--db-init-statements
Geavanceerde MySQL-configuratieparameter. Gebruikt de verklaringen van de gegevensbestandinitialisatie om te lopen wanneer het verbinden met het gegevensbestand MySQL. Raadpleeg een verwijzing die vergelijkbaar is met deze voordat u waarden instelt.

Standaard is SET NAMES utf8;.
Nee
--sales-order-increment-prefix
Geef een tekenreekswaarde op die als voorvoegsel voor verkooporders moet worden gebruikt. Dit wordt doorgaans gebruikt om unieke bestelnummers voor betalingsverwerkers te garanderen.
Nee
TIP
Om de verre opslagdiensten tijdens installatie toe te laten, zie Verre Opslagin de Gids van de Configuratie vormen.

de configuratieopties van de motor van het Onderzoek:

Naam
Waarde
Vereist?
--search-engine
De versie van het zoekprogramma. Mogelijke waarden zijn elasticsearch7 , elasticsearch6 en elasticsearch5 . De standaardwaarde is elasticsearch7 . Als u OpenSearch als zoekprogramma hebt geïnstalleerd, geeft u de waarde elasticsearch7 op. Elasticsearch 5 is afgekeurd en wordt niet aanbevolen.
Nee
--elasticsearch-host
De hostnaam of het IP-adres waar de zoekmachine wordt uitgevoerd. De standaardwaarde is localhost .
Nee
--elasticsearch-port
De poort voor binnenkomende HTTP-aanvragen. De standaardwaarde is 9200 .
Nee
--elasticsearch-index-prefix
Een voorvoegsel dat de zoekindex aangeeft. De standaardwaarde is magento2 .
Nee
--elasticsearch-timeout
Het aantal seconden voordat het systeem uitvalt. De standaardwaarde is 15 .
Nee
--elasticsearch-enable-auth
Hiermee wordt verificatie ingeschakeld op de zoekmachineserver. De standaardwaarde is false .
Nee
--elasticsearch-username
De gebruikersnaam die moet worden geverifieerd
Nee, tenzij verificatie is ingeschakeld
--elasticsearch-password
Het wachtwoord voor verificatie
Nee, tenzij verificatie is ingeschakeld

RabbitMQconfiguratieopties:

Naam
Waarde
Vereist?
--amqp-host
Gebruik de opties voor --amqp alleen als u al een installatie van RabbitMQ hebt ingesteld. Zie RabbitMQ voor meer informatie over het installeren en configureren van RabbitMQ .

hostname waar RabbitMQ geïnstalleerd is.
Nee
--amqp-port
De poort die moet worden gebruikt om verbinding te maken met RabbitMQ . De standaardwaarde is 5672.
Nee
--amqp-user
De gebruikersnaam voor het verbinden met RabbitMQ . Gebruik de standaardgebruiker guest niet.
Nee
--amqp-password
Het wachtwoord voor het maken van verbinding met RabbitMQ . Gebruik het standaardwachtwoord niet guest .
Nee
--amqp-virtualhost
De virtuele host voor verbinding met RabbitMQ. De standaardwaarde is / .
Nee
--amqp-ssl
Geeft aan of verbinding moet worden gemaakt met RabbitMQ . De standaardwaarde is false . Zie RabbitMQ voor informatie over het instellen van SSL voor RabbitMQ .
Nee
--consumers-wait-for-messages
Moeten consumenten wachten op een bericht uit de wachtrij? 1 - Ja, 0 - Nee
Nee

Verre opslagopties:

Naam
Beschrijving
Vereist?
remote-storage-driver
De naam van de adapter
Mogelijke waarden:
dossier: Maakt verre opslag onbruikbaar en gebruikt het lokale filesystem
aws-s3: Gebruik de Eenvoudige Dienst van de Opslag van Amazon (Amazon S3)
Nee
remote-storage-bucket
Objectopslag of containernaam
Nee
remote-storage-prefix
Optioneel voorvoegsel (locatie binnen opslag van object)
Nee
remote-storage-region
Naam regio
Nee
remote-storage-key
Optionele toegangstoets
Nee
remote-storage-secret
Optionele geheime sleutel
Nee

de configuratieopties van het Slot:

Naam
Waarde
Vereist?
--lock-provider
Naam provider vergrendelen.

Beschikbare vergrendelingsproviders: db, zookeeper, file .

De standaardvergrendelingsprovider: db
Nee
--lock-db-prefix
Het specifieke voorvoegsel van de tab om vergrendelingsconflicten te voorkomen wanneer u db vergrendelingsprovider gebruikt.

De standaardwaarde: NULL
Nee
--lock-zookeeper-host
Gastheer en poort om verbinding te maken met de Zookeeper-cluster wanneer u zookeeper lock provider gebruikt.

Bijvoorbeeld: 127.0.0.1:2181
Ja, als u --lock-provider=zookeeper instelt
--lock-zookeeper-path
Het pad waar Zookeeper vergrendelingen opslaat.

Het standaardpad is: /magento/locks
Nee
--lock-file-path
Het pad waar de bestandsvergrendelingen worden opgeslagen.
Ja, als u --lock-provider=file instelt

de configuratieopties van de Consumenten:

Naam
Beschrijving
Waarde
Vereist
--consumers-wait-for-messages
Hiermee bepaalt u of consumenten op een bericht in de wachtrij wachten.
1 - Ja, 0 - Nee
Nee

  • 0: De consumenten verwerken beschikbare berichten in de rij, sluiten de verbinding van TCP, en eindigen. De consumenten wachten niet op extra berichten om de rij in te gaan, zelfs als het aantal verwerkte berichten minder dan de --max_messages waarde is die tijdens beginnende consumenten wordt gespecificeerd.

  • 1: De consumenten blijven berichten van de berichtrij verwerken tot het maximum aantal berichten (de waarde die voor --max_messages op het queue:consumers:start bevel wordt gespecificeerd) alvorens de verbinding van TCP te sluiten en het consumentenproces te beëindigen. Als de wachtrij leeg is voordat --max_messages wordt bereikt, wacht de consument tot er meer berichten zijn. Als u workers gebruikt om consumenten te runnen in plaats van een uitsnijdtaak, stelt u deze variabele in op 1 .

WARNING
De optie --consumers-wait-for-messages is een algemene optie en kan niet afzonderlijk voor elke consument worden geconfigureerd.
NOTE
Om modules toe te laten of onbruikbaar te maken na het installeren van de toepassing, zie modulestoelaten en onbruikbaar maken.

Gevoelige gegevens:

Adobe Commerce gebruikt uw coderingssleutel om het volgende te coderen:

  • Creditcardgegevens
  • Gebruikersnamen en wachtwoorden die zijn opgegeven in de beheerconfiguratie (bijvoorbeeld aanmelden bij betaalgateways)
  • CAPTCHA-waarden die via het netwerk worden verzonden

Adobe Commerce ** coderen niet:

  • Administratieve en klantengebruikersnamen en wachtwoorden (deze wachtwoorden worden gehakt)
  • Adres
  • Telefoonnummer
  • Andere soorten persoonlijk identificeerbare informatie, behalve creditcardnummers

Voorbeeld van localhost-installaties

In de volgende voorbeelden ziet u de opdrachten voor het lokaal installeren van Adobe Commerce met verschillende opties.

Voorbeeld 1—Basisinstallatie met beheergebruikersaccount

In het volgende voorbeeld wordt de toepassing met de volgende opties geïnstalleerd:

  • De toepassing wordt geïnstalleerd in de map magento2 ten opzichte van de hoofdmap van de webserver op localhost en het pad naar de beheerdersmap is admin . Dit betekent dat:

    De URL van uw winkel is http://127.0.0.1

  • De databaseserver bevindt zich op dezelfde host als de webserver.

    De databasenaam is magento en de gebruikersnaam en het wachtwoord zijn beide magento

  • Gebruikt herschrijvingen van server

  • De beheerder heeft de volgende eigenschappen:

    • Voornaam en achternaam zijn Commerce User
    • Gebruikersnaam is admin en het wachtwoord is admin123
    • E-mailadres is user@example.com

  • Standaardtaal is en_US (Amerikaans Engels)

  • Standaardvaluta is Amerikaanse dollars

  • Standaardtijdzone is VS Central (Amerika/Chicago)

  • Elasticsearch 7 is geïnstalleerd op es-host.example.com en maakt verbinding met poort 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

Berichten die lijken op de volgende weergave om aan te geven dat de installatie is gelukt:

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

Voorbeeld 2—Basisinstallatie zonder beheergebruikersaccount

U kunt de toepassing installeren zonder de beheerdersgebruiker te creëren zoals in het volgende voorbeeld wordt getoond.

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

Berichten zoals de volgende weergave als de installatie is gelukt:

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

Na de installatie kunt u een beheerder maken met de opdracht admin:user:create :
creeer of geef een beheerderuit

Voorbeeld 3—Installeren met extra opties

In het volgende voorbeeld wordt de toepassing met de volgende opties geïnstalleerd:

  • De Magapplication is geïnstalleerd in de map magento2 ten opzichte van de hoofdmap van de webserver op localhost en het pad naar de beheerder is admin ; daarom:

    De URL van uw winkel is http://127.0.0.1

  • De databaseserver bevindt zich op dezelfde host als de webserver.

    De databasenaam is magento en de gebruikersnaam en het wachtwoord zijn beide magento

  • De beheerder heeft de volgende eigenschappen:

    • Voornaam en achternaam zijn Commerce User
    • Gebruikersnaam is admin en het wachtwoord is admin123
    • E-mailadres is user@example.com

  • Standaardtaal is en_US (Amerikaans Engels)

  • Standaardvaluta is Amerikaanse dollars

  • Standaardtijdzone is VS Central (Amerika/Chicago)

  • Het installatieprogramma schoont eerst de database voordat de tabellen en het schema worden geïnstalleerd

  • U gebruikt een ORD$ prefix voor de verhoging van de verkooporde (aangezien het een speciaal karakter [$] bevat, moet de waarde in dubbele citaten worden ingesloten)

  • Sessiegegevens worden opgeslagen in de database

  • Gebruikt herschrijvingen van server

  • Elasticsearch 7 is geïnstalleerd op es-host.example.com en maakt verbinding met poort 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
U moet de opdracht op één regel invoeren of, zoals in het vorige voorbeeld, met een \ -teken aan het einde van elke regel.

Berichten zoals de volgende weergave als de installatie is gelukt:

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
Als u één gebruikersrekening hebt om tot de toepassingsserver toegang te hebben, zie plaats een masker. Dit type installatie is standaard voor gedeelde hosting.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995