Dokumentation Handel Installationshandbok

Installera Adobe Commerce

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:

Skapat för:

Erfaren
Administratör
Utvecklare

Utför följande steg innan du börjar:

Kontrollera att datorn uppfyller de krav som beskrivs i systemkraven.
Slutför alla nödvändiga-aktiviteter.
Slutför de första installationsstegen. Se Installations- eller uppgraderingssökvägen.
När du har loggat in på programservern växlar du till filsystemets ägare.
Granska Kom igång med översikten över kommandoradsinstallationen.

NOTE

Du måste installera programmet från underkatalogen bin.

Du kan köra installationsprogrammet flera gånger med olika alternativ för att slutföra installationsåtgärder som följande:

Installera i faser - När du till exempel har konfigurerat webbservern för SSL (Secure Sockets Layer) kan du köra installationsprogrammet igen och ange SSL-alternativ.
Åtgärda fel i tidigare installationer.
Installera programmet i en annan databasinstans.

NOTE

Som standard skriver installationsprogrammet inte över databasen om du installerar Commerce-programmet i samma databasinstans. Du kan använda den valfria parametern cleanup-database om du vill ändra det här beteendet.

Se även Uppdatera, installera om, avinstallera.

Säker installation

Om du vill använda SSL (Secure Sockets Layer), som även kallas HTTPS, för både administratören och butiken, måste du ange alla följande parametrar:

