Documentation

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 を参照してください。

CommerceCountryテーブルは、Countryテーブルよりも多くのフィールドを持っています。

アップグレード後のインデックスの再構築の実行

DXP 7.4にアップグレードした後、フルサーチのインデックスの再構築をを実行します。

  1. グローバルメニュー を開き、 [Control Panel] → [Search] にいきます。

    [コントロールパネル]タブの[検索]に進みます。

  2. アクションをインデックスする] タブで、 [検索で利用するインデックスを再構築する] の [実行] をクリックします。

インデックスの再構築が完了したら、グローバルメニューの [コマース] → [製品] に移動して、すべての商品が表示されていることを確認してください。

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にアップグレードした後、フルサーチのインデックスの再構築を実行します。

  1. グローバルメニュー を開き、 [Control Panel] → [Search] にいきます。

    [コントロールパネル]タブの[検索]に進みます。

  2. アクションをインデックスする] タブで、 [検索で利用するインデックスを再構築する] の [実行] をクリックします。

インデックスの再構築が完了したら、グローバルメニューの [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 を参照してください。

その後、以下の手順でフィックスパックが正常にインストールされたことを確認します。

  1. [Liferay Home]/patching-tool フォルダに移動します。

  2. 以下を実行して、フィックスパックが適用されたことを確認します。

    • 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にアップグレードします。

  1. Liferay Commerceをダウンロードします。

  2. LPKG[Liferay Home]/deployフォルダにデプロイしてください。 Liferay DXPへのアプリケーションのデプロイについて詳しくは、 アプリのインストール をご覧ください。

  3. 以下に示すようなメッセージがアプリケーションサーバーコンソールに表示されることを確認します。

    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
    
  4. アプリケーションサーバーをシャットダウンします。

古いデータを消去し、アップグレードプロセスを確認する

  1. [Liferay Home]/osgi/stateフォルダーを削除します。 OSGiフォルダーの詳細は、 アプリのインストール を参照してください。

  2. アプリケーションサーバーを起動します。

  3. アプリケーションサーバーのログから、このようなメッセージが表示され、アップグレード処理が開始されたことを確認します。

    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以前

最新版へのアップグレード後、全検索再インデックスを行ってください。

  1. コントロールパネル] → [設定] → [検索] に移動します。

  2. 全ての検索インデクスの再構築] の隣にある [実行] をクリックします。 終了を待ちます。

  3. コントロールパネル] → [コマース] → [商品] に移動します。

  4. すべての商品が再び表示されることを確認します。

インデックスの再構築が完了すると、アップグレードされたLiferay Commerceインスタンスを使用する準備が整います。