JBoss Enterprise Application Platform 4.2 インストールガイド

JBoss Enterprise Application
Platform 4.2
インストールガイド
JBoss Enterprise Application Platform 4.2 Cumulative Patch 5 向け
エディッション 1.0
Red Hat ドキュメントグループ
JBoss Enterprise Application Platform 4.2 インストールガイド
JBoss Enterprise Application Platform 4.2 Cumulative Patch 5 向け
エディッション 1.0
Red Hat ドキュメントグループ
法律上の通知
Copyright © 2008 Red Hat, Inc.
T his document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported
License. If you distribute this document, or a modified version of it, you must provide attribution to Red
Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be
removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section
4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo,
and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux ® is the registered trademark of Linus T orvalds in the United States and other countries.
Java ® is a registered trademark of Oracle and/or its affiliates.
XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States
and/or other countries.
MySQL ® is a registered trademark of MySQL AB in the United States, the European Union and other
countries.
Node.js ® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or
endorsed by the official Joyent Node.js open source or commercial project.
T he OpenStack ® Word Mark and OpenStack Logo are either registered trademarks/service marks or
trademarks/service marks of the OpenStack Foundation, in the United States and other countries and
are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or
sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
概要
本インストールガイドには JBoss Enterprise Application Platform のインストールに関する情報が記載さ
れています。
目次
目次
. . .1章
第
. . . .はじめに
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3. . . . . . . . . .
1.1. フィードバック
3
1.2. その他のガイド
3
. . .2章
第
. . . .スタートガイド
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4. . . . . . . . . .
2.1. 前提条件
4
2.1.1. ハードウェアおよびオペレーティングシステムの要件
4
2.1.2. Java 環境を設定する
4
2.2. JBoss Enterprise Application Platform のコンポーネント
6
. . .3章
第
. . . インストールの代替
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8. . . . . . . . . .
. . .4.章
第
. . .グラフィカルインストーラを使用したインストール
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9. . . . . . . . . .
. . .5章
第
. . . .Z.IP
. . .ダウンロードを使用したインストール
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
...........
5.1. ダウンロード
13
5.2. インストール
13
. . .6章
第
. . . .RHN
. . . . を使用したインストール
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
............
6.1. はじめに
14
6.2. RHN を使用したインストール
14
. . .7章
第
. . . .インストール後の設定
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
............
7.1. JBOSS_HOME 環境変数を設定する
16
7.2. メモリ設定の調節
16
7.3. インストール後のセキュリティ設定
16
7.4. 認証を無効にする
17
. . .8章
第
. . . .JBoss
. . . . . . のアンインストール
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
............
. . .9章
第
. . . .インストールのテスト
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
............
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
改訂履歴
............
1
JBoss Enterprise Application Platform 4.2 インストールガイド
2
第1章はじめに
第 1章はじめに
JBoss Enterprise Application Platform は Java EE サービススィートのオープンソース実装です。検証お
よび認定済みの JBoss エンタープライズミドルウェアコンポーネントを事前構成したプロフィールで統合
的な運用を目指す企業顧客に適したパッケージで構成されてます。取扱いが容易なサーバーアーキテク
チャとなるため、高度な柔軟性により JBoss は J2EE を使いはじめたばかりのユーザーのみならずカス
タマイズ可能なミドルウェアプラットフォームを求める上級アーキテクチャの方にも理想的な選択となり
ます。
Java ベースであるため、 JBoss Enterprise Application Platform はクロスプラットフォームとなり Java
に対応するオペレーティングシステムであれば簡単にインストールして使用することができます。入手が
容易なソースコードはサーバーのデバッグを行い理解するのに適したパワフルなラーニングツールとなり
ます。また、個人使用やビジネス使用にカスタムバージョンを作成する場合も柔軟性を提供していま
す。
JBoss Enterprise Application Platform のインストールはシンプルで簡単です。インストールしてすぐに
実行できます。本ガイドでは JBoss のインストールとアンインストールの方法を説明しています。
1.1. フィードバック
JBoss Enterprise Application Platform インストールガイドに誤字、誤植を発見された場合、または本マ
ニュアルの改善に関するご意見などがある場合はぜひおしらせください。 JIRA にて、 Product: JBoss
Enterprise Application Platform、 Version: <version>、 Component: Doc を選択しレポートをサブミット
してください。マニュアルの改善案をレポートしていただく場合は、できるだけ詳細に記述して頂くよ
うお願いいたします。エラーを発見された場合は、そのセクション番号と前後の文章を含めてご報告頂
けると修正箇所の確定が容易になります。
1.2. その他のガイド
製品に関する詳細をお探しの場合は、 http://www.redhat.com/docs/manuals/jboss でオンラインによるガ
イドを参照してください。
3
JBoss Enterprise Application Platform 4.2 インストールガイド
第 2章スタートガイド
2.1. 前提条件
JDK 及び JBoss Enterprise Application Platform のインストールに十分なディスク領域の他、アプリケー
ション用の領域も確保しておく必要があります。 JBoss Enterprise Application Platform をインストール
する前に、正常に動作する Java をインストールしておく必要があります。 JBoss は 100% 純粋な Java
となるため Java に対応するオペレーティングシステム / プラットフォームならいずれでも動作します。
ただし、理解しておく必要があるオペレーティングシステム固有の問題がいくつかあります。詳細につ
いては、http://wiki.jboss.org/wiki/Wiki.jsp?page=JBossOperatingSystemSpecificIssues を参照してくださ
い。
2.1.1. ハードウェアおよびオペレーティングシステムの要件
対応オペレーティングシステム / JVM の組み合わせ、対応データベースのプラットフォームに関する最新
情報については、 http://www.jboss.com/products/platforms/application/testedconfigurations を参照して
ください。
2.1.2. Java 環境を設定する
JBoss Enterprise Application Platform をインストールする前に、正常に動作する JDK 1.5 をインストー
ルしておく必要があります。必要に応じて 32-bit または 64-bit の JVM をインストールすることができま
す。本ガイドでは、汎用の Linux プラットフォームおよび Microsoft Windows プラットフォームに RHN
を使用して、 32-bit の Sun JDK 5.0 をインストールする方法を説明します。インストールを始める前
に、 64-bit の JVM を使用した場合の特長をいくつか示しておきます。
64 -bit の OS とハードウェアにインストールした 64 -bit JVM の特長
より広範囲のデータパス: RAM と CPU 間のパイプが二倍の大きさになり、メモリ依存のアプリケー
ションのパフォーマンスを向上させます。
64-bit メモリの処理により実質的に無限 (1 exabyte) の heap 割り当てを実現します。ただし、大容
量の heap はガベージコレクションに影響を及ぼします。
1.5GB 以上の RAM (ガベージコレクションの最適化用の空きスペースも含む) で動作するアプリケー
ションには 64-bit の JVM を使用してください。
32-bit の JVM で稼働し、最小限のサイズを超える heap は必要としないアプリケーションには 64-bit
の JVM を使用する利点はありません。メモリ問題を除いては、同じようなクロックスピードとアー
キテクチャを持つ 64-bit ハードウェアは Java アプリケーションを 32-bit 系より速く作動させること
はありません。
RHN を使用した 32-bit Sun JDK 5.0 のインストールと設定
Java SDK は、ご使用の Linux の種類とアーキテクチャの為の Red Hat Enterprise Linux 5 補助チャン
ネルによって提供されています。アーキテクチャに応じてそれらのチャンネルには以下の名前があり
ます:
rhel-i386-server-supplementary-5 及び rhel-x86_64-server-supplementary-5
java-1.5.0-bea と java-1.5.0-ibm と java-1.5.0-sun SDK 群はこれらのチャンネルから取
得できます。-devel サブパッケージも忘れずにインストールして下さい。
java と javac と java_sdk_1.5.0 用に alternatives を選択。（java_sdk_1.5.0 の設定
はオプションです）
SysV service スクリプトの使用を希望したり、このインストール済の SDK をシステム内のデフォル
トの java 及び javac にしたい場合のみにこれが必要になります。この選択は JAVA_HOME 環境変数を
セットすることで上書きが可能です。
alternatives システムにより、異なるシステムからの異なるバージョンの Java が使用中のシステ
4
第2章スタートガイド
ムで共存できるようになります。サービススクリプトが適切な Java を使用するように意図する Java
を確実に選択する必要があります。
root として次のコマンドを実行します:
/usr/sbin/alternatives --config java
そして意図する Java が選択してあること（'+' のマーク付き）を確認するか、又は要求された時にそ
の番号を入力してそれを選択します。
javac と java_sdk_1.5.0. の為にも同じことを確実に実行して下さい。弊社では、全てが同じ製
造元とバージョンを指すようにすることを推奨しています。
汎用 Linux プラットフォームに 32-bit Sun JDK 5.0 をインストールして設定する
Sun JDK 5.0 (Java 2 Development Kit) を Sun のウェブサイト、
http://java.sun.com/javase/downloads/index_jdk5.jsp からダウンロードします。ダウンロードするに
は "JDK 5.0 Update <x>" (x は最新の更新番号) を選択し、次に Linux 用の "RPM in self-extracting"
ファイルを選択します [1] 。 JDK のインストールについては Sun のウェブサイトでインストール方法
をお読みください。
SysV サービススクリプトを使用したくない場合は、 "RPM in self-extracting" ファイルではなく Linux
用の "self-extracting file" をインストールすることができます。この場合、以下で説明している次の
手順は省略して構いません。ただし、実稼働サーバーには SysV サービススクリプトを使用すること
を推奨します。
JPackage ここから適切な -com pat RPM をダウンロードしてインストールします。必ずインス
トールしている JDK と一致する -com pat パッケージのバージョンを選択するようにしてください。
JDK インストールディレクトリを指す環境変数を作成してJAVA_HOME という名前を付けます。コマ
ンドラインから java を実行できるようシステムパスに $JAVA_HOME/bin を追加します。ユーザー
のホームディレクトリ内の .bashrc ファイルに以下の行を追加すると行うことができます。
#In this example /usr/java/jdk1.5.0_11 is the JDK installation directory.
export JAVA_HOME=/usr/java/jdk1.5.0_11
export PATH=$PATH:$JAVA_HOME/bin
この変数をインストールを行っているユーザーおよびサーバーを稼働する予定のユーザーアカウント
に対して設定します。
マシンに異なるバージョンの JVM が複数インストールされている場合、 JDK1.5 インストールをデ
フォルトの java および javac として使用していることを確認してください。 alternatives の機構を
使用することで確認することができます。 alternatives により異なるソースからの異なるバージョンの
Java 同士がシステム上で共存できるようになります。
java、 javac、 java_sdk_1.5.0 用の alternatives を選択する
root になり、シェルプロンプトで以下のコマンドを入力すると次のように表示されます。
[root@vsr ~]$ /usr/sbin/alternatives --config java
There are 2 programs which provide 'java'.
Selection
Command
----------------------------------------------1
/usr/lib/jvm/jre-1.4.2-gcj/bin/java
*+ 2
/usr/lib/jvm/jre-1.5.0-sun/bin/java
Enter to keep the current selection[+], or type selection number:
Sun バージョン [この場合 jre-1.5.0-sun] が選択されていることを確認するか (出力に '+' で表
示)、またはプロンプトに応じてその番号を入力して選択してください。
javac および java_sdk_1.5.0 に対しても同じ手順を繰り返します。
5
JBoss Enterprise Application Platform 4.2 インストールガイド
[root@vsr ~]$ /usr/sbin/alternatives --config javac
There are 1 programs which provide 'javac'.
Selection
Command
----------------------------------------------*+ 1
/usr/lib/jvm/java-1.5.0-sun/bin/javac
Enter to keep the current selection[+], or type selection number:
[root@vsr ~]$ /usr/sbin/alternatives --config java_sdk_1.5.0
There are 1 programs which provide 'java_sdk_1.5.0'.
Selection
Command
----------------------------------------------*+ 1
/usr/lib/jvm/java-1.5.0-sun
Enter to keep the current selection[+], or type selection number:
java、 javac、 java_sdk_1.5.0 がすべて同一のメーカーとバージョンをポイントしていることを確
認してください。
注記
前述のように、 JAVA_HOME 環境変数を設定することによりいつでもこの手順を上書きするこ
とができます。
java 実行ファイルがパスの中にあり、適切なバージョンを使用していることを確認してください。
Java 環境を確認するには、シェルプロンプトで java -version と入力して以下のように表示され
ることを確認します。
[root@vsr ~]$ java -version
java version "1.5.0_11"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_11-b03)
Java HotSpot(TM) Client VM (build 1.5.0_11-b03, mixed mode, sharing)
Microsoft Windows に 32-bit Sun JDK 5.0 をインストールして設定する
Sun のウェブサイト、 http://java.sun.com/javase/downloads/index_jdk5.jsp から Sun JDK 5.0 (Java
2 Development Kit) をダウンロードします。ダウンロードするには "JDK 5.0 Update <x>" (x は最新
の更新番号) を選択し、次に Windows Platform のオプションを選択してインストールを実行します。
JDK インストールディレクトリを指す JAVA_HOME と言う名前の環境変数を作成します。例えば、
C:\Program Files\Java\jdk1.5.0_11\ などです。コマンドラインから java を実行するため
に、パスに jre\bin ディレクトリを追加します。例えば、 C:\Program
Files\Java\jdk1.5.0_11\jre\bin などです。これを行うには、スタートメニューからコント
ロールパネルを開き必要に応じてクラシックビューに切り替え、システムコントロールパネルアプ
レットを開いて高度な設定のタブを選択し環境変数ボタンをクリックします。
2.2. JBoss Enterprise Application Platform のコンポーネント
含まれているコンポーネントの改訂レベルに関する最新情報は、
http://www.jboss.com/products/platforms/application/components を参照してください。
[1] 必ずご使用のプラットフォームに適したファイルを選択してください。
6
第2章スタートガイド
7
JBoss Enterprise Application Platform 4.2 インストールガイド
第 3章インストールの代替
JBoss Enterprise Application Platform は以下の 3 種類の方法のいずれかでインストールすることができ
ます。
グラフィカルインストーラ
グラフィカルインストーラを使用すると、経験の浅いユーザーにとってインストールと設定のプロセ
スが簡単になります。基本インストールの他、基本的な設定機能も提供しているため、 JMX イン
ターフェースの安全化を行うかどうか、またコンソールのユーザー名/パスワードの入力ができるよう
にするかどうかを制御できるようになります。
ZIP ダウンロード
この形式のインストールでは、ダウンロードした zip を選択したディレクトリに解凍するだけです。
zip 形式に対応するオペレーティングシステムならいずれでもプラットフォームを解凍することができ
ます。
RPM ダウンロード
この形式のインストールでは、 Red Hat Network を使って Red Hat Enterprise Linux システムに自動
的にプラットフォームをインストールさせることができます。
インストーラでインストールする場合、使用する環境に合わせて小さめのサイズのインストールイメージ
を取得することになります。ただし、 rpm や zip アーカイブを使用したインストールとはディレクトリ
構成が若干異なります。
インストールには minimal、 default、 production、 all の 4 種類のサーバー設定が含まれています。これ
らのサーバー設定ファイルについては「スタートガイド」で詳しく説明されています。
8
第4章グラフィカルインストーラを使用したインストール
第 4章グラフィカルインストーラを使用したインストール
グラフィカルインストーラを起動する
インストーラは enterprise-installer-<release> .jar と言う名前の実行可能な JAR ファイ
ルです。
多くのオペレーティングシステムでは、ダブルクリックで実行可能な JAR を実行することができま
す。使用するシステムがダブルクリックに対応していない場合はコマンドラインから直接インストー
ラを実行できます。
[vsr]$ java -jar enterprise-installer-<release>.jar
次に、インストーラによって次のセクションで詳しく説明するインストール手順が順番に進められて
いきます。最終インストールの確認を行うまでは、いつでもインストールプロセスを中止することが
できます。
インストールの手順
インストール手順で使用される言語を選択してから OK ボタンを押します。
ライセンス同意書をよく読んでください。同意書の規定に同意する場合は「ライセンス同意書の規定
を承諾する」("I accept the terms of this license agreement") オプションを選択してから「次へ」
(Next) ボタンを押します。規定を承諾しない場合は「ライセンス同意書の規定を承諾しない」( "I do
not accept to the terms of this license agreement") オプションを選択します。この 2 番目のオプショ
ンを選択する場合はインストール手順を先に進めることはできません。
JBoss Enterprise Application Platform をインストールするインストールパスを選択します。完全パス
を入力するか、ブラウズ選択することができます。入力したパスに相当するディレクトリが存在しな
い場合、インストーラは指定パスにそのターゲットディレクトリを作成します。入力したパスに相当
するディレクトリが既に存在する場合は、インストーラがそのディレクトリの内容を上書きします。
いずれの場合も、インストーラは行う動作の確認を求めてきます。
注記
システム上のどこに JBoss Enterprise Application Platform をインストールしても構いません
が、 Sun ベースの VM では特定の状況おいてその名前に空白のあるディレクトリに JBoss
Enterprise Application Platform をインストールすると問題が発生するため注意してください。
これは、その結果として出る URL 内で空白を正しく処理できないファイル URL のバグによる
ものです。
9
JBoss Enterprise Application Platform 4.2 インストールガイド
図 4 .1 インストールパスの選択
JMX セキュリティの設定 - このセクションでは、 JMX インターフェース用のセキュリティ設定を制御
することができます。以下のサービスの安全化を選択することができます。
jmx-console.war, web-console.war, jmx-invoker-services, http invoker
全てのサービスに対してセキュリティの有効をクリックしてユーザー名/パスワードをデフォルトの
adm in/adm in の値から変更することをお推めします。
図 4 .2 JMX Security の設定
10
第4章グラフィカルインストーラを使用したインストール
注記
GUI インストーラからインストールしている場合、 JMX および web コンソールはパスワード
を要求してきます。
http://www.redhat.com/docs/manuals/jboss で最新のリリースノートをご覧になれます。このリリース
ノートに記載された情報をよくお読みいただき、互換性と設定に関連する重要な問題、ライブラリの
更新、機能リクエストとバグ、ライセンス情報とその他のドキュメントへのリンクなどを確認してく
ださい。
これで JBoss Enterprise Application Platform のインストール準備ができました。要約画面に表示さ
れているインストールパスを確認してから「次へ」 (Next) ボタンを押します。「次へ」 (Next) ボタ
ンを押すとインストールが開始されます。
JBoss プラットフォームメニューを XDG メニューに追加して、デスクトップ上にショートカットを
作る選択もできます。「デスクトップに追加のショートカットを作成する ("Create additional
shortcuts on the desktop")」のチェックボックスを選択すると、インストーラは以下のショートカッ
トを作成します。
アプリケーションサーバーを開始するショートカット
アプリケーションサーバーを停止するショートカット
ドキュメントへのショートカット
JMX コンソールへのショートカット
デモアプリケーションを開始するショートカット
root ユーザーとしてインストーラを実行すると、これらのショートカットを全てのユーザーに対して
作成する選択を行うことができます。
図 4 .3 デスクトップショートカットの作成
これでインストールが完了しました。 EnterprisePlatform -<release> と言う名前のディレクト
リ、またはご自分で指定した名前のディレクトリがあるはずです。プラットフォームのディレクトリ
構成を確認しレイアウトを十分理解するには、 Getting Started Guide (スタートガイド) を参照してし
てください。
11
JBoss Enterprise Application Platform 4.2 インストールガイド
12
第5章 Z IP ダウンロードを使用したインストール
第 5章 ZIP ダウンロードを使用したインストール
5.1. ダウンロード
zip ファイルは https://network.jboss.com にある JBoss Customer Service Portal (CSP) からダウンロード
することができます。
5.2. インストール
この形式のインストールでは、ダウンロードした zip を選択したディレクトリに解凍するだけです。 zip
形式に対応するオペレーティングシステムならいずれでもプラットフォームを解凍することができます。
jboss-eap-<release>.zip を解凍してアーカイブの内容を選択した場所に展開します。 JDK jar
ツール (または、他の Z IP 解凍ツール) を使って行います。
[vsr]$ cd jbeapinstallationdir
[vsr]$ jar -xvf jboss-eap-<release>.zip
これでインストールは完了です。 jboss-eap-<release> と言う名前のディレクトリができているは
ずです。プラットフォームのディレクトリ構成を確認、理解するには「スタートガイド (Getting
Started Guide)」を参照してください。
13
JBoss Enterprise Application Platform 4.2 インストールガイド
第 6章 RHN を使用したインストール
6.1. はじめに
Red Hat Network は単一の Red Hat Enterprise Linux システムまたは複数の Red Hat Enterprise Linux シ
ステム群から成るネットワークを管理するためのインターネットソリューションです。セキュリティ通
知、バグ修正の通知、および機能強化の通知 (総合的にエラータ通知と呼ばれる) はすべて直接 Red Hat
からダウンロードすることも、独自のカスタムコレクションからダウンロードすることもできます。ま
た、更新がリリースされたらすぐにシステムに配信されるようスケジュールすることも可能です。
Red Hat Update Agent で Red Hat Network への初めての接続を行います。 Red Hat Enterprise Linux ４
およびそれ以降のシステムでは Red Hat Update Agent を使用して RHN への登録を行います。登録行う
には、固有となる RHN ユーザー名とパスワードの作成、ハードウェアプロフィールの作成に伴うシステ
ムのハードウェア検出、パッケージプロフィールの作成に伴いシステムにインストールされているソフト
ウェアの検出が必要になります。これらの情報は RHN に送信され、 RHN は固有のシステム ID をそのシ
ステムに返してきます。登録が完了すると、 Red Hat Update Agent によりチャンネルのサブスクリプ
ション、パッケージのインストール、システムプロフィールの管理ができるようになります。
Red Hat Update Agent は RHN のベースコンポーネントととして単一のシステムを管理するよう設計され
ています。これによりシステムのスーパーユーザーはエラータを表示してシステムに適用できるようにな
ります。 RHN web インターフェースにより各システムの Red Hat Update Agent の設定などを含めて大
規模なシステム配備における管理、監視、プロビジョニングが容易になります。 RHN に関する詳細は
https://www.redhat.com/rhn/ でご覧ください。
6.2. RHN を使用したインストール
RHN を使って JBoss Enterprise Application Platform をインストールできるようにするには、まず「前
提条件」に記載された前提条件を満たしていることを確認します。つぎに適切な子チャンネルにサブス
クライブします (それに続く指示に従います)。
ソフトウェアチャンネルは、オペレーティングシステムやパッケージの種類、その機能性に応じてシス
テムに適用可能なインストール用パッケージやアップグレード用パッケージを確定できるよう明確に定義
されたメソッドを提供します。 http://rhn.redhat.com の RHN ウェブサイトで自分のアカウントにログイ
ンしたら、チャンネル名をクリックしてそのチャンネルの詳細ページを表示させます。
以下の手順でシステムをアプリケーションプラットフォーム（Application Platform ）チャンネルに購読さ
せることができます。このチャンネルは有効なサブスクリプションに対してのみ使用できます。チャン
ネルのタブを使用して自分のアカウントに使用できるソフトウェアチャンネルを表示させます。
Red Hat Network (RHN) に既に登録されているシステムの場合、自分のアカウントにログインしま
す。
上部メニューにある「システム」タブを選択します。「システム概要」が表示されます。
「システム概要」メニューで「システムグループ」が表示される場合は「システムの表示」を選択し
て「システム一覧」を確認します。
「システム」コラムの下のシステム名のリンクをクリックして目的のシステムを選択します。
「サブスクライブされたチャンネル」セクション (ページ右側) の下にある「チャンネルのサブスクリ
プションを変更」リンクを選択します。
このシステムに関連付けられている子チャンネルを修正するには、チャンネル横のチェックボックス
を使用して「サブスクリプションの変更」ボタンをクリックします。正しく終了したメッセージか、
エラーが表示されます。
Red Hat Enterprise Linux 4 :
14
第6章 RHN を使用したインストール
子チャンネル jbappplatform -4 -[i386|x86_64 ]-[as|es]-4 -rpm にサブスクライブします。
次のコマンドを実行します。
yum install jbossas jboss-seam rh-eap-docs jboss-profiler
Red Hat Enterprise Linux 5:
子チャンネル jbappplatform -4 -[i386|x86_64 ]-server-5-rpm にサブスクライブします。
次のコマンドを実行します。
yum install jbossas jboss-seam rh-eap-docs jboss-profiler
注記
ドキュメント (rh-eap-docs) のインストールとログベースイベントプロファイラー (jbossprofiler) はオプションですが、これらは JBoss Enterprise Application Platform の理解とトラブ
ルシューティングに役立つため、お薦め事項です。
15
JBoss Enterprise Application Platform 4.2 インストールガイド
第 7章インストール後の設定
7.1. JBOSS_HOME 環境変数を設定する
Linux プラットフォーム
インストールディレクトリ (JBOSS_DIST /jboss-as) を示す環境変数を作成し、JBOSS_HOME という
名前を付けます。コマンドラインからサーバーを実行できるようシステムパスに $JBOSS_HOME/bin を
追加します。これには、ホームディレクトリ内の .bashrc ファイルに次の行を追加します。
#In this example /home/vrenish/EnterprisePlatform-4.2/jboss-as is the installation
directory.
export JBOSS_HOME=/home/vrenish/EnterprisePlatform-4.2/jboss-as
export PATH=$PATH:$JBOSS_HOME/bin
この変数をサーバーを実行する予定のユーザーアカウントに対して設定します。
Microsoft Windows
たとえば C:\Program Files\EnterprisePlatform-4.2\jboss-as\ などのインストールディレクトリを指す
JBOSS_HOME という名前の環境変数を作成します。コマンドラインからサーバーを実行するためには、
C:\Program Files\EnterprisePlatform-4.2\jboss-as\bin のようにパスに bin ディレクトリを追加します。
これを行うには、スタートメニューからコントロールパネルを開き、必要に応じてクラシックビューに切
り替え、システムコントロールパネルのアプレットを開いて高度な設定のタブを選択してから環境変数の
ボタンをクリックします。
7.2. メモリ設定の調節
サーバーが起動に使用するデフォルト設定は、他の設定が指定されていない場合、 production 設定にな
ります。 production 設定を使ってドキュメントに含まれているサンプルの Seam アプリケーションを実
行することをお勧めします。
メモリ関連の問題を回避するには、アプリケーションを導入する前にメモリ設定を調節します。次のよ
うな推奨値で JBOSS_DIST /jboss-as/server/production/run.conf ファイルにある
JAVA_OPT S 設定の更新を行うと調節することができます。
-Xms1303m -Xmx1303m -XX:PermSize=256m -XX:MaxPermSize=256m
7.3. インストール後のセキュリティ設定
zip アーカイブからインストールした場合、すべての JBoss サービスは管理サービスも含めてほとんどの
JBoss サービスにアクセスするために認証が必要になっています。また、ユーザーアカウントは作成さ
れていません。デフォルトのユーザー / パスワードベースの攻撃を阻止するためにこのようになっていま
す。
次を変更して jm x-console と invoker のアカウントをセットアップします。
$JBOSS_HOME/server/$CONFIG/conf/props/jmx-console-users.properties
次を変更して web-console ユーザーのアカウントをセットアップします。
16
第7章インストール後の設定
$JBOSS_HOME/server/$CONFIG/deploy/management/console-mgr.sar/
web-console.war/WEB-INF/classes/web-console-users.properties
$JBOSS_HOME はインストールディレクトリで、 $CONFIG は使用されるサーバー設定です。
7.4. 認証を無効にする
特定のサービスで認証を無効にすることもできます。以下のセクションで指定されるパスはすべて
$JBOSS_HOME に相対となります。
JXM Console 認証の無効化 :
JXM Console の認証を無効にするには、次のファイルを編集して security-constraint のセクションをコ
メントアウトします。
server/$CONFIG/deploy/jmx-console.war/WEB-INF/web.xml
次の部分をコメントアウトします。
<security-constraint>
<web-resource-collection>
<web-resource-name>HtmlAdaptor</web-resource-name>
<description>An example security config that only allows
users with the
role JBossAdmin to access the HTML JMX console web application
</description>
<url-pattern>/*</url-pattern>
<http-method>GET</http-method>
<http-method>POST</http-method>
</web-resource-collection>
<auth-constraint>
<role-name>JBossAdmin</role-name>
</auth-constraint>
</security-constraint>
Web Console 認証の無効化 :
Web Console の認証を無効にするには、次のファイルを編集して security-constraint のセクションをコ
メントアウトします。
server/$CONFIG/deploy/management/console-mgr.sar/web-console.war/WEB-INF/web.xml
次の部分をコメントアウトします。
17
JBoss Enterprise Application Platform 4.2 インストールガイド
<security-constraint>
<web-resource-collection>
<web-resource-name>HtmlAdaptor</web-resource-name>
<description>An example security config that only allows
users with the role JBossAdmin to access the HTML JMX console web application
</description>
<url-pattern>/*</url-pattern>
<http-method>GET</http-method>
<http-method>POST</http-method>
</web-resource-collection>
<auth-constraint>
<role-name>JBossAdmin</role-name>
</auth-constraint>
</security-constraint>
HT T P Invoker 認証の無効化 :
HT T P Invoker の認証を無効にするには、次のファイル内のセキュリティ範囲から JNDIFactory、
EJBInvokerServlet、 JMXInvokerServlet を削除する必要があります
server/$CONFIG/deploy/httpha-invoker.sar/invoker.war/WEB-INF/web.xml
たとえば、 security-constraint のエレメントは次のようになります。
<security-constraint>
<web-resource-collection>
<web-resource-name>HttpInvokers</web-resource-name>
<description>An example security config that only allows
users with the role HttpInvoker to access the HTTP invoker servlets
</description>
<url-pattern>/restricted/*</url-pattern>
<http-method>GET</http-method>
<http-method>POST</http-method>
</web-resource-collection>
<auth-constraint>
<role-name>HttpInvoker</role-name>
</auth-constraint>
</security-constraint>
JMX Invoker 認証の無効化 :
JMX Invoker の認証を無効にするには、次のファイルを編集してセキュリティインターセプタのパスス
ルーをコメントアウトします。
server/$CONFIG/deploy/jmx-invoker-service.xml
org.jboss.jm x.connector.invoker.InvokerAdaptorService クラスを持つ mbean セクショ
ンをさがします。そのセクションで認証されるユーザーに関連する行をコメントアウトします。
18
第7章インストール後の設定
<descriptors>
<interceptors>

<interceptor
code="org.jboss.jmx.connector.invoker.AuthenticationInterceptor"
securityDomain="java:/jaas/jmx-console"/>

<interceptor
code="org.jboss.jmx.connector.invoker.SerializableInterceptor"
policyClass="StripModelMBeanInfoPolicy"/>
</interceptors>
</descriptors>
19
JBoss Enterprise Application Platform 4.2 インストールガイド
第 8章 JBoss のアンインストール
JBoss Enterprise Application Platform のインストールに GUI インストーラを使用した場合は、自動アン
インストーラもインストールされています。インストール時に作成されていれば、 GUI で JBoss プログ
ラムグループからアンインストーラを選択することができます。もう 1 つのオプションは、アンインス
トーラをコマンドラインから実行することです。 JBoss Enterprise Application Platform インストール
ディレクトリ内に Uninstaller と言う名前のディレクトリがあります。 Uninstaller ディレクトリ
内には、uninstaller. jar と言う名前の jar ファイルがあります。コマンドラインから jar ユー
ティリティを使用してアンインストーラを実行します。
[vsr]$ java -jar uninstaller.jar
このコマンドがアンインストーラプログラムを開始します。インストールディレクトリとその内容全てを
削除したい場合は、 "Force the deletion of <installation_directory>" と言うチェックボックスを選択して
アンインストールボタンをクリックします。
図 8.1 アンインストーラ
使用できるアンインストーラがなく、 JBoss Enterprise Application Platform が zip ファイルでインス
トールされている場合、単にインストールされた JBoss Enterprise Application Platform ディレクトリを
削除することでアンインストールが行えます。
20
第9章インストールのテスト
第 9章インストールのテスト
JBoss Enterprise Application Platform をインストールしたら、簡単なスタートアップテストをして Java
VM とオペレーティングシステムの組み合わせに大きな問題がないことを確認した方がよいでしょう。
Post_Installation_Configuration にあるように JBOSS_HOME を設定していることを確認します。インス
トールをテストするには、 JBOSS_DIST /jboss-as/bin ディレクトリに移動して使用中のオペレー
ティングシステムに応じて run.bat スクリプト (Windows 用) または run.sh スクリプト (Linux 用) を
実行します。次のような出力になり (インストールディレクトリの相違はあります)、エラーや例外メッ
セージはないはずです。
21
JBoss Enterprise Application Platform 4.2 インストールガイド
[vrenish@vinux bin]$ ./run.sh
=====================================================
JBoss Bootstrap Environment
JBOSS_HOME: /home/vrenish/jboss-eap-4.2/jboss-as
JAVA: /usr/java/jdk1.5.0_11/bin/java
JAVA_OPTS: -Dprogram.name=run.sh -server -Xms1503m -Xmx1503m -Dsun.rmi.dgc.cli
ent.gcInterval=3600000
-Dsun.rmi.dgc.server.gcInterval=3600000 -Djava.net.prefer
IPv4Stack=true
CLASSPATH: /home/vrenish/jboss-eap-4.2/jboss-as/bin/run.jar:/u
sr/java/jdk1.5.0_11/lib/tools.jar
=====================================================
18:45:49,550 INFO [Server] Starting JBoss (MX MicroKernel)...
18:45:49,551 INFO [Server] Release ID: JBoss [EAP] 4.2.0.GA_CP01 (build: SVNTag
=JBPAPP_4_2_0_GA_CP01
date=200708310047)
18:45:49,584 INFO
18:45:49,584 INFO
18:45:49,617 INFO
18:45:49,617 INFO
18:45:49,685 INFO
[Server]
[Server]
[Server]
[Server]
[Server]
Home Dir: /home/vrenish/jboss-eap-4.2/jboss-as
Home URL: file:/home/vrenish/jboss-eap-4.2/jboss-as/
Patch URL: null
Server Name: production
Server Home Dir:
/home/vrenish/jboss-eap-4.2/jboss-
as/server/production
18:45:49,686 INFO [Server] Server Home URL:
file:/home/vrenish/jboss-eap-4.2/jbossas/server/production/
18:45:49,686 INFO [Server] Server Log Dir:
/home/vrenish/jboss-eap-4.2/jbossas/server/production/log
18:45:49,726 INFO [Server] Server Temp Dir:
/home/vrenish/jboss-eap-4.2/jbossas/server/production/tmp
18:45:49,726 INFO [Server] Root Deployment Filename: jboss-service.xml
18:45:50,449 INFO [ServerInfo] Java version: 1.5.0_11,Sun Microsystems Inc.
18:45:50,449 INFO [ServerInfo] Java VM: Java HotSpot(TM) Server VM 1.5.0_11-b03
,Sun Microsystems Inc.
18:45:50,449 INFO [ServerInfo] OS-System: Linux 2.6.9-42.0.3.EL,i386
18:45:51,824 INFO [Server] Core system initialized
18:45:59,622 INFO [WebService] Using RMI server codebase: http://127.0.0.1:8083 /
18:45:59,659 INFO [Log4jService$URLWatchTimerTask] Configuring from URL: resour
ce:jboss-log4j.xml
注記
他の指定がない時にデフォルトとなる production プロフィールを使用してサーバーを開始した
場合、コンソールに「Server Started」と言うメッセージは表示されないので注意してください。
このメッセージは、 server/production/log サブディレクトリにある server.log ファイ
ル内で見ることができます。
22
第9章インストールのテスト
ここで、 web ブラウザ内で http://localhost:8080 を開きます。 (マシン上でこのポートを使用す
るものが他にないことを確認してください)。
ンストールのテスト」。
[2]
ページの内容は以下に似たものになります。図9.1「イ
図 9.1 インストールのテスト
これで JBoss Enterprise Application Platform を使用できる準備が整いました。プラットフォームのレイ
アウトや JBoss の機能をご覧になれるサンプルアプリケーションの詳細は「スタートガイド」を参照して
ください。
[2] 一部のマシンでは、 lo c alho s t が正しく解決されないため、代わりにローカルループバックアドレス 127.0 .0 .1 を使用する必要があります。
23
JBoss Enterprise Application Platform 4.2 インストールガイド
改訂履歴
改訂 1.0-2.1.4 00
2013-10-30
Landmann Rüdiger [FAMILY
Given]
Mon Oct 22 2012
Landmann Ruediger [FAMILY
Given]
Rebuild with publican 4.0.0
改訂 1.0-2.1
T ranslation files synchronised with XML sources 1.0-2
改訂 1.0-2
Port to Publican 3.0
24
Sat Oct 13 2012
Landmann Rüdiger [FAMILY
Given]

Download Report