Liferay DXPをインストールする最も簡単な方法はバンドルを 使うことです。 しかし、これは常に可能というわけではありません。組織によっては、Liferay DXPをインストールする必要がある既存のインフラストラクチャがあります。また、特定のアプリケーションサーバーで標準化している組織もあります。Liferay DXPは、多くの主要なアプリケーションサーバーとうまく連携します。インストールを始める前に、Liferay DXPのデータソースとメールセッションを管理するための2つの異なるアプローチがあることに注意してください。これらのトピックはすべて網羅されています。
データソースから始めます。
データソースを使用すること
Liferay DXPには、データソースを設定するためには2つの方法があります。
- Liferay DXPの組み込みデータソースを使用する
- ご利用のアプリケーションサーバーのJNDIデータソースを使用する
組み込みデータソースの使用をお勧めします。Liferay DXPのデータソースは、プロパティファイルで設定されているプロパティによって設定されています。デフォルトでは、 Liferay DXPの初回起動時に表示される基本設定ページにデータベースの接続情報を入力できます。セットアップウィザードは入力された情報をLiferay Homeフォルダにあるportal-setup-wizard.propertiesという名前の設定ファイルに保管します。組み込みデータソースはこの情報を使用してデータベースに接続します。
組み込みデータソースを使用することをお勧めしますが、それ以外の方法もあります。アプリケーションサーバーが提供するデータソースを使用することもできます。この場合、JNDIルックアップはデータソースへのハンドルを提供し、アプリケーションサーバーは接続プールを管理します。
アプリケーションサーバーのデータソースを設定するには、独自の設定ファイルを作成してセットアップウィザードをスキップする必要があります。ウィザードの後にこのファイルを作成することになるので 、いずれにしても大したことではありません。以下の手動設定のセクションでは、JNDIデータソースの設定について説明します。
メールセッションもデータソースと同じように設定されているので、それを次に紹介します。
Using Mail Sessions
Liferay DXPはSMTPを使用してメールを送信します。データベースと同様に、メールサーバーを設定するには2つの方法があります。
- Liferay DXPの組み込みメールセッションを使用する
- アプリケーションサーバーのメールセッションを使用する
組み込みメールセッションを使用することをお勧めします。Liferay DXPを起動した後は、[Controle Panel]からメールサーバーを設定できます。デフォルト設定は、Liferay DXPを実行している同じマシン上のメールサーバです。これが自身の設定ではない場合は、デフォルトを変更する必要があります。これを行うには、Liferay Homeフォルダ内の、portal-ext.propertiesファイルを使用します（下記参照）。
アプリケーションサーバーのメールセッションを使用するには、それをアプリケーションサーバー内に作成する必要があります。メールセッションを作成したら、portal-ext.propertiesファイルまたは[Control Panel]からLiferay DXPをつなげることができます。
データベース接続とメールセッションの両方を管理するためにLiferay DXPを使用する場合は、Liferay DXPの最初の起動時に基本設定ページにデータベース接続情報を入力してから、[Control Panel]からメールサーバー情報を入力します。
自身のアプリケーションサーバでデータベース接続、またはメールサーバーを管理する予定の場合、Liferay DXPのセットアップウィザードを使うことができません：以下の手動設定セクションの指示に従う必要があります。
各アプリケーションサーバーのインストール記事には、データベース接続とメールサーバーを管理するためにアプリケーションサーバーを設定するための手順も含まれています。
Manual Configuration
アプリケーションサーバーにデータベース接続またはメールサーバー（あるいはその両方）を管理させるには、この設定を手動で作成する必要があります。Liferay Homeフォルダにportal-ext.propertiesという名前のテキストファイルを作成します。このファイルはデフォルトのプロパティを上書きします。
アプリケーションサーバーのデータソースを使用するには、データベースとつなげる接続プールをアプリケーションサーバー内に作成します。この接続プールをjdbc/LiferayPoolと名付けます。以上は、各アプリケーションサーバーの記事で詳しく説明しています。jdbc/LiferayPool接続プールを使用するようにLiferay DXPに指示するには、portal-ext.propertiesファイルに次のディレクティブを追加します。
jdbc.default.jndi.name=jdbc/LiferayPool
次に、アプリケーションサーバーの記事に従ってLiferay DXPをインストールします。 インストールしたら、メール設定をセットアップできます。
メール設定を作成するために、コントロールパネルを使用する必要があります。[コントロールパネル]→[設定]→[サーバ管理]→[メール]へ行き、メールセッション設定のための設定を入力します。
これをportal-ext.propertiesファイルで設定することもできます。これにより、設定を1回実行してから設定ファイルを複数のマシンにコピーできます。組み込みメールセッションを使用するには、以下のプロパティを使用して、環境に合わせてそれらの値をカスタマイズします。
mail.session.mail.pop3.host=localhost
mail.session.mail.pop3.password=
mail.session.mail.pop3.port=110
mail.session.mail.pop3.user=
mail.session.mail.smtp.auth=false
mail.session.mail.smtp.host=localhost
mail.session.mail.smtp.password=
mail.session.mail.smtp.port=25
mail.session.mail.smtp.user=
mail.session.mail.store.protocol=pop3
mail.session.mail.transport.protocol=smtp
アプリケーションサーバーのメールセッションを使用するには、まずメールセッションを作成します。それから、それをportal-ext.propertiesファイルに指定します。
mail.session.jndi.name=mail/MailSession
完了したら、ファイルを保存します。
Logging
Liferay DXPをデプロイした後、PhaseOptimizerを含む以下のような過剰な警告とログメッセージが表示される場合があります。これらは良性なので無視することができます。このようなログメッセージを回避するために、必ずアプリケーションサーバーのログレベルまたはログフィルターを調整してください。
May 02, 2018 9:12:27 PM com.google.javascript.jscomp.PhaseOptimizer$NamedPass process
WARNING: Skipping pass gatherExternProperties
May 02, 2018 9:12:27 PM com.google.javascript.jscomp.PhaseOptimizer$NamedPass process
WARNING: Skipping pass checkControlFlow
May 02, 2018 9:12:27 PM com.google.javascript.jscomp.PhaseOptimizer$NamedPass process
INFO: pass supports: [ES3 keywords as identifiers, getters, reserved words as properties, setters, string continuation, trailing comma, array pattern rest, arrow function, binary literal, block-scoped function declaration, class, computed property, const declaration, default parameter, destructuring, extended object literal, for-of loop, generator, let declaration, member declaration, new.target, octal literal, RegExp flag 'u', RegExp flag 'y', rest parameter, spread expression, super, template literal, modules, exponent operator (**), async function, trailing comma in param list]
current AST contains: [ES3 keywords as identifiers, getters, reserved words as properties, setters, string continuation, trailing comma, array pattern rest, arrow function, binary literal, block-scoped function declaration, class, computed property, const declaration, default parameter, destructuring, extended object literal, for-of loop, generator, let declaration, member declaration, new.target, octal literal, RegExp flag 'u', RegExp flag 'y', rest parameter, spread expression, super, template literal, exponent operator (**), async function, trailing comma in param list, object literals with spread, object pattern rest]