Red Hat Training
A Red Hat training course is available for Red Hat JBoss Web Server
インストールガイド
for Use with Red Hat JBoss Web Server
エディッション 1.0.2
Laura Bailey
lbailey@redhat.com
Eva Kopalová
ekopalov@redhat.com
概要
第1章 はじめに
1.1. コンポーネント
- Apache Tomcatは、Java Servlet Specification に沿ったサーブレットコンテナで、JBoss Enterprise Web ServerにはApache Tomcat 6 と Apache Tomcat 5が含まれています。
- Apache Nativeは Tomcat のライブラリで、Tomcatの拡張性、性能、ネーティブサーバー技術との統合性を向上します。また、これにはAPR (Apache Portable Runtime)の実装も含まれています。APRは、Apache HTTP Serverおよび Apache Tomcat の通信を行うためのバイナリプロトコルです。
- Apache Tomcat Connectors (mod_jk, mod_cluster) はApache HTTP Server と Apache Tomcatの間のコネクタです。mod_clusterは JBoss ネーティブのロードバランサで、mod_jkより効率性、信頼性、拡張性が高くなっています。
- Apache HTTP Serverは、Apache Software Foundationにより開発されたオープンソースの Web サーバーです。この実装は、現在のHTTP規格に準拠しています。
注記
同梱のApache HTTP Serverは、デフォルトで Secure Socket Layer (SSL) に対応していますが、削除するにはお使いのインストール設定におけるSSL削除の項を参照してください。 - Hibernate は、オブジェクト関係マッピングのフレームワークで、同梱の Hibernate には Hibernate Core、Hibernate Annotations、Hibernate EntityManager with JPA 1.0 APIsが含まれています。
重要
重要
1.2. 対応のオペレーティングシステム
- Red Hat Enterprise Linux 6 最新アップデート(x86, x86_64)
- Red Hat Enterprise Linux 5 最新アップデート (x86, x86_64)
- Red Hat Enterprise Linux 4 最新アップデート (x86, x86_64)
- Solaris 10 (x86, x86_64, SPARC64)
- Solaris 9 (x86, SPARC32, SPARC64)
- Windows Server 2008 R2 (x86, x86_64)
- Windows Server 2003 SP2 (x86, x86_64)
1.3. 対応のコネクタ設定
- Apache HTTP Server + mod_cluster + JBoss EAP 5.x
- Apache HTTP Server + mod_cluster + Tomcat 6
- Apache HTTP Server + mod_jk + JBoss EAP 5.x
- Apache HTTP Server + mod_jk + Tomcat 5
- Apache HTTP Server + mod_jk + Tomcat 6
重要
1.4. インストールとアップグレード
1.5. ソースファイル
パート I. インストール
- Red Hat Enterprise Linuxについては、3章Red Hat Enterprise Linuxで Enterprize Web Server をインストールを参照。
- Windows は4章Windows上でEnterprise Web Serverをインストールを参照。
- Solaris は5章SolarisでEnterprise Web Serverのインストールを参照。
第2章 前提条件
- JBoss Enterprise Web Server のインストールに十分なディスクの空き容量
- ご利用中のアプリケーション用に十分な空き容量
第3章 Red Hat Enterprise Linuxで Enterprize Web Server をインストール
- Red Hat Customer Portal にあるZIPファイルから (「ZIPファイルからEnterprise Web Serverをインストール」参照)
注記
ZIPからのインストールですが、JBoss Enterprise Web Serverはどこにでも展開、インストール可能です。 - from RPM packages from Red Hat Network (RHN, refer to 「RPMパッケージからEnterprise Web Serverをインストール」)
注記
RPMパッケージからのインストールは Web サーバーとservice
コマンドを統合し、そのリソースを絶対パスにインストールします。
警告
3.1. 前提条件
- 対応のJava がインストールされていること(手順3.1「Java のインストール」 参照)。
- 必要なパッケージがインストールされていること (手順3.2「必要なパッケージのインストール」参照)。
- classpathx-jaf パッケージが削除されていること (手順3.3「classpathx-jaf の削除」参照)。
手順3.1 Java のインストール
- ご利用中のシステムを該当のチャネルへサブスクライブします。
- Red Hat Enterprise Linux6向けの補助RHELサーバー
- Red Hat Enterprise Linux5向けの補助RHELサーバー
- Red Hat Enterprise Linux 4 向けの追加機能
- コマンドラインからroot ユーザーで Java 1.6 をインストールするためのコマンドを実行します。
- Red Hat Enterprise Linux5およびRed Hat Enterprise Linux6では、
yum install
コマンドを使います。# yum install java-1.6.0-<VENDOR>-devel
<VENDOR> をsun
、ibm
あるいはopenjdk
で置き換えてください。 - Red Hat Enterprise Linux4では、
up2date
コマンドを実行します。# up2date java-1.6.0-<VENDOR>-devel
<VENDOR> をsun
あるいはibm
で置き換えてください。
- 以下のコマンドを root ユーザーで実行し (別のユーザーから切り替える場合、
su -
コマンドを実行するようにしてください) 、正しいJDKが利用されていることを確認します。# alternatives --config java
# alternatives --config javac
これらのコマンドは、利用可能なJDKのバージョン一覧を返します。使用中のバージョンにはプラスのマーク(+
) が付けられます。設定したJDKが希望のオプションでない場合、コマンドラインにある指示の通り、正しいJDKに切り替えます。重要
java
とjavac
コマンドを使うソフトウェアは、alternatives で設定したJDKを利用します。Java alternatives を切り替えるとこれらのソフトウェアの稼働に悪影響を与える可能性があります。 - 必要なパッケージをインストールします (手順3.2「必要なパッケージのインストール」参照)。
手順3.2 必要なパッケージのインストール
- オペレーティングシステムのバージョンにあわせ、root ユーザーで各インストール用コマンドを実行します。
- Red Hat Enterprise Linux 5および 6 の場合
# yum install distcache pcre
- Red Hat Enterprise Linux 4の場合
# up2date distcache pcre
- プロンプトが出るとyを押し次に進みます。
- インストールが完了すると、以下のコマンドを実行しパッケージがインストールされていることを確認します。
# rpm -q distache pcre
パッケージがインストールされている場合、コマンドの出力でパッケージ名およびバージョン番号を表示します。 - ZIPファイル (「ZIPファイルからEnterprise Web Serverをインストール」)あるいはRPM(「RPMパッケージからEnterprise Web Serverをインストール」)からJBoss Enterprise Web Server をインストールします。
手順3.3 classpathx-jaf の削除
- シェルプロンプトでroot ユーザーになります。
- Red Hat Enterprise Linuxのバージョンにより、該当のコマンドを実行し当パッケージをアンインストールします。
- Red Hat Enterprise Linux 5および 6 の場合
# yum remove classpathx-jaf
- Red Hat Enterprise Linux 4の場合
# rpm -e classpathx-jaf
3.2. ZIPファイルからEnterprise Web Serverをインストール
3.2.1. ZIPファイルのダウンロードおよび展開
手順3.4 Enterprise Web Service のZIPファイルをダウンロード
- Web ブラウザでhttp://access.redhat.com を開きます。
- 右上端にある Log in ボタンをクリックします。
- ログイン情報を入力し、Log inをクリックします。
- ページ上部にあるメニューバーの Downloadsオプションにマウスをかざし、表示メニューのJBoss Enterprise Middleware にあるDownloadsをクリックします。
- Product ドロップダウン欄のWeb Serverをクリックします。
- Software Downloadsページで、Version のドロップダウンボックスにて製品のバージョンを選択し、下のReleases タブで正しいバージョンの
JBoss EWS
へのリンクをクリックします。 - Software Details ページにて、File のドロップダウンボックスの隣にあるDownload ボタンをクリックします。
注記
ご利用中のシステムおよびアーキテクチャ向けのファイルであることを確認します。 - ダウンロードファイルを確認します。
- ZIPファイルを正常にダウンロードした後、手順3.5「ZIPファイルの展開」に従いJBoss Enterprise Web ServerのZIPファイルを展開します。
手順3.5 ZIPファイルの展開
- コマンドラインでZIPファイルの含まれているディレクトリに移動します。
- 以下の
unzip
コマンドを実行します。
FILE_NAME をダウンロードしたファイル名で、TARGET_DIRECTORY を展開先のディレクトリへのパスで置き換えます。unzip <FILE_NAME> -d <TARGET_DIRECTORY>
ZIPの展開後、環境を正しく設定してからJBoss Enterprise Web Serverを起動させます(「環境設定」参照)。注記
展開ディレクトリつまり、JBoss Enterprise Web Serverのインストール先のディレクトリは$EWS_HOME
とします。<EWS_HOME> のフォーマットを使い、利用しているディレクトリへの全体パスを示します。例えば、<EWS_HOME>/httpd could refer to the/opt/jboss-ews-1.0/httpd
のパスなどです。
3.2.2. 環境設定
- ApacheおよびTomcatユーザーを作成しセキュアでシンプルなユーザー管理ができる(手順3.8「Apache ユーザーの設定」 and 手順3.7「Tomcatユーザの作成」参照)
- SSLサポートの削除 (手順3.9「SSLの削除」参照)
- log4jロギングの追加 (手順3.10「log4jの設定」の参照)
- mod_jk あるいは mod_clusterを有効化 (手順3.11「mod_jkの設定」 および 手順3.12「mod_clusterの設定」を参照)
手順3.6 JAVA_HOMEの設定
JAVA_HOME
変数を設定します。
- Tomcatの
bin
ディレクトリで($EWS_HOME/tomcat5/bin
あるいは$EWS_HOME/tomcat6/bin
)、setenv.sh
ファイルを作成します(例:vim tomcat<VERSION>/bin/setenv.sh
コマンドを実行)。 - JAVA_HOME パスの定義をファイルに追加します。例:
export JAVA_HOME=/usr/lib/jvm/jre-1.6.0-openjdk.x86_64
手順3.7 Tomcatユーザの作成
- シェルプロンプトでroot ユーザーになります。
- 以下のコマンドを実行し、Tomcatユーザーグループを作成します。
# groupadd -g 91 -r tomcat
- $EWS_HOMEに移動します。
- $EWS_HOMEから以下のコマンドを実行し、TomcatユーザーグループにTomcatユーザーを作成します。
# useradd -c "Tomcat" -u 91 -g tomcat -s /bin/sh -r -d /home/tomcat tomcat
- $EWS_HOMEから以下のコマンドを実行し、
tomcat
ユーザーにTomcatディレクトリの所有権を割り当て、ユーザーがTomcatサービスを実行できるようにします。#
chown -R tomcat:tomcat tomcat<VERSION>
該当のTomcatバージョン番号(5
あるいは6
)で <VERSION> を置き換えてください。 - $EWS_HOME から
ls -l
コマンドを実行し、TomcatユーザーがTomcatディレクトリの所有者かどうかを確認します。 - 必ず、
tomcat
ユーザーが親ディレクトリすべてに対して実行権限を持つようにしてください。
手順3.8 Apache ユーザーの設定
- root ユーザーで以下のコマンドを実行し、Apacheユーザーグループを作成します。
# groupadd -g 48 -r apache
- 以下のコマンドを実行し、Apache ユーザーグループを作成します。
# useradd -c "Apache" -u 48 -g apache -s /bin/sh -r -d /home/apache apache
$EWS_HOME
へ移動してから、以下のコマンドを実行しapache
ユーザーにApache ディレクトリの所有権を割り当て、ユーザーがhttpd
サービスを実行できるようにします。# chown -R apache:apache httpd
- $EWS_HOME から
ls -l
を入力し、apache
ユーザーが該当の Apache インストールパスへの実行権限を持つか確認してください。出力は以下のようになります。drwxrwxr-- 11 apache apache 4096 Feb 14 06:52 httpd
手順3.9 SSLの削除
$EWS_HOME/httpd/conf.d/
ディレクトリに移動します。- SSL設定ファイルの名前変更
- SSLを削除するには、
ssl.conf
の名前をssl.conf.disabled
に変更します。 - SSLを再追加するには、
ssl.conf.disabled
の名前をssl.conf
に変更します。
手順3.10 log4jの設定
log4j
ロギングを追加するには、この手順に従います。
$EWS_HOME/extras/
ディレクトリに移動します。log4j.jar
およびlog4j.properties
ファイルをTomcatディレクトリのlib
にコピーします。- Tomcat6を使っている場合は、以下のコマンドを実行します。
extras]# cp log4j.jar log4j.properties ../tomcat6/lib
extras]# cp tomcat-juli-adapters.jar $EWS_HOME/tomcat6/lib
- Tomcat5を使っている場合は、以下のコマンドを実行します。
extras]# cp log4j.properties ../tomcat5/common/classes
extras]# cp log4j.jar ../tomcat5/common/lib
手順3.11 mod_jkの設定
workers.properties
ファイルで利用可能なワーカー (JBoss インスタンス)- mod_jk 設定ファイル
$EWS_HOME/httpd/conf/
ディレクトリで、workers.propertiesを作成します。$EWS_HOME/httpd/conf.d/
ディレクトリでmod_jk.confを作成します。注記
jboss-ews-docs-1.0.2.zip ファイルにあるテンプレートファイルを使うこともできます(このファイルは Red Hat Customer Portal から入手可能)。ファイルをダウンロード、展開後、mod_jk.conf.sample
とworkers.properties.sample
のサンプルファイルを$EWS_HOME/doc/mod_jk/からステップ 1 と ステップ 2で定義されている場所にコピーします。これらのファイルの名前を変更し(sample
の拡張子を削除) 、必要であれば内容を変更します(「その他のリソース」参照)。
手順3.12 mod_clusterの設定
<EWS_HOME>/httpd/conf/httpd.conf
ファイルにて、以下の行頭にハッシュ記号(#
) を追加し、mod_proxy_balancer.soを無効にします。LoadModule proxy_balancer_module /modules/mod_proxy_balancer.so
このモジュールは、JBoss HTTP Connectorとの互換性がありません。- サーバーを設定し、JBoss HTTP Connector モジュールをロードします。
$EWS_HOME/httpd/conf.d/
ディレクトリでJBoss_HTTP.conf
を作成します。- 以下の行を
JBoss_HTTP.conf
ファイルに追加します。LoadModule slotmem_module <EWS_HOME>/httpd/modules/mod_slotmem.so LoadModule manager_module <EWS_HOME>/httpd/modules/mod_manager.so LoadModule proxy_cluster_module <EWS_HOME>/httpd/modules/mod_proxy_cluster.so LoadModule advertise_module <EWS_HOME>/httpd/modules/mod_advertise.so
手順3.13 Post-intallation スクリプトの実行
- シェルプロンプトでroot ユーザーになります。
$EWS_HOME/httpd
ディレクトリに移動します。- 以下のコマンドを実行します。
# ./.postinstall
3.2.3. Enterprise Web Serverの実行
- Tomcat (5 あるいは 6、「Tomcatの起動」参照)
- HTTP サーバー (「HTTPの実行」)
3.2.3.1. Tomcatの起動
重要
- Tomcatユーザが作成されていること (手順3.7「Tomcatユーザの作成」参照)
- JAVA_HOME が正しく設定されていること (手順3.6「JAVA_HOMEの設定」参照)
3.2.3.1.1. プログラムとしてTomcatを稼働
startup.sh
スクリプト各Tomcatバージョン (5
あるいは6
)で以下のコマンドを root ユーザーで実行します。# sh <EWS_HOME>/tomcat<VERSION>/bin/startup.sh
システムは設定ファイルを読み込み、Tomcatユーザーアカウントのユーザーおよびグループに変わります (つまり、Tomcatは常にTomcatユーザーの下で作動)。デフォルトでは、Tomcat起動時にtomcat-native
が自動的にLD_LIBRARY_PATH
および-Djavalibrary.path
へ追加されます。catalina.sh
スクリプト各Tomcatバージョン (5
あるいは6
)で以下のコマンドを実行します。# sh <EWS_HOME>/tomcat<VERSION>/bin/catalina.sh
catalina.sh
を呼び出すカスタムのスクリプト
3.2.3.1.2. サービスとしてTomcatを作動
3.2.3.2. HTTPの実行
<EWS_HOME>/httpd/sbin/
に移動し以下のコマンドをroot ユーザーで実行してください。
# ./apachectl start
3.2.4. Enterprise Web Serverの停止
3.2.4.1. Tomcatの停止
# sh <EWS_HOME>/tomcat<VERSION>/bin/shutdown.sh
3.2.4.2. HTTPサーバーの停止
<EWS_HOME>/httpd/sbin/
に移動し以下のコマンドをroot ユーザーで実行してください。
# apachectl stop
3.2.5. ZIPの各種設定構造
`-- jboss-ews-1.0 |-- extras (includes log4j) |-- httpd (includes modules, configuration files, executable for the HTTP Server) |-- tomcat5 `-- tomcat6
3.2.6. その他のリソース
jboss-ews-docs-1.0.2.zip
と jboss-ews-src-1.0.2.zip
ファイルをダウンロードし、$EWS_HOMEに展開してください。展開時doc
と src
ディレクトリが作成され、文書や例、ソースコードがここに入ります。
3.3. RPMパッケージからEnterprise Web Serverをインストール
3.3.1. RPMパッケージ
Red Hat Enterprise Linux5と6向けのRPMパッケージ
- Tomcat 6:
- tomcat6tomcat6-webappstomcat6-admin-webapps
- Tomcat 5:
- tomcat5tomcat5-webappstomcat5-admin-webapps
- Tomcat Native:
- tomcat-native
- HTTP サーバー:
- httpd
- mod_jk:
- mod_jk-ap20
- mod_cluster:
- mod_cluster-tomcat6mod_cluster-native
- log4j:
- tomcat6-log4j
- mod_ssl:
- mod_ssl
- Hibernate:
- hibernate3
- JK Status Ant tasks:
- tomcat-jkstatus-ant
重要
次のリリースでtomcat-jkstatus-ant ライブラリは廃止予定となっています。
Red Hat Enterprise Linux4向けのRPMパッケージ
- Tomcat 6:
- tomcat6tomcat6-webappstomcat6-admin-webapps
- Tomcat 5:
- tomcat5tomcat5-webappstomcat5-admin-webapps
- Tomcat Native:
- tomcat-native
- HTTP サーバー:
- httpd22
- mod_jk:
- mod_jk-ap20
- mod_cluster:
- mod_cluster-tomcat6mod_cluster-native
- log4j:
- tomcat6-log4j
- mod_ssl:
- mod_ssl22
- Hibernate:
- hibernate3
- JK Status Ant tasks:
- tomcat-jkstatus-ant
重要
次のリリースでtomcat-jkstatus-ant ライブラリは廃止予定となっています。 - Xerces2 Java Parser:
- xerces-j2
注記
Xerces2 Java Parser は Tomcat5と依存関係があり、Tomcat6を利用している場合、当パッケージが自動的に依存関係としてインストールされます。ただし、tomcat5 パッケージのみをインストールしている場合、xerces-j2 を先にインストールするようにします。
3.3.2. JBoss Enterprise Web Server のインストールパッケージに対するRHNチャネル
- Red Hat Enterprise Linux 6の場合
- jb-ews-1-i386-server-6-rpm
- jb-ews-1-x86_64-server-6-rpm
- Red Hat Enterprise Linux 5の場合
- jb-ews-1-i386-server-5-rpm
- jb-ews-1-x86_64-server-5-rpm
- Red Hat Enterprise Linux 4の場合
- jb-ews-1-i386-as-4-rpm
- jb-ews-1-x86_64-as-4-rpm
- jb-ews-1-i386-es-4-rpm
- jb-ews-1-x86_64-es-4-rpm
3.3.3. RPMをファイルからEnterprise Web Serverをインストール
手順3.14 Red Hat Network Enterprise チャネルへサブスクライブ
- Red Hat Network Enterpriseに移動します。
Red Hat Application Stack
チャネルからご利用中のシステムのサブスクリプションを解除します。- JBoss Enterprise Web Serverチャネルへサブスクライブします (「JBoss Enterprise Web Server のインストールパッケージに対するRHNチャネル」参照)。
exactarch
が正しい値に設定されているようにしてください。- Red Hat Enterprise Linux4では、この手順を飛ばし手順3.15「RPMパッケージからEnterprise Web Serverをインストール」に進んでください。
- Red Hat Enterprise Linux6および5では、
/etc/yum.conf
を編集できるよう開き、exactarch
の値を0
に設定します。exactarch=0
この指示文がない場合は、ファイルに追加してください。
手順3.15 RPMパッケージからEnterprise Web Serverをインストール
- シェルプロンプトでroot ユーザーになります。
- ご利用中のオペレーティングシステムにあわせ、root ユーザーでインストール用コマンドを実行します。
- Red Hat Enterprise Linux5および6の場合
# yum install <LIST_OF_PACKAGES>
<LIST_OF_PACKAGES> をパッケージ名で置き換えてください。各パッケージはスペースで区切るものとします。全JBoss Enterprise Web Server パッケージをインストールするにはこのコマンドを実行します。# yum install tomcat6 tomcat6-webapps tomcat6-admin-webapps tomcat5.noarch tomcat5-webapps.noarch tomcat5-admin-webapps.noarch tomcat-native httpd mod_jk-ap20 mod_cluster-tomcat6 mod_cluster-native tomcat6-log4j mod_ssl hibernate3 tomcat-jkstatus-ant
注記
package.noarchがTomcat5パッケージ向けに指定されていない限り、JBoss Enterprise Web Serverチャネルの代わりに基本チャネルからTomcat5パッケージのすべてをyum で 取得してきます。 - Red Hat Enterprise Linux 4の場合
# up2date <LIST_OF_PACKAGES>
<LIST_OF_PACKAGES> をパッケージ名で置き換えてください。各パッケージはスペースで区切るものとします。全JBoss Enterprise Web Server パッケージをインストールするにはこのコマンドを実行します。# up2date tomcat6 tomcat6-webapps tomcat6-admin-webapps xerces-j2 tomcat5 tomcat5-webapps tomcat5-admin-webapps tomcat-native httpd22 mod_jk-ap20 mod_cluster-tomcat6 mod_cluster-native tomcat6-log4j mod_ssl22 hibernate3 tomcat-jkstatus-ant
exactarch
が正しい値に設定されているようにしてください。- Red Hat Enterprise Linux4ではこの手順を飛ばします。
- Red Hat Enterprise Linux6および5では、
/etc/yum.conf
を編集できるよう開き、exactarch
の値を1
に設定します。exactarch=1
- Verify the system is using the correct javac and java (for details refer to 手順3.1「Java のインストール」).
3.3.4. 環境設定
- SSLの削除 (手順3.16「SSLの削除」参照)
- log4jロギングの追加 (手順3.18「Tomcat6からlog4j を削除」の参照)
- mod_jk あるいは mod_clusterを有効化 (手順3.20「mod_jkの設定」 および 手順3.21「mod_clusterの設定」を参照)
手順3.16 SSLの削除
- シェルプロンプトでroot ユーザーになります。
- 各アンインストールコマンドを実行します。
- Red Hat Enterprise Linux5および6の場合
# yum remove mod_ssl
- Red Hat Enterprise Linux 4の場合
# rpm -e mod_ssl22
Tomcat6はtomcat6-log4j パッケージがlog4jサポートを提供し、パッケージのインストール時に有効になります(手順3.15「RPMパッケージからEnterprise Web Serverをインストール」参照)。log4jをTomcat5上で有効にするには、該当のlog4jリソースをtomcat6
からtomcat5
ディレクトリにコピーしてください (tomcat5
参照)。
手順3.17 Tomcat5でlog4jを追加
tomcat6-log4j
RPM パッケージをインストールします。/usr/share/java/tomcat6/
から以下をコピーします。log4j.jar
を/usr/share/tomcat5/common/lib
へlog4j.properties
を/usr/share/tomcat5/common/classes
へ
手順3.18 Tomcat6からlog4j を削除
- シェルプロンプトでroot ユーザーになります。
- 各アンインストールコマンドを実行します。
- Red Hat Enterprise Linux5および6の場合
# yum remove tomcat6-log4j
- Red Hat Enterprise Linux 4の場合
# rpm -e tomcat6-log4j
手順3.19 Tomcat5からlog4j を削除
log4j.jar
ファイルを/usr/share/tomcat5/common/lib
ディレクトリから削除します。log4j.properties
ファイルを/usr/share/tomcat5/common/classes
ディレクトリから削除します。
手順3.20 mod_jkの設定
mod_jk
の設定テンプレートファイルをインストールします。# cp /usr/share/doc/mod_jk-ap20-*/mod_jk.conf.sample /etc/httpd/conf.d/mod_jk.conf
workers.properties
のテンプレートファイルをインストールします。# cp /usr/share/doc/mod_jk-ap20-*/workers.properties.sample /etc/httpd/conf/workers.properties
- ワーカーマッピングを
workers.properties
に追加します。例えば、# Mount the Servlet context to the ajp20 worker /jmx-console=loadbalancer /jmx-console/*=loadbalancer /web-console=loadbalancer /web-console/*=loadbalancer
注記
デフォルト設定は、トラフィックの少ない Web サイトには適しています。中から高程度のロードを持つ Web サイトに対する最適化情報は、 http://kbase.redhat.com/faq/docs/DOC-15836を参照してください。
手順3.21 mod_clusterの設定
/etc/httpd/conf/httpd.conf
ファイルにて、以下の行頭にハッシュ記号(#
) を追加し、mod_proxy_balancer.soを無効にします。LoadModule proxy_balancer_module /modules/mod_proxy_balancer.so
このモジュールは、JBoss HTTP Connectorとの互換性がありません。- サーバーを設定し、JBoss HTTP Connector モジュールをロードします。
/etc/httpd/conf.d/JBoss_HTTP.conf
ファイルを作成します。- 以下の行を
JBoss_HTTP.conf
ファイルに追加します。- 32ビットアーキテクチャの場合
LoadModule slotmem_module /usr/lib/httpd/modules/httpd/modules/mod_slotmem.so LoadModule manager_module /usr/lib/httpd/modules/mod_manager.so LoadModule proxy_cluster_module /usr/lib/httpd/modules/mod_proxy_cluster.so LoadModule advertise_module /usr/lib/httpd/modules/mod_advertise.so
- 64ビットアーキテクチャの場合
LoadModule slotmem_module /usr/lib64/httpd/modules/httpd/modules/mod_slotmem.so LoadModule manager_module /usr/lib64/httpd/modules/mod_manager.so LoadModule proxy_cluster_module /usr/lib64/httpd/modules/mod_proxy_cluster.so LoadModule advertise_module /usr/lib64/httpd/modules/mod_advertise.so
3.3.5. サービスのブート動作を設定
- コマンドラインから以下のコマンドを実行します。その際、<SERVICE_NAME> は該当のサービス名で置き換えてください (
tomcat6
あるいはtomcat5
、およびhttpd
あるいはhttpd22
)。chkconfig <SERVICE_NAME> on
詳細についてはchkconfig man ページを参照してください。 - Service Configuration ツールを使うには、
system-config-services
コマンドを実行し、表示ウィンドウ内のサービス設定を変更します。
3.3.6. Enterprise Web Serverの実行
- Tomcat (5 あるいは 6、手順3.22「Tomcatの起動」参照)
- HTTP サーバー(手順3.23「HTTPの実行」)
手順3.22 Tomcatの起動
重要
tomcat
を開始します。
- シェルプロンプトでroot ユーザーになります。
- 以下の
start
コマンドを実行します。<VERSION> は、正しいTomcatのバージョンで置き換えてください(5
あるいは6
)。# service tomcat<VERSION> start
- Web ブラウザでhttp://localhost:8080 へ行き、Tomcatが作動しているか確認します。Apache Software Foundationが表示されます。
注記
RPMパッケージからJBoss Enterprise Web Server がインストールされている場合、サポートしているTomcatの起動方法は、本項で説明しているもののみとなっています。
手順3.23 HTTPの実行
httpd
を開始します。
- シェルプロンプトでroot ユーザーになります。
- 以下の
start
コマンドを実行します。- Red Hat Enterprise Linux5および6の場合
# service httpd start
- Red Hat Enterprise Linux 4の場合
# service httpd22 start
3.3.7. Enterprise Web Serverの停止
手順3.24 Tomcatの停止
tomcat
を停止します。
- シェルプロンプトでroot ユーザーになります。
- 以下の
start
コマンドを実行します。<VERSION> は、正しいTomcatのバージョンで置き換えてください(5
あるいは6
)。# service tomcat<VERSION> stop
- Web ブラウザからhttp://localhost:8080 に行き、Tomcatが稼働していないことを確認します。
手順3.25 HTTPサーバーの停止
httpd
を停止します。
- シェルプロンプトでroot ユーザーになります。
- 以下の
stop
を実行します。- Red Hat Enterprise Linux5および6の場合
# service httpd stop
- Red Hat Enterprise Linux 4の場合
# service httpd22 stop
3.3.8. 追加文書
up2date
コマンドの後に必要な文書パッケージリストを入力、実行します。また、Red Hat Enterprise Linux5および6ではyum install
の後に必要文書のパッケージリストを入れ実行してください。
- Red Hat Enterprise Linux5および6では、以下の文書パッケージをご利用いただけます。
- Tomcat5の場合
- tomcat5-webapps
- Tomcat6の場合
- mod_jk-manualhttpd-manualtomcat6-docs-webapp
- Red Hat Enterprise Linux4 では、以下の文書パッケージをご利用いただけます。
- Tomcat5の場合
- tomcat5-webapps
- Tomcat6の場合
- mod_jk-manualhttpd22-manualtomcat6-docs-webapp
第4章 Windows上でEnterprise Web Serverをインストール
4.1. 前提条件
手順4.1 Java のインストール
- Oracle のホームページへ移動します。
- このWeb サイトからご利用中のオペレーティングシステム向けのJDK 1.6 をダウンロードします。
- ダウンロードした場所に移動します。
- ダウンロードしたファイルをダブルクリックし、Java のインストールを開始します。
- インストールの表示ウィンドウの指示に従い進めてください。
4.2. インストレーションファイルをダウンロードおよび展開
手順4.2 Enterprise Web Service のZIPファイルをダウンロード
- Web ブラウザでhttp://access.redhat.com を開きます。
- 右上端にある Log in ボタンをクリックします。
- ログイン情報を入力し、Log inをクリックします。
- ページ上部にあるメニューバーの Downloadsオプションにマウスをかざし、表示メニューのJBoss Enterprise Middleware にあるDownloadsをクリックします。
- Product ドロップダウンメニューのWeb Serverをクリックします。
- Releases タブにて、Windows 用の
JBoss EWS
で正しいアーキテクチャおよびバージョンをクリックします。 - Software Details ページにて、File のドロップダウンボックスの隣にあるDownload ボタンをクリックします。
注記
ご利用中のシステムおよびアーキテクチャ向けのファイルであることを確認します。 - ダウンロードファイルを確認します。
手順4.3 ZIPファイルの展開
- ファイルを右クリックし
すべて展開 (Extract All...)
を選択します。 - 次へ (Next)をクリックします。
- When prompted for the extract location, click Browse and navigate to
C:\Program Files
. - 完了 (Finish)をクリックします。
注記
Files are extracted inC:\Program Files\Red Hat\Enterprise Web Server
. If you wish to change the httpd configuration (for example, add mod_cluster), edit thehttpd.conf
file in theC:\Program Files\Red Hat\Enterprise Web Server\etc\httpd\conf
folder.
4.3. 環境設定
手順4.4 環境変数の設定
- 管理者権限を持つアカウントでログインします。
- コントロールパネル (Control Panel) → システム (System)に移動します。
- Advanced タブをクリックします。
- 環境変数 (Environment Variables) ボタンをクリックします。
- システム変数のNewをクリックします。
- 必要とされる
JAVA_HOME
、TMP
、TEMP
の名前-値ペアを入力します。 - You will also need to add
<EWS_HOME>\bin
to the PATH environment variable of the user the service runs under. This is SYSTEM by default. Without this, the SSL Connector will fail to work.
手順4.5 Post-installation スクリプトの実行
- 管理者でログインしている場合でも、管理者としてコマンドプロンプト (Command Prompt) を実行します。
- スタート (Start) ボタンをクリックします。
- すべてのプログラム (All Programs) → アクセサリ(Accessories)へ移動します。
- Command Promptを右クリックし、
管理者として実行 (Run as administrator)
を選択します。
注記
Windows Server 2003はユーザアカウント制御 の概念がないため、Command Prompt (cmd.exe
)を実行するだけで結構です。 - Command Promptで、以下を入力し利用中のEnterprise Web Server設定の
etc
フォルダに移動します。C:\> cd /D "C:\Program Files\Red Hat\Enterprise Web Server\etc"
call postinstall.bat
コマンドを発行しpost-installation スクリプトを実行します。このスクリプトは、一時ログインや設定ディレクトリに対し必要とされるシンボリックリンク(Junction Points) を作成します。
手順4.6 Tomcatのインストール
- 管理者としてCommand Prompt を実行します。
- スタート (Start) ボタンをクリックします。
- すべてのプログラム (All Programs) → アクセサリ(Accessories)へ移動します。
- Command Promptを右クリックし、
管理者として実行 (Run as administrator)
を選択します。注記
64-bit Windowsでは、64-bit バージョンのCommand Prompt (cmd.exe
)を使う必要があります。32-bit アプリケーションからcmd
を実行すると、32-bit のコマンドプロンプトが起動します。これにより、サービスの設定スクリプトが ファイルが見つかりません (File Not Found) という警告で失敗してしまいます。 - JBoss Enterprise Web Serverの各種設定フォルダーの
sbin
フォルダに移動します。C:\> cd /D "C:\Program Files\Red Hat\Enterprise Web Server\sbin"
- コマンドラインで、必要なTomcatのバージョン(5 あるいは 6)を含め、以下のコマンドを実行しTomcatをインストールします。
call service<VERSION>.bat install
tomcat<VERSION>w.exe
と入力すると、サービスパラメータを確認できます。
手順4.7 HTTPのインストール
- 管理者としてCommand Prompt を実行します。
- スタート (Start) ボタンをクリックします。
- すべてのプログラム (All Programs) → アクセサリ(Accessories)へ移動します。
- Command Promptを右クリックし、
管理者として実行 (Run as administrator)
を選択します。
- 新しいインストレーションの
bin
フォルダに移動します。C:\> cd /D "C:\Program Files\Red Hat\Enterprise Web Server\bin"
- コマンドラインで
install
コマンドを実行します。httpd -k install
Apache HTTP Server サービスへのネットワークアクセスを要求するファイアウォールのセキュリティダイアログが表示されます。ネットワークからこのサービスにアクセスしたい場合は、Allowをクリックしてください。注記
デフォルトでは、 Apache HTTP Server はポート 80 をリッスンするように設定されています。Microsoft IIS がインストールされている場合は、以下を確認してください。World Wide Web...
サービスが停止されており、Startup Type がManual
に設定されていること。World Wide Web...
が別ポートをリッスンするように設定されていること。
あるいは、サービスのインストール前にhttpd.conf
ファイルを編集し、Internet Information Service がリッスンするポートと衝突しないように、Listen
するポートを変更してください。
手順4.8 log4jの設定
log4j
ロギングを使用するには、この手順に従います。
- Change to
C:\Program Files\Red Hat\Enterprise Web Server\extras\
- 該当のlog4j ファイルをTomcatフォルダにコピーします。
- Tomcat6を使っている場合は、以下のコマンドを実行します。
copy log4j.jar log4j.properties ..\tomcat6\lib
copy C:\Program Files\Red Hat\Enterprise Web Server\extras\tomcat-juli-adapters.jar C:\Program Files\Red Hat\Enterprise Web Server\tomcat6\lib
- Tomcat5を使っている場合は、以下のコマンドを実行します。
copy log4j.properties ..\tomcat5\common\classes
copy log4j.jar ..\tomcat5\common\lib
手順4.9 SSLの削除
- Go to
C:\Program Files\Red Hat\Enterprise Web Server\etc\httpd\conf.d
- SSL設定ファイルの名前変更
- SSLを削除するには、
ssl.conf
の名前をssl.conf.disabled
に変更します。 - SSLを再追加するには、
ssl.conf.disabled
の名前をssl.conf
に変更します。
手順4.10 mod_jkの設定
workers.properties
ファイルで利用可能なワーカー (JBoss インスタンス)- mod_jk 設定ファイル
mod_jk.conf
- In
C:\Program Files\Red Hat\Enterprise Web Server\etc\httpd\conf\
create workers.properties (refer to http://tomcat.apache.org/connectors-doc/reference/apache.html). - In
C:\Program Files\Red Hat\Enterprise Web Server\etc\httpd\conf.d\
, create mod_jk.conf (refer to http://tomcat.apache.org/connectors-doc/reference/apache.html)注記
You can also use the sample filesmod_jk.conf.sample
andworkers.properties.sample
available inC:\Program Files\Red Hat\Enterprise Web Server\etc\httpd\conf
: modify their content as needed and rename them tomod_jk.conf
andworkers.properties
.
手順4.11 mod_clusterの設定
- In the
C:\Program Files\Red Hat\Enterprise Web Server\etc\httpd\conf\httpd.conf
file, add the hash (#
) sign at the beginning of the following line to disable mod_proxy_balancer.so:LoadModule proxy_balancer_module /modules/mod_proxy_balancer.so
このモジュールは、JBoss HTTP Connectorとの互換性がありません。 - サーバーを設定し、JBoss HTTP Connector モジュールをロードします。
- Create the file
C:\Program Files\Red Hat\Enterprise Web Server\etc\httpd\conf\JBoss_HTTP.conf
. - 以下の行を
JBoss_HTTP.conf
ファイルに追加します。LoadModule slotmem_module /modules/mod_slotmem.so LoadModule manager_module /modules/mod_manager.so LoadModule proxy_cluster_module /modules/mod_proxy_cluster.so LoadModule advertise_module /modules/mod_advertise.so
手順4.12 セキュリティの設定
C:\Program Files\Red Hat
folder and all of its subfolders:
- Right-click the
C:\Program Files\Red Hat
folder and clickProperties
. Security
タブを選択します。- 追加 (Add..) ボタンをクリックし、
LOCAL SERVICE
と入力します。 - 新規
LOCAL SERVICE
アカウントのフルコントロール (Full Control)
チェックボックスを選択します。 - 詳細設定 (Advanced) ボタンをクリックします。
- Advanced Security Settings for Red Hat ダイアログの
Replace permissions on all child objects...
チェックボックスを選択しOK ボタンをクリックします。この手順はWindows 2003向けで、Windows Server 2008 や Windows Server 2008R2 の手順については若干違う可能性があります。
4.4. Enterprise Web Serverの実行
手順4.13 コマンドプロンプトからEnterprise Web Serverを実行
- 管理者としてCommand Prompt を実行します。
- スタート (Start) ボタンをクリックします。
- すべてのプログラム (All Programs) → アクセサリ(Accessories)へ移動します。
- Command Promptを右クリックし、
管理者として実行 (Run as administrator)
を選択します。
- コマンドプロンプトで以下のコマンドを入力しTomcatサービスを実行します。
net start tomcat<VERSION>
- コマンドプロンプトで以下のコマンドを実行しhttpd サービスを起動します。
net start httpd
手順4.14 Computer Management ツールからEnterprise Web Serverを実行
- 管理者としてCommand Prompt を実行します。
- スタート (Start) ボタンをクリックします。
- すべてのプログラム (All Programs) → アクセサリ(Accessories)へ移動します。
- Command Promptを右クリックし、
管理者として実行 (Run as administrator)
を選択します。
- スタート(Start) → 管理ツール (Administrative Tools) → サービス (Services)へ移動します。
- Services のダイアログにて、サービス名(
httpd
あるいはtomcat
) を右クリックし、開始 (Start) あるいは 停止(Stop)をクリックします。
注記
catalina.bat run
を使うことでエラーを確認することができます。
C:\windows\System32\
directory and PATH directories, and check for DLLs library conflicting with those shipped with Enterprise Web Server. In particular, look for libeay32.dil
, ssleay32.dll
, and libssl32.dll
.
4.5. Enterprise Web Serverの停止
手順4.15 コマンドプロンプトからEnterprise Web Serverを停止
- 管理者としてCommand Prompt を実行します。
- スタート (Start) ボタンをクリックします。
- すべてのプログラム (All Programs) → アクセサリ(Accessories)へ移動します。
- Command Promptを右クリックし、
管理者として実行 (Run as administrator)
を選択します。
- コマンドプロンプトで以下のコマンドを入力しTomcatサービスを実行します。
net stop tomcat<VERSION>
- コマンドプロンプトで以下のコマンドを実行しhttpd サービスを起動します。
net stop httpd
手順4.16 Computer Management ツールからEnterprise Web Serverを停止
- 管理者としてCommand Prompt を実行します。
- スタート (Start) ボタンをクリックします。
- すべてのプログラム (All Programs) → アクセサリ(Accessories)へ移動します。
- Command Promptを右クリックし、
管理者として実行 (Run as administrator)
を選択します。
- スタート(Start) → 管理ツール (Administrative Tools) → サービス (Services)へ移動します。
- Services のダイアログにて、サービス名(
httpd
あるいはtomcat
) を右クリックし、停止(Stop)をクリックします。
4.6. フォルダ構造
|-- bin |-- doc |-- etc | |-- httpd | |-- postinstall.bat | |-- ssl | `-- sysconfig |-- include |-- lib[64] |-- sbin |-- share | |-- apache-tomcat-5.VERSION | |-- apache-tomcat-6.VERSION | |-- java | |-- tomcat5 | `-- tomcat6 `-- var |-- cache |-- log |-- run `-- www
bin
やsbin
ディレクトリには、Apache HTTP Server や Tomcatの実行可能ファイルが含まれています。etc
フォルダには、Apache HTTP Server や post-installation スクリプトの設定ファイルが含まれています。share
フォルダには、Apache Tomcat 5 and 6 各種設定ファイルおよび共有の Java JAR が含まれています。var
にはサブディレクトリが4つあります。cache
cache
にはサーバーがキャッシュしたリソースが含まれます。log
log
フォルダにはHTTP Server およびTomcatのログファイルが含まれます。www
- Apache HTTP Serverは、このファイルで
default
設定のWeb コンテンツを検索します。 run
run
フォルダにはPIDファイルが含まれます。
第5章 SolarisでEnterprise Web Serverのインストール
- ZIPファイルから
- Solaris パッケージから
5.1. 前提条件
手順5.1 Java のインストール
- Oracle のホームページへ移動します。
- このWeb サイト(http://www.oracle.com/technetwork/java/javase/downloads/index.html)からJDK 1.6.0 をダウンロードします。
- ダウンロードした場所に移動します。
- Java のインストールファイルを実行します。
usr
へ移動します。- 以下のコマンドを実行し現在の Java のシンボリックリンクを表示します。
ls -lad java
- リンクの削除方法:
rm java
- JDK 1.6.0へのjava のシンボリックリンクを作成します。
ln -sf /usr/jdk/<JDK>
5.2. インストレーションファイルをダウンロード
手順5.2 Solaris パッケージあるいはZIPファイルのダウンロード
- Web ブラウザでhttps://access.redhat.com を開きます。
- 右上端にある Log in ボタンをクリックします。
- ログイン情報を入力し、Log inをクリックします。
- ページ上部にあるメニューバーの Downloadsオプションにマウスをかざし、表示メニューのJBoss Enterprise Middleware にあるDownloadsをクリックします。
- 表示ページのProduct ドロップダウンボックス欄でWeb Server を選択しページが更新されるのを待ちます。
- Releases タブにて、ご利用中のオペレーティングシステムおよびアーキテクチャの
JBoss EWS
リンクをクリックします。 - Software Details ページにて、File のドロップダウンボックスの隣にあるDownload ボタンをクリックします。
注記
ご利用中のシステムおよびアーキテクチャ向けのファイルであることを確認します。 - ダウンロードファイルを確認します。
5.3. Enterprise Web Serverの展開、インストール
手順5.3 ZIPファイルからEnterprise Web Serverを展開、インストール
- シェルプロンプトでroot ユーザーになります。
- ZIPファイルのあるディレクトリに移動します。
- 以下のコマンドを実行し、パッケージを
opt
へ移動します。# unzip <FILE_NAME> -d /opt
<FILE_NAME>をダウンロードしたZIPファイルの名前で置き換えてください。 - 以下のコマンドを発行しpost-installation スクリプトを実行します。
cd /opt/redhat/ews/etc sh .postinstall
post installation プロセスでTomcatおよびApache ユーザーおよびグループ、ディレクトリが作成されます。- ユーザーおよびグループ
apache
はID48、tomcat
はID91です。apache
ユーザーはhttpd
を、tomcat
はtomcat
を作動させるのに利用されます。 tomcat
グループが書き込み権限を持つその他のディレクトリは以下のとおりです。/var/logs/tomcat5
/var/logs/tomcat6
手順5.4 Solaris パッケージからEnterprise Web Serverを展開、インストール
/opt/redhat/ews
ディレクトリにインストールします。インストールの一部として、パッケージインストーラはカスタムのスクリプトを実行し、Apache およびTomcatユーザーアカウントを設定します。
- シェルプロンプトでroot ユーザーになります。
- 以下の
gunzip
およびpkgadd
コマンドを実行し、パッケージを展開およびインストールします。gunzip RHATews-1.0.*
pkgadd -d RHATews-1.0.*
このコマンドは以下のような出力を返します。The following packages are available: 1 RHATews JBoss Enterprise Web Server (i386) 1.0.0,REV=2.el5 Select package(s) you wish to process (or 'all' to process all packages). (default: all) [?,??,q]:
1
をタイプするか、enter
を押しインストールを確定すると、以下の情報が表示されます。JBoss Enterprise Web Server(i386) 1.0.0,REV=2.GA END USER LICENSE AGREEMENT JBOSS(r) ENTERPRISE MIDDLEWARE(tm) The end user license agreement ("EULA") governs the use of the various software modules that collectively comprise JBoss Enterprise Middleware and any related updates, source code, appearance, structure and organization, regardless of the delivery mechanism. The JBoss Enterprise Middleware EULA can be found here: http://www.redhat.com/licenses/jboss_eula.html ## Executing checkinstall script. Using </opt> as the package base directory. ## Processing package information. ## Processing system information. ## Verifying disk space requirements. ## Checking for conflicts with packages already installed. ## Checking for setuid/setgid programs. This package contains scripts which will be executed with super-user permission during the process of installing this package. Do you want to continue with the installation of <RHATews> [y,n,?]
- インストール確定のプロンプトが表示され、
y
を入力しenter
を押すと、インストールが開始され以下が表示されます。## Executing postinstall script. Apache group (id=48) already exists. +++ or created if not Apache user (id=48) already exists. Generating private RSA key ... OK Generating new (+++ user hostname displayed here) certificate ... OK Tomcat group (id=91) already exists. Tomcat user (id=91) already exists. ----------------------------------------------------------------------- NOTICE ----------------------------------------------------------------------- JAVA_HOME environment variable is not set. Either set the JAVA_HOME or edit the configuration scripts inside `/opt/redhat/ews/etc/sysconfig' directory and set the JAVA_HOME to the installed JDK location. Installation of <RHATews> was successful.
- 以下のコマンドを実行し、パッケージ情報を表示します。
pkginfo -l RHATews
注記
インストール時にシステムはJAVA_HOME
の環境変数が設定されていないとの通知を生成します。この変数を稼働させたいTomcat向けに設定する必要があります (手順5.5「Tomcatの設定」の章を参照)。 - 該当のTomcatのバージョンで以下のコマンドを入力し
catalina.sh
スクリプトを実行します。/opt/redhat/ews/share/tomcat<VERSION>/bin/catalina.sh
catalina.sh
スクリプトは、作動中のJVMバージョンを検知し、/opt/redhat/ews/libパス( 64 bit JVMは /opt/redhat/ews/lib64) をライブラリパスへ追加します。
5.4. 環境設定
- リンクの削除 (手順5.6「SSLの削除」参照)
- log4jロギングの追加 (手順5.7「log4jの設定」の参照)
- mod_jk あるいは mod_clusterを有効化 (手順5.8「mod_jkの設定」 および 手順5.9「mod_clusterの設定」を参照)
手順5.5 Tomcatの設定
JAVA_HOME
変数を対象のJDK (1.6.0)を指定するように設定します。
tomcat
設定ファイルを検索します。- Tomcat5は
/opt/redhat/ews/etc/sysconfig/tomcat5
- Tomcat6は
/opt/redhat/ews/etc/sysconfig/tomcat6
- 設定ファイルを開き以下の行頭にあるハッシュ (#)を削除します。
# JAVA_HOME="/usr/java"
手順5.6 SSLの削除
/opt/redhat/ews/etc/httpd/conf.d
へ移動します。- SSL設定ファイルの名前変更
- SSLを削除するには、
ssl.conf
の名前をssl.conf.disabled
に変更します。 - SSLを再度有効にするには、
ssl.conf.disabled
の名前をssl.conf
に変更します。
手順5.7 log4jの設定
log4j
ロギングを追加するには、この手順に従います。
/opt/redhat/ews/share/extras
ディレクトリに移動します。log4j.jar
およびlog4j.properties
ファイルをTomcatディレクトリのlib
にコピーします。- Tomcat6を使っている場合は、以下のコマンドを実行します。
extras]# cp log4j.jar log4j.properties ../tomcat6/lib
extras] # cp tomcat-juli-adapters.jar /opt/redhat/ews/share/tomcat6/lib
- Tomcat5を使っている場合は、以下のコマンドを実行します。
extras]# cp log4j.properties ../tomcat5/common/classes
extras]# cp log4j.jar ../tomcat5/common/lib
手順5.8 mod_jkの設定
workers.properties
ファイルで利用可能なワーカー (JBoss インスタンス)- mod_jk 設定ファイルのmod_jk.conf
/opt/rehat/ews/etc/httpd/conf/httpd/conf/
でworkers.properties ファイルを作成します (http://tomcat.apache.org/connectors-doc/reference/apache.htmlを参照)。/opt/rehat/ews/etc/httpd/conf/httpd/conf.d/
でmod_jk.conf ファイルを作成します (http://tomcat.apache.org/connectors-doc/reference/apache.htmlを参照)。注記
/opt/rehat/ews/etc/httpd/conf/httpd/conf/にあるサンプルファイルmod_jk.conf.sample
とworkers.properties.sample
をコピーし変更することができます。必要に応じ内容を変更し、mod_jk.conf
やworkers.properties
に名前を変更します。
手順5.9 mod_clusterの設定
- Red Hat Customer Portalから、ご利用中のオペレーティングシステムおよびアーキテクチャ向けのjboss-ep-native ZIPファイルをダウンロードします。
- ダウンロードしたファイルを展開します。
- ファイルを展開した場所から、
jboss-ep-<VERSION> /native/lib[64]/httpd/modules
へ移動します。 - 以下のコマンドを実行しmod_cluster モジュールを
/opt/redhat/ews/lib[64]/httpd/modules
にコピーします。modules]# cp mod_advertise.so mod_manager.so mod_proxy_cluster.so mod_slotmem.so -t /usr/lib[64]/httpd/modules
/opt/redhat/ews/httpd/conf/httpd.conf
ファイルで、以下の行頭にハッシュ記号 (#
) を追加し、mod_proxy_balancer モジュールを無効にします。LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
このモジュールは、JBoss HTTP Connectorとの互換性がありません。- サーバーを設定し、JBoss HTTP Connector モジュールをロードします。
/opt/redhat/ews/httpd/conf.d/JBoss_HTTP.conf
のファイルを作成します。- 以下の行を$EWS_HOME/httpd/conf.d/JBoss_HTTP.confファイルに追加します。
LoadModule slotmem_module $EWS_HOME/httpd/modules/mod_slotmem.so LoadModule manager_module $EWS_HOME/httpd/modules/mod_manager.so LoadModule proxy_cluster_module $EWS_HOME/httpd/modules/mod_proxy_cluster.so LoadModule advertise_module $EWS_HOME/httpd/modules/mod_advertise.so
5.5. Enterprise Web Serverの実行
5.5.1. Tomcatの起動
重要
5.5.1.1. プログラムとしてTomcatを稼働
sbin
ディレクトリのtomcat[5,6]
スクリプトを使うか、lib
ディレクトリのcatalina
スクリプトを利用します。
- TomcatスクリプトでTomcatを起動するには、各Tomcatバージョン (
5
あるいは6
)で以下のコマンドを root ユーザーで実行します。/opt/redhat/ews/sbin/tomcat<VERSION> start
システムは設定ファイルを読み込み、Tomcatユーザーアカウントのユーザーおよびグループに変わります (つまり、Tomcatは常にTomcatユーザーの下で作動)。デフォルトでは、Tomcat起動時にtomcat-native
が自動的にLD_LIBRARY_PATH
および-Djavalibrary.path
へ追加されます。 catalina.sh
スクリプトでTomcatを起動するには、各Tomcatバージョン (5
あるいは6
)で以下のコマンドを root ユーザーで実行します。/opt/redhat/ews/share/tomcat<VERSION>/bin/catalina.sh
catalina.sh
スクリプトは、作動中のJVMバージョンを検知し、/opt/redhat/ews/lib/
パス( 64 bit JVMは/opt/redhat/ews/lib64
) をライブラリパスへ追加します。
5.5.1.2. サービスとしてTomcatを作動
init.d
にあるTomcatスクリプトを利用するか、jsvc あるいは ranukiwrapper を持つ独自のシステムデーモンスクリプトを作成、使用することができます。
ln -s /opt/redhat/ews/etc/init.d/tomcat<VERSION> /etc/rc3.d/S70tomcat<VERSION> ln -s /opt/redhat/ews/etc/init.d/tomcat<VERSION> /etc/rcS.d/K20tomcat<VERSION>
init
レベルの数値を定義します ( init
レベルの定義方法に関する情報はSolaris 文書を参考にしてください)。推奨のサービス管理方法は、Solaris Service Management Facility
を使うことです。この機能の詳細を見るには、smf(5)
マニュアルを参照してください。
5.5.2. HTTPサーバーの実行
apachectl
スクリプト (/opt/redhat/ews/sbin
の中に置かれています) で開始できます。apachectl
スクリプトは設定ファイル/opt/redhat/ews/etc/sysconfig/httpd
を使います。このファイル内でmpm
の起動など、スタートアップのパラメータを編集、選択できます。
httpd
設定ファイルは/opt/redhat/ews/etc/httpd
ディレクトリ内に置かれています。デフォルトでは、対応モジュールがすべてロードされ、有効になります (付録A 対応のHTTPモジュール参照)。モジュールの一部を無効にするには、httpd.conf
ファイルで該当モジュールをコメントアウトしてください (モジュールの説明についてはhttp://httpd.apache.org/docs/2.2/mod/を参照)。
手順5.10 HTTPサーバーの実行
- root ユーザーでコマンドラインを起動します。
- 以下のコマンドを実行しHTTPサーバーを起動します。
sbin/apachectl start
システムの再起動後も自動でサーバーの稼働を継続したい場合、apachectl
スクリプトへの呼び出しを利用中のシステムスタートアップファイルに追加します。注記
HTTPサーバーの開始、停止方法に関する完全な文書はそれぞれ、docs/httpd/invoking.html
とdocs/httpd/stopping.html
を参照してください。
5.6. Enterprise Web Serverの停止
手順5.11 サービスを稼働するTomcatを停止
- シェルプロンプトでroot ユーザーになります。
- 各Tomcatバージョン (
5
あるいは6
)で以下のコマンドを実行し、bin
ディレクトリのTomcatスクリプトから開始されたTomcatを停止します。sbin/tomcat<VERSION> stop
手順5.12 プログラムを稼働するTomcatを停止
- シェルプロンプトで
/opt/redhat/ews/share/tomcat<VERSION>/bin
に移動します。 - 各Tomcatバージョン (
5
あるいは6
)で以下のコマンドを実行し、bin
ディレクトリのTomcatスクリプトから開始されたTomcatを停止します。sh shutdown.sh
手順5.13 HTTPサーバーの停止
- root ユーザーでコマンドラインを起動します。
- 以下のコマンドを実行しHTTPサーバーを停止します。
sbin/apachectl stop
5.7. Solaris でこのパッケージをアンインストール
- 以下のコマンドを実行しパッケージをアンインストールします。
pkgrm RHATews
- 以下のディレクトリを削除します。
/opt/redhat/ews
/var/run/tomcat5
/var/run/tomcat6
/var/cache/tomcat5
/var/cache/tomcat6
/var/log/httpd
/var/cache/mod_ssl
/var/cache/mod_proxy
5.8. Solaris のディレクトリ構造
. |- /opt/redhat/ews/ |- bin |- doc |- etc |- lib |- lib64 (present only for x86_64 systems platforms) |- include |- README |- man |- share |- tomcat5 |- tomcat6 |- extras |- java |- sbin |- var
- ネーティブのSolaris パッケージは絶対ロケーションパスが必要
- Solaris (およびその他のRed Hat Enterprise Linux以外のプラットフォーム)は
openldap
、openssl
、db4
、cyrus-sasl
などの、依存コンポーネントをすべて同梱および構築する必要
パート II. アップグレード
- Red Hat Enterprise Linux については6章Red Hat Enterprise Linuxで Enterprize Web Server をアップグレードを参照。
- Windows については7章Windows 上で Enterprise Web Server をアップグレードを参照。
- Solaris については8章Solaris 上でEnterprise Web Serverをアップグレードを参照。
第6章 Red Hat Enterprise Linuxで Enterprize Web Server をアップグレード
6.1. ZIPのインストール各種設定をアップグレード
- 利用中のアプリケーションおよびカスタム設定のバックアップを取ります。
- JBoss Enterprise Web Serverの新しいバージョンをインストールします (「ZIPファイルからEnterprise Web Serverをインストール」を参照のこと)。
- JBoss Enterprise Web Server の新規設定が置かれているディレクトリにアプリケーションとカスタム設定をコピーします。
- バックアップの削除前にアプリケーションがすべて正しく機能することを確認してください。
6.2. RPMのインストール各種設定をアップグレード
注記
手順6.1 Red Hat Enterprise Linux 5上でJBoss Enterprise Web Server をアップグレード
- シェルプロンプトで、root ユーザになります。
- 以下のコマンドを実行しclasspathx-jaf パッケージを削除します。
# yum remove classpathx-jaf
- アップグレードのコマンドを実行します。
# yum upgrade
手順6.2 Red Hat Enterprise Linux 4でJBoss Enterprise Web Server をアップグレード
- シェルプロンプトで、root ユーザになります。
- 以下のコマンドを実行します。
# up2date -u
第7章 Windows 上で Enterprise Web Server をアップグレード
- ご利用中のアプリケーションおよびカスタム設定のバックアップをとります。
- JBoss Enterprise Web Server の新しいバージョンをインストールします (4章Windows上でEnterprise Web Serverをインストールを参照のこと)。
- Copy the applications and custom settings to the directory with the new JBoss Enterprise Web Server installation (
C:\Program Files\Red Hat\Enterprise Web Server
). - バックアップの削除前にアプリケーションがすべて正しく機能することを確認してください。
第8章 Solaris 上でEnterprise Web Serverをアップグレード
- ご利用中のアプリケーション、およびカスタム設定のバックアップをとります。
- JBoss Enterprise Web Server の新しいバージョンをインストールします(5章SolarisでEnterprise Web Serverのインストールを参照のこと)。
- JBoss Enterprise Web Server の新規設定(
/opt/redhat/ews/
)のあるディレクトリにアプリケーションとカスタム設定をコピーします。 - バックアップの削除前にアプリケーションがすべて正しく機能することを確認してください。
第9章 Enterprise Web Server上の Hibernate
context.xml
にて定義しています)。ただし、persistence.xml
と web.xml
が必要です。以下の例にて、Tomcat の接続プーリングメカニズムを使った設定について示しています。
/META-INF/context.xml
は、Tomcat が作成すべき接続プールを定義しています。例9.1 context.xml
<Context> <Resource name="jdbc/DsWebAppDB" auth="Container" type="javax.sql.DataSource" username="sa" password="" driverClassName="org.h2.Driver" url="jdbc:h2:mem:target/test/db/h2/hibernate maxActive="8" maxIdle="4"/> </Context>
/WEB-INF/classes/META-INF/persistence.xml
はJPA設定ファイルで、Tomcat プールからの接続を消費できるようにアプリケーションが どのようにHibernate を設定するかを定義します。Hibernate API を直接利用している場合は、hibernate.cfg.xml
にてよく似た設定を使います。例9.2 persistence.xml
<persistence version="1.0" xmlns="http://java.sun.com/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd"> <persistence-unit name="dswebapp"> <provider>org.hibernate.ejb.HibernatePersistence</provider> <properties> <property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect" /> <property name="hibernate.connection.datasource" value="java:comp/env/jdbc/DsWebAppDB"/> </properties> </persistence-unit> </persistence>
/WEB-INF/web.xml
は通常の Web アプリケーションデプロイメントファイルで、どのデータソースを消費するかTomcat に指示をだします。例9.3「web.xml」ではデータソースがjdbc/DsWebAppDB
となっています。例9.3 web.xml
<?xml version="1.0" encoding="UTF-8"?> <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"> <resource-env-ref> <resource-env-ref-name>jdbc/DsWebAppDB</resource-env-ref-name> <resource-env-ref-type>javax.sql.DataSource</resource-env-ref-type> </resource-env-ref> </web-app>
第10章 JBoss Operating NetworkでEnterprise Web Serverを監視
手順10.1 Unix オペレーティングシステム上でユーザー権限を設定
注記
httpd
および Tomcat のディレクトリに対して読み取り/書き込みの権限が必要です。
- シェルプロンプトでroot ユーザーになります。
- 以下のコマンドを実行し、JON エージェントを作動させるユーザーをTomcatと Apache ユーザーグループに追加します。
# useradd -G tomcat,apache <RHQ_AGENT_USER>
手順10.2 監視設定
- 該当のJBoss Enterprise Web Server インスタンスの
startup
を編集用に開きます。- ZIP ファイルからインストールしたRed Hat Enterprise Linuxの場合は、
$EWS_HOME/tomcat<VERSION>/bin/startup.sh
を開きます。 - RPM ファイルからインストールしたRed Hat Enterprise Linuxの場合は、
/usr/sbin/tomcat<VERSION>
を開きます。 - Solaris の場合は
/opt/redhat/ews/tomcat<VERSION>/bin/startup.sh
を開きます。 - on Windows open
C:\Program Files\Red Hat\Enterprise Web Server\sbin\tomcat<VERSION>.sh
- JMX監査用に利用可能なポートを定義します。ファイアーウォールによりブロックされていないか確認します。定義方法は、startup ファイルのJAVA_OPTS 変数に、以下の行を追加しPORT_NUMBER を監視用のポート番号に置き換えます。
- Red Hat Enterprise Linuxおよび Solaris の場合
JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.port=PORT_NUMBER"
- Windows の場合
set "JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.port=PORT_NUMBER"
- 開発時に認証およびSSLを無効にしたい場合、startup ファイルのJAVA_OPTS 変数に以下の行を追加します。
JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.ssl=false" JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.authenticate=false"
重要
本番環境では、startup ファイルのJAVA_OPTS 変数に以下の行を追加しSSLでJMXのセキュリティを高めファイアーウォールでアクセスを制限します。- Red Hat Enterprise Linuxおよち Solaris の場合
JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.access.file=$EWS_HOME/jmxremote.access" JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.password.file=$EWS_HOME/jmxremote.password"
- Windows の場合
set "JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.access.file=c:\Program Files\Red Hat\Enterprise Web Server\jmxremote.access" set "JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.password.file=c:\Program Files\Red Hat\Enterprise Web Server\jmxremote.password"
注記
JON httpd プラグインは、HTTP Server を監視するために特定のディレクトリが必要です。- Solaris および Red Hat Enterprise Linuxの場合:
/etc/httpd
- on Windows:
C:\apache
該当のディレクトリが存在しない場合はJONエージェントを起動する前に作成してください。JBoss Operating Networkに関する詳細情報は、基本管理ガイドの「検知」の章を参照してください。
付録A 対応のHTTPモジュール
- mod_filter.so
- mod_filter.so
- mod_substitute.so
- mod_version.so
- mod_usertrack.so
- mod_authn_alias.so
- mod_vhost_alias.so
- mod_headers.so
- mod_authz_host.so
- mod_dumpio.so
- mod_ssl.so
- mod_userdir.so
- mod_authn_dbd.so
- mod_env.so
- mod_ldap.so
- mod_expires.so
- mod_logio.so
- mod_authn_default.so
- mod_proxy_scgi.so
- mod_negotiation.so
- mod_disk_cache.so
- mod_authn_file.so
- mod_autoindex.so
- mod_auth_basic.so
- mod_proxy_http.so
- mod_setenvif.so
- mod_proxy.so
- mod_suexec.so
- mod_dav.so
- mod_asis.so
- mod_alias.so
- mod_proxy_balancer.so
- mod_log_forensic.so
- mod_mime_magic.so
- mod_deflate.so
- mod_proxy_connect.so
- mod_dav_fs.so
- mod_cgi.so
- mod_dbd.so
- mod_mem_cache.so
- mod_cgid.so
- mod_auth_digest.so
- mod_authz_owner.so
- mod_include.so
- mod_proxy_ajp.so
- mod_reqtimeout.so
- mod_authn_anon.so
- mod_status.so
- mod_cern_meta.so
- mod_log_config.so
- mod_cache.so
- mod_dir.so
- mod_proxy_ftp.so
- mod_ext_filter.so
- mod_authz_user.so
- mod_mime.so
- mod_unique_id.so
- mod_authz_default.so
- mod_ident.so
- mod_file_cache.so
- mod_speling.so
- mod_actions.so
- mod_authnz_ldap.so
- mod_authn_dbm.so
- mod_rewrite.so
- mod_authz_groupfile.so
- mod_imagemap.so
- mod_info.so
- mod_authz_dbm.so
付録B 改訂履歴
改訂履歴 | |||
---|---|---|---|
改訂 1.0.2-55 | Tue Feb 10 2015 | Lucas Costi | |
| |||
改訂 1.0.2-55 | Tue Feb 10 2015 | Lucas Costi | |
| |||
改訂 1.0.2-54 | Thu Jan 12 2012 | Rebecca Newton | |
| |||
改訂 1.0.2-54 | Thu Jan 12 2012 | Rebecca Newton | |
| |||
改訂 1.0.2-53 | Thu Jul 21 2011 | Rebecca Newton | |
| |||
改訂 1.0.2-53 | Thu Jul 21 2011 | Rebecca Newton | |
| |||
改訂 1.0.2-50 | Tue Jun 21 2011 | Rebecca Newton | |
| |||
改訂 1.0.2-50 | Tue Jun 21 2011 | Rebecca Newton | |
|