フィードバックを送信
legacy-knowledge-base
公開されました Jul. 2, 2025

アクティベーションキーの問題のトラブルシューティング

投稿者

Liferay Support

knowledge-article-header-disclaimer-how-to

knowledge-article-header-disclaimer

legacy-article

learn-legacy-article-disclaimer-text

Liferay DXP、Liferay Commerce、Liferay Portalをご利用のお客様向けに、アクティベーションキーに関するトラブルシューティングガイドを掲載します。

​目次

  1. フォルダーとログの読み込み
  2. デプロイメントに関する問題

トラブルシューティング_アクティベーションキー_問題点.png

1. フォルダーとログの読み込み

ライセンスマネージャを読む

アクティベーションキーに失敗した場合、画面にエラーが表示される可能性があります。 このセクションでは、先ほどデプロイしたアクティベーション XML ファイルを読み、 License Manager ページに書かれている内容と照らし合わせる方法について説明します。

  1. License Manager のページを見る {eg. localhost}/c/portal/license
  2. 最近配備されたXMLと、サーバーで読み込まれるXMLを相互参照する。
  3. License Manager ページは、配置されたキーに関する有用な情報を提供します：
    1. Liferayのバージョン
    2. サーバーの詳細（MAC、IP、ホスト名）
    3. アクティベーションキーの種類（プロダクション、ノンプロダクション、デベロッパー）
    4. アクティベーションキーの有効期間（永久または試用期間）
  4. 最近デプロイされたXMLと情報が一致しない場合は、以下の Deploy / Directory をご確認ください。

デプロイディレクトリの確認

症状： .xml アクティベーションキーファイルを最初にデプロイしようとすると、ファイルがデプロイされない可能性があります。 この問題の大半は、 .xml ファイルが正しいディレクトリに配置されていないことに起因します。

  1. アプリケーションサーバーを起動します。 初回起動時に ${liferay.home} に deploy/ ディレクトリが作成されます。
    1. XMLファイルは、 ${auto.deploy.deploy.dir} ディレクトリに置く必要があります（通常は、 ${liferay.home}/deploy）。
    2. XML ファイルは ${liferay.home}/data/licenseに置くべきではありません。
  2. 一度ドロップしたXMLは、サーバーの稼働中に消滅します
  3. .li ファイルが ${liferay.home}/data/licenseに生成されます。

XMLがまだ/deployディレクトリにある場合、 Deploymentを確認してください。

