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にアップグレードするための前提条件
Liferay Commerce 4.0 では CommerceCountry
テーブルは非推奨となり、Country
テーブルに置き換えられます。 CommerceCountry`テーブルでは国名だけでよかったが、Countryテーブルでは国名とアルファ2(a2)とアルファ3(a3)のコードが必要になる。
Miniumアクセラレータを使用している場合、または独自の値を使用している場合は、CommerceCountry
テーブルに入力することができます。 Minium Acceleratorを使用していない場合、このテーブルは空の状態です。 Liferay DXP 7.4にアップグレードする前の前提条件として、CommerceCountry
テーブルのそれぞれの国にISOコードが事前に入力されていることを確認する必要があります。 詳細は、 Country Codes を参照してください。
アップグレード後のインデックスの再構築の実行
DXP 7.4にアップグレードした後、フルサーチのインデックスの再構築をを実行します。
-
グローバルメニュー を開き、 コントロールパネル → 検索 に進む。
-
インデックス・アクション(Index Actions)」タブで、「すべての検索インデックス(All search indexes)」の「インデックス再作成(Reindex)」をクリックします。
再インデックスが完了したら、グローバルメニューの Commerce → Products にアクセスして、すべての商品が表示されていることを確認してください。
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にアップグレードした後、フルサーチのインデックスの再構築を実行します。
-
グローバルメニュー を開き、 コントロールパネル → 検索 に進みます。
-
Index Actions タブで、 Reindex all search indexes の Execute をクリックする。
再インデックスが完了したら、グローバルメニューの Commerce → Products にアクセスして、すべての商品が表示されていることを確認してください。
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
詳細なパッチリスト [ -] dxp-12-7110 ::現在インストールされていません; インストールされません: dxp-14 にはこのパッチに含まれる修正が含まれています :: LIFERAY 用にビルドされています [*I] dxp-14-7110 :: インストールされています; インストールされる予定です:LIFERAY のために作られた
- Linux/Unix:
フィックスパックは本質的に累積的であり、以前にリリースされたすべてのフィックスパックが含まれています。 パッチ適用後、[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 → Products に移動します。
- すべての商品が再び表示されることを確認します。
インデックスの再構築が完了すると、アップグレードされたLiferay Commerceインスタンスを使用する準備が整います。