WebSphereに以前のバージョンのLiferayをインストールする

Liferay DXP 2024.Q1/Portal GA112以下

WebSphereにLiferay DXPをインストールするには、DXP WARのインストール、依存関係のインストール、WebSphereの構成、およびDXPの開始が必要です。 データベースとメールサーバーの接続も設定する必要があります。

IBM® WebSphere®は、International Business Machines Corporationの商標であり、世界各国の多くの法域で登録されています。

前提条件

Liferay DXPが正しく機能するには、WebSphere 9（フィックスパック11以降）がインストールされている必要があります。 この修正パックに関する詳細については、IBMサポートにアクセスしてください。 Liferay DXPは現在、WebSphere Application Liberty Profileをサポートしていません。

以下のファイルは、WebSphereアプリケーションサーバーにLiferay DXPをインストールするために必要であり、 ヘルプセンター （サブスクリプション）または Liferayコミュニティダウンロードから入手できます。

• DXP WARファイル
• OSGi依存関係のZIPファイル
• 依存関係のZIPファイル（DXP 7.3以前）

Liferay DXP には サポートされている Java バージョン が必要です。 推奨設定については、 JVM構成 を参照してください。

[Liferay Home] フォルダーは、Liferay DXP が機能するために必要なファイルとフォルダーを保存および管理する場所です。 WebSphereでは、［Liferay Home］フォルダは通常［Install Location］/WebSphere/AppServer/profiles/［your-profile］/liferayです。

WebSphereの構成

WebSphereプロファイルの作成

アプリケーションサーバーのバイナリがインストールされたら、プロファイル管理ツールを起動して、DXPに適したプロファイルを作成します。

1. [作成]…をクリックし、 [アプリケーション サーバー]を選択してから、 [次へ] をクリックします。

2. 詳細プロファイル作成オプション をクリックし、次に 次へ をクリックします。 詳細プロファイルを使用して、次のような設定の値を指定します。

   • プロフィールの場所とプロフィール名
   • ノードとホスト
   • 特定のポートを割り当てる
   • 管理コンソールとサンプルアプリケーションをデプロイするかどうかを選択する
   • IBM HTTP Server の Web サーバー定義を追加する

   これらのオプションの詳細は、WebSphereのドキュメントを参照してください。

   

3. ［Deploy the administrative console］ボックスをオンにします。 これにより、アプリケーションサーバーを操作するためのWebベースのUIが有効になります。 デフォルトのアプリケーションをスキップします。 （これらは開発マシンにのみインストールしてください。） をクリックして、 に進みます。

4. プロファイル名と場所を設定します。 環境に適したパフォーマンス調整設定を指定します。

   注

   パフォーマンス調整設定の詳細は、WebSphereのドキュメントを参照してください。 をクリックして、 に進みます。

5. サーバーのノード、サーバー、およびホスト名を選択します。 これらは、ユーザーの環境に合わせたものです。 をクリックして、 に進みます。

6. WebSphereの管理セキュリティは、管理ツールへのアクセス権を持つユーザーを制限する方法です。 環境でこの方法を有効にすることで、WebSphereサーバーの管理にユーザー名とパスワードが必要となるようにできます。 詳細は、WebSphereのドキュメントを参照してください。 をクリックして、 に進みます。

7. 各プロファイルには、ウィザードの次に表示されるセキュリティ証明書が必要です。 証明書をまだ生成していない場合は、個人証明書と署名証明書を生成するオプションを選択し、［Next］をクリックします。

8. 証明書が生成されたら、キーストアのパスワードを設定します。 をクリックして、 に進みます。

9. このサーバープロファイルが使用するポートをカスタマイズできます。 必ず、マシン上で空いているポートを選択してください。 ポートを選択する際、ウィザードは既存のWebSphereインストールを自動的に検出し、アクティビティが検出された場合はポートを1つ増やします。

10. マシンの起動時にこのプロファイルを開始するかどうかを選択します。 をクリックして、 に進みます。

11. WebSphereにはIBM HTTP Serverが付属しています。 このJVMがHTTPサーバーから転送された要求を受信できるように、Webサーバー定義が必要かどうかを選択します。 詳細は、WebSphereのドキュメントを参照してください。 完了したら、 次へ をクリックします。

12. ウィザードに選択された内容の概要が表示され、選択内容を保持したり、前の画面に戻って内容を変更したりできます。 完了したら、 次へ をクリックします。

