Liferay Commerceのアップグレード¶
Liferay Commerceのエクスペリエンスを向上させるために、Liferayはバグフィックスや新機能を含む定期的な商品アップグレードを提供しています。 ユーザーの皆様におかれましては、定期的に最新版へのアップデートをご検討ください。
Commerce 4.0へのアップグレード¶
Liferay Commerce 3.0より、CommerceはLiferay DXPにバンドルされています。 Commerce 4.0にアップグレードするには、まずベースとなるLiferay DXPのインストールをDXP 7.4にアップグレードし、検索のインデックスの再構築を行う必要があります。
警告
7.4にアップグレードした後は、CommerceのLPKG
を再度デプロイしないでください。 Commerce 4.0のモジュールは7.4にバンドルされています。 'LPKG'をデプロイすると競合が発生します。
DXPのアップグレード手順については、 アップグレードの基本 を参照してください。 DXPが7.4にアップグレードされたら、インデックスの再構築を実行してください。
Liferay Commerce 4.0にアップグレードするための前提条件¶
CommerceCountry
テーブルはLiferay Commerce 4.0では廃止予定であるため、Country
テーブルに置き換えられています。 CommerceCountry
テーブルでは、国名だけが必要でしたが、Countryテーブルでは、国名と各国のアルファ2(a2)、アルファ3(a3)のコードが必要です。
CommerceCountry
テーブルは、Minium Acceleratorを使用している場合や、独自の値を使用している場合に入力されることがあります。 Minium Acceleratorを使用していない場合、このテーブルは空の状態です。 Liferay DXP 7.4にアップグレードする前の前提条件として、 CommerceCountry
テーブル内の各国にISOコードがあらかじめ入力されていることを確認する必要があります。 詳細は、 Country Codes を参照してください。
アップグレード後のインデックスの再構築の実行¶
DXP 7.4にアップグレードした後、フルサーチのインデックスの再構築をを実行します。
グローバルメニュー を開き、 [Control Panel] → [Search] にいきます。
[アクションをインデックスする] タブで、 [検索で利用するインデックスを再構築する] の [実行] をクリックします。
インデックスの再構築が完了したら、グローバルメニューの [commerce] → [製品] に移動して、すべての商品が表示されていることを確認してください。
2.1以下のバージョンからCommerce 3.0へのアップグレード¶
Commerce 3.0にアップグレードするには、まずベースとなるLiferay DXPのインストールをDXP 7.3にアップグレードし、検索のインデックスの再構築を実行する必要があります。
警告
7.3にアップグレードした後は、CommerceのLPKG
を再度デプロイしないでください。 Commerce 3.0のモジュールは7.3にバンドルされています。 'LPKG'をデプロイすると競合が発生します。
アップグレード後のインデックスの再構築の実行¶
DXP 7.3にアップグレードした後、フルサーチのインデックスの再構築を実行します。
グローバルメニュー を開き、 [Control Panel] → [Search] にいきます。
[アクションをインデックスする] タブで、 [検索で利用するインデックスを再構築する] の [実行] をクリックします。
インデックスの再構築が完了したら、グローバルメニューの [Commerce] → [商品] に移動して、すべての商品が表示されていることを確認してください。
Commerce 2.1.x/2.2.xへのアップグレードについて¶
Liferay Commerceを2.1.x/2.2.xにアップグレードするには、適切なDXPフィックスパックを適用する必要があります。
注釈
1.1.xから2.1.xへのアップグレードでは、2.0.xへの増分アップグレードは必要ありません。
例えば、Liferay Commerce 2.0.7にアップグレードする場合、Liferay DXP 7.1をフィックスパック 16以上にアップグレードしてください。 Liferay DXP 7.2を使用している場合、フィックスパック2または3を適用する必要があります。 DXPのアップグレードについては、 アップグレードの基礎知識 を参照してください。 アップグレードパスを理解するために、以下の表を参照してください。
以下バージョンへのアップグレード |
必要なフィックスパックのバージョン |
---|---|
Liferay Commerce 2.0.7 |
Liferay DXP 7.1 FP 16+/DXP 7.2 FP 2-3 |
Liferay Commerce 2.1.0 |
Liferay DXP 7.1 FP 17+/DXP 7.2 FP 5 |
Liferay Commerce 2.1.3 |
Liferay DXP 7.1 FP 24 以上 |
Liferay Commerce 2.2.0 |
Liferay DXP 7.2 FP 13 |
Liferay Commerce 2.2.1 |
Liferay DXP 7.2 FP 15 |
Commerce 2.0.7から2.1.3, 2.2.0または2.2.1にアップグレードする場合、まずCommerce 2.1.0にアップグレードする必要があります。 Commerceバージョン2.1.3+はLiferay DXP 7.1.xのみ、Commerceバージョン2.2.0+はLiferay DXP 7.2.xのみサポートします。
注釈
Liferay DXP 7.1 FP 17+/Commerce 2.1.0 または Liferay DXP 7.2 FP5/Commerce 2.1.0 にアップグレードすると、Commerce 4.0 にバンドルされている Liferay DXP 7.4 など他のターゲットバージョンにアップグレードすることが可能です。
適切なフィックスパックを適用する¶
サブスクリプション
Liferayの適切なフィックスパックは、 ヘルプセンター からダウンロードできます。 ダウンロードが完了したら、 Liferayパッチングツール を使ってフィックスパックを適用できます。 詳細は、 パッチのインストール を参照してください。
Liferay DXPを 手動でインストールした場合 (WebLogicなどで)は、 Installing Patches on the Liferay DXP 7.1 WAR を参照してください。
その後、以下の手順でフィックスパックが正常にインストールされたことを確認します。
[Liferay Home]/patching-tool
フォルダに移動します。以下を実行して、フィックスパックが適用されたことを確認します。
Linux/Unix:
./patching-tool.sh info
Windows:
patching-tool info
Detailed patch list: [ -] dxp-12-7110 :: Currently not installed; Won't be installed: dxp-14 contains the fixes included in this one :: Built for LIFERAY [*I] dxp-14-7110 :: Installed; Will be installed. :: Built for LIFERAY
フィックスパックは本質的に累積的であり、以前にリリースされたすべてのフィックスパックが含まれています。 パッチ適用後、[Liferay Home]/work
フォルダの内容を削除して、Liferay DXPのデプロイ済みコードのキャッシュを削除します。 その他の古いデータを削除する方法については、以下を参照してください。
ダウンロードとデプロイ¶
DXP 7.1/7.2の適切なフィックスパックを実行したら、以下の手順でCommerce 2.1.x/2.2.xにアップグレードします。
Liferay Commerceをダウンロードします。
Commerceエンタープライズは ヘルプセンター から入手できます。
Commerce Communityは、 Liferay Commerce Communityダウンロードページ から入手できます。
LPKG
を[Liferay Home]/deploy
フォルダにデプロイしてください。 Liferay DXPへのアプリケーションのデプロイについて詳しくは、 アプリのインストール をご覧ください。以下に示すようなメッセージがアプリケーションサーバーコンソールに表示されることを確認します。
Processing Liferay Commerce Enterprise x.x.x.lpkg
The portal instance needs to be restarted to complete the installation of file:/../../liferay-commerce-enterprise-1.1.6/osgi/marketplace/Liferay%20Commerce%20-%20API.lpkg
The portal instance needs to be restarted to complete the installation of file:/../../liferay-commerce-enterprise-1.1.6/osgi/marketplace/Liferay%20Commerce%20-%20Impl.lpkg
アプリケーションサーバーをシャットダウンします。
古いデータを消去し、アップグレードプロセスを確認する¶
[Liferay Home]/osgi/state
フォルダーを削除します。 OSGiフォルダーの詳細は、 アプリのインストール を参照してください。アプリケーションサーバーを起動します。
アプリケーションサーバーのログから、このようなメッセージが表示され、アップグレード処理が開始されたことを確認します。
Upgrading com.liferay.commerce.account.internal.upgrade.v1_2_0.CommerceAccountGroupCommerceAccountRelUpgradeProcess Completed upgrade process com.liferay.commerce.account.internal.upgrade.v1_2_0.CommerceAccountGroupCommerceAccountRelUpgradeProcess in 24 ms Upgrading com.liferay.commerce.account.internal.upgrade.v1_2_0.CommerceAccountGroupRelUpgradeProcess Completed upgrade process com.liferay.commerce.account.internal.upgrade.v1_2_0.CommerceAccountGroupRelUpgradeProcess in 8 ms Upgrading com.liferay.commerce.account.internal.upgrade.v1_2_0.CommerceAccountGroupUpgradeProcess Completed upgrade process com.liferay.commerce.account.internal.upgrade.v1_2_0.CommerceAccountGroupUpgradeProcess in 12 ms Upgrading com.liferay.commerce.account.internal.upgrade.v1_3_0.CommerceAccountNameUpgradeProcess Starting com.liferay.portal.kernel.upgrade.UpgradeProcess#alter Completed com.liferay.portal.kernel.upgrade.UpgradeProcess#alter in 40 ms Completed upgrade process com.liferay.commerce.account.internal.upgrade.v1_3_0.CommerceAccountNameUpgradeProcess in 60 ms Starting com.liferay.portal.upgrade.internal.index.updater.IndexUpdaterUtil#updateIndexes#Updating database indexes for com.liferay.commerce.account.service Dropping stale indexes Adding indexes
Verifying com.liferay.commerce.product.internal.verify.CommerceCatalogServiceVerifyProcess Starting com.liferay.commerce.product.internal.verify.CommerceCatalogServiceVerifyProcess#verifyMasterCommerceCatalog Completed com.liferay.commerce.product.internal.verify.CommerceCatalogServiceVerifyProcess#verifyMasterCommerceCatalog in 2 ms Completed verification process com.liferay.commerce.product.internal.verify.CommerceCatalogServiceVerifyProcess in 7 ms 1 theme for admin-theme is available for use 1 theme for classic-theme is available for use 1 theme for minium-theme is available for use
Liferay Commerceインスタンスがアップグレードされました。
アップグレード後のインデックスの再構築を実行する¶
Liferay Commerce 2.1以前
最新版へのアップグレード後、全検索再インデックスを行ってください。
[コントロールパネル] → [設定] → [検索] に移動します。
[全ての検索インデクスの再構築] の隣にある [実行] をクリックします。 終了を待ちます。
[コントロールパネル] → [commerce] → [商品] に移動します。
すべての商品が再び表示されることを確認します。
インデックスの再構築が完了すると、アップグレードされたLiferay Commerceインスタンスを使用する準備が整います。