この記事は、WebSphere 7にLiferay Portalを導入する方法について書かれています。
解像度
Websphere アプリケーション・サーバーに変更を加える前に、まずサーバーを停止してください! 失敗するとエラーの原因になります。
Liferay Portalの6.1以降の最新バージョンでは、Websphereでのホットデプロイが可能です。 この機能を正しく設定するためには、 auto.deploy.dest.dir
が liferay.home ディレクトリとは別のディレクトリであることを確認してください。 ( liferay.home
を C:/home
に、 auto.deploy.dest.dir
を C:/home/deploy
に設定しないでください。そうすると liferay.home
と auto.deploy.dest.dir
で同じ配置フォルダになってしまいプラグイン展開に問題が発生します)。
portal-ext.properties
を Liferay.war
ファイル内に配置してからデプロイしてください。
JNDIを使用してデータベースを設定する場合は、 管理コンソール内でデータベースを設定する を参照してください。 JDBCを使用して接続する場合は、portal-ext.properties内にデータベースプロパティを設定します。
必要な .jar
と .war
のファイルを入手する。
以下の.jarファイルが必要です。
hsql.jar
portal-service.jar
portlet.jar
また、以下の.jarファイルが必要です。
jtds.jar
mysql.jar
persistance.jar
postgresql.jar
servlet-api.jar
-
activation.jar
(メール連携時のみ) -
mail.jar
(メール統合時のみ)
Websphere上でのLiferayのセットアップ
1. この場所に、以下の.jarファイルを配置します:C:¥Program Files¥IBM¥Websphere¥AppServer¥lib¥ext
hsql.jar
jtds.jar
mysql.jar
persistance.jar
portal-service.jar
postgresql.jar
2. この場所に、以下の.jarファイルを配置します:C:◆Program FilesIBM Websphere AppServer
servlet-api.jar
portlet.jar
3. (オプションで、特にメール統合を必要とする場合のみ使用します):C:¥Program FilesIBM¥Websphere¥AppServer¥java¥jre¥lib¥ext
activation.jar
mail.jar
4. Websphere 7 Server を起動する スタート> プログラム> IBM WebSphere> Application Server V7.0> プロファイル> AppSrv01 をクリックし、 サーバーを起動するをクリックします。
5.管理コンソールを起動する スタート> プログラム> IBM WebSphere> Application Server V7.0> プロファイル> AppSrv01 と進み、 管理コンソールをクリックします。
6. アプリケーション> アプリケーションの種類> WebSphere Enterprise Applicationに移動します。 すでにいくつかのアプリケーションが稼働しています。 すべてのアプリケーションにチェックを入れ、[停止]をクリックします。 デフォルトのアプリケーションをアンインストールすると、Liferayのデフォルトのコンテキストルート設定と衝突するためです。
管理コンソール内のMySQLデータベースがJNDI設定を使用するように設定すること
デフォルトでは、portal.propertiesのLiferayのMySQL接続は、JDBC接続になっています。 しかし、ユーザーは純粋なJDBCではなく、JNDI接続でデータベースに接続することも可能です。 JNDIを使用して、ユーザーはPoolDataSourceまたはXADataSourceとして設定するオプションがあります。
JNDI PoolDataSourceの接続ステップ。
- 左のドロップダウンメニューから「リソース」をクリックします。
- "JDBCプロバイダー "をクリック
- スコープのドロップダウンから、ノードとサーバーの両方がある3番目のオプションを選択します。
- 新規作成...]ボタンをクリックします。
- 以下を選択します:
- データベースの種類ユーザー定義
- 実装クラス名: com.mysql.jdbc.jdbc2.optional.MysqlConnectionPoolDataSource
- 名前MySQLプロバイダ
- 説明します:MySQLのJNDI接続
- 次へ」をクリックします。
- クラスパスの値を削除します。 これは、独自のmysql.jarを使用するためです。 サーバーを起動する前に、mysql.jar ファイルが WebSphere ディレクトリの適切な場所に既にあることを確認してください。
- 次へ」をクリックします。
- 完了」ボタンをクリックします。
- [Save]をクリックします。
- MySQL Provider」が新しいJDBCプロバイダとして表示されるようになったことを確認します。
- 新しく作成した「MySQL Provider」をクリックします。
- 追加プロパティ」の「データソース」をクリックします。
- 新規作成」ボタンをクリックします。
- データソース名欄に「liferaydatabasesource」と入力します。
- JNDI名の欄に「java_liferay:jdbc/LiferayPool」と入力します。
- 次の画面は「Next」をクリックし、「Summary」ページまではデフォルト値のままにしておきます。
- Finish]をクリックします。
- [Save]をクリックします。
- liferaydatabasesource」が新しいデータソースとして表示されるようになったことを確認します。
- liferaydatabasesource」リンクをクリックします。
- "追加プロパティ "の下にある "カスタムプロパティ "をクリックします。
- フィルター機能を表示する]をクリックします。 以下の項目を検索し、該当する値を入力してください:
フィルター:名前 検索ワード"- user - Value: root (匿名ユーザーの場合は空白)
- serverName - 値: データベースIPアドレスまたは(localhost)
- databaseName - Value: データベース名
- OK]をクリックします。
- [Save]をクリックします。
portal-ext.propertiesに、以下を追加します:
plugin.notifications.enabled=false jdbc.default.jndi.name=java_liferay:jdbc/LiferayPool liferay.home= auto.deploy.dest.dir=
これは、デフォルトのJDBC接続に代わるものです。 どちらか一方でなければならない。
JNDIとXA Datasourceについては、いくつかの重要な違いがあります。 特に、ソースファイルから入手できるmysql.jarの代わりに、mysql-connector-java-5.1.25-bin.jarを使用してください。 次に、Implementation class nameの欄にXA接続を指定します。
- 左のドロップダウンメニューから「リソース」をクリックします。
- "JDBCプロバイダー "をクリック
- スコープのドロップダウンから、ノードとサーバーの両方がある3番目のオプションを選択します。
- 新規作成...]ボタンをクリックします。
- 以下を選択します:
- データベースの種類ユーザー定義
- 実装クラス名: com.mysql.jdbc.jdbc2.optional.MysqlXADataSource.
- 名前MySQLプロバイダ
- 説明します:MySQLのJNDI接続
- 次へ」をクリックします。
- クラスパスの値を削除します。 これは、独自のmysql-connector-java-5.1.25-bin.jarを使用するためです。 サーバーを起動する前に、mysql-connector-java-5.1.25-bin.jar ファイルが WebSphere ディレクトリの適切な場所に既にあることを確認してください。
- 次へ」をクリックします。
- 完了」ボタンをクリックします。
この時点以降も、JNDIセクションと同じ手順で進めます。
WebSphereの最適化(WebSphereでLiferayを正しく機能させるために必須です。)
Liferayを起動する前に、ユーザーはJavaとDynamic Cache Serviceのいくつかの設定を変更することでWebsphereを「最適化」する必要があります。 これらの設定を変更することで、Liferayが遅くなったり、クラッシュしたり、DockバーやCKEditorのような必須機能を失うことなく、適切に機能するようになります。
アプリケーションサーバ> Server1> Javaとプロセス管理> プロセス定義> Java仮想マシンへ移動します。
- 初期ヒープサイズ=256MBに設定
- 最大ヒープサイズ=1024MBに設定
- バーボーズ・ガベージコレクションがtrueに設定されている
- Generic JVM引数: -Xk22000 -Xp64k,16k -Dfile.encoding=UTF-8 を設定します。
アプリケーションサーバー> server1> コンテナサービス>Dynamic Cache Service へ移動します。
- キャッシュサイズ=3000に設定
- デフォルトの優先順位 = 3 に設定
アプリケーションサーバー > server1 > Webコンテナ > カスタムプロパティに移動します。
- 名前 = com.ibm.ws.webcontainer.AllowQueryParamWithNoEqual
- 値=true
サーバーを再起動する。
メール統合のためのEquifax証明書の設定(オプションですが、Gmailを使用してメール統合機能をテストする場合は必須です。)
デフォルトでは、WebSphere はドメイン smtp.gmail.com で使用されている Equifax Secure Certificate Authority を信頼しません。 このため、Gmailを使ったメール連携を正しく行うためには、この証明書を信頼できる証明書に追加する必要があります。
1. 証明書は下記よりダウンロードしてください:
https://www.geotrust.com/resources/root_certificates/certificates/Equifax_Secure_Certificate_Authority.cer
2. 管理コンソールで、「SSL証明書と鍵の管理」→「エンドポイントセキュリティ設定の管理」→ノードを選択(どちらでもよい)→「キーストアと証明書」→「NodeDefaultTrustStore」→「署名者証明書」と進みます。
3. 追加」をクリックし、エイリアスに「equifax」と入力し、.cerファイルへのパスを入力します。 応募してお得 Equifaxの証明書が追加されます。
4. 上記のように、Activation.jarとmail.jarがC:³³Program Files³Websphere³AppServer³java³jre³lib³ext ディレクトリに追加されたことを確認します。
Liferayのインストールと起動
必要な手順がすべて完了すると、アプリケーションサーバーはLiferayを展開する準備が整いました。 liferay.warファイルを新しいアプリケーションとしてインストールし、プロンプトに従います。 マスター構成に保存し、Liferayを起動します。 ポータルは9080番ポートで起動します。