WebSphereはプロファイルを作成し、プロファイルが正常に作成されたことを示すメッセージで終了します。

最後に、アプリケーションサーバーをシャットダウンします。

WebSphereアプリケーションサーバーの構成

このバージョンのWebSphereでは、サーブレットフィルターはWebアプリケーションの起動時ではなく、最初のアクセス時に初期化されます。 これにより、特定のアプリをDXPにデプロイするときに問題が発生する可能性があります。 アプリケーションの起動時（つまり、デプロイ時）に初期化するようにサーブレットフィルターを構成するには、WebSphereアプリケーションサーバーで以下のwebcontainerプロパティを設定します。

com.ibm.ws.webcontainer.initFilterBeforeInitServlet = true
com.ibm.ws.webcontainer.invokeFilterInitAtStartup = true

WebSphereアプリケーションサーバーでwebcontainerプロパティを設定するには、WebSphereのドキュメンテーションの指示に従ってください。

Liferay DXPのJVMパラメータの設定

次のファイルの変更から始めます。

[Install Location]/WebSphere/AppServer/profiles/your-profile/config/cells/your-cell/nodes/your-node/servers/your-server/server.xml

ベースラインとして、 maximumHeapSize="2560" を jvmEntries タグ内に追加します。 以下に例を示します。

<jvmEntries xmi:id="JavaVirtualMachine_1183122130078" ... maximumHeapSize="2560">

<jvmEntries genericJvmArguments=.../> 属性で UTF-8 プロパティを設定できます。 server.xml。 これは必須です。そうしないと、国際文字が正しく解析されません。 ヒープサイズの最大値と最小値も増やします。 jvmEntriesタグ内に以下を追加します。

<jvmEntries xmi:id="JavaVirtualMachine_1183122130078" ...genericJvmArguments="-Dfile.encoding=UTF-8 -Djava.net.preferIPv4Stack=true -Dlog4j2.formatMsgNoLookups=true -Duser.timezone=GMT -Xms6144m -Xmx6144m -XX:MaxNewSize=1536m -XX:MaxMetaspaceSize=768m -XX:MetaspaceSize=768m -XX:NewSize=1536m -XX:SurvivorRatio=7">

Javaオプションとメモリ引数について以下に説明します。

JVMオプションの説明

メモリ引数の説明

secureSessionCookieタグの削除

同じプロファイルで、DXP起動エラーの原因となる可能性のあるsecureSessionCookieタグを削除します。 これは単なるデフォルト設定であることに注意してください。 DXPがインストールされたら、使用環境に基づいてWebSphereを適切に調整してください。

[インストール場所]/WebSphere/AppServer/profiles/your-profile/config/cells/your-cell/cell.xmlで、 secureSessionCookie タグ（ xmi:id="SecureSessionCookie_1" を含む）を削除します。

このタグを削除しないと、次のようなエラーが発生する可能性があります。

WSVR0501E: Error creating component com.ibm.ws.runtime.component.CompositionUnitMgrImpl@d74fa901
com.ibm.ws.exception.RuntimeWarning: com.ibm.ws.webcontainer.exception.WebAppNotLoadedException: Failed to load webapp: Failed to load webapp: SRVE8111E: The application, LiferayEAR, is trying to modify a cookie which matches a pattern in the restricted programmatic session cookies list [domain=*, name=JSESSIONID, path=/].

構成チェックポイント

この時点で、次の手順が完了している必要があります。

1. WebSphereアプリケーションサーバーのプロファイルが作成されている。

2. サーブレットフィルターが、webcontainer設定でアプリケーションの起動時に初期化するように構成されている。

3. JVMパラメータがserver.xmlファイルに設定されている。

4. ファイルのエンコーディングとしてUTF-8が設定されている。

5. サーバーのタイムゾーンがGMTに設定されている。

6. secureSessionCookieタグが削除されている。

依存関係のインストール

1. OSGi依存関係ZIPファイルを解凍し、その内容を［Liferay Home］/osgiフォルダに置きます(まだ存在しない場合は、このフォルダを作成します)。 LiferayのOSGiランタイムは、これらのモジュールに依存しています。

