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のアップグレードプロセスの詳細は、 Upgrade Overview を参照してください。 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. グローバルメニュー]を開き、[コントロールパネル]→ [検索機能]にいきます。

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

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

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

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. グローバルメニュー]を開き、[コントロールパネル]→ [検索機能]にいきます。

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

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

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

Commerce 2.1.xへのアップグレード

Liferay Commerceでは、バージョン1.1.x、2.0.xのどちらからでも、Commerce 2.1.xへのスムーズなアップグレードプロセスを提供しています。

注釈

1.1.xから2.1.xへのアップグレードでは、2.0.xへの増分アップグレードは必要ありません

Commerce 2.1.xにアップグレードする前に、まずLiferay DXP 7.2の最新のフィックスパックを実行している必要があります。 たとえば、Liferay Commerce Enterprise 2.0.6にアップグレードする場合は、Liferay DXPをフィックスパック14にアップグレードする必要があります。 DXP 7.2へのアップグレードについては、 アップグレードの概要 を参照してください。

最新のフィックスパックを適用する

変更通知を受け取り(購読)が必要

Liferayは最新のフィックスパックリリースを ヘルプセンター からダウンロードできるように提供しています。 ダウンロードが完了したら、 Liferayパッチツール を使ってフィックスパックを適用することができます。 詳細は、 Installing Patches を参照してください。

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.2の最新フィックスパックを実行したら、以下の手順に従ってCommerce 2.1.x upgrade Commerceにアップグレードします。

  1. 最新のLiferay Commerceをダウンロードしてください。

    • Commerce Enterpriseは [ヘルプセンター](https://customer.liferay.com/downloads?p p id=com liferay osb customer downloads display web DownloadsDisplayPortlet& com liferay osb customer downloads display web DownloadsDisplayPortlet productAssetCategoryId=118190997& com liferay osb customer downloads display web DownloadsDisplayPortlet_fileTypeAssetCategoryId=118191001) から入手できます。

    • Commerce Communityは、 Liferay Commerce Communityダウンロードページ から入手できます。

  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. [コントロールパネル] → [Commerce] → [商品] に移動します。

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

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