oo

Liferay Commerceのアップグレード

Liferay Commerceのエクスペリエンスを向上させるために、Liferayはバグフィックスや新機能を含む定期的な商品アップグレードを提供しています。 ユーザーの皆様におかれましては、定期的に最新版へのアップデートをご検討ください。

Commerce 4.0へのアップグレード

Liferay Commerce 3.0より、CommerceはLiferay DXPにバンドルされています。 Commerce 4.0にアップグレードするには、まずベースとなるLiferay DXPのインストールをDXP 7.4にアップグレードし、検索のインデックスの再構築を行う必要があります。

warning

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

The CommerceCountry table has more fields than the Country table.

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

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

  1. グローバルメニュー を開き、 コントロールパネル検索 に進む。

    Go to Search in the Control Panel tab.

  2. インデックス・アクション(Index Actions)」タブで、「すべての検索インデックス(All search indexes)」の「インデックス再作成(Reindex)」をクリックします。

再インデックスが完了したら、グローバルメニューの CommerceProducts にアクセスして、すべての商品が表示されていることを確認してください。

2.1以下のバージョンからCommerce 3.0へのアップグレード

Commerce 3.0にアップグレードするには、まずベースとなるLiferay DXPのインストールをDXP 7.3にアップグレードし、検索のインデックスの再構築を実行する必要があります。

warning

7.3にアップグレードした後は、CommerceのLPKGを再度デプロイしないでください。 Commerce 3.0のモジュールは7.3にバンドルされています。 ’LPKG’をデプロイすると競合が発生します。

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

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

  1. グローバルメニュー を開き、 コントロールパネル検索 に進みます。

    Go to Search in the Control Panel tab.

  2. Index Actions タブで、 Reindex all search indexesExecute をクリックする。

再インデックスが完了したら、グローバルメニューの CommerceProducts にアクセスして、すべての商品が表示されていることを確認してください。

Commerce 2.1.x/2.2.xへのアップグレードについて

Liferay Commerceを2.1.x/2.2.xにアップグレードするには、適切なDXPフィックスパックを適用する必要があります。

note

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のみサポートします。

note

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
    詳細なパッチリスト
       [ -] dxp-12-7110 ::現在インストールされていません; インストールされません: dxp-14 にはこのパッチに含まれる修正が含まれています :: LIFERAY
       用にビルドされています [*I] dxp-14-7110 :: インストールされています; インストールされる予定です: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. コントロールパネルCommerceProducts に移動します。
  4. すべての商品が再び表示されることを確認します。

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

関連トピック