2. DXP 7.4+ WARファイルには、MariaDBおよびPostgreSQLのドライバーが含まれています。 以前のDXP WARにはそれらがありません。 7.4以降のWARに、使用中のサポートされているデータベースのドライバーがない場合は、DXP WARを任意の場所に解凍し、データベースベンダーのJDBC JARファイルを展開されたDXP WARのWEB-INF/shielded-container-libフォルダーに配置し、DXP WARを再度圧縮します。

   サポートされているデータベースのリストについては、互換性マトリックスを参照してください。

Elasticsearchのインストール

Liferay を起動すると、デフォルトの サイドカー Elasticsearch サーバーがインストールされ、起動します。 WebSphereにインストールするときは、最初からリモートElasticsearchサーバーをセットアップする必要があります。 Elasticsearch 入門 を参照してください。

Liferay DXP が構成され (Elasticsearch コネクタには .config ファイルを使用)、Elasticsearch が既に構成され実行されている状態で起動されると、Elasticsearch への接続がアクティブ化されます。

DXP portlet.jarのインストール

DXPのportlet.jar（バージョン3）は、バージョン2.0との下位互換性があります。 DXP 7.4 .warにはportlet.jarが含まれており、以前のDXPバージョンの依存関係ZIPにも含まれています。 WebSphereのportlet.jarバージョン2.0をオーバーライドする必要があります。

1. [インストール場所]/WebSphere/AppServer/profiles/your-profile/フォルダに、app_shared_librariesというフォルダを作成します。

2. DXP WAR（7.4以降）または[インストール場所] /WebSphere/AppServer/lib/extフォルダからDXP portlet.jarを、作成したapp_shared_librariesフォルダにコピーします。

3. サーバーに関連付けられた共有ライブラリを使用するためのIBMの手順に従ってください。手順4dで、最初にローカルクラスローダー（parent_Last）がロードされたクラスを選択してください。

4. 設定を保存します。

DXP Portlet.jarが最初に読み込まれるようにする

DXPのportlet.jarをサーバーに関連付けられた共有ライブラリに配置することに加えて、config.iniファイルを最初にロードされるように構成します。

1. [インストール場所]/WebSphere/AppServer/configuration/config.iniファイルを開きます。

2. プロパティcom.ibm.CORBA,com.ibmを検索します。

3. プロパティ javax.portlet,javax.portlet.filter,javax.portlet.annotations を com.ibm.CORBA の後、 com.ibm の前に挿入します。

4. ファイルを保存します。

依存関係チェックポイント

1. DXP依存関係がインストールされている。
2. DXPのportlet.jarがインストールされている。
3. config.iniファイルが設定されている。

アプリケーションサーバープロファイルを起動します。

データベース設定

DXPには組み込みのHypersonicデータベースが含まれています。これはデモンストレーション目的には最適ですが、本番環境では使用しないでください。 デモの目的以外に、フル機能のサポートされているRDBMSを使用することをお勧めします。 データベースの設定方法については、 データベースの構成 を参照してください。

Liferay DXPは、DXPに組み込まれているデータソースを使用する（推奨）か、アプリケーションサーバー上に作成したデータソースを使用してデータベースに接続できます。

DXP を初めて実行するときに、DXP の組み込みデータソースをデータベースで構成するには、 セットアップウィザード を使用します。 または、データベースの データベーステンプレート 基づいて、データソースを portal-ext.properties ファイルで構成できます。

WebSphereを使用してデータベース接続を管理する場合は、以下の手順に従ってください。 それ以外の場合、DXPの組み込みデータソースを使用する場合は、このセクションをスキップしてください。

1. DXP WAR（7.4以降）またはデータベースベンダーからJDBC JARを入手し、[インストール場所]/WebSphere/AppServer/lib/extフォルダにコピーします。

2. WebSphereを起動します。

3. 管理コンソールを開き、ログインします。

4. リソース → JDBC プロバイダー をクリックします。

5. スコープを選択し、［New］をクリックします。

6. データベースの種類、プロバイダーの種類、実装の種類を選択します。 事前定義されたデータベースを選択すると、ウィザードによって名前と説明のフィールドが自動的に入力されます。 目的のデータベースがリストにない場合は、［データベースの種類］フィールドから［User-defined］を選択して、［Implementation Class Name］を入力します。 例えば、MySQL を使用する場合は、 データベース タイプ → ユーザー定義を選択し、 com.mysql.jdbc.jdbc2.optional.MysqlConnectionPoolDataSource を 実装クラス名 に入力します。 をクリックして、 に進みます。

