Liferay DXP、Liferay Commerce、Liferay Portalをご利用のお客様向けに、アクティベーションキーに関するトラブルシューティングガイドを掲載します。
目次
1. フォルダーとログの読み込み
ライセンスマネージャを読む
アクティベーションキーに失敗した場合、画面にエラーが表示される可能性があります。 このセクションでは、先ほどデプロイしたアクティベーション XML ファイルを読み、 License Manager ページに書かれている内容と照らし合わせる方法について説明します。
-
License Manager のページを見る
{eg. localhost}/c/portal/license - 最近配備されたXMLと、サーバーで読み込まれるXMLを相互参照する。
-
License Manager ページは、配置されたキーに関する有用な情報を提供します：
- Liferayのバージョン
- サーバーの詳細（MAC、IP、ホスト名）
- アクティベーションキーの種類（プロダクション、ノンプロダクション、デベロッパー）
- アクティベーションキーの有効期間（永久または試用期間）
- 最近デプロイされたXMLと情報が一致しない場合は、以下の Deploy / Directory をご確認ください。
デプロイディレクトリの確認
症状： .xml アクティベーションキーファイルを最初にデプロイしようとすると、ファイルがデプロイされない可能性があります。 この問題の大半は、 .xml ファイルが正しいディレクトリに配置されていないことに起因します。
- アプリケーションサーバーを起動します。 初回起動時に
${liferay.home}に deploy/ ディレクトリが作成されます。- XMLファイルは、
${auto.deploy.deploy.dir}ディレクトリに置く必要があります（通常は、${liferay.home}/deploy）。 - XML ファイルは
${liferay.home}/data/licenseに置くべきではありません。
- XMLファイルは、
- 一度ドロップしたXMLは、サーバーの稼働中に消滅します
-
.liファイルが${liferay.home}/data/licenseに生成されます。
XMLがまだ/deployディレクトリにある場合、 Deploymentを確認してください。
${liferay.home}/data/*に *.li が存在します。
症状です：
既存のアクティベーションキーとのコンフリクト
過去にアクティベーションキーを導入したことがある場合、 ${liferay.home}/data/license に *.li ファイルが存在することになります。 現在のキーがデプロイされていない場合、このファイルとの競合が発生する可能性があります。
-
${liferay.home}/data/*に存在する .li ファイルを削除する。 - Liferay DXP の場合、
${liferay.home}/osgi/modules/*フォルダから *.xml ファイルをすべて削除します。 - 提供された鍵の XML ファイルを liferay のデプロイディレクトリにコピーして再デプロイします （
auto.deploy.deploy.dirを参照）。
エラーが再発した場合は、次のステップ「*.liファイルの検索」に進んでください。
LCSとの兼ね合い
Liferay DXP 7.0 Fix Pack 53までは、*.xmlキーによるアクティベーションは、Liferay Connected Servicesのアクティベーションと互換性がありません。 そのため、アクティベーションキーを導入する前に、LCSクライアントをアンインストールすることが必須となります。
- サーバーをシャットダウンする
- 位置するLiferay Connected Services Client.lpkgを削除します：
- Tomcat バンドル内の
$ {liferay.home}/osgi/marketplaceフォルダにあります。 - 他のアプリケーションサーバーを使用する場合、
OSGi Dependencies/marketplaceフォルダーにあります。
- Tomcat バンドル内の
- Liferayの立ち上げ
Liferay DXP 7.2、7.1、7.0 Fix Pack 54以降では、これらの手順はオプションです。
エラーが再発した場合は、次の「*.liファイルの検索」に進んでください。
.liファイルを検索する
症状： ${liferay.home}/data/licenseに *.li がない場合、アクティベーションキーがどこかに配備されている可能性があります。 そうなれば、コンフリクトが発生します。 このシナリオは、Liferay Portalのカスタムデプロイメントで最も多く発生するものです。
- 任意のディレクトリにある.liファイルの検索を実行します。
- 見つかった .li ファイルを削除する
- XMLアクティベーションキーファイルの再展開
エラーが再発する場合は、 サーバーログの読み方 の記事に進んでください。
サーバーログの読み方
症状： .li のファイルをすべて削除してもアクティベーションキーエラーが消えない場合、ログを確認してください。
-
${liferay.home}/logsフォルダを確認します。 - デプロイ時に生成されるログの場所を確認する
生成される一般的なエラーログ：
- 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つあります：
-
liferay.homeは、ポータルが使用するいくつかのディレクトリのルートで、アクティベーションプロセスの結果として .li キーファイルがコピーされるディレクトリも含まれます。 デフォルト値は、liferayが動作しているアプリケーションサーバーに依存します。 -
auto.deploy.deploy.dirは、.xml アクティブ化キーファイルを含む新しいコンポーネントをデプロイするために、ポータルがリッスンする場所を定義します。 このプロパティのデフォルトは、${liferay.home}/deployです。
そのため、関係するディレクトリを確認すること、
-
auto.deploy.deploy.dirの値を確認してください。 このディレクトリにxmlキーファイルをコピーして、アクティベーションキーの展開処理を開始する必要があります。 -
liferay.homeの値を確認してください。 アクティベーションキー導入時に、.li ファイルが${liferay.home}/data/licenseに書き込まれます。
なお、これらのプロパティは、 portal-ext.propertiesから設定することができます。 ただし、 liferay.homeを変更する前にポータルが起動していた場合は、古い liferay.home の内容を新しい場所に移動する必要があります。
アクティベーションエラーメッセージがまだ表示される場合は、 ヘルプセンターチケット を開き、以下の情報を提供することで進めてください：
- ライセンスマネージャー のページでのエラーのスクリーンショット。
- デプロイメント処理中に生成されるログ
-
portal-ext.propertiesのファイルです。
Read-Writeパーミッション
アクティベーションキーの展開で起こりうるエラーのひとつに、OSの権限設定によるものがあります。
症状です：
- XML ファイルは
${liferay.home}/deployフォルダーに格納されています。 -
${liferay.home}/data/licenseに .li ファイルが生成されない。 - デプロイ時に以下のエラーログが生成されます。
ERROR [AutoDeployDir:xxx] Unable to write license-portalproduction-production-6.1ga1-abc123.xml
読み取り/書き込み権限を設定する必要があります
Linux
- ファイルのパーミッションを確認するには、ターミナルを開き、
cdで${liferay.home}内の対応するフォルダに移動し、コマンドls -lを実行してください。 - パーミッションを変更するには、コマンド
chmod -R 777 fileまたはchmod -R a+rwx file（fileはアクティベーションキーファイルまたは何らかのディレクトリ）を入力してください。
ウィンドウズ
ユーザーがディレクトリやファイルの読み取り/書き込み権限を持っていても、Windowsの「読み取り専用」フラグが設定されている可能性があります。 この設定により、Javaはファイルへの書き込みができないと考えるようになります。
パーミッションの確認やフラグを変更するため：
- アクティベーション・キー・ファイルを右クリックし、 プロパティを選択します。
- General タブで、 Read-only チェックボックスがオンになっている場合は、チェックを外します。
- キーファイルをデプロイフォルダに置き、再度お試しください。
ヘルプセンターサポートチケットを開く
それでもライセンスエラーメッセージが表示される場合は、 ヘルプセンターチケット を開き、以下の情報を提供しながら手続きを進めてください：
- ライセンスマネージャー のページでのエラーのスクリーンショット。
- デプロイメント処理中に生成されるログ
-
portal-ext.propertiesのファイルです。
オーダーIDの使用（マーケットプレイスアプリケーション）
症状： オーダーIDで登録されたアプリケーションで、エラーメッセージが表示される場合。
- 利用可能なライセンスがない/サーバーがすでに登録されている
- 外部インターネット接続ができない： "unable to find valid certification path to requested target"
ヘルプセンターチケット を開き、以下の情報を提供してください：
- サーバーの詳細（MACアドレス、IPアドレス、ホスト名）。
- サーバーで複数のJVMやLiferayのインスタンスが稼働している場合。
- サーバー環境です。
- デプロイメントプロセス中に生成されるログです。
- アクティベートするマーケットプレイスアプリの名称