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 のアップグレード プロセスの詳細については、「 Liferay のアップグレード」を参照してください。 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コードがあらかじめ入力されていることを確認する必要があります。 詳細については、 国コード (ISO) を参照してください。

アップグレード後のインデックスの再構築の実行
DXP 7.4 にアップグレードした後、完全な検索の再インデックスを実行します。
-
グローバル メニューを開き、 コントロール パネル → 検索に移動します。
![[コントロールパネル]タブの[検索]に進みます。](https://resources.learn.liferay.com/images/dxp/latest/en/commerce/installation-and-upgrades/upgrading-liferay-commerce/images/02.png)
-
[インデックス アクション] タブで、 [すべての検索インデックス]の [再インデックス] をクリックします。
再インデックスが完了したら、グローバル メニューの コマース → 製品 に移動して、すべての製品が表示されていることを確認し、成功したことを確認します。
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 にアップグレードした後、完全な検索の再インデックスを実行します。
-
グローバル メニュー を開き、 コントロール パネル → 検索に移動します。
![[コントロールパネル]タブの[検索]に進みます。](https://resources.learn.liferay.com/images/dxp/latest/en/commerce/installation-and-upgrades/upgrading-liferay-commerce/images/02.png)
-
「インデックスアクション」 タブで、 「実行」 を 「すべての検索インデックスの再インデックス」に対してクリックします。
再インデックスが完了したら、グローバル メニューの コマース → 製品 に移動して、すべての製品が表示されていることを確認し、成功したことを確認します。
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 のアップグレード」を参照してください。 アップグレードパスを理解するために、以下の表を参照してください。
| 以下バージョンへのアップグレード | 必要なフィックスパックのバージョン |
|---|---|
| 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 Patching Toolを使用して修正パックを適用できます。 詳細については、 パッチのインストール を参照してください。
Liferay DXP が 手動でインストール されている場合(たとえば、WebLogic 上)は、「 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 - Linux/Unix:
フィックスパックは本質的に累積的であり、以前にリリースされたすべてのフィックスパックが含まれています。 パッチ適用後、[Liferay Home]/workフォルダの内容を削除して、Liferay DXPのデプロイ済みコードのキャッシュを削除します。 その他の古いデータを削除する方法については、以下を参照してください。
ダウンロードとデプロイ
DXP 7.1/7.2の適切なフィックスパックを実行したら、以下の手順でCommerce 2.1.x/2.2.xにアップグレードします。
-
Liferay Commerceをダウンロードします。
- Commerce Enterprise は ヘルプ センターから入手できます。
- Commerce Communityは、 Liferay Commerce Communityダウンロードページから入手できます。
-
LPKGを[Liferay Home]/deployフォルダにデプロイしてください。 Liferay DXPへのアプリケーションのデプロイの詳細については、「 アプリケーションのインストール」を参照してください。 -
以下に示すようなメッセージがアプリケーションサーバーコンソールに表示されることを確認します。
Processing Liferay Commerce Enterprise x.x.x.lpkgThe portal instance needs to be restarted to complete the installation of file:/../../liferay-commerce-enterprise-1.1.6/osgi/marketplace/Liferay%20Commerce%20-%20API.lpkgThe 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 indexesVerifying 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以前
最新版へのアップグレード後、全検索再インデックスを行ってください。
-
コントロール パネル → 構成 → 検索に移動します。
-
「 すべての検索インデックスを再インデックス」の横にある「 実行 」をクリックします。 終了を待ちます。
-
コントロール パネル → コマース → 製品に移動します。
-
すべての商品が再び表示されることを確認します。
インデックスの再構築が完了すると、アップグレードされたLiferay Commerceインスタンスを使用する準備が整います。