Documentazione Commerce Guida all’installazione

Installare Adobe Commerce

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

Argomenti:

Creato per:

Esperto
Amministratore
Sviluppatore

Prima di iniziare, completa i passaggi seguenti:

Verifica che il tuo sistema soddisfi i requisiti descritti in requisiti di sistema.
Completa tutte le attività prerequisite.
Completare i primi passaggi di installazione. Vedi Percorso di installazione o aggiornamento.
Dopo aver effettuato l'accesso al server applicazioni, passare al proprietario del file system.
Rivedi la panoramica di Introduzione all'installazione della riga di comando.

NOTE

È necessario installare l'applicazione dalla relativa sottodirectory bin.

È possibile eseguire il programma di installazione più volte con diverse opzioni per completare attività di installazione come le seguenti:

Eseguire l'installazione in più fasi: ad esempio, dopo aver configurato il server Web per Secure Sockets Layer (SSL), è possibile eseguire di nuovo il programma di installazione per impostare le opzioni SSL.
Correggere gli errori nelle installazioni precedenti.
Installare l'applicazione in un'istanza di database diversa.

NOTE

Per impostazione predefinita, il programma di installazione non sovrascrive il database se si installa il software Commerce nella stessa istanza di database. È possibile utilizzare il parametro facoltativo cleanup-database per modificare questo comportamento.

Vedere anche Aggiorna, reinstalla, disinstalla.

Installazione sicura

Per utilizzare SSL (Secure Sockets Layer), noto anche come HTTPS, sia per l'amministratore che per lo storefront, è necessario impostare tutti i seguenti parametri:

--use-secure: imposta su 1
--base-url-secure: imposta su un URL protetto (cioè, che inizia con https://)
--use-secure-admin Imposta su 1

Ulteriori dettagli su questi parametri sono disponibili più avanti in questo argomento.

Comandi della Guida del programma di installazione

È possibile eseguire i seguenti comandi per trovare i valori per alcuni argomenti obbligatori:

Argomento del programma di installazione

Comando

Lingua

magento info:language:list

Valuta

magento info:currency:list

Fuso orario

magento info:timezone:list

NOTE

Se durante l'esecuzione di questi comandi viene visualizzato un errore, verificare di aver aggiornato le dipendenze di installazione come descritto in Aggiorna dipendenze di installazione.

Installa dalla riga di comando

Il comando install utilizza il seguente formato:

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

Nelle tabelle seguenti vengono descritti i nomi e i valori delle opzioni di installazione, ad esempio i comandi di installazione. Vedi Esempi di installazioni localhost.

NOTE

Le opzioni contenenti spazi o caratteri speciali devono essere racchiuse tra virgolette singole o doppie.

Credenziali amministratore:

Le opzioni seguenti specificano le informazioni utente e le credenziali per l’utente amministratore.

In Adobe Commerce versione 2.2.8 e successive, puoi creare l’utente amministratore durante o dopo l’installazione. Se crei l’utente durante l’installazione, sono necessarie tutte le variabili delle credenziali amministratore. Vedi Esempi di installazioni localhost.

Nome

Valore

Obbligatorio

--admin-firstname

Nome dell'utente amministratore.

Sì

--admin-lastname

Cognome dell'utente amministratore.

Sì

--admin-email

Indirizzo di posta elettronica dell'utente amministratore.

Sì

--admin-user

Nome utente amministratore.

Sì

--admin-password

Password utente amministratore. La password deve contenere almeno 7 caratteri e includere almeno un carattere alfabetico e almeno un carattere numerico. Consigliamo una password più lunga e complessa. Racchiudere l'intera stringa della password tra virgolette singole. Ad esempio: --admin-password='A0b9%t3g'

Sì

Opzioni di configurazione del sito e del database:

Nome

Valore

Obbligatorio

--base-url

URL di base da utilizzare per accedere all'amministratore e alla vetrina in uno dei seguenti formati:

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

Nota: lo schema (http:// o https://) e una barra finale sono entrambi obbligatori.

<your install dir> è il percorso relativo alla directory principale dei documenti in cui installare l'applicazione. A seconda della configurazione del server web e degli host virtuali, il percorso potrebbe essere magento2 o vuoto.

Per accedere all'applicazione su localhost, è possibile utilizzare http://127.0.0.1/<your install dir>/ o http://127.0.0.1/<your install dir>/.

- {{base_url}} che rappresenta un URL di base definito da un'impostazione host virtuale o da un ambiente di virtualizzazione come Docker. Ad esempio, se imposti un host virtuale con il nome host commerce.example.com, puoi installare l'applicazione con --base-url={{base_url}} e accedere all'amministratore con un URL come http://commerce.example.com/admin.

Sì

--backend-frontname

URI (Uniform Resource Identifier) per accedere all'amministratore. È possibile omettere questo parametro per consentire all'applicazione di generare un URI casuale con il seguente pattern admin_jkhgdfq.

È consigliabile utilizzare un URI casuale per motivi di sicurezza. Un URI casuale è più difficile da sfruttare per gli hacker o per il software dannoso.

L'URI viene visualizzato alla fine dell'installazione. È possibile visualizzarlo in un secondo momento utilizzando il comando magento info:adminuri.

Se scegli di immettere un valore, ti consigliamo di non usare una parola comune come admin, backend. L'URI amministratore può contenere solo valori alfanumerici e il carattere di sottolineatura (_).

--db-host

Utilizzare uno dei seguenti elementi:

- Nome host o indirizzo IP completo del server di database.

- localhost (impostazione predefinita) o 127.0.0.1 se il server di database si trova sullo stesso host del server Web.localhost significa che la libreria client MySQL utilizza socket UNIX per connettersi al database. 127.0.0.1 fa in modo che la libreria client utilizzi il protocollo TCP. Per ulteriori informazioni sui socket, consulta la documentazione PHP PDO_MYSQL.

Nota: è possibile specificare la porta del server di database nel nome host, ad esempio www.example.com:9000

Sì

--db-name

Nome dell'istanza di database in cui si desidera installare le tabelle di database.

Il valore predefinito è magento2.

Sì

--db-user

Nome utente del proprietario dell'istanza di database.

Il valore predefinito è root.

Sì

--db-password

Password del proprietario dell'istanza di database.

Sì

--db-prefix

Da utilizzare solo se si installano le tabelle di database in un'istanza di database in cui sono già presenti tabelle Adobe Commerce.

In tal caso, utilizzare un prefisso per identificare le tabelle per l'installazione. Alcuni clienti hanno più di un’istanza di Adobe Commerce in esecuzione su un server con tutte le tabelle nello stesso database.

La lunghezza del prefisso non può superare i cinque caratteri. Deve iniziare con una lettera e può includere solo lettere, numeri e caratteri di sottolineatura.

Questa opzione consente ai clienti di condividere il server di database con più installazioni.

--db-ssl-key

Percorso della chiave client.

--db-ssl-cert

Percorso del certificato client.

--db-ssl-ca

Percorso del certificato del server.

--language

Codice lingua da utilizzare nell’amministrazione e nella vetrina. Se non lo hai già fatto, puoi visualizzare l'elenco dei codici di lingua immettendo magento info:language:list dalla directory bin.

--currency

Valuta predefinita da utilizzare nella vetrina. Se non lo hai già fatto, puoi visualizzare l'elenco delle valute immettendo magento info:currency:list dalla directory bin.

--timezone

Fuso orario predefinito da utilizzare in Admin e storefront. Se non lo hai già fatto, puoi visualizzare l'elenco dei fusi orari immettendo magento info:timezone:list dalla directory bin.

--use-rewrites

1 significa che si utilizza il server Web per riscrivere i collegamenti generati nella vetrina e in Amministrazione.

0 disabilita l'utilizzo delle riscritture del server Web. Questa è l'impostazione predefinita.

--use-secure

1 consente l'utilizzo di Secure Sockets Layer (SSL) negli URL della vetrina. Prima di selezionare questa opzione, assicurati che il server web supporti SSL.

0 disabilita l'utilizzo di SSL. In questo caso, anche tutte le altre opzioni URL protetto sono impostate su 0. Questa è l'impostazione predefinita.

--base-url-secure

URL di base sicuro da utilizzare per accedere all'amministratore e alla vetrina nel seguente formato: http[s]://<host or ip>/<your install dir>/

--use-secure-admin

1 significa che si utilizza SSL per accedere all'amministratore. Prima di selezionare questa opzione, assicurati che il server web supporti SSL.

0 significa che non utilizzi SSL con l'amministratore. Questa è l'impostazione predefinita.

--admin-use-security-key

1 fa in modo che l’applicazione utilizzi un valore chiave generato in modo casuale per accedere alle pagine in Admin e nei moduli. Questi valori chiave aiutano a prevenire attacchi di tipo cross-site script forgery. Questa è l'impostazione predefinita.

0 disabilita l'utilizzo della chiave.

--session-save

Utilizzare uno dei seguenti elementi:

- db per archiviare i dati della sessione nel database. Se si dispone di un database in cluster, scegliere l'archiviazione del database. In caso contrario, l'archiviazione basata su file potrebbe non offrire molti vantaggi.

- files per archiviare i dati della sessione nel file system. L'archiviazione delle sessioni basata su file è appropriata a meno che l'accesso al file system non sia lento, che si disponga di un database cluster o che si desideri archiviare i dati della sessione in Redis.

- redis per archiviare i dati della sessione in Redis. Se utilizzi Redis per il caching predefinito o delle pagine, Redis deve essere già installato. Per ulteriori informazioni sulla configurazione del supporto per Redis, consulta Utilizzare Redis per l’archiviazione delle sessioni.

--key

Se disponibile, specificare una chiave per crittografare i dati sensibili nel database. Se non ne hai uno, l’applicazione ne genera uno per te.

Sì

--cleanup-database

Per eliminare le tabelle di database prima di installare l'applicazione, specificare questo parametro senza un valore. In caso contrario, il database viene lasciato intatto.

--db-init-statements

Parametro di configurazione MySQL avanzato. Utilizza le istruzioni di inizializzazione del database da eseguire durante la connessione al database MySQL. Consultate un riferimento simile a questo prima di impostare qualsiasi valore.

Il valore predefinito è SET NAMES utf8;.

--sales-order-increment-prefix

Specificare un valore stringa da utilizzare come prefisso per gli ordini cliente. In genere, viene utilizzato per garantire numeri di ordine univoci per gli elaboratori dei pagamenti.

TIP

Per abilitare i servizi di archiviazione remota durante l'installazione, vedere Configurare Archiviazione remota nella Guida alla configurazione.

Opzioni di configurazione del motore di ricerca:

Nome

Valore

Obbligatorio

--search-engine

Versione del motore di ricerca. I valori possibili sono elasticsearch7, elasticsearch6 e elasticsearch5. Il valore predefinito è elasticsearch7. Se OpenSearch è stato installato come motore di ricerca, specificare il valore elasticsearch7. L'Elasticsearch 5 è stato dichiarato obsoleto e non è consigliato.

--elasticsearch-host

Il nome host o l’indirizzo IP in cui è in esecuzione il motore di ricerca. Il valore predefinito è localhost.

--elasticsearch-port

Porta per le richieste HTTP in ingresso. Il valore predefinito è 9200.

--elasticsearch-index-prefix

Prefisso che identifica l'indice di ricerca. Il valore predefinito è magento2.

--elasticsearch-timeout

Il numero di secondi prima del timeout del sistema. Il valore predefinito è 15.

--elasticsearch-enable-auth

Abilita l'autenticazione sul server del motore di ricerca. Il valore predefinito è false.

--elasticsearch-username

ID utente da autenticare

No, a meno che l'autenticazione non sia abilitata

--elasticsearch-password

Password per l'autenticazione

No, a meno che l'autenticazione non sia abilitata

RabbitMQopzioni di configurazione:

Nome

Valore

Obbligatorio

--amqp-host

Non utilizzare le opzioni --amqp a meno che non sia già stata impostata un'installazione di RabbitMQ. Per ulteriori informazioni sull'installazione e la configurazione di RabbitMQ, vedere Installazione di RabbitMQ.

Il nome host in cui è installato RabbitMQ.

--amqp-port

Porta da utilizzare per la connessione a RabbitMQ. Il valore predefinito è 5672.

--amqp-user

Nome utente per la connessione a RabbitMQ. Non utilizzare l'utente predefinito guest.

--amqp-password

Password per la connessione a RabbitMQ. Non utilizzare la password predefinita guest.

--amqp-virtualhost

Host virtuale per la connessione a RabbitMQ. Il valore predefinito è /.

--amqp-ssl

Indica se connettersi a RabbitMQ. Il valore predefinito è false. Per informazioni sulla configurazione di SSL per RabbitMQ, vedere RabbitMQ.

--consumers-wait-for-messages

I consumatori devono attendere un messaggio dalla coda? 1 - Sì, 0 - No

Opzioni di archiviazione remota:

Nome

Descrizione

Obbligatorio

remote-storage-driver

Nome scheda
Valori possibili:
file: disabilita l'archiviazione remota e utilizza il file system locale
aws-s3: utilizza il servizio Amazon Simple Storage (Amazon S3)

remote-storage-bucket

Archiviazione oggetto o nome contenitore

remote-storage-prefix

Prefisso facoltativo (posizione all'interno dell'archivio oggetti)

remote-storage-region

Nome regione

remote-storage-key

Chiave di accesso opzionale

remote-storage-secret

Chiave segreta opzionale

Blocca opzioni di configurazione:

Nome

Valore

Obbligatorio

--lock-provider

Blocca nome provider.

Provider di blocchi disponibili: db, zookeeper, file.

Provider di blocchi predefinito: db

--lock-db-prefix

Prefisso db specifico per evitare conflitti di blocco quando si utilizza il provider di blocchi db.

Valore predefinito: NULL

--lock-zookeeper-host

Host e porta per la connessione al cluster Zookeeper quando si utilizza il provider di blocchi zookeeper.

Esempio: 127.0.0.1:2181

Sì, se si imposta --lock-provider=zookeeper

--lock-zookeeper-path

Percorso in cui Zookeeper salva i blocchi.

Percorso predefinito: /magento/locks

--lock-file-path

Percorso in cui vengono salvati i blocchi di file.

Sì, se si imposta --lock-provider=file

Opzioni di configurazione consumer:

Nome

Descrizione

Valore

Obbligatorio

--consumers-wait-for-messages

Determina se i consumatori attenderanno un messaggio dalla coda.

1 - Sì, 0 - No

0: i consumer elaborano i messaggi disponibili nella coda, chiudono la connessione TCP e terminano. I consumatori non attendono messaggi aggiuntivi per entrare nella coda, anche se il numero di messaggi elaborati è inferiore al valore --max_messages specificato durante l'avvio dei consumatori.
1: i consumer continuano a elaborare i messaggi dalla coda dei messaggi fino a raggiungere il numero massimo di messaggi (valore specificato per --max_messages nel comando queue:consumers:start) prima di chiudere la connessione TCP e terminare il processo consumer. Se la coda si svuota prima di raggiungere --max_messages, il consumatore attende l'arrivo di altri messaggi. Se si utilizzano i processi di lavoro per eseguire i consumer anziché un processo cron, impostare questa variabile su 1.

WARNING

L'opzione --consumers-wait-for-messages è globale e non può essere configurata separatamente per ogni consumatore.

NOTE

Per attivare o disattivare i moduli dopo l'installazione dell'applicazione, vedere Attivare e disattivare i moduli.

Dati sensibili:

Adobe Commerce utilizza la tua chiave di crittografia per crittografare quanto segue:

Informazioni carta di credito
Nomi utente e password specificati nella configurazione amministratore (ad esempio, accessi ai gateway di pagamento)
Valori CAPTCHA inviati tramite la rete

Adobe Commerce non crittografa:

Password e nomi utente amministrativi e cliente (con hash)
Indirizzo
Numero di telefono
Altri tipi di informazioni personali identificabili, ad eccezione dei numeri di carta di credito

Esempi di installazioni localhost

Gli esempi seguenti mostrano i comandi per installare Adobe Commerce localmente con varie opzioni.

Esempio 1: installazione di base con account utente amministratore

L'esempio seguente installa l'applicazione con le opzioni seguenti:

L'applicazione è installata nella directory magento2 relativa alla directory principale dei documenti del server Web in localhost e il percorso dell'amministratore è admin. Pertanto:

L'URL della vetrina è http://127.0.0.1
Il server di database si trova sullo stesso host del server Web.

Il nome del database è magento e il nome utente e la password sono entrambi magento
Utilizza le riscritture del server
L’amministratore dispone delle seguenti proprietà:
- Il nome e il cognome sono Commerce User
- Nome utente: admin, password: admin123
- Indirizzo di posta elettronica: user@example.com
La lingua predefinita è en_US (inglese americano)
La valuta predefinita è il dollaro statunitense
Il fuso orario predefinito è Stati Uniti centrali (America/Chicago)
L'Elasticsearch 7 è installato su es-host.example.com e si connette alla porta 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

Messaggi simili alla seguente visualizzazione per indicare un'installazione riuscita:

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

Esempio 2: installazione di base senza account utente amministratore

È possibile installare l'applicazione senza creare l'utente amministratore, come illustrato nell'esempio seguente.

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

Se l’installazione ha esito positivo, vengono visualizzati messaggi come i seguenti:

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

Dopo l'installazione è possibile creare un utente amministratore utilizzando il comando admin:user:create:
Creare o modificare un amministratore

Esempio 3 - Installazione con opzioni aggiuntive

L'esempio seguente installa l'applicazione con le opzioni seguenti:

Magapplication è installato nella directory magento2 relativa alla directory principale dei documenti del server Web in localhost e il percorso dell'amministratore è admin. Pertanto:

L'URL della vetrina è http://127.0.0.1
Il server di database si trova sullo stesso host del server Web.

Il nome del database è magento e il nome utente e la password sono entrambi magento
L’amministratore dispone delle seguenti proprietà:
- Il nome e il cognome sono Commerce User
- Nome utente: admin, password: admin123
- Indirizzo di posta elettronica: user@example.com
La lingua predefinita è en_US (inglese americano)
La valuta predefinita è il dollaro statunitense
Il fuso orario predefinito è Stati Uniti centrali (America/Chicago)
Il programma di installazione pulisce il database prima di installare le tabelle e lo schema
Si utilizza un prefisso di incremento dell'ordine cliente ORD$ (poiché contiene un carattere speciale [$], il valore deve essere racchiuso tra virgolette)
I dati della sessione vengono salvati nel database
Utilizza le riscritture del server
L'Elasticsearch 7 è installato su es-host.example.com e si connette alla porta 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

È necessario immettere il comando su una sola riga oppure, come nell'esempio precedente, con un carattere \ alla fine di ogni riga.

Se l’installazione ha esito positivo, vengono visualizzati messaggi come i seguenti:

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

Se disponi di un account utente per accedere al server applicazioni, vedi impostare un umask. Questo tipo di configurazione è tipico per l'hosting condiviso.

recommendation-more-help

0f8e7db5-0e9c-4002-a5b8-a0088077d995