Liferay Commerceエンタープライズの有効化¶
Liferay DXP/Portal 7.3から、CommerceはすべてのLiferayバンドルとDockerコンテナに同梱されているため、別途インストールする必要はありません。 ただし、Commerceのエンタープライズ機能にアクセスして利用するためには、実行するDXPのバージョンによって手順が異なります。 Liferay DXP 7.4 GA1では、すべてのCommerceモジュールがデフォルトで有効になっており、すぐに使用できます。 DXP 7.3 FP3/SP2以降では、Commerceは portal property を使用して有効化されますが、それ以前のバージョンではCommerceライセンスファイルが使用されます。 このプロパティは、Liferay Portalのバンドル/画像にはエンタープライズ機能が含まれていないため、影響を与えません。
Liferay DXP 7.4 GA1以降のLiferay Commerceエンタープライズの無効化¶
Liferay DXPとCommerceのサブスクリプションが必要
Liferay DXP 7.4 GA1では、すべてのCommerceモジュールがデフォルトで有効になっています。 ユーザーは、 enterprise.product.commerce.enabled
ポータルプロパティをfalse
に設定することで、これらを無効にすることができます。
LiferayバンドルのCommerceの無効化¶
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コンテナのCommerceの無効化¶
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 FP3/SP3+用のLiferay Commerceエンタープライズの有効化¶
Liferay DXPとCommerceのサブスクリプションが必要
DXP 7.3 FP3/SP2+では、enterprise.product.commerce.enabled
ポータルプロパティをtrue
に設定して、Commerceを有効にします。
Liferayバンドルの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エンタープライズの有効化¶
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のアクティベーションキーは,両方とも同じlicense-type
(例:production
,developer
,enterprise
)でなければなりません。 アクティベーションキータイプが一致しない場合は、サーバーの起動ログに警告が出力されます。
本番環境ライセンスでは、入力値の検証のためにホスト名、IPアドレス、MACアドレスのいずれかが一致する必要があります。
Commerceのアクティベーションキーの入手¶
Commerceサブスクリプションが 購入済 の場合は、以下のいずれかの方法でアクティベーションキーをダウンロードして入手できます。
Commerceのアクティベーションキーのデプロイ¶
XMLアクティベーションキーを取得したら、それをDXPインスタンスのデプロイ
フォルダにコピーすることで、Commerceのエンタープライズを有効にできます。 このプロセスは、Liferay DXPを有効化するのと同じです。
注釈
Liferay 7.3 SP1では、Commerceを有効にした後、ユーザーはインスタンスのインデックスを再作成する必要がなくなりました。
DXP Bundlesへのデプロイ¶
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コンテナへのファイルのデプロイについては、 Providing Files to a Container を参照してください。
Liferay Cloudへのデプロイメント¶
プロジェクトのセントラルGitリポジトリ内の liferay/configs/{ENV}/deploy/
フォルダにキーをコピーし、変更をコミットします。 次に、LiferayサービスのJenkinsビルドを起動し、目的のプロジェクト環境にデプロイします。 環境の Liferay サービスへのファイルのデプロイについては、 Liferay Cloud デプロイメントワークフローの概要 を参照してください。
重要
Liferay Cloudの契約でCommerceを購入した場合、アクティベーションキーはLiferay Cloudチームがクラウド基盤を通じて管理するため、お客様自身で管理する必要はありません。 ただし、既存のLiferay CloudプロジェクトにCommerceを追加する場合は、ライセンスを自分で手動でデプロイする必要があります。
デプロイの確認¶
キーが正常にデプロイされたことをコンソールで確認します。
INFO [com.liferay.portal.kernel.deploy.auto.AutoDeployScanner][AutoDeployDir:271] Processing activation-key-commercesubscriptiondevelopment-1-developeractivationkeys.xml
...
INFO [fileinstall-directory-watcher][LicenseManager:?] Commerce Subscription Development license validation passed
INFO [fileinstall-directory-watcher][LicenseManager:?] License registered for Commerce Subscription Development
期限切れのCommerceエンタープライズライセンスの更新¶
Commerceエンタープライズのライセンスは、ユーザーのサブスクリプションの条件に基づいて、一定期間のみ有効となります。 ライセンスの有効期限が近づくと(i.e., < ほとんどのライセンスの場合は30日、< 30日のライセンスの場合は7日間)、管理者向けのCommerceアプリケーションに警告メッセージが表示されます。 ライセンスは、与えられた有効期限の後、2日間の猶予期間を経て失効します。
ライセンスの有効期限が切れても、Commerceモジュールは有効なままですが、UIでは使用できなくなり、ライセンスが更新されるまではAPIの呼び出しもできなくなります。 すべてのユーザーのCommerceアプリケーションに、Commerceアプリケーションが利用できないことを示す通知が表示されます。 管理者はライセンスの更新を、その他のユーザーは管理者への問い合わせを求められます。
また、サーバーの再起動時に、コンソールにエラーメッセージが表示されます:
ERROR [main][LicenseManager:?] Liferay Commerce license is expired
Liferay Commerceエンタープライズを再起動するには、まずサーバーから期限切れのファイルを削除し、新しいキーを デプロイ します。
Tip
アクティベーションキーの削除や追加は、サーバーの稼動中に行うことができます。
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 サービスを更新する¶
DXPとCommerceのライセンスはLiferay Cloudチームが管理しており、ユーザーが自分で手動で更新する必要はありません。