[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト(Adobeが管理する PaaS インフラストラクチャ)およびオンプレミスプロジェクトにのみ適用されます。"}

高度なオンプレミス インストール

TIP
お忘れですか? 助ける手が必要ですか? ​ クイックスタートインストール ​または​ コントリビューターインストール ​ ガイドをお試しください。
NOTE
SELinuxを有効にする場合は、SELinuxとiptablesを参照してください。

コマンドラインインターフェイス(CLI)

Adobe Commerceには、インストール タスクと設定タスク用の1つのコマンド ライン インターフェイスがあります:<magento_root>/bin/magento。 インターフェイスは、次のような複数のタスクを実行します。

  • インストール(およびデータベーススキーマの作成や更新、デプロイメント設定の作成など)に関連するタスク。
  • キャッシュのクリア。
  • インデックス再作成を含むインデックスの管理。
  • 翻訳辞書と翻訳パッケージの作成。
  • プラグインのファクトリやインターセプタなどの存在しないクラスを生成し、オブジェクトマネージャーの依存関係インジェクション設定を生成します。
  • 静的ビューファイルのデプロイ。
  • より少ないCSSの作成。

その他の利点:

  • 単一のコマンド (<magento_root>/bin/magento list)には、使用可能なすべてのインストールおよび設定コマンドが一覧表示されます。
  • Symfonyに基づいた一貫したユーザーインターフェイス。
  • CLIは拡張可能なので、サードパーティの開発者はCLIに「プラグイン」できます。 これは、ユーザーの学習曲線を排除するという追加の利点があります。
  • 無効なモジュールのコマンドは表示されません。

このトピックでは、CLIを使用したAdobe Commerce ソフトウェアのインストールについて説明します。 設定について詳しくは、設定ガイド ​を参照してください。

インストーラーは必要に応じて複数回実行できるので、次のことが可能です。

  • 異なる値を指定

    例えば、セキュアソケットレイヤー(SSL)用にweb サーバーを設定した後、インストーラーを実行してSSL オプションを設定できます。

  • 以前のインストールでの間違いを修正

  • 別のデータベースインスタンスへのAdobe Commerceのインストール

インストールの開始前

開始する前に、次の手順を実行します。

NOTE
Adobe Commerceをbin サブディレクトリからインストールする必要があります。

インストーラーを複数回実行して、次のようなインストールタスクを完了できます。

  • 段階的なインストール – 例えば、Web サーバーをSSL (Secure Sockets Layer)用に設定した後、インストーラーを再度実行してSSL オプションを設定できます。

  • 以前のインストールで発生したエラーを修正します。

  • 別のデータベースインスタンスにAdobe Commerceをインストールします。

NOTE
デフォルトでは、同じデータベースインスタンスにソフトウェアをインストールしても、インストーラーはデータベースを上書きしません。 オプションのcleanup-database パラメーターを使用して、この動作を変更できます。

更新、再インストール、アンインストール ​も参照してください。

安全なインストール

Secure Sockets Layer (SSL)(HTTPS とも呼ばれます)を管理者とストアフロントの両方で使用するには、次のパラメーターをすべて設定する必要があります。

  • --use-secure: 1 に設定
  • --base-url-secure:セキュア URL (https:// で始まる)に設定します
  • --use-secure-admin1 に設定

これらのパラメーターの詳細については、このトピックの後半で説明します。

インストーラーヘルプコマンド

次のコマンドを実行して、必須の引数の値を検索できます。

インストーラー引数
コマンド
言語
bin/magento info:language:list
通貨
bin/magento info:currency:list
タイムゾーン
bin/magento info:timezone:list
NOTE
これらのコマンドを実行するとエラーが表示される場合は、​ インストール依存関係の更新で説明したように、インストール依存関係を更新したことを確認してください。

コマンドラインからインストール

install コマンドでは、次の形式が使用されます。

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

次の表に、インストールオプションの名前と値を示します。 インストールコマンドの例については、​ サンプル localhost インストール ​を参照してください。

NOTE
スペースまたは特殊文字を含むオプションは、1つまたは2つの引用符で囲む必要があります。

管理者の資格情報:

次のオプションは、管理者ユーザーのユーザー情報と資格情報を指定します。

インストール中またはインストール後に管理者ユーザーを作成できます。 インストール中にユーザーを作成する場合は、すべての管理者資格情報変数が必要です。 ​ サンプル localhost インストール ​を参照してください。

次の表に、使用可能なインストールパラメーターの多くはありますが、一部ではありません。 完全なリストについては、​ コマンドラインツールのリファレンス ​を参照してください。

名前
必要ですか?
--admin-firstname
管理者ユーザーの名前。
はい
--admin-lastname
管理者ユーザーの姓。
はい
--admin-email
管理者ユーザーのメールアドレス。
はい
--admin-user
管理者ユーザー名。
はい
--admin-password
管理者ユーザーパスワード。 パスワードは、少なくとも7文字の長さである必要があり、少なくとも1つのアルファベットと少なくとも1つの数字を含める必要があります。 より長く複雑なパスワードを使用することをお勧めします。 パスワード文字列全体を一重引用符で囲みます。 例:--admin-password='A0b9%t3g'
はい

サイトとデータベースの設定オプション:

名前
必要ですか?
--base-url
次のいずれかの形式で管理者およびストアフロントにアクセスするために使用するベース URL:

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

注意: スキーム (http://またはhttps://)と末尾のスラッシュは両方とも必須です。

<your install dir>は、Adobe Commerce ソフトウェアをインストールするdocroot相対パスです。 Web サーバーと仮想ホストの設定方法によっては、パスがmagento2であるか、空白である可能性があります。

Adobe CommerceまたはMagenAdobe Commerceにアクセスするには、http://127.0.0.1/<your install dir>/またはhttp://127.0.0.1/<your install dir>/のいずれかを使用してください。

- {{base_url}}は、仮想ホスト設定またはDockerなどの仮想化環境によって定義されたベース URLを表します。 例えば、ホスト名magento.example.comで仮想ホストを設定する場合、--base-url={{base_url}}でソフトウェアをインストールし、http://magento.example.com/adminのようなURLで管理者にアクセスできます。
はい
--backend-frontname
管理者にアクセスするためのURI (Uniform Resource Identifier)。 このパラメーターを省略すると、次のパターン admin_jkhgdfqを持つランダム URIをアプリケーションで生成できます

セキュリティ上の理由から、ランダム URIをお勧めします。 ランダム URIは、ハッカーや悪意のあるソフトウェアが悪用するのが困難です。

URIはインストールの最後に表示されます。 後でbin/magento info:adminuri コマンドを使用して、いつでも表示できます。

値を入力する場合は、「管理者」、「バックエンド」などの一般的な単語を使用しないことをお勧めします。 管理者URIには、英数字とアンダースコア文字(_)のみを含めることができます。
いいえ
--db-host
次のいずれかを使用します。

- データベース サーバーの完全修飾ホスト名またはIP アドレス。データベース サーバーがweb サーバーと同じホスト上にある場合、

- localhost (デフォルト)または127.0.0.1。localhostは、MySQL クライアントライブラリがUNIX ソケットを使用してデータベースに接続することを意味します。 127.0.0.1によって、クライアント ライブラリでTCP プロトコルが使用されます。 ソケットについて詳しくは、PHP PDO_MYSQL ドキュメント ​を参照してください。

注: データベース サーバーのポートは、オプションでwww.example.com:9000のようにホスト名に指定できます
はい
--db-name
データベーステーブルをインストールするデータベースインスタンスの名前。

デフォルトはmagento2です。
はい
--db-user
データベースインスタンス所有者のユーザー名。

デフォルトはrootです。
はい
--db-password
データベースインスタンス所有者のパスワード。
はい
--db-prefix
既にAdobe Commerce テーブルが含まれているデータベースインスタンスにデータベーステーブルをインストールする場合にのみ使用します。

その場合、プレフィックスを使用して、このインストールのテーブルを識別します。 一部のお客様は、同じデータベース内のすべてのテーブルを含む複数のAdobe CommerceまたはMagenAdobe Commerce Serverを持っています。

プレフィックスは、最大5文字まで指定できます。 文字で始まる必要があり、文字、数字、アンダースコア文字のみを含めることができます。

このオプションを使用すると、お客様は複数のAdobe Commerce インストールでデータベース サーバーを共有できます
--db-ssl-key
クライアントキーへのパス。
いいえ
--db-ssl-cert
クライアント証明書へのパス。
いいえ
--db-ssl-ca
サーバー証明書へのパス。
いいえ
--language
管理者とストアフロントで使用する言語コード。 (まだ行っていない場合は、bin ディレクトリからbin/magento info:language:listを入力して、言語コードのリストを表示できます)。
いいえ
--currency
ストアフロントで使用するデフォルト通貨。 (まだ行っていない場合は、bin ディレクトリからbin/magento info:currency:listを入力して、通貨のリストを表示できます)。
いいえ
--timezone
管理者とストアフロントで使用するデフォルトのタイムゾーン。 (まだ実行していない場合は、bin/magento info:timezone:list ディレクトリからbin/を入力して、タイムゾーンのリストを表示できます)。
いいえ
--use-rewrites
1とは、ストアフロントおよび管理画面で生成されたリンクにweb サーバーの書き換えを使用することを意味します。

0は、web サーバーの書き換えの使用を無効にします。 これがデフォルトです。
いいえ
--use-secure
1では、ストアフロント URLでSSL (Secure Sockets Layer)を使用できます。 このオプションを選択する前に、web サーバーがSSLをサポートしていることを確認してください。

0はSSLの使用を無効にします。 この場合、その他のすべてのセキュア URL オプションも0と見なされます。 これがデフォルトです。
いいえ
--base-url-secure
管理者およびストアフロントへのアクセスに使用するセキュアなベース URL: http[s]://<host or ip>/<your install dir>/
いいえ
--use-secure-admin
1とは、SSLを使用して管理者にアクセスすることを意味します。 このオプションを選択する前に、web サーバーがSSLをサポートしていることを確認してください。

0は、管理者と一緒にSSLを使用しないことを意味します。 これがデフォルトです。
いいえ
--admin-use-security-key
1を指定すると、アプリケーションはランダムに生成されたキー値を使用して、管理者およびフォームのページにアクセスできます。 これらのキー値は、クロスサイトスクリプトフォージェリー攻撃を防ぐのに役立ちます。 これがデフォルトです。

0は、キーの使用を無効にします。
いいえ
--session-save
次のいずれかを使用して、セッションデータをデータベースに保存します。

db クラスター化されたデータベースがある場合は、データベースストレージを選択します。そうでない場合、ファイルベースのストレージよりもメリットが大きくない可能性があります。セッションデータをファイルシステムに保存するための

files。 ファイルベースのセッションストレージは、ファイルシステムのアクセス速度が遅い、クラスター化されたデータベースがある、またはセッションデータをRedisに保存したい場合を除いて適切です。セッションデータをRedisに保存する

redis。 デフォルトまたはページキャッシュにRedisを使用している場合は、Redisが既にインストールされている必要があります。 Redisのサポートの設定について詳しくは、セッションストレージにRedisを使用するを参照してください。
いいえ
--key
データベースがある場合は、データベース内の機密データを暗号化するためのキーを指定します。 アカウントをお持ちでない場合は、アプリケーションによってアカウントが生成されます。
はい
--cleanup-database
Adobe Commerceをインストールする前にデータベーステーブルをドロップするには、値を指定せずにこのパラメーターを指定します。 それ以外の場合は、データベースはそのまま残ります。
いいえ
--db-init-statements
高度なMySQL設定パラメーター。 データベース初期化ステートメントを使用して、MySQL データベースに接続するときに実行します。 値を設定する前に、このリファレンスと同様のリファレンスを参照してください。

デフォルトはSET NAMES utf8;です。
いいえ
--sales-order-increment-prefix
受注の接頭辞として使用する文字列値を指定します。 通常、これは決済代行会社の一意の注文番号を保証するために使用されます。
いいえ

検索エンジン設定オプション:

名前
必要ですか?
--search-engine
検索エンジンとして使用するElasticsearchまたはOpenSearchのバージョン。 デフォルトはelasticsearch7です。 Elasticsearch 5は非推奨(廃止予定)であり、お勧めしません。
いいえ
--elasticsearch-host
Elasticsearchが実行されているホスト名またはIP アドレス。 デフォルトはlocalhostです。
いいえ
--elasticsearch-port
受信HTTP リクエスト用のElasticsearch ポート。 デフォルトは9200です。
いいえ
--elasticsearch-index-prefix
Elasticsearch検索インデックスを識別するプレフィックス。 デフォルトはmagento2です。
いいえ
--elasticsearch-timeout
システムがタイムアウトするまでの秒数。 デフォルトは15です。
いいえ
--elasticsearch-enable-auth
Elasticsearch サーバーでの認証を有効にします。 デフォルトはfalseです。
いいえ
--elasticsearch-username
Elasticsearch サーバーに対する認証のユーザーID。
いいえ、認証が有効になっていない限り
--elasticsearch-password
Elasticsearchserverに対する認証のパスワード。
いいえ、認証が有効になっていない限り
--opensearch-host
OpenSearchが実行されているホスト名またはIP アドレス。 デフォルトはlocalhostです。
いいえ
--opensearch-port
受信HTTP リクエストのOpenSearch ポート。 デフォルトは9200です。
いいえ
--opensearch-index-prefix
OpenSearch検索インデックスを識別するプレフィックス。 デフォルトはmagento2です。
いいえ
--opensearch-timeout
システムがタイムアウトするまでの秒数。 デフォルトは15です。
いいえ
--opensearch-enable-auth
OpenSearch サーバーでの認証を有効にします。 デフォルトはfalseです。
いいえ
--opensearch-username
OpenSearch サーバーに対して認証するユーザーID。
いいえ、認証が有効になっていない限り
--opensearch-password
OpenSearch サーバーに対する認証のパスワード。
いいえ、認証が有効になっていない限り

RabbitMQ設定オプション:

名前
必要ですか?
--amqp-host
--amqpのインストールを既に設定していない限り、RabbitMQ オプションを使用しないでください。 RabbitMQのインストールと設定について詳しくは、RabbitMQ インストールを参照してください。

RabbitMQがインストールされているホスト名。
いいえ
--amqp-port
RabbitMQへの接続に使用するポート。 デフォルトは5672です。
いいえ
--amqp-user
RabbitMQに接続するためのユーザー名。 既定のユーザーguestは使用しないでください。
いいえ
--amqp-password
RabbitMQに接続するためのパスワード。 既定のパスワード guestは使用しないでください。
いいえ
--amqp-virtualhost
RabbitMQに接続するための仮想ホスト。 デフォルトは/です。
いいえ
--amqp-ssl
RabbitMQに接続するかどうかを示します。 デフォルトはfalseです。 RabbitMQのSSLの設定について詳しくは、RabbitMQを参照してください。
いいえ
--consumers-wait-for-messages
消費者はキューからのメッセージを待つべきですか? 1 – はい、0 – いいえ
いいえ

ActiveMQ Artemis設定オプション:

NOTE
ActiveMQ Artemisは、Adobe Commerce 2.4.5以降で導入されました。
名前
必要ですか?
--stomp-host
ActiveMQ Artemisのインストールを既に設定していない限り、--stomp オプションを使用しないでください。 ActiveMQ Artemisのインストールと設定について詳しくは、ActiveMQ Artemisのインストールを参照してください。

ActiveMQ Artemisがインストールされているホスト名。
いいえ
--stomp-port
ActiveMQ Artemisへの接続に使用するポート。 デフォルトは61613です。
いいえ
--stomp-user
ActiveMQ Artemisに接続するためのユーザー名。 既定のユーザーartemisは使用しないでください。
いいえ
--stomp-password
ActiveMQ Artemisに接続するためのパスワード。 既定のパスワード artemisは使用しないでください。
いいえ
--stomp-ssl
SSLを使用してActiveMQ Artemisに接続するかどうかを示します。 デフォルトはfalseです。 ActiveMQ ArtemisのSSL設定について詳しくは、ActiveMQ Artemisを参照してください。
いいえ
--consumers-wait-for-messages
消費者はキューからのメッセージを待つべきですか? 1 – はい、0 – いいえ
いいえ

設定オプションのロック:

名前
必要ですか?
--lock-provider
プロバイダー名をロックします。

使用可能なロック プロバイダー:dbzookeeperfile

既定のロック プロバイダー:db
いいえ
--lock-db-prefix
db ロックプロバイダーの使用時にロックの競合を回避するための特定のdb プレフィックス。

デフォルト値:NULL
いいえ
--lock-zookeeper-host
zookeeper ロックプロバイダーを使用する場合に、Zookeeper クラスターに接続するためのホストとポート。

例:127.0.0.1:2181
はい、--lock-provider=zookeeperを設定した場合
--lock-zookeeper-path
Zookeeperがロックを保存するパス。

デフォルトパスは/magento/locksです
いいえ
--lock-file-path
ファイルロックが保存されるパス。
はい、--lock-provider=fileを設定した場合

コンシューマー設定オプション:

名前
説明
必須
--consumers-wait-for-messages
コンシューマーがキューからのメッセージを待機するかどうかを決定します。
1 – はい、0 – いいえ
不可
  • 0: コンシューマーは、キュー内の使用可能なメッセージを処理し、TCP 接続を閉じて終了します。 コンシューマーは、処理されたメッセージの数が、コンシューマーの開始時に指定された --max_messages 値より少ない場合でも、追加のメッセージがキューに入るのを待ちません。

  • 1: コンシューマーは、TCP 接続を閉じてコンシューマープロセスを終了する前に、メッセージの最大数(--max_messages コマンドで queue:consumers:start に指定された値)に達するまで、メッセージキューからのメッセージ処理を続行します。 キューが --max_messages に到達する前に空になった場合、コンシューマーは到着するメッセージがさらに届くのを待ちます。 cron ジョブを使用する代わりにワーカーを使用してコンシューマーを実行する場合は、この変数を 1 に設定します。

WARNING
--consumers-wait-for-messages オプションはグローバルなオプションであり、消費者ごとに個別に設定することはできません。
NOTE
Adobe Commerceのインストール後にモジュールを有効または無効にするには、​ モジュールの有効と無効を参照してください。

機密データ:

Adobe Commerceでは、暗号化キーを使用して以下を暗号化します。

  • クレジットカード情報
  • 管理者設定で指定されたユーザー名とパスワード (例:支払いゲートウェイへのログイン)
  • ネットワーク経由で送信される CAPTCHA 値

Adobe Commerceは暗号化 ません

  • 管理者および顧客のユーザー名とパスワード(これらのパスワードはハッシュ化されます)
  • アドレス
  • 電話番号
  • クレジットカード番号を除く、他のタイプの個人を特定できる情報

localhostのインストール例

次の例は、様々なオプションを使用してAdobe Commerceをローカルにインストールするコマンドを示しています。

例1:管理者ユーザーアカウントを使用した基本的なインストール

次の例では、次のオプションを使用してAdobe Commerceをインストールします。

  • アプリケーションは、magento2のweb サーバーのdocrootに関連するlocalhost ディレクトリにインストールされ、管理者へのパスはadminです。したがって、次のようになります。

    ストアフロント URLはhttp://127.0.0.1です

  • データベース・サーバは、Web サーバと同じホスト上にあります。

    データベース名はmagentoで、ユーザー名とパスワードはどちらもmagentoです

  • サーバーの書き換えの使用

  • 管理者には次のプロパティがあります。

    • 氏名はMagento Userです
    • ユーザー名はadmin、パスワードはadmin123です
    • メールアドレスはuser@example.comです
  • 既定の言語はen_US (米国英語)です

  • デフォルト通貨は米ドルです

  • デフォルトのタイムゾーンは米国中部(アメリカ/シカゴ)です

  • OpenSearch 1.2はos-host.example.comにインストールされ、ポート 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=Magento --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=opensearch --opensearch-host=os-host.example.com \
--opensearch-port=9200

インストールが成功したことを示す次のようなメッセージが表示されます。

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

例2 – 管理者ユーザーアカウントを持たない基本インストール

次の例に示すように、管理者ユーザーを作成せずにAdobe Commerceをインストールできます。

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=opensearch --opensearch-host=os-host.example.com \
--opensearch-port=9200

インストールが成功した場合、次のようなメッセージが表示されます。

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

インストール後、admin:user:create コマンドを使用して管理者ユーザーを作成できます。
管理者を作成または編集

例3:追加のオプションを使用したインストール

次の例では、次のオプションを使用してAdobe Commerceをインストールします。

  • アプリケーションは、magento2のweb サーバーのdocrootに関連するlocalhost ディレクトリにインストールされ、管理者へのパスはadminです。したがって、次のようになります。

    ストアフロント URLはhttp://127.0.0.1です

  • データベース・サーバは、Web サーバと同じホスト上にあります。

    データベース名はmagentoで、ユーザー名とパスワードはどちらもmagentoです

  • 管理者には次のプロパティがあります。

    • 氏名はMagento Userです
    • ユーザー名はadmin、パスワードはadmin123です
    • メールアドレスはuser@example.comです
  • 既定の言語はen_US (米国英語)です

  • デフォルト通貨は米ドルです

  • デフォルトのタイムゾーンは米国中部(アメリカ/シカゴ)です

  • インストーラーは、テーブルとスキーマをインストールする前に、まずデータベースをクリーンアップします

  • 販売注文増分プレフィックス ORD$を使用できます(特殊文字[$]が含まれているため、値は二重引用符で囲む必要があります)

  • セッションデータはデータベースに保存されます

  • サーバーの書き換えの使用

  • OpenSearchはos-host.example.comにインストールされ、ポート 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=Magento --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=opensearch --opensearch-host=os-host.example.com \
--opensearch-port=9200
NOTE
コマンドは、1行で入力するか、前の例のように、各行の末尾に\文字を付けて入力する必要があります。

インストールが成功した場合、次のようなメッセージが表示されます。

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

例4 - ActiveMQ Artemisを使用したインストール

次に、メッセージブローカーとしてActiveMQ Artemisを使用してAdobe Commerceをインストールする例を示します。

bin/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=Magento --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=opensearch --opensearch-host=os-host.example.com \
--opensearch-port=9200 --stomp-host=localhost --stomp-port=61613 \
--stomp-user=artemis --stomp-password=artemis
NOTE
ActiveMQ Artemisのインストールには、Adobe Commerce 2.4.5以降が必要です。
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995