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インスタンスを使用する準備が整います。