legacy-knowledge-base
公開されました Jul. 2, 2025

Wildfly で Liferay を構成する

投稿者

Amit Tiwari

knowledge-article-header-disclaimer-how-to

knowledge-article-header-disclaimer

legacy-article

learn-legacy-article-disclaimer-text

問題

  • Wildfly に Liferay DXP をインストールする詳細な手順

Environment

  • Liferay DXP 7.2+
  • JDK1.8

注: Wildfly のバージョンについては、 7.2 および 7.3の Liferay 互換性マトリックスを確認してください。

解像度

ヘルプ センターから以下のファイルをダウンロードします。

  1. DXP WARファイル

  2. 依存関係の ZIP ファイル

  3. OSGi依存関係のZIPファイル

  • フォルダー $WILDFLY_HOME/modules/com/liferay/portal/main を作成し、そこに依存関係の ZIP JAR を抽出します。
  • $WILDFLY_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="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>

Liferay の依存関係 ZIP 内の各 JAR に対して、JAR 名に設定された 8パス 属性持つ resource-root 要素を追加します。 たとえば、 resource-root com.liferay.petra.concurrent.jar ファイルに次のような要素を追加します:

<resource-root path="com.liferay.petra.concurrent.jar" />
  • osgi フォルダーを Liferay Home フォルダーに作成します。 ダウンロードした OSGi 依存関係の ZIP ファイルを [Liferay Home]/osgi フォルダーに抽出します。
  • $WILDFLY_HOME/standalone/configuration/standalone.xml に移動し、次の変更を行います。

1. <jsp-config> タグで、Liferay ソースとクラス ファイル Java VM 互換性を設定します。 これらはデフォルトでJava 8と互換性があります。

<jsp-config development="true" source-vm="1.8" target-vm="1.8" />

2. 終了タグ </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>

3. <filter-spec> <console-handler> <level name="INFO"/>

<filter-spec value="not(any(match(&quot;WFLYSRV0059&quot;),match(&quot;WFLYEE0007&quot;)))" />

4. 以下の抜粋に示すように、 deployment-timeout="600" を設定して、デプロイメント スキャナーのタイムアウトを追加します。

<subsystem xmlns="urn:jboss:domain:deployment-scanner:2.0">
    <deployment-scanner deployment-timeout="600" path="deployments" relative-to="jboss.server.base.dir" scan-interval="5000" runtime-failure-causes-rollback="${jboss.deployment.scanner.rollback.on.failure:false}"/>
</subsystem>

5. ウェルカム コンテンツのコード スニペットを削除します。

<location name="/" handler="welcome-content"/>

および

<handlers>
    <file name="welcome-content" path="${jboss.home.dir}/welcome-content"/>
</handlers>

6. $WILDFLY_HOME/bin/に移動します

standalone.conf.bat (Windows 用):

最初の JAVA_OPTS 割り当てをコメントアウトします。

rem set "JAVA_OPTS=-Xms64M -Xmx512M -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=2560m"

次の JAVA_OPTS 割り当てを、ファイルの末尾にある :JAVA_OPTS_SET 行の 1 行上に追加します。

set "JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF-8 -Djava.net.preferIPv

standalone.conf (Unix 用):

1. の場合 [ "x$JAVA_OPTS" = "x" ]; ステートメント、この JAVA_OPTS ステートメントを置き換えます。

JAVA_OPTS="-Xms1303m -Xmx1303m -XX:MetaspaceSize=96M -XX:MaxMetaspaceSize=2560m -Djava.net.preferIPv4Stack=true"

以下のものと置き換えます。

JAVA_OPTS="-Djava.net.preferIPv4Stack=true"

2. 次のステートメントをファイルの末尾に追加します。

JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8 -Djava.net.preferIPv4Stack=true -Djboss.as.management.blocking.timeout=480 -Duser.timezone=GMT -Xms2560m -Xmx2560m -XX:MaxMetaspaceSize=512m"

JDK 11 では、この JVM 引数を追加して 4 桁の年を表示します。

-Djava.locale.providers=JRE,COMPAT,CLDR
NOTE:

If using the IBM JDK with the JBoss server, complete these additional steps:

Navigate to the $JBOSS_HOME/modules/com/liferay/portal/main/module.xml file and insert the following dependency within the <dependencies> element:

<module name="ibm.jdk" />

7. $JBOSS_HOME/modules/system/layers/base/sun/jdk/main/module.xml ファイルに移動し、次のパス名を <paths>...</paths>内に挿入します。 要素:

<path name="com/sun/crypto" />
<path name="com/sun/crypto/provider" />
<path name="com/sun/image/codec/jpeg" />
<path name="com/sun/org/apache/xml/internal/resolver" />
<path name="com/sun/org/apache/xml/internal/resolver/tools" />

8. フォルダー $WILDFLY_HOME/standalone/deployments/ROOT.war が WildFly インストールに既に存在する場合は、そのサブフォルダーとファイルをすべて削除します。 それ以外の場合は、 $WILDFLY_HOME/standalone/deployments/ROOT.warという新しいフォルダーを作成します。

9. DXP .war ファイルを ROOT.war フォルダーに解凍します。

10. ROOT.warのデプロイをトリガーするには、 $WILDFLY_HOME/standalone/deployments/ フォルダーに ROOT.war.dodeploy という名前の空のファイルを作成します。 起動時に、WildFly はこのファイルを検出し、Web アプリケーションとして展開します。

11. $WILDFLY_HOME/bin に移動し、 standalone.bat または standalone.shを実行して、WildFly アプリケーション サーバーを起動します。

12. アクティベーション キーを Liferay DXP 展開フォルダーに配置します。

追加情報

  1. WildFlyへのインストール
  2. ダウンロード Wildfly に基づく 互換性マトリックスに従ってサポートされているバージョン
  3. ダウンロード Liferay DXP WAR、依存関係 zip、特定のバージョンの OSGi 依存関係
did-this-article-resolve-your-issue

legacy-knowledge-base