- JBoss EAP 7.1にLiferay DXPをインストールするには3つの手順があります
続行する前に、Customer Portalからこれらのファイルをダウンロードしてください :
-
Liferay DXP WARファイル
-
依存関係のZIPファイル
-
OSGi JARsのZIPファイル
Liferay Homeのフォルダの中に、JBossサーバーフォルダが入っています。Liferay DXPをインストールおよびデプロイしたら、Liferayのホームフォルダの中にJBossサーバーのフォルダ、data、deploy、logs、およびosgiフォルダが含まれています。$JBOSS_HOMEはJBossサーバーのフォルダのことです。 このフォルダには通常jboss-eap-[version]という名前が付けられています。
依存関係のインストール
Liferay DXPは、いくつかのLiferay固有の、およびサードパーティーのJARに依存しています。 以下の説明に従って、必要なJARをダウンロードしてインストールしてください。
-
$JBOSS_HOME/modules/com/liferay/portal/mainというフォルダがない場合は新たに作成し、そのフォルダーに依存関係のZIPからJARを抽出します。- `com.liferay.petra.concurrent.jar` - `com.liferay.petra.executor.jar` - `com.liferay.petra.function.jar` - `com.liferay.petra.io.jar` - `com.liferay.petra.lang.jar` - `com.liferay.petra.memory.jar` - `com.liferay.petra.nio.jar` - `com.liferay.petra.process.jar` - `com.liferay.petra.reflect.jar` - `com.liferay.petra.string.jar` - `com.liferay.registry.api.jar` - `hsql.jar` - `portal-kernel.jar` - `portlet.jar` -
データベースドライバ
.jarファイルをダウンロードして、同じフォルダにコピーします。 例えば、copy MySQL’s driver を$JBOSS_HOME/modules/com/liferay/portal/mainフォルダにコピーします。 -
$JBOSS_HOME/modules/com/liferay/portal/mainフォルダにmodule.xmlファイルを作成し、以下の設定を挿入します。<?xml version="1.0"?> <module xmlns="urn:jboss:module:1.0" name="com.liferay.portal"> <resources> <resource-root path="com.liferay.petra.concurrent.jar" /> <resource-root path="com.liferay.petra.executor.jar" /> <resource-root path="com.liferay.petra.function.jar" /> <resource-root path="com.liferay.petra.io.jar" /> <resource-root path="com.liferay.petra.lang.jar" /> <resource-root path="com.liferay.petra.memory.jar" /> <resource-root path="com.liferay.petra.nio.jar" /> <resource-root path="com.liferay.petra.process.jar" /> <resource-root path="com.liferay.petra.reflect.jar" /> <resource-root path="com.liferay.petra.string.jar" /> <resource-root path="com.liferay.registry.api.jar" /> <resource-root path="hsql.jar" /> <resource-root path="mysql.jar" /> <resource-root path="portal-kernel.jar" /> <resource-root path="portlet.jar" /> </resources> <dependencies> <module name="javax.api" /> <module name="javax.mail.api" /> <module name="javax.servlet.api" /> <module name="javax.servlet.jsp.api" /> <module name="javax.transaction.api" /> </dependencies> </module>別のデータベースを使用している場合は、デートベース用にMySQL
.jarをドライバJAR（例：HSQL、PostgreSQLなど）に置き換えてください。 -
Liferay Homeフォルダの中に
osgiフォルダを作成します。osgiフォルダの中にダウンロードしたOSGi ZIPファイルを抽出します。この
osgiフォルダは、Liferay DXPのOSGiランタイムに必要なモジュールを提供します。
確認事項:
-
$JBOSS_HOME/modules/com/liferay/portal/mainフォルダに以下のファイルがあることを確認します：com.liferay.petra.concurrentcom.liferay.petra.executor.jarcom.liferay.petra.function.jarcom.liferay.petra.io.jarcom.liferay.petra.lang.jarcom.liferay.petra.memory.jarcom.liferay.petra.nio.jarcom.liferay.petra.process.jarcom.liferay.petra.reflect.jarcom.liferay.petra.string.jarcom.liferay.registry.api.jarportal-kernel.jarportlet.jar- MySQL ConnectorなどのデータベースJAR
-
module.xmlには<resource-root-path>内の全てのJARsがリストされています。 -
osgiフォルダの中には、以下のサブフォルダがあります。configscoremarketplacemodulesportalstatictestwar
これで .jarファイルの準備が整いました。
Standalone ModeとDomain ModeでLiferay DXPをJBoss EAPで実行する
JBoss EAPは、standalone modeまたはdomain modeで起動できます。Domain modeでは、複数のアプリケーションサーバーインスタンスを単一のコントロールポイントから管理できます。このようなアプリケーションサーバーの集まりをdomainと言います。 Standalone modeとDomain modeの詳細については、JBoss EAP Product Documentationのこのトピックに関するセクションを参照してください 。
Liferay DXPは、JBoss EAPをstandalone modeで実行している場合はサポートしますが、domain modeで実行している場合はサポートしません。JBossは、（展開または非展開の）ファイルをコピーすることによってデプロイの内容を管理するため、Liferay DXPのhot-deployは管理されたデプロイでは機能しません。これにより、JSP hooksおよびExtプラグインが意図したとおりに機能しなくなってしまいます。例えば、Liferay DXPのJSPオーバーライドメカニズムはアプリケーションサーバーに依存しているため、JSPフックは管理されているドメインモードで実行されているJBoss EAPでは機能しません。しかし、これらの機能はどちらも廃止予定であるため、使用しない可能性があります。
コマンドラインインターフェースは、domain modeのデプロイにお勧めします。
JBossの設定方法
Liferay DXPを実行するためにJBossを設定するには、以下のことをします：
- 環境変数を設定する
- プロパティと記述子の設定
- 不要な設定を削除する
必要に応じて、Liferay DXPのために以下のものを管理するようにJBossを設定できます:
Liferay DXPを実行できるようにするためにはまずJBossを設定することから始めます。
以下の変更を
$JBOSS_HOME/standalone/configuration/standalone.xmlに加えます：
-
Closing
</extensions>タグを見つけます。そのタグのすぐ下に、次のシステムプロパティを挿入します。<system-properties> <property name="org.apache.catalina.connector.URI_ENCODING" value="UTF-8" /> <property name="org.apache.catalina.connector.USE_BODY_ENCODING_FOR_QUERY_STRING" value="true" /> </system-properties> -
<level name="INFO"/>タグのすぐ下に、以下の<filter-spec>タグを<console-handler>タグに追加してください。<filter-spec value="not(any(match("WFLYSRV0059"),match("WFLYEE0007")))" /> -
以下の抜粋のように、
deployment-timeout="360"を設定して、デプロイメントスキャナーのタイムアウトを追加します。<subsystem xmlns="urn:jboss:domain:deployment-scanner:2.0"> <deployment-scanner deployment-timeout="360" path="deployments" relative-to="jboss.server.base.dir" scan-interval="5000"/> </subsystem> -
<subsystem xmlns="urn:jboss:domain:security:2.0">で定義された構成部分に次のJAASセキュリティドメインをセキュリティサブシステム<security-domains>に追加します。 -
ウェルカムコンテンツを提供する2つのコードスニペットを削除します：
<location name="/" handler="welcome-content"/>と
<handlers> <file name="welcome-content" path="${jboss.home.dir}/welcome-content"/> </handlers> -
<jsp-config/>タグを検索して、development、source-vm、およびtarget-vmタグの属性を設定します。これが完了すると、タグは次のようになります：<jsp-config development="true" source-vm="1.8" target-vm="1.8"/>
確認事項:
続行する前に、standalone.xmlファイルに次のプロパティが設定されていることを確認してください:
-
新しい
<system-property>が追加されている。 -
新しい
<filter-spec>が追加されている。 -
<deployment-timeout>が360に設定されている。 -
新しい
<security-domain>が作成されている。 -
ウェルカムコンテンツが削除されている。
-
<jsp-config>タグに、新しい属性が含まれている。
以上のことが確認できたら、JVMと立ち上げ時のスクリプトを設定します。
$JBOSS_HOME/binフォルダの中の、スタンドアロンドメインの設定スクリプトファイルstandalone.confを以下のように変更する必要があります（Windowsの場合standalone.conf.bat）：
-
ファイルエンコーディングを設定する。
-
ユーザーのタイムゾーンを設定する。
-
希望するプロトコルスタックを設定する。
-
利用可能なデフォルトのメモリ容量を増やす。
使用しているオペレーティングシステムに応じて、以下の編集を行います：
Windows
-
以下に示されているように、最初の
JAVA_OPTSの割り当てをコメントアウトします。rem set "JAVA_OPTS=-Xms1G -Xmx1G -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m" -
ファイルの末尾にある
:JAVA_OPTS_SETの一行上にJAVA_OPTSを追加します:set "JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF-8 -Djava.net.preferIPv4Stack=true -Djboss.as.management.blocking.timeout=480 -Duser.timezone=GMT -Xmx2048m -XX:MaxMetaspaceSize=384m"
Unix
-
if [ "x$JAVA_OPTS" = "x" ];の下を、このJAVA_OPTSに置き換えます：JAVA_OPTS="-Xms1303m -Xmx1303m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=256m -Djava.net.preferIPv4Stack=true以下も置き換えます：
JAVA_OPTS="-Djava.net.preferIPv4Stack=true" -
ファイルの末尾に以下を追加します：
JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8 -Djava.net.preferIPv4Stack=true -Djboss.as.management.blocking.timeout=480 -Duser.timezone=GMT -Xmx2048m -XX:MaxMetaspaceSize=512m"
確認事項:
これで、アプリケーションサーバーのJVM設定は完了しました。
-
ファイルのエンコーディング、ユーザータイムゾーン、希望するプロトコルスタックは
standalone.conf.bat内のJAVA_OPTSで設定されています。 -
利用可能なデフォルトのメモリ量が増えています。
JBossにLiferay DXPをインストールするためのスクリプトの変更はこれで完了しました。次にデータベースとメールを設定します。
データベースの設定方法
データベース設定を処理する上で一番簡単な方法は Liferay DXPにデータソースを管理させることです。Basic Configurationのページでは、Liferay DXPの組み込みデータソースを設定できます。 組み込みのデータソースを使用したい場合は、このセクションを飛ばしてください。
このセクションではMySQLデータベースの設定方法について説明します。別のデータベースを使用している場合は、必要に応じてデータソースとドライバのスニペットを変更します。
JBossにデータソースを管理させたい場合は、次の手順に従ってください：
-
<datasources>要素内にデータソースを追加します。<datasource jndi-name="java:jboss/datasources/ExampleDS" pool-name="ExampleDS" enabled="true" jta="true" use-java-context="true" use-ccm="true"> <connection-url>jdbc:mysql://localhost/lportal</connection-url> <driver>mysql</driver> <security> <user-name>root</user-name> <password>root</password> </security> </datasource>データベース名（例
lportal）、ユーザー名、およびパスワードを適切なものに置き換えてください。 -
<datasources>要素内にあるstandalone.xmlファイルの<drivers>要素にドライバを追加します。<drivers> <driver name="mysql" module="com.liferay.portal"> <driver-class>com.mysql.jdbc.Driver</driver-class> </driver> </drivers>最終的なデータソースサブシステムは次のようになります：
<subsystem xmlns="urn:jboss:domain:datasources:5.0"> <datasources> <datasource jndi-name="java:jboss/datasources/ExampleDS" pool-name="ExampleDS" enabled="true" jta="true" use-java-context="true" use-ccm="true"> <connection-url>jdbc:mysql://localhost/lportal</connection-url> <driver>mysql</driver> <security> <user-name>root</user-name> <password>root</password> </security> </datasource> <drivers> <driver name="mysql" module="com.liferay.portal"/> </drivers> </datasources> </subsystem> -
Liferayホーム内の
portal-ext.propertiesファイルに、データソースを指定します。jdbc.default.jndi.name=java:jboss/datasources/ExampleDS
データソースを設定したので、次はメールの設定方法について説明します。
メール設定方法
データベースと同様、メール設定の処理もLiferay DXPに行わせるのが一番簡単な方法です。Liferay DXPの組み込みメールセッションを使用したい場合は、このセクションを飛ばしてControl Panelでメールセッションを設定してください。
JBoss上でメールセッションを管理したい場合は、次の手順に従ってください：
-
$WILDFLY_HOME/standalone/configuration/standalone.xmlのファイル上でメールサブシステムを以下のように指定します：<subsystem xmlns="urn:jboss:domain:mail:3.0"> <mail-session jndi-name="java:jboss/mail/MailSession" > <smtp-server ssl="true" outbound-socket-binding-ref="mail-smtp"> <login username="USERNAME" password="PASSWORD"/> </smtp-server> </mail-session> </subsystem> ... <socket-binding-group name="standard-sockets" default-interface="public" port-offset="${jboss.socket.binding.port-offset:0}"> ... <outbound-socket-binding name="mail-smtp"> <remote-destination host="smtp.gmail.com" port="465"/> </outbound-socket-binding> </socket-binding-group> -
Liferay Homeの
portal-ext.propertiesのファイルに、メールセッションを参照してください：mail.session.jndi.name=java:jboss/mail/MailSession
これでメールが届くようになります。次に、Liferay DXPをJBossアプリケーションサーバーにデプロイします。
Liferay DXPをデプロイする
-
$JBOSS_HOME/standalone/deployments/ROOT.warのフォルダがすでにJBossインストールに存在する場合は、そのサブフォルダとファイルをすべて削除します。 存在しない場合は、$JBOSS_HOME/standalone/deployments/ROOT.warという名前の新しいフォルダを作成します 。 -
Liferay DXP
.warファイルをROOT.warフォルダに解凍します。 -
ROOT.warのデプロイを実行するために、名前なしのファイルROOT.war.dodeployを、$JBOSS_HOME/standalone/deployments/フォルダに作成します。 立ち上げ時に、JBossはこのファイルの存在を検出してWebアプリケーションとしてデプロイします。 -
$JBOSS_HOME/binに移動して、実行されているstandalone.batまたはstandalone.shを使ってJBossアプリケーションを立ち上げます。
これでJBossにLiferay DXPをデプロイできました！