${liferay.home}/data/*に *.li が存在します。

症状です：

既存のアクティベーションキーとのコンフリクト

過去にアクティベーションキーを導入したことがある場合、 ${liferay.home}/data/license に *.li ファイルが存在することになります。 現在のキーがデプロイされていない場合、このファイルとの競合が発生する可能性があります。

  1. ${liferay.home}/data/*に存在する .li ファイルを削除する。
  2. Liferay DXP の場合、 ${liferay.home}/osgi/modules/* フォルダから *.xml ファイルをすべて削除します。
  3. 提供された鍵の XML ファイルを liferay のデプロイディレクトリにコピーして再デプロイします （ auto.deploy.deploy.dirを参照）。

エラーが再発した場合は、次のステップ「*.liファイルの検索」に進んでください。

LCSとの兼ね合い

Liferay DXP 7.0 Fix Pack 53までは、*.xmlキーによるアクティベーションは、Liferay Connected Servicesのアクティベーションと互換性がありません。 そのため、アクティベーションキーを導入する前に、LCSクライアントをアンインストールすることが必須となります。

  1. サーバーをシャットダウンする
  2. 位置するLiferay Connected Services Client.lpkgを削除します：
    1. Tomcat バンドル内の $ {liferay.home}/osgi/marketplace フォルダにあります。
    2. 他のアプリケーションサーバーを使用する場合、 OSGi Dependencies/marketplace フォルダーにあります。
  3. Liferayの立ち上げ

Liferay DXP 7.2、7.1、7.0 Fix Pack 54以降では、これらの手順はオプションです。

エラーが再発した場合は、次の「*.liファイルの検索」に進んでください。

.liファイルを検索する

症状： ${liferay.home}/data/licenseに *.li がない場合、アクティベーションキーがどこかに配備されている可能性があります。 そうなれば、コンフリクトが発生します。 このシナリオは、Liferay Portalのカスタムデプロイメントで最も多く発生するものです。

  1. 任意のディレクトリにある.liファイルの検索を実行します。
  2. 見つかった .li ファイルを削除する
  3. XMLアクティベーションキーファイルの再展開

エラーが再発する場合は、 サーバーログの読み方 の記事に進んでください。

サーバーログの読み方

症状： .li のファイルをすべて削除してもアクティベーションキーエラーが消えない場合、ログを確認してください。

  1. ${liferay.home}/logs フォルダを確認します。
  2. デプロイ時に生成されるログの場所を確認する

生成される一般的なエラーログ：

  • data/licenseフォルダにライセンスが展開されました。
ERROR [LicenseManager:?] Failed to read license file C:\Users\Liferay\Desktop\liferay-portal-6.1.10-ee-ga1\data\license\license-portaldevelopment-developer-6.1-liferaycom.xml

ERROR [LicenseManager:?] No binary licenses found

XMLファイルは、 ${auto.deploy.deploy.dir} フォルダ ( 通常, ${liferay.home}/deploy) に配置してください。 ${auto.deploy.deploy.dir}でXMLファイルがドロップされていることを確認した場合は、 Deploy/ Directoryの確認 の記事をご参照ください。

  • 読み書きの権限を設定する必要があります
ERROR [AutoDeployDir:143] Unable to write license-portalproduction-production-6.1ga1-abc123.xml

このエラーがログで確認された場合は、 Read/Write Permissions の記事を参照してください。

2. デプロイメントに関する問題

デプロイディレクトリが正しくない

症状： data/licenseフォルダをクリアし、すべての.liファイルを削除し、XMLファイルが ${liferay.home}/deploy ディレクトリにドロップされていることを確認しても、アクティベーションエラーメッセージが表示されます。

アクティベーションキーの展開に関わるディレクトリを制御するプロパティが2つあります：

  1. liferay.home は、ポータルが使用するいくつかのディレクトリのルートで、アクティベーションプロセスの結果として .li キーファイルがコピーされるディレクトリも含まれます。 デフォルト値は、liferayが動作しているアプリケーションサーバーに依存します。
  2. auto.deploy.deploy.dir は、.xml アクティブ化キーファイルを含む新しいコンポーネントをデプロイするために、ポータルがリッスンする場所を定義します。 このプロパティのデフォルトは、 ${liferay.home}/deployです。

そのため、関係するディレクトリを確認すること、

  1. auto.deploy.deploy.dir の値を確認してください。 このディレクトリにxmlキーファイルをコピーして、アクティベーションキーの展開処理を開始する必要があります。
  2. liferay.home の値を確認してください。 アクティベーションキー導入時に、.li ファイルが ${liferay.home}/data/licenseに書き込まれます。

なお、これらのプロパティは、 portal-ext.propertiesから設定することができます。 ただし、 liferay.homeを変更する前にポータルが起動していた場合は、古い liferay.home の内容を新しい場所に移動する必要があります。

アクティベーションエラーメッセージがまだ表示される場合は、 ヘルプセンターチケット を開き、以下の情報を提供することで進めてください：

  • ライセンスマネージャー のページでのエラーのスクリーンショット。
  • デプロイメント処理中に生成されるログ
  • portal-ext.properties のファイルです。

Read-Writeパーミッション

アクティベーションキーの展開で起こりうるエラーのひとつに、OSの権限設定によるものがあります。

症状です：

  1. XML ファイルは${liferay.home}/deployフォルダーに格納されています。
  2. ${liferay.home}/data/licenseに .li ファイルが生成されない。
  3. デプロイ時に以下のエラーログが生成されます。
ERROR [AutoDeployDir:xxx] Unable to write license-portalproduction-production-6.1ga1-abc123.xml

読み取り/書き込み権限を設定する必要があります

Linux

  1. ファイルのパーミッションを確認するには、ターミナルを開き、cd で ${liferay.home}内の対応するフォルダに移動し、コマンド ls -lを実行してください。
  2. パーミッションを変更するには、コマンドchmod -R 777 file または chmod -R a+rwx file （fileはアクティベーションキーファイルまたは何らかのディレクトリ）を入力してください。

ウィンドウズ

ユーザーがディレクトリやファイルの読み取り/書き込み権限を持っていても、Windowsの「読み取り専用」フラグが設定されている可能性があります。 この設定により、Javaはファイルへの書き込みができないと考えるようになります。

パーミッションの確認やフラグを変更するため：

  1. アクティベーション・キー・ファイルを右クリックし、 プロパティを選択します。
  2. General タブで、 Read-only チェックボックスがオンになっている場合は、チェックを外します。
  3. キーファイルをデプロイフォルダに置き、再度お試しください。

ヘルプセンターサポートチケットを開く

それでもライセンスエラーメッセージが表示される場合は、 ヘルプセンターチケット を開き、以下の情報を提供しながら手続きを進めてください：

  • ライセンスマネージャー のページでのエラーのスクリーンショット。
  • デプロイメント処理中に生成されるログ
  • portal-ext.properties のファイルです。

オーダーIDの使用（マーケットプレイスアプリケーション）

症状： オーダーIDで登録されたアプリケーションで、エラーメッセージが表示される場合。

  1. 利用可能なライセンスがない/サーバーがすでに登録されている
  2. 外部インターネット接続ができない： "unable to find valid certification path to requested target"

ヘルプセンターチケット を開き、以下の情報を提供してください：

  • サーバーの詳細（MACアドレス、IPアドレス、ホスト名）。
  • サーバーで複数のJVMやLiferayのインスタンスが稼働している場合。
  • サーバー環境です。
  • デプロイメントプロセス中に生成されるログです。
  • アクティベートするマーケットプレイスアプリの名称
did-this-article-resolve-your-issue
legacy-knowledge-base
did-this-article-resolve-your-issue