7. クラスパス設定のテキストをすべてクリアします。 必要なJARは、サーバーのクラスパス上の場所にすでにコピーされています。 をクリックして、 に進みます。

8. 設定を確認し、［Finish］をクリックします。 最終的な構成は次のようになります。

   

9. 新しいプロバイダー構成が表に表示されたらクリックします。

10. 追加プロパティ の下にある データソース をクリックします。

11. ［新規］をクリックします。

12. liferaydatabasesource を データ ソース名 フィールドに、 jdbc/LiferayPool を JNDI 名 フィールドに入力します。 をクリックして、 に進みます。

13. ウィザードの残りの画面で［Next］をクリックして、デフォルト値を受け入れます。 次にすべての変更を確認し、［Finish］をクリックします。

14. データソースが表に表示されたらクリックし、［Custom Properties］をクリックします。

15. ［Show Filter Function］ボタンをクリックします。 このボタンは、［New］ボタンと［削除］ボタンの下にある小さいアイコンの最後から2番目です。

16. userを検索語句に入力し、［Go］をクリックします。

    

17. userプロパティを選択し、ユーザー名の値をデータベースに付与します。

18. ［OK］をクリックして、マスター構成に保存します。

19. urlプロパティに対して別のフィルター検索を実行します。 このプロパティに、データベースを指す値を指定します。 たとえば、MySQLのURLは次のようになります。

    jdbc:mysql://localhost/lportal?useUnicode=true&characterEncoding=UTF-8&useFastDateParsing=false
    

    ヒント

    その他のURLの例については、 jdbc.default.url の値（ データベーステンプレート）を参照してください。

    ［OK］をクリックして、マスター構成に保存します。

20. passwordプロパティに対して別のフィルター検索を実行します。 このプロパティの値として、前に追加したユーザーIDのパスワードを入力します。 ［OK］をクリックして、マスター構成に保存します。

21. パンくずリストでデータソースページをクリックして、そのページに戻ります。 ［Test Connection］ボタンを使用して、この時点までの構成を検証します。

22. [Liferay_Home]のportal-ext.propertiesファイルで、データソースを指定します。 例えば、

    jdbc.default.jndi.name=jdbc/LiferayPool
    

メール設定

DXPの組み込みメールセッションを使用する場合は、このセクションをスキップしてください。 DXP の組み込みメールセッションの使用方法については、 メール設定 の記事を参照してください。

WebSphereを使用してメールセッションを管理する場合は、次の手順に従います。

WebSphere管理のメールセッションの作成

1. リソース → メール → メールプロバイダー をクリックします。

2. ノードとサーバーの組み込みメールプロバイダーをクリックします。

3. メールセッション をクリックし、次に 新規 ボタンをクリックします。

4. メールセッションにliferaymailの名前とmail/MailSessionのJNDI名を付けます。 ［Outgoing Mail Properties］セクションと［Incoming Mail Properties］セクションにメールサーバーの正しい情報を入力します。 ［OK］をクリックして、マスター構成に保存します。

5. 表に表示されたメールセッションをクリックし、［Additional Properties］セクションの下で［Custom Properties］を選択します。 プロトコル、ポート、SSLを使用するかどうかなど、メールサーバーに必要なその他のJavaMailプロパティを設定します。

6. セキュリティ → グローバル セキュリティ をクリックし、 Java 2 セキュリティを使用してローカル リソースへのアプリケーション アクセスを制限する が選択されている場合は選択を解除します。

   

7. をクリックして を適用します。

8. Liferay Homeのportal-ext.propertiesファイルで、メールセッションを指定します。 例えば、

   mail.session.jndi.name=mail/MailSession
   

メールサーバーからSSL証明書を取得し、それをWebSphereのトラストストアに追加する必要がある場合があることに注意してください。 この手順については、WebSphereのドキュメントを参照してください。

WebSphereメールプロバイダーの検証

メールセッションが正しく設定されていることを検証するには、WARファイルがデプロイされ、サーバーが起動し、ユーザーがシステム管理者としてサインインした後、多くのテスト方法があります。 検証する簡単な方法の1つは、有効なメールアカウントで新しいユーザーを作成することです。 新しく作成されたユーザーは、電子メール通知を受信します。 ログには、リストされている正しいポート番号でSMTPサーバーがpingされていることが表示されます。

HTTPセッションのCookieを有効にする