--use-secure: Ange som 1
--base-url-secure: Ange som en säker URL (d.v.s. från https://)
--use-secure-admin inställd på 1

Mer information om de här parametrarna finns senare i det här avsnittet.

Hjälpkommandon för installationsprogrammet

Du kan köra följande kommandon för att hitta värden för vissa obligatoriska argument:

Installationsargument

Kommando

Språk

magento info:language:list

Valuta

magento info:currency:list

Tidszon

magento info:timezone:list

NOTE

Om ett fel visas när du kör dessa kommandon kontrollerar du att du har uppdaterat installationsberoenden enligt beskrivningen i Uppdatera installationsberoenden.

Installera från kommandoraden

Installationskommandot har följande format:

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

I följande tabeller beskrivs namnen på installationsalternativen och deras värden, t.ex. installationskommandon. Se Exempel på lokala värdinstallationer.

NOTE

Alla alternativ som innehåller blanksteg eller specialtecken måste omslutas med enkla eller dubbla citattecken.

Administratörsautentiseringsuppgifter:

Följande alternativ anger användarinformation och autentiseringsuppgifter för administratörsanvändaren.

I Adobe Commerce version 2.2.8 och senare kan du skapa administratörsanvändaren under eller efter installationen. Om du skapar användaren under installationen krävs alla autentiseringsuppgifter för administratörer. Se Exempel på lokala värdinstallationer.

Namn

Värde

Obligatoriskt?

--admin-firstname

Administratörsanvändarens förnamn.

--admin-lastname

Administratörsanvändarens efternamn.

--admin-email

Administratörsanvändarens e-postadress.

--admin-user

Administratörsanvändarnamn.

--admin-password

Administratörslösenord. Lösenordet måste innehålla minst 7 tecken och innehålla minst en bokstav och minst ett numeriskt tecken. Vi rekommenderar ett längre och mer komplext lösenord. Omsluter hela lösenordssträngen med enkla citattecken. Exempel: --admin-password='A0b9%t3g'

Konfigurationsalternativ för plats och databas:

Namn

Värde

Obligatoriskt?

--base-url

Bas-URL som används för att komma åt din administratör och butiker i något av följande format:

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

Obs! Schemat (http:// eller https://) och ett avslutande snedstreck krävs båda.

<your install dir> är den dokumentberoende sökvägen där programmet ska installeras. Beroende på hur du konfigurerar webbservern och de virtuella värdarna kan sökvägen vara magento2 eller tom.

Om du vill komma åt programmet på den lokala värden kan du antingen använda http://127.0.0.1/<your install dir>/ eller http://127.0.0.1/<your install dir>/.

- {{base_url}} som representerar en bas-URL som definieras av en virtuell värdinställning eller av en virtualiseringsmiljö som Docker. Om du till exempel konfigurerar en virtuell värd med värdnamnet commerce.example.com kan du installera programmet med --base-url={{base_url}} och få åtkomst till administratören med en URL som http://commerce.example.com/admin.

--backend-frontname

URI (Uniform Resource Identifier) för åtkomst till administratören. Du kan utelämna den här parametern så att programmet kan generera en slumpmässig URI med följande mönster: admin_jkhgdfq.

Vi rekommenderar en slumpmässig URI av säkerhetsskäl. En slumpmässig URI är svårare för hackare eller skadlig programvara att utnyttja.

URI:n visas i slutet av installationen. Du kan visa det senare när som helst med kommandot magento info:adminuri.

Om du väljer att ange ett värde rekommenderar vi att du inte använder ett vanligt ord som admin, serverdel. Admin-URI kan bara innehålla alfanumeriska värden och understreck (_).

Nej

--db-host

Använd något av följande:

- Databasserverns kvalificerade värdnamn eller IP-adress.

- localhost (standard) eller 127.0.0.1 om databasservern finns på samma värd som webbservern.localhost betyder att MySQL-klientbiblioteket använder UNIX-socketar för att ansluta till databasen. 127.0.0.1 gör att klientbiblioteket använder TCP-protokollet. Mer information om socketar finns i PHP SUB_MYSQL-dokumentationen.

Obs! Du kan välja att ange databasserverporten i dess värdnamn som www.example.com:9000

--db-name

Namnet på den databasinstans där du vill installera databastabellerna.

Standardvärdet är magento2.

--db-user

Användarnamn för databasinstansens ägare.

Standardvärdet är root.

--db-password

Lösenord för databasinstansens ägare.

--db-prefix

Använd bara om du installerar databastabellerna i en databasinstans som redan innehåller Adobe Commerce-tabeller.

Använd i så fall ett prefix för att identifiera tabellerna för den här installationen. Vissa kunder har fler än en Adobe Commerce-instans som körs på en server med alla tabeller i samma databas.

Prefixet får innehålla högst fem tecken. Den måste börja med en bokstav och kan bara innehålla bokstäver, siffror och understreck.

Med det här alternativet kan dessa kunder dela databasservern med mer än en installation.

Nej

--db-ssl-key

Sökväg till klientnyckeln.

Nej

--db-ssl-cert

Sökväg till klientcertifikatet.

Nej

--db-ssl-ca

Sökväg till servercertifikatet.

Nej

--language

Språkkod som ska användas i Admin och storefront. (Om du inte redan har gjort det kan du visa listan med språkkoder genom att ange magento info:language:list i katalogen bin.)

Nej

--currency

Standardvaluta som ska användas i butiken. (Om du inte redan har gjort det kan du visa listan med valutor genom att ange magento info:currency:list i bin-katalogen.)

Nej

--timezone

Standardtidszon att använda i Admin och storefront. (Om du inte redan har gjort det kan du visa listan över tidszoner genom att ange magento info:timezone:list i bin-katalogen.)

Nej

--use-rewrites

1 betyder att du använder webbserveromskrivningar för genererade länkar i storefront och Admin.

0 inaktiverar användning av omskrivningar av webbservrar. Det här är standardinställningen.

Nej

--use-secure

1 aktiverar användning av Secure Sockets Layer (SSL) i butiks-URL:er. Kontrollera att webbservern stöder SSL innan du väljer det här alternativet.

0 inaktiverar användningen av SSL. I det här fallet antas alla andra säkra URL-alternativ också vara 0. Det här är standardinställningen.

Nej

--base-url-secure

Säker bas-URL som ska användas för att komma åt din administratör och butiker i följande format: http[s]://<host or ip>/<your install dir>/

Nej

--use-secure-admin

1 betyder att du använder SSL för att komma åt administratören. Kontrollera att webbservern stöder SSL innan du väljer det här alternativet.

0 betyder att du inte använder SSL med administratören. Det här är standardinställningen.

Nej

--admin-use-security-key

1 gör att programmet använder ett slumpmässigt genererat nyckelvärde för att få åtkomst till sidor i Admin och i formulär. Dessa nyckelvärden hjälper till att förhindra attacker med förfalskade korsskriptattacker mellan webbplatser. Det här är standardinställningen.

0 inaktiverar användningen av nyckeln.

Nej

--session-save

Använd något av följande:

- db för att lagra sessionsdata i databasen. Välj databaslagring om du har en klustrad databas, annars kanske det inte finns någon större fördel jämfört med filbaserad lagring.

- files för att lagra sessionsdata i filsystemet. Filbaserad sessionslagring är lämplig om inte filsystemåtkomsten är långsam, du har en klustrad databas eller du vill lagra sessionsdata i Redis.

- redis för att lagra sessionsdata i Redis. Om du använder Redis som standard- eller sidcache-lagring måste Redis vara installerat. Mer information om hur du konfigurerar stöd för Redis finns i Använda Redis för sessionslagring.

Nej

--key

Om du har ett, anger du en nyckel för att kryptera känsliga data i databasen. Om du inte har någon skapar programmet en åt dig.

--cleanup-database

Om du vill släppa databastabeller innan du installerar programmet anger du den här parametern utan ett värde. Annars lämnas databasen intakt.

Nej

--db-init-statements

Avancerad MySQL-konfigurationsparameter. Använder databasinitieringssatser som ska köras vid anslutning till MySQL-databasen. Läs en referens som liknar den här innan du anger några värden.

Standardvärdet är SET NAMES utf8;.

Nej

--sales-order-increment-prefix

Ange ett strängvärde som ska användas som prefix för försäljningsorder. Vanligtvis används detta för att garantera unika ordernummer för betalningsprocessorer.

Nej

TIP

Information om hur du aktiverar fjärrlagringstjänster under installationen finns i Konfigurera fjärrlagring i konfigurationshandboken.

Konfigurationsalternativ för sökmotor:

Namn

Värde

Obligatoriskt?

--search-engine

Versionen av sökmotorn. Möjliga värden är elasticsearch7, elasticsearch6 och elasticsearch5. Standardvärdet är elasticsearch7. Om du har installerat OpenSearch som sökmotor anger du värdet elasticsearch7. Elasticsearch 5 har tagits bort och rekommenderas inte.

Nej

--elasticsearch-host

Värdnamnet eller IP-adressen där sökmotorn körs. Standardvärdet är localhost.

Nej

--elasticsearch-port

Porten för inkommande HTTP-begäranden. Standardvärdet är 9200.

Nej

--elasticsearch-index-prefix

Ett prefix som identifierar sökindexet. Standardvärdet är magento2.

Nej

--elasticsearch-timeout

Antalet sekunder innan systemet timeout. Standardvärdet är 15.

Nej

--elasticsearch-enable-auth

Aktiverar autentisering på sökmotorservern. Standardvärdet är false.

Nej

--elasticsearch-username

Användar-ID för autentisering

Nej, om inte autentisering är aktiverat

--elasticsearch-password

Lösenordet som ska autentiseras

Nej, om inte autentisering är aktiverat

Konfigurationsalternativ för RabbitMQ:

Namn

Värde

Obligatoriskt?

--amqp-host

Använd inte alternativen för --amqp om du inte redan har konfigurerat en installation av RabbitMQ. Mer information om hur du installerar och konfigurerar RabbitMQ finns i RabbitMQ-installationen.

Värdnamnet där RabbitMQ är installerat.

Nej

--amqp-port

Den port som ska användas för att ansluta till RabbitMQ. Standardvärdet är 5672.

Nej

--amqp-user

Användarnamnet för anslutning till RabbitMQ. Använd inte standardanvändaren guest.

Nej

--amqp-password

Lösenordet för att ansluta till RabbitMQ. Använd inte standardlösenordet guest.

Nej

--amqp-virtualhost

Det virtuella värdsystemet för anslutning till RabbitMQ. Standardvärdet är /.

Nej

--amqp-ssl

Anger om anslutningen till RabbitMQ ska upprättas. Standardvärdet är false. Mer information om hur du konfigurerar SSL för RabbitMQ finns i RabbitMQ.

Nej

--consumers-wait-for-messages

Ska konsumenterna vänta på ett meddelande från kön? 1 - Ja, 0 - Nej

Nej

Alternativ för fjärrlagring:

Namn

Beskrivning

Obligatoriskt?

remote-storage-driver

Kortnamn
Möjliga värden:
file: Inaktiverar fjärrlagring och använder det lokala filsystemet
aws-s3: Använd Amazon Simple Storage Service (Amazon S3)

Nej

remote-storage-bucket

Objektets lagrings- eller behållarnamn

Nej

remote-storage-prefix

Valfritt prefix (plats inuti objektlagring)

Nej

remote-storage-region

Regionnamn

Nej

remote-storage-key

Valfri åtkomstnyckel

Nej

remote-storage-secret

Valfri hemlig nyckel

Nej

Lås konfigurationsalternativ:

Namn

Värde

Obligatoriskt?

--lock-provider

Lås leverantörens namn.

Tillgängliga låsleverantörer: db, zookeeper, file.

Standardlåsleverantör: db

Nej

--lock-db-prefix

Det specifika db-prefixet för att undvika låskonflikter när db-låsprovidern används.

Standardvärdet: NULL

Nej

--lock-zookeeper-host

Värd och port för att ansluta till Zookeeper-klustret när du använder zookeeper-låsprovidern.

Till exempel: 127.0.0.1:2181

Ja, om du anger --lock-provider=zookeeper

--lock-zookeeper-path

Sökvägen där Zookeeper sparar lås.

Standardsökvägen är: /magento/locks

Nej

--lock-file-path

Sökvägen där fillås sparas.

Ja, om du anger --lock-provider=file

Konfigurationsalternativ för konsumenter:

Namn

Beskrivning

Värde

Obligatoriskt

--consumers-wait-for-messages

Bestämmer om konsumenterna ska vänta på ett meddelande från kön.

1 - Ja, 0 - Nej

Nej

0: Konsumenterna bearbetar tillgängliga meddelanden i kön, stänger TCP-anslutningen och avslutar. Konsumenterna väntar inte på att ytterligare meddelanden ska skickas till kön, även om antalet bearbetade meddelanden är mindre än värdet --max_messages som angavs när konsumenterna startades.
1: Konsumenterna fortsätter att bearbeta meddelanden från meddelandekön tills det maximala antalet meddelanden (det värde som anges för --max_messages i kommandot queue:consumers:start) nås innan TCP-anslutningen stängs och konsumentprocessen avslutas. Om kön töms innan --max_messages nås väntar konsumenten på att fler meddelanden ska komma fram. Om du använder arbetare för att köra konsumenter i stället för att använda ett cron-jobb anger du den här variabeln till 1.

WARNING

Alternativet --consumers-wait-for-messages är ett globalt alternativ och kan inte konfigureras separat för varje konsument.

NOTE

Information om hur du aktiverar eller inaktiverar moduler efter att du har installerat programmet finns i Aktivera och inaktivera moduler.

Känsliga data:

Adobe Commerce använder din krypteringsnyckel för att kryptera följande:

Kreditkortsinformation
Användarnamn och lösenord som anges i Admin-konfigurationen (t.ex. inloggningar på betalningsgateways)
CAPTCHA-värden som skickas över nätverket

Adobe Commerce krypterar inte:

Användarnamn och lösenord för administration och kund (dessa lösenord hashas)
Adress
Telefonnummer
Andra typer av personligt identifierbar information förutom kreditkortsnummer

Exempel på lokala värdinstallationer

I följande exempel visas kommandon för att installera Adobe Commerce lokalt med olika alternativ.

Exempel 1 - Grundinstallation med administratörsanvändarkonto

I följande exempel installeras programmet med följande alternativ:

Programmet installeras i katalogen magento2 i förhållande till webbserverns docroot på localhost och sökvägen till Admin är admin. Därför:

Din storefront-URL är http://127.0.0.1
Databasservern finns på samma värd som webbservern.

Databasnamnet är magento och användarnamnet och lösenordet är båda magento
Använder serveromskrivning
Administratören har följande egenskaper:
- För- och efternamn är Commerce User
- Användarnamnet är admin och lösenordet är admin123
- E-postadressen är user@example.com
Standardspråket är en_US (amerikansk engelska)
Standardvalutan är amerikanska dollar
Standardtidszonen är USA Central (America/Chicago)
Elasticsearch 7 är installerat på es-host.example.com och ansluts på 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

Meddelanden som liknar följande för att ange att installationen lyckades:

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

Exempel 2 - Grundläggande installation utan administratörsanvändarkonto

Du kan installera programmet utan att skapa administratörsanvändaren, vilket visas i följande exempel.

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

Meddelanden som följande om installationen lyckas:

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

Efter installationen kan du skapa en administratörsanvändare med kommandot admin:user:create:
Skapa eller redigera en administratör

Exempel 3 - Installera med ytterligare alternativ

I följande exempel installeras programmet med följande alternativ:

Magapplication är installerat i katalogen magento2 i förhållande till webbserverns docroot på localhost och sökvägen till Admin är admin. Därför:

Din storefront-URL är http://127.0.0.1
Databasservern finns på samma värd som webbservern.

Databasnamnet är magento och användarnamnet och lösenordet är båda magento
Administratören har följande egenskaper:
- För- och efternamn är Commerce User
- Användarnamnet är admin och lösenordet är admin123
- E-postadressen är user@example.com
Standardspråket är en_US (amerikansk engelska)
Standardvalutan är amerikanska dollar
Standardtidszonen är USA Central (America/Chicago)
Installationsprogrammet rensar först databasen innan tabellerna och schemat installeras
Du använder ett ORD$-tilläggsprefix för försäljningsorder (eftersom det innehåller specialtecknet [$] måste värdet omges av dubbla citattecken)
Sessionsdata sparas i databasen
Använder serveromskrivning
Elasticsearch 7 är installerat på es-host.example.com och ansluts på 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

Du måste ange kommandot antingen på en rad eller, som i föregående exempel, med ett \-tecken i slutet av varje rad.

Meddelanden som följande om installationen lyckas:

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

Om du har ett användarkonto för åtkomst till programservern kan du läsa Ange en mask. Den här typen av konfiguration är typisk för delade värdtjänster.

recommendation-more-help

0f8e7db5-0e9c-4002-a5b8-a0088077d995