Liferay Commerce Enterprise の有効化
Liferay DXP/Portal 7.3以降、CommerceはすべてのLiferayバンドルとDockerコンテナに同梱されており、別途インストールする必要はありません。 ただし、Commerceのエンタープライズ機能にアクセスする手順は、使用しているDXPのバージョンによって異なります。 Liferay DXP 7.4 GA1では、すべてのCommerceモジュールがデフォルトで有効になっており、すぐに使用できます。 DXP 7.3 SP3+ では、Commerce は ポータル プロパティを使用して有効化されますが、それ以前のバージョンでは Commerce ライセンス ファイルを使用します。 このプロパティは、Liferay Portalのバンドル/画像にはエンタープライズ機能が含まれていないため、影響を与えません。
Liferay 7.4 U48+/GA48+ では、Commerce モジュールを無効にするためのポータル プロパティ (enterprise.product.commerce.enabled) が削除されました。 有効なDXP 7.4サブスクリプションをお持ちのお客様は、コマース機能をご利用いただけるようになりました。 Commerceを無効にすると、他のLiferay DXPモジュールとの間で不整合が発生する可能性があります。
Liferay DXP 7.4 GA1+ で Liferay Commerce Enterprise を無効にする
Liferay DXPのサブスクリプションが必要です
Liferay DXP 7.4 GA1では、すべてのCommerceモジュールがデフォルトで有効になっています。 ユーザーは、 enterprise.product.commerce.enabledポータルプロパティをfalseに設定することで、これらを無効にすることができます。
Liferayバンドルのコマース機能を無効にする
Liferayバンドルを使用している場合、portal-ext.propertiesファイルを使用してenterprise.product.commerce.enabledプロパティを構成することができます。 構成するには、Liferayサーバーのportal-ext.properties ファイルに以下のプロパティを追加するだけです。
enterprise.product.commerce.enabled=false
プロパティを追加したら、Liferayサーバーを再起動して変更を適用します。
portal-ext.properties ファイルが存在しない場合は、 [Liferay Home] または [User Home] フォルダーに作成してください。
バンドルにセットアップ ウィザードを使用した場合は、ポータル プロパティは [Liferay Home] フォルダー内の portal-setup-wizard.properties ファイルを使用して設定されます。 このファイルは portal-ext.properties ファイルよりも優先されるため、 enterprise.product.commerce.enabled プロパティに競合する値が設定されていないことを確認してください。 詳細については、 ポータルプロパティ を参照してください。
Dockerコンテナのコマースを無効にする
Dockerコンテナ上では、enterprise.product.commerce.enabledプロパティをportal-ext.propertiesファイル、またはDockerの env変数で設定することができます。
portal-ext.propertiesファイルには、このプロパティを追加します。
enterprise.product.commerce.enabled=false
または、このDockerのenv変数を使用します。
LIFERAY_ENTERPRISE_PERIOD_PRODUCT_PERIOD_COMMERCE_PERIOD_ENABLED=false
詳細については、 コンテナの設定 を参照してください。
成功すると、Commerce モジュールはグローバル メニュー (
に表示されなくなります。
Liferay DXP 7.3 SP3+ 向け Liferay Commerce Enterprise のアクティベーション
Liferay DXPおよびCommerceのサブスクリプションが必要です
DXP 7.3 SP3+ の場合、ポータル プロパティ enterprise.product.commerce.enabled を true に設定して Commerce をアクティブ化します。
Liferay Bundles の Commerce の有効化
portal-ext.propertiesファイルを使用してenterprise.product.commerce.enabledプロパティを構成することができます。 Liferayサーバーのportal-ext.propertiesファイルに以下のプロパティを追加してください。
enterprise.product.commerce.enabled=true
プロパティを追加したら、Liferayサーバーを再起動して変更を適用します。
portal-ext.properties ファイルが存在しない場合は、 [Liferay Home] または [User Home] フォルダーに作成してください。
Dockerコンテナ向けCommerceの有効化
Dockerコンテナを使用している場合、enterprise.product.commerce.enabledプロパティはportal-ext.propertiesファイルを使用して構成するか、Dockerのenv変数を使用してオーバーライドすることができます。
portal-ext.propertiesファイルを使用するには、以下のプロパティを新しい行に追加するだけです。
enterprise.product.commerce.enabled=true
ポータルプロパティをオーバーライドするには、以下のDocker env 変数を使用します。
LIFERAY_ENTERPRISE_PERIOD_PRODUCT_PERIOD_COMMERCE_PERIOD_ENABLED=true
アクティベーション成功の確認
プロパティが正常に追加されたことを確認するには、Liferay DXP を起動し、 グローバルメニュー ( を開きます。 認証が成功すると、Commerce の下の Commerce モジュールを表示およびアクセスできるようになります。 または、 グローバルメニュー () を開き、 コントロールパネル → サーバー管理 → プロパティ → ポータルプロパティ に移動します。 新しいプロパティは、他のプロパティと一緒に表示されます。
Liferay DXP 7.1-7.3 FP2 向け Liferay Commerce Enterprise のアクティベーション
Liferay DXPおよびCommerceのサブスクリプションが必要です
Liferay DXP 7.1-7.3 FP2の場合、Commerceを使用するには有効なライセンスが必要です。 このライセンスは、XML (.xml) アクティベーションキーとして提供され、Commerceモジュールを有効にするためには、Liferayサーバーにデプロイする必要があります。
Commerceライセンスには product-version、 license-type、そしてexpiration-dateを含むDXPライセンスと同じパラメータが多く使用されています。 ただし、システムリソース（プロセッサコア数など）やプラグインのバージョンによる制限は、Commerceライセンスには実装されていません。
DXP と Commerce のアクティベーション キーは両方とも同じ ライセンス タイプ である必要があります (例: プロダクション、 デベロッパー、または エンタープライズ)。 ライセンスの種類が一致しない場合、サーバーの起動ログに警告が表示されます。
実稼働ライセンスの場合、認証のために一致するホスト名、IPアドレス、またはMACアドレスも必要となります。
コマースアクティベーションキーの入手
すでにCommerceのサブスクリプションをご購入済みの場合は、以下のいずれかの方法でアクティベーションキーをダウンロードして入手できます。
-
アクティベーションキー/プロジェクト管理コンポーネントを使用して、 ヘルプセンター チケットを開きます。
-
各地域のプロビジョニングチーム（例：provisioning-[region]@liferay.com）にメールでリクエストを送信してください。
-
Commerceのアクティベーションキーは、 こちらからダウンロードできます。
コマースアクティベーションキーの展開
XMLアクティベーションキーを取得したら、それをDXPインスタンスのデプロイフォルダにコピーすることで、Commerceのエンタープライズを有効にできます。 このプロセスは、Liferay DXPを有効化するのと同じです。
Liferay 7.3 SP1以降では、Commerceを有効化した後にインスタンスのインデックスを再構築する必要がなくなりました。
DXPバンドルへのデプロイ
XML ファイルを DXP インスタンスの ${liferay.home}/deploy フォルダーにコピーします。 アクティベーションキーの処理中、Liferayはこのファイルを ${liferay.home}/osgi/modulesフォルダに移動させ、ライセンスファイル(.li）${liferay.home}/data/licenseフォルダに生成します。 詳細については、 Liferay DXP のアクティベーション を参照してください。
Dockerコンテナへのデプロイ
XMLファイルをコンテナの/opt/liferay/deployフォルダにコピーします。 アクティベーションキーの処理中、Liferayはこのファイルを opt/liferay/osgi/modulesフォルダに移動させ、ライセンスファイル(.liをopt/liferay/data/licenseフォルダに生成します。 Dockerコンテナへのファイルのデプロイに関する詳細は、 コンテナへのファイルの提供 を参照してください。
Liferay Cloudへのデプロイ
キーをプロジェクトの中央 Git リポジトリの liferay/configs/{ENV}/deploy フォルダーにコピーし、変更をコミットします。 次に、Liferayサービス用のJenkinsビルドをトリガーし、目的のプロジェクト環境にデプロイします。 環境の Liferay サービスにファイルをデプロイする方法の詳細については、 Liferay PaaS でのサービスの更新 を参照してください。
Liferay Cloud契約を通じてCommerceを購入した場合、Liferay Cloudチームがクラウドインフラストラクチャを通じてアクティベーションキーを管理するため、お客様自身でキーを管理する必要はありません。 ただし、既存のLiferay CloudプロジェクトにCommerceを追加する場合は、ライセンスを手動でデプロイする必要があります。
デプロイメントの検証
コンソールからキーが正常にデプロイされたことを確認してください。
INFO [com.liferay.portal.kernel.deploy.auto.AutoDeployScanner][AutoDeployDir:271] activation-key-commercesubscriptiondevelopment-1-developeractivationkeys.xml を処理中
...
INFO [fileinstall-directory-watcher][LicenseManager:?] Commerce Subscription Development ライセンスの検証に合格しました
INFO [fileinstall-directory-watcher][LicenseManager:?] コマースサブスクリプション開発のライセンスを登録済み
期限切れのCommerce Enterpriseライセンスを更新する
Commerceエンタープライズのライセンスは、ユーザーのサブスクリプションの条件に基づいて、一定期間のみ有効となります。 ライセンスの有効期限が近づくと（例： < ほとんどのライセンスでは30日前、 < 30日間のライセンスでは7日前）、Commerceアプリケーション上で管理者向けに警告メッセージが表示されます。 ライセンスは、与えられた有効期限の後、2日間の猶予期間を経て失効します。
ライセンスの有効期限が切れた場合、Commerceモジュールは有効なままですが、ライセンスが更新されるまでUIでの使用やAPIの呼び出しはできなくなります。 すべてのユーザーのCommerceアプリケーションに、Commerceアプリケーションが使用できないことを示す通知が表示されます。 管理者はライセンスの更新を、その他のユーザーは管理者への問い合わせを求められます。
サーバーの再起動中に、コンソールにエラーメッセージも表示されます。
エラー [main][LicenseManager:?] Liferay Commerceのライセンスが期限切れです
Liferay Commerce Enterprise を再有効化するには、まずサーバーから有効期限が切れたファイルを削除し、その後、新しいキーをデプロイしてください。
サーバー稼働中でも、アクティベーションキーの削除や追加が可能です。
DXPバンドルの更新
期限切れのXMLキーを{liferay.home}/osgi/modulesフォルダから削除し、期限切れのライセンスファイルは${liferay.home}/data/licenseフォルダから削除します。 次に、新しいアクティベーションキーを ${liferay.home}/deployフォルダに追加します。
Dockerコンテナの更新
期限切れのXMLキーをopt/liferay/osgi/modulesフォルダから削除し、期限切れのライセンスファイルは opt/liferay/data/licensesフォルダから削除します。 次に、新しいアクティベーションキーを、コンテナ内の /opt/liferay/deployフォルダに追加します。
Liferay CloudプロジェクトにおけるLiferayサービスの更新
Liferay CloudチームがDXPとCommerceの両方のライセンスを管理しているため、ユーザーが手動で更新する必要はありません。