WebSphereでは、デフォルトでCookieをHTTPSセッションに制限しています。 HTTPを使用している場合、ユーザーはDXPにサインインできなくなり、コンソールに次のエラーが表示されます。

20:07:14,021 WARN  [WebContainer : 1][SecurityPortletContainerWrapper:341]
User 0 is not allowed to access URL http://localhost:9081/web/guest/home and portlet com_liferay_login_web_portlet_LoginPortlet

これは、HTTPの使用時にDXPがHTTPS Cookieを使用できないために発生します。 その結果、ページが更新されるたびに新しいセッションが作成されます。 WebSphereでこの問題を解決するには、以下の手順に従ってください。

1. アプリケーションサーバー → server1 → セッション管理 → Cookie を有効にする をクリックします。

2. ［Restrict cookies to HTTPS sessions］の選択を解除します。

3. をクリックして を適用します。

4. ［保存］をクリックします。

DXPのデプロイ

1. WebSphere の管理コンソールで、 アプリケーション → 新規アプリケーション → 新規エンタープライズアプリケーション をクリックします。

2. DXP .warファイルを参照して選択し、［Next］をクリックします。

3. 高速パス を選択したまま、 次へ をクリックします。 ［Distribute Application］がオンになっていることを確認し、もう一度［Next］をクリックします。

4. DXPをデプロイするWebSphereランタイムまたはクラスター、あるいはその両方を選択します。 をクリックして、 に進みます。

5. DXPをデプロイする仮想ホストを選択し、［Next］をクリックします。

6. DXP をルート コンテキスト (/) にマッピングし、 次へ をクリックします。

7. 目的の メタデータ完全属性 設定を選択し、 次へ をクリックします。

8. 設定が正しいことを確認し、［Finish］をクリックします。

9. DXPがインストールされたら、［Save to Master Configuration］をクリックします。

   

DXPがインストールされました。 DXPを開始する前に、いくつかの必要な手順があります。

JSPをコンパイルするためのJDKバージョンの設定

DXPでは、JSPをJava 8バイトコード形式にコンパイルする必要があります。 WebSphereがこれを行うようにするには、DXP .warファイルをデプロイした後にWebSphereをシャットダウンします。 WEB_INFフォルダに移動し、次の設定をibm-web-ext.xmlに追加します（ほとんどの場合、ibm-web-ext.xmiファイルです）。

<jsp-attribute name="jdkSourceLevel" value="18" />

ibm-web-ext.xmiファイルへの正確なパスは、WebSphereのインストール場所とDXPのバージョンによって異なりますが、以下に例を示します。

/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells/localhostNode01Cell/applications/liferayXX.ear/deployments/liferayXX/liferayXX.war/WEB-INF/ibm-web-ext.xmi

DXP .warは、ibm-web-ext.xmiファイルにあらかじめパッケージ化されていることに注意してください。この形式は機能的に.xmlと同じで、WebSphereは両方の形式を認識します。 WebSphere が JSP をコンパイルする方法に関するより一般的な情報については、IBM の WebSphere Application Server 9.0.0.x の公式ドキュメントを参照してください。

DXPの開始

1. セットアップウィザードを使用する場合は、次の手順に進んでください。 ただし、WebSphereのデータソースとメールセッションを使用していて、セットアップウィザードをバイパスする場合は、portal-ext.propertiesファイルで次のポータルプロパティを設定します。

   setup.wizard.enabled=false
   

2. アプリケーションサーバーを起動します。

3. WebSphere管理コンソールで、［Enterprise Applications］に移動し、DXPアプリケーションを選択して、［Start］をクリックします。 DXPの起動中、WebSphereには回転する図が表示されます。

4. DXPのセットアップウィザードで、データベースの種類を選択して設定します。 をクリックして完了します。 DXPは、データベースに必要なテーブルを作成します。

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]

Liferay DXP Enterpriseサブスクリプションをお持ちの場合、DXPはアクティベーションキーを要求します。 詳細については、 Liferay DXP のアクティベーション を参照してください。

　 Liferay DXPをWebSphereで実行しています。

今後の流れ

管理者ユーザー として サインインして、DXP 上でソリューションの構築を開始できます。 または、Liferay DXPのその他のセットアップトピックを参照できます。

• マーケットプレイスプラグインのインストール
• 試用期間中のプラグインへのアクセス
• 検索エンジンのインストール
• セキュリティ
• 高可用性のクラスタリング