JBoss Enterprise Application Platform 6.4 スタートガイド

JBoss Enterprise Application
Platform 6.4
スタートガイド
Red Hat JBoss Enterprise Application Platform 6 向け
Nidhi Chaudhary
Sande Gilda
Darrin Mison
Misty Stanley-Jones
Lucas Costi
Vikram Goyal
Scott Mumford
Keerat Verma
Russell Dickenson
Eamon Logue
David Ryan
Tom Wells
JBoss Enterprise Application Platform 6.4 スタートガイド
Red Hat JBoss Enterprise Application Platform 6 向け
Nidhi Chaudhary
Lucas Co sti
Russell Dickenso n
Sande Gilda
Vikram Go yal
Eamo n Lo gue
Darrin Miso n
Sco tt Mumfo rd
David Ryan
Misty Stanley-Jo nes
Keerat Verma
To m Wells
法律上の通知
Co pyright © 20 15 Red Hat, Inc..
This do cument is licensed by Red Hat under the Creative Co mmo ns Attributio n-ShareAlike 3.0
Unpo rted License. If yo u distribute this do cument, o r a mo dified versio n o f it, yo u must pro vide
attributio n to Red Hat, Inc. and pro vide a link to the o riginal. If the do cument is mo dified, all Red
Hat trademarks must be remo ved.
Red Hat, as the licenso r o f this do cument, waives the right to enfo rce, and agrees no t to assert,
Sectio n 4 d o f CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shado wman lo go , JBo ss, MetaMatrix, Fedo ra, the Infinity
Lo go , and RHCE are trademarks o f Red Hat, Inc., registered in the United States and o ther
co untries.
Linux ® is the registered trademark o f Linus To rvalds in the United States and o ther co untries.
Java ® is a registered trademark o f Oracle and/o r its affiliates.
XFS ® is a trademark o f Silico n Graphics Internatio nal Co rp. o r its subsidiaries in the United
States and/o r o ther co untries.
MySQL ® is a registered trademark o f MySQL AB in the United States, the Euro pean Unio n and
o ther co untries.
No de.js ® is an o fficial trademark o f Jo yent. Red Hat So ftware Co llectio ns is no t fo rmally
related to o r endo rsed by the o fficial Jo yent No de.js o pen so urce o r co mmercial pro ject.
The OpenStack ® Wo rd Mark and OpenStack Lo go are either registered trademarks/service
marks o r trademarks/service marks o f the OpenStack Fo undatio n, in the United States and o ther
co untries and are used with the OpenStack Fo undatio n's permissio n. We are no t affiliated with,
endo rsed o r spo nso red by the OpenStack Fo undatio n, o r the OpenStack co mmunity.
All o ther trademarks are the pro perty o f their respective o wners.
概要
本書は、JBo ss EAP 6 を初めて使用する場合の基本的な手順を提供します。
目次
目次
.前書き
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3. . . . . . . . . .
⁠1. 本書の表記規則
3
⁠1.1. 書体の表記規則
3
⁠1.2. 引用文の表記規則
4
⁠1.3. 注記および警告
5
⁠2 . ヘルプとフィードバック
5
⁠2 .1. ヘルプ
⁠2 .2. フィードバック
5
6
. . 1. 章
⁠第
. . はじめに
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7. . . . . . . . . .
⁠1.1. Red Hat JBo s s Enterp ris e Ap p lic atio n Platfo rm 6
7
⁠1.2. Red Hat カスタマーポータルについて
7
⁠1.3. Red Hat JBo s s Develo p er Pro g ram について
7
⁠1.4. Full Red Hat JBo s s Co mmerc ial Pro g ram について
7
⁠1.5. 詳細情報の見つけ方
8
. . 2. 章
⁠第
. . 前提条件
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9. . . . . . . . . .
⁠2 .1. JBo s s EAP 6 インストールの要件
9
. . 3章
⁠第
. . . 製品のダウンロードおよびインストール
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. 0. . . . . . . . . .
⁠3 .1. JBo s s EAP インストールの概要
⁠3 .2. グラフィカルインストールプログラムを使用した JBo s s EAP のダウンロードおよびインストール
10
10
⁠3 .2.1. JBo s s EAP 6 Ins tallatio n Pro g ram のダウンロード
⁠3 .2.2. JBo s s EAP インストールプログラムの実行
⁠3 .3. ZIP を使用した JBo s s EAP のダウンロードおよびインストール
10
11
12
⁠3 .3.1. JBo s s EAP 6 (ZIP インストール) のダウンロード
⁠3 .3.2. JBo s s EAP 6 のインストール (ZIP インストール)
⁠3 .4. クイックスタートコードサンプルのダウンロード
⁠3 .4.1. クイックスタートのダウンロード
13
13
14
14
. . 4. 章
⁠第
. . インストール後の手順
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. 6. . . . . . . . . .
⁠4 .1. 開発環境の設定
⁠4 .1.1. Red Hat JBo s s Develo p er Stud io のインストールの概要
⁠4 .1.2. Red Hat JBo s s Develo p er Stud io のダウンロード
⁠4 .1.3. Red Hat JBo s s Develo p er Stud io のインストール
⁠4 .1.4. Red Hat JBo s s Develo p er Stud io の起動
⁠4 .1.5. Define New Server を使用した JBo s s EAP Server の追加
⁠4 .2. Maven の設定
⁠4 .2.1. Maven について
⁠4 .2.2. Maven の設定
⁠4 .2.3. Red Hat JBo s s Develo p er Stud io 向け Maven の設定
⁠4 .2.3.1. Red Hat JBo s s Develo p er Stud io 向け Maven の設定
⁠4 .2.4. コマンドライン向け Maven の設定
⁠4 .2.4.1. Maven のダウンロードとインストール
⁠4 .2.4.2. コマンドラインでの使用向け Maven 設定
16
16
16
16
17
17
23
23
23
24
24
27
27
28
. . 5章
⁠第
. . . 実践
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
...........
⁠5 .1. クイックスタートの実行
33
⁠5 .1.1. Red Hat JBo s s Develo p er Stud io でのクイックスタートの実行
33
⁠5 .1.2. コマンドラインを使用したクイックスタートの実行
40
.インストールプログラムのスクリーンショット
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4. 1. . . . . . . . . .
⁠A .1. 言語の選択
41
⁠A .2. 使用許諾契約書
41
1
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
⁠A .2. 使用許諾契約書
⁠A .3. インストールパス
⁠A .4. インストールするパックの選択
41
42
43
⁠A .5. 管理ユーザーの作成
⁠A .6 . クイックスタートのインストール
⁠A .7. Maven リポジトリーのセットアップ
⁠A .8 . ソケットバインディングのセットアップ
44
45
46
47
⁠A .9 . サーバーの起動
⁠A .10 . ロギングレベルの設定
⁠A .11. ランタイム環境の設定
⁠A .12. インストールコンポーネントの確認
⁠A .13. インストールの進捗
48
49
50
51
52
⁠A .14. インストール処理の完了
⁠A .15. ショートカットの作成
⁠A .16 . インストールスクリプトの生成
53
54
55
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
改訂履歴
...........
2
前書き
前書き
1. 本書の表記規則
本ガイドでは、一部の単語や語句を強調して、特定の情報に対する読者の注意を促すために、以下のような
表記規則を採用しています。
1.1. 書体の表記規則
本ガイドでは、特定の単語や語句に対する注意を促すために、4 つの書体表記規則を採用しています。これ
らの表記規則および適用される状況は、以下のとおりです。
太字の等幅フォント
シェルコマンド、ファイル名、パスなど、システムへの入力を強調するために使用します。また、キー名や
キーの組み合わせを強調するのにも使用します。以下が例となります。
作業ディレクトリ内の my_next_bestsel l i ng _no vel というファイルの内容を表示す
るには、シェルプロンプトで cat my_next_bestsel l i ng _no vel というコマンドを
入力して Enter キーを押し、そのコマンドを実行します。
上記の例には、ファイル名、シェルコマンド、キー名が含まれており、すべて太字の等幅フォントで表示さ
れていますが、文脈で区別することができます。
キーの組み合わせは、プラス記号 (+) で各キーがつながれているので、個別のキーと区別することができま
す。以下が例となります。
Enter を押してコマンドを実行します。
C trl +Al t+F2 を押して仮想ターミナルに切り替えます。
第 1 の例では、押すべき特定のキー名が強調されています。第 2 の例では、3 つのキーを同時に押す、キー
の組み合わせが強調されています。
ソースコードを記載する場合、その段落で言及されるクラス名、メソッド、関数、変数名、戻り値は上記の
ように太字の等幅フォントで表示されます。以下が例となります。
ファイル関連のクラスには、fi l esystem (ファイルシステム)、fi l e (ファイル)、d i r
(ディレクトリ) などがあります。各クラスにそれぞれ独自のパーミッションセットが関連
付けられています。
太字の可変幅フォント
この書体は、アプリケーション名、ダイアログボックスのテキスト、ラベル付きボタン、チェックボック
ス/ラジオボタンのラベル、メニュータイトル、サブメニュータイトルなど、システムで表示される単語や
語句であることを示します。以下が例となります。
メインメニューバーからシステム → 設定 → マウスの順で選択し、マウスの設定を起動し
ます。全般タブで左利きのラジオボタンを選択して閉じるをクリックし、マウスの主
ボタンを左から右へ切り替えます (左利きのユーザーが使用するのに適切な設定に変更しま
す)。
g ed it ファイルに特殊文字を入力するには、メインのメニューバーからアプリケーション
→ アクセサリ → 文字マップの順に選択します。次に文字マップのメニューバーから検
索 → 検索… の順に選択して検索フィールドに文字名を入力し、次を検索をクリックしま
す。検索対象の文字が文字テーブルに強調表示されます。その文字をダブルクリックし
3
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
てコピーする文字列のフィールドに表示されたら、コピーボタンをクリックします。こ
の後に編集中のドキュメントに戻り、g ed it のメニューバーから編集 → 貼り付けの順で
選択します。
上記のテキストには、アプリケーション名、システム全体のメニュー名と項目、アプリケーション固有のメ
ニュー名、GUI インターフェースで使用されているボタンおよびテキストが含まれており、これらはすべ
て、太字の可変幅フォントで表示されていますが、文脈で区別することができます。
太字斜体の等幅フォントまたは太字斜体の可変幅フォント
太字の等幅フォントおよび太字の可変幅フォントに斜体を使用した場合には、いずれも置き換え可能な可変
テキストであることを意味します。斜体は、記載されている通りには入力しないテキスト、あるいは状況に
よって変化するテキストを示します。以下が例となります。
ssh を使用してリモートマシンに接続するには、シェルプロンプトで ssh
username@ domain.name と入力します。リモートマシンが exampl e. co m で、そのマ
シン上のユーザー名が john である場合には、ssh jo hn@ exampl e. co m と入力してく
ださい。
mo unt -o remo unt file-system のコマンドは、指定したファイルシステムを再マ
ウントします。たとえば、/ho me ファイルシステムを再マウントするコマンドはmo unt
-o remo unt /ho me となります。
現在インストール済みのパッケージのバージョンを確認するには、rpm -q package の
コマンドを使用します。その結果、次のような出力が返されます: package-versionrelease
ユーザー名、ドメイン名、ファイルシステム、パッケージ、バージョン、およびリリースが太字のイタ
リック体で表示されている点に注意してください。これらの語句はプレースホルダーで、コマンドを発行す
る際に入力するテキストまたはシステムによって表示されるテキストのいずれかです。
斜体は、著作物のタイトルを表すという標準的な用途の他に、重要な用語の初出時にも使用されます。以下
が例となります。
Publican は DocBook の出版システムです。
1.2. 引用文の表記規則
端末の出力とソースコードは、周囲のテキストとは視覚的に区切られて表示されます。
端末に送信される出力は、ローマン体の等幅フォントを使用して以下のように表示されます。
books
books_tests
Desktop
Desktop1
documentation drafts mss
downloads
images notes
photos
scripts
stuff
svgs
svn
ソースコードの表示にもローマン体の等幅フォントが使用されますが、以下のような構文強調表示が追
加されます。
static int kvm_vm_ioctl_deassign_device(struct kvm *kvm,

struct kvm_assigned_pci_dev *assigned_dev)

{

int r = 0;

struct kvm_assigned_dev_kernel *match;
4

mutex_lock(& kvm->lock);

match = kvm_find_assigned_dev(& kvm->arch.assigned_dev_head,
前書き

assigned_dev->assigned_dev_id);
if (!match) {
printk(KERN_INFO "%s: device hasn't been assigned

before, "

"so cannot be deassigned\n", __func__);
r = -EINVAL;
goto out;

}

kvm_deassign_device(kvm, match);

kvm_free_assigned_device(kvm, match);
o ut:

mutex_unlock(& kvm->lock);
return r;

}
1.3. 注記および警告
本ガイドでは、見落としがちな情報に注意を促すために、次にあげる 3 つの視覚的スタイルを使用していま
す。
注記
注記には、対象のタスクに関するヒント、ショートカット、その他のアプローチなどを記載してい
ます。注記を無視しても、悪影響はありませんが、作業を効率的に行うためのコツを見逃してしまう
可能性があります。
重要
重要の欄には、現行セッションのみに適用される設定の変更や、更新を適用するのに再起動が必要
なサービスなど、見落としがちな情報を記載しています。「重要」と記載された事項を無視しても、
データ損失などには至りませんが、作業が思ったようにスムーズに進まなくなる可能性があります。
警告
警告は、無視しないでください。警告を無視すると、データ損失が発生する可能性が非常に高くなり
ます。
2. ヘルプとフィードバック
2.1. ヘルプ
本ガイドに記載されている手順で問題が発生した場合には、Red Hat カスタマーポータル
(http://access.redhat.com) をご利用ください。カスタマーポータルでは、以下のような機能を提供してい
ます。
5
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
Red Hat 製品に関する技術情報のナレッジベース記事の検索、閲覧
Red Hat グローバルサポートサービス (GSS) へのサポートケース提出
その他の製品ドキュメントの参照
Red Hat では、Red Hat のソフトウェアおよびテクノロジーに関するディスカッションの場として、数多
くのメーリングリストをホストしています。一般公開されているメーリングリストの一覧
は、https://www.redhat.com/mailman/listinfo に記載しています。各メーリングリストをクリックすると、
そのメーリングリストをサブスクライブしたり、アーカイブを参照したりすることができます。
2.2. フィードバック
本ガイドで誤字、脱字を発見された場合、または内容を改善するためのご意見、ご提案がございましたら、
弊社にご連絡いただくようお願いします。バグレポートは、Bugzilla (http://bugzilla.redhat.com/) から製
品に JBoss Enterprise Application Platform を選択して提出してください。
バグレポートを提出される時には、ガイドの識別子: Getting_Started_Guide を必ずご指定いただくようお願
いします。
本ガイドを改善するためのご意見、ご提案をお寄せいただく場合には、可能な限り具体的に説明してくださ
い。また、エラーを発見された場合は、弊社で対象箇所を容易に見つけることができるように、そのセク
ション番号と該当部分の前後の文章も含めてご報告いただくようお願いします。
6
⁠第1 章はじめに
第1章はじめに
1.1. Red Hat JBoss Ent erprise Applicat ion Plat form 6
Red Hat JBoss Enterprise Application Platform 6 (JBoss EAP 6) は、オープンな標準に基いて構築さ
れ、Java Enterprise Edition 6 の仕様に準拠するミドルウェアプラットフォームです。高可用性クラスタ
リング、メッセージング、分散キャッシングなどの技術が JBoss Application Server 7 と統合されます。
JBoss EAP 6 には、必要な場合にだけサービスを有効にできる新しいモジュール構造が含まれます (サービ
スの起動時間が短縮されます)。
管理コンソールと管理コマンドラインインターフェースにより、XML 設定ファイルの編集が不必要にな
り、タスクをスクリプト化および自動化する機能が追加されました。
また、JBoss EAP 6 には、セキュアでスケーラブルな Java EE アプリケーションの迅速な開発を可能にす
る API と開発フレームワークが含まれます。
バグを報告する
1.2. Red Hat カスタマーポータルについて
Red Hat カスタマーポータルは、Red Hat のナレッジリソースやサブスクリプションリソースを管理する集
中プラットフォームです。Red Hat カスタマーポータルでは、以下のことを行えます。
Red Hat エンタイトルメントやサポート契約の管理および維持。
正式サポートされたソフトウェアのダウンロード。
製品ドキュメントや Red Hat ナレッジベースの利用。
グローバルサポートサービスへの連絡。
Red Hat 製品のバグの登録。
カスタマーポータルは https://access.redhat.com からアクセスしてください。
バグを報告する
1.3. Red Hat JBoss Developer Program について
Red Hat JBoss D eveloper Program (「Program」) により、開発のために特定の Red Hat サブスクリプ
ションを無料でデプロイすることが可能になります。この Program で提供される Red Hat サブスクリプ
ションは、サポート対象ではなく、既知のセキュリティー脆弱性が解決されないことがあります。開発目的
のためにのみ使用でき、本番稼働環境での使用やアクティブな Red Hat サブスクリプションなしでのアッ
プデートへのアクセスなどの他の目的を対象としていません。Red Hat JBoss D eveloper Program の完全
な詳細については、http://www.jboss.org/developer-program/termsandconditions を参照してください。
バグを報告する
1.4 . Full Red Hat JBoss Commercial Program について
Full Red Hat JBoss Commercial Program では、本番稼働環境へのデプロイが可能になります。また、ソ
フトウェアアップデートおよびパッチに対する追加エンタイトルメント、サポートサービス、および Red
Hat ナレッジベースへのアクセスが提供されます。Program に参加するには、カスタマーポータル
7
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
(https://access.redhat.com/) でアカウントを作成する必要があります。この Program の詳細について
は、「Red Hat カスタマーポータルについて」を参照してください。
バグを報告する
1.5. 詳細情報の見つけ方
本書の目的は、ユーザーが Red Hat JBoss Enterprise Application Platform をできるだけ早く使用できる
ようにすることです。さらに学びたい場合は、カスタマーポータル
(https://access.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform) で
JBoss EAP 向けの完全なドキュメンテーションセットを利用してください。
バグを報告する
8
⁠第2 章前提条件
第2章前提条件
2.1. JBoss EAP 6 インストールの要件
概要
JBoss EAP は、Red Hat JBoss D eveloper Program または Full Red Hat JBoss Commercial Program
で取得できます。Red Hat JBoss D eveloper Program の詳細については、「Red Hat JBoss D eveloper
Program について」を参照してください。Full Red Hat JBoss Commercial Program の詳細について
は、「Full Red Hat JBoss Commercial Program について」を参照してください。以下の手順は、両方の
Program の前提条件を示しています。
一般的な要件
サポート対象の設定を確認し、ご使用のシステムがサポートされるようにしてください
(https://access.redhat.com/site/articles/111663を参照)。
Red Hat カスタマーポータルでアカウントをセットアップし、Full Red Hat JBoss Commercial
Program に参加している場合は、システムが Red Hat 発行のアップデートとエラータで更新されてい
ることを確認してください。
Z IP またはインストーラーの要件
インストールディレクトリーに管理権限を付与する必要があります。
選択した JD K が展開 (またはインストール) されていることを確認してください。展開およびインス
トール方法については、JD K のドキュメントを参照してください。
Microsoft Windows Server では、JAVA_HOME および PATH 環境変数が設定されていることを確認し
ます。設定されていないと、ショートカットが動作しません。
Hewlett-Packard HP-UX では、unzi p ユーティリティーがインストールされていることを確認しま
す。
バグを報告する
9
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
第3章製品のダウンロードおよびインストール
3.1. JBoss EAP インストールの概要
本書では、JBoss EAP をできるだけ早く使用できるように最も単純なインストールプロセスの手順につい
て説明します。完全なインストール手順は、JBoss EAP 向けのインストールガイドに記載されています。
JBoss EAP のインストール後に、管理 CLI または管理コンソールを使用してサーバーを設定できます。
JBoss EAP の設定方法については、JBoss EAP 向け管理および設定ガイドを参照してください。両方のガ
イドは、カスタマーポータル
(https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/) で利用できま
す。
JBoss EAP は、次のいずれかの方法でインストールできます。
グラフィカルインストールプログラムを使用して JBoss EAP をインストールします。
Z IP ファイルを使用して JBoss EAP をインストールします。
好きなインストール方法に基づいた手順を実行します。
バグを報告する
3.2. グラフィカルインストールプログラムを使用した JBoss EAP のダウン
ロードおよびインストール
3.2.1. JBoss EAP 6 Inst allat ion Program のダウンロード
概要
JBoss EAP は、Red Hat JBoss D eveloper Program または Full Red Hat JBoss Commercial Program
で取得できます。Program に応じて以下の手順を選択し、実行してください。
手順3.1 Fu ll R ed H at JB o ss C o mmercial Pro g ram でのカスタマーポータルからの JB o ss EAP イ
ンストールプログラムのダウンロード
この手順は、Full Red Hat JBoss Commercial Program に参加している場合に実行します。このプログラ
ムの詳細については、「Full Red Hat JBoss Commercial Program について」を参照してください。
1. ブラウザーを開き、カスタマーポータル (https://access.redhat.com) にログインします。
2. ダウンロードをクリックします。
3. P ro d uct D o wnl o ad s リストで R ed Hat JBo ss Enterpri se Appl i cati o n
P l atfo rm をクリックします。
4. Versi o n ドロップダウンメニューから正しい JBoss EAP のバージョンを選択します。
5. リストで R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm 6 . x.x Instal l er
を見つけ、D o wnl o ad オプションをクリックします。
6. ディレクトリーに JAR ファイルを保存するよう促されます。ディレクトリーを選択し、ファイル
を保存します。
手順3.2 R ed H at JB o ss D evelo p er Pro g ram での jb o ss.o rg からの JB o ss EAP インストールプ
ログラムのダウンロード
10
⁠第3章製品のダウンロードおよびインストール
この手順は、Red Hat JBoss D eveloper Program に参加している場合に実行します。このプログラムの詳
細については、「Red Hat JBoss D eveloper Program について」を参照してください。
1. ブラウザーを開き、URL http://www.jboss.org/products/eap にアクセスします。
A. 現在の GA 出荷バージョンの製品向けインストールプログラムをダウンロードするには、ページ
の右側にある D o wnl o ad ボタンをクリックします。
B. 次の手順に従って別のバージョン (最新のアルファまたはベータリリースおよび以前のバージョ
ンの製品を含む) を選択します。
a. ページの左側にある D o wnl o ad JBo ss EAP リンクをクリックします。
b. 適切な製品バージョンの D o wnl o ad 列以下の Instal l er リンクをクリックしま
す。
2. ディレクトリーに JAR ファイルを保存するよう促されます。ディレクトリーを選択し、ファイル
を保存します。
結果
JBoss EAP 6 インストールプログラム JAR ファイルが、ターゲットマシンに正しくダウンロードされま
す。
バグを報告する
3.2.2. JBoss EAP インストールプログラムの実行
JBoss EAP インストールプログラムは、グラフィカルモードまたはテキストモードで実行できます。この
トピックでは、グラフィカルモードでインストールプログラムを実行するコマンドについて説明します。
オプションについてわからない場合は、デフォルト値を使用してください。サーバーは後で簡単に設定でき
ます。JBoss EAP サーバーの設定方法の詳細については、カスタマーポータルにある Red Hat JBoss
Enterprise Application Platform 6 向け管理および設定ガイド
(https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/) を参照してく
ださい。
手順3.3 JB o ss EAP インストールプログラムの実行
1. ターミナルを開き、ダウンロードされたインストールプログラム JAR を含むディレクトリーに移動
します。
2. 以下のコマンドを入力します。
java -jar jboss-eap-6.x.x-installer.jar
3. 以下の表の手順を実行します。
表3.1 JB o ss EAP インストールプログラムの画面
画面の名前
表示されるタイミング
説明
「言語の選択」
常時
インストールプログラムの言語を選択し、O K をク
リックします。
11
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
画面の名前
表示されるタイミング
説明
「使用許諾契約書」
常時
RED HAT JBOSS MID D LEWARE の EULA。
「I accept the terms of this license agreement (ラ
イセンス契約の内容に同意します)」を選択
し、Next をクリックします。
「インストールパス」
常時
JBoss EAP のインストールパスを選択し、Next
をクリックします。新しいディレクトリーを作成す
るか、指定されたディレクトリーを置き換える
(ディレクトリーが存在する場合) よう求められま
す。
「インストールするパッ常時
インストールするパックを選択します。必須パック
クの選択」
は選択解除できません。
「管理ユーザーの作成」常時
管理ユーザーを作成し、パスワードを割り当てま
す。次に、Next をクリックします。
「クイックスタートのイ常時
クイックスタートサンプルをインストールしま
ンストール」
す。Y es を選択し、インストールパスを選択しま
す。次に、Next をクリックします。
「Maven リポジトリークイックスタートサンプデフォルトの選択を維持して、デフォルトの
のセットアップ」
ルのインストールを選択 Maven 設定を自動的に指定し、パブリックにホス
したとき
トされた Maven リポジトリーを使用します。次
に、Next をクリックします。
「ソケットバインディ
常時
デフォルトのポートバインディングを保持
ングのセットアップ」
し、Next をクリックします。
「サーバーの起動」
常時
インストールプロセスの完了時に任意の起動オプ
ションを選択します。次に、Next をクリックしま
す。
「ロギングレベルの設
常時
No を選択してロギングレベルの設定を省略しま
定」
す。次に、Next をクリックします。
「ランタイム環境の設
常時
P erfo rm d efaul t co nfi g urati o n を選択
定」
し、Next をクリックして作業を続行します。
「インストールコンポー常時
選択を確認し、Next をクリックします。
ネントの確認」
「インストールの進捗」常時
インストールが完了すると、Next をクリックしま
す。
「インストール処理の完常時
処理が完了したら、Next をクリックします。
了」
「ショートカットの作
常時
デフォルト値を受け入れ、Next をクリックしま
成」
す。
「インストールスクリプ常時
D o ne をクリックします。
トの生成」
インストールが完了します。
結果
インストールが完了し、ターゲットマシンに JBoss EAP 6 がインストールされます。
バグを報告する
3.3. ZIP を使用した JBoss EAP のダウンロードおよびインストール
12
⁠第3章製品のダウンロードおよびインストール
3.3.1. JBoss EAP 6 (ZIP インストール) のダウンロード
概要
JBoss EAP は、Red Hat JBoss D eveloper Program または Full Red Hat JBoss Commercial Program
で取得できます。Program に応じて以下の手順を選択し、実行してください。
手順3.4 Fu ll R ed H at JB o ss C o mmercial Pro g ram でのカスタマーポータルからの Z IP ファイルの
ダウンロード
この手順は、Full Red Hat JBoss Commercial Program に参加している場合に実行します。このプログラ
ムの詳細については、「Full Red Hat JBoss Commercial Program について」を参照してください。
1. ブラウザーを開き、Red Hat カスタマーポータル (https://access.redhat.com) にログインします。
2. ダウンロードをクリックします。
3. P ro d uct D o wnl o ad s リストで R ed Hat JBo ss Enterpri se Appl i cati o n
P l atfo rm をクリックします。
4. Versi o n ドロップダウンメニューから正しい JBoss EAP のバージョンを選択します。
5. リストで R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm 6 . x.x を見つ
け、D o wnl o ad オプションをクリックします。
6. ディレクトリーに Z IP ファイルを保存するよう促されます。ディレクトリーを選択し、ファイルを
保存します。
手順3.5 R ed H at JB o ss D evelo p er Pro g ram での jb o ss.o rg からの Z IP ファイルのダウンロード
この手順は、Red Hat JBoss D eveloper Program に参加している場合に実行します。このプログラムの詳
細については、「Red Hat JBoss D eveloper Program について」を参照してください。
1. Web ブラウザーを開き、URL http://www.jboss.org/products/eap/ にアクセスします。
2. ページの左側にある D o wnl o ad JBo ss EAP リンクをクリックします。
3. 適切な製品バージョンの D o wnl o ad 列以下の ZIP
リンクをクリックします。
4. ディレクトリーに Z IP ファイルを保存するよう促されます。ディレクトリーを選択し、ファイルを
保存します。
結果
JBoss EAP 6 Z IP ファイルが、ターゲットマシンに正しくダウンロードされます。
バグを報告する
3.3.2. JBoss EAP 6 のインストール (ZIP インストール)
概要
ここでは、ダウンロードした Z IP ファイルを使用して JBoss EAP 6 をインストールする手順を説明しま
す。
手順3.6 Z IP ファイルのインストール
1. Z IP アーカイブを希望の場所に移動します。
13
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
Z IP ファイルを、JBoss EAP 6 をインストールするサーバーとディレクトリーに移動します。サー
バーを起動および停止するユーザーは、このディレクトリーへの読み書きアクセス許可を持ってい
る必要があります。
2. 適切なアプリケーションを使用して Z IP アーカイブを希望の場所に展開します。
Red Hat Enterprise 環境では、unzi p ユーティリティーを使用して Z IP アーカイブの内容を抽出
します。
Microsoft Windows の環境では、ファイルを右クリックし、Extract Al l (すべて展開 ) を選
択します。
Hewlett-Packard HP-UX 環境では、unzi p ユーティリティーを使用して Z IP アーカイブの内容を
展開します。
結果
JBoss EAP 6 が正常にインストールされます。Z IP アーカイブを展開して作成されたディレクトリーは、
サーバーの最上位ディレクトリーとなります。このディレクトリーの名前は、EAP_HOME/ となります。
バグを報告する
3.4 . クイックスタートコードサンプルのダウンロード
3.4 .1. クイックスタートのダウンロード
概要
JBoss EAP 6 には、ユーザーが Java EE 6 の技術を使用したアプリケーションの作成を簡単に開始できる
包括的なクイックスタートコードのサンプルが含まれています。
JBoss EAP をインストールしたときにクイックスタートサンプルのインストールを選択した場合は、この
トピックを省略できます。それ以外の場合は、Red Hat JBoss D eveloper Program または Full Red Hat
JBoss Commercial Program でクイックスタートサンプルをダウンロードします。選択したプログラムに
適合する以下の手順に従ってください。
手順3.7 Fu ll R ed H at JB o ss C o mmercial Pro g ram でのクイックスタートのダウンロード
この手順は、Full Red Hat JBoss Commercial Program に参加している場合に実行します。このプログラ
ムの詳細については、「Full Red Hat JBoss Commercial Program について」を参照してください。
1. ブラウザーを開き、Red Hat カスタマーポータル (https://access.redhat.com) にログインします。
2. ダウンロードをクリックします。
3. P ro d uct D o wnl o ad s リストで R ed Hat JBo ss Enterpri se Appl i cati o n
P l atfo rm をクリックします。
4. Versi o n ドロップダウンメニューから正しい JBoss EAP のバージョンを選択します。
5. リストで R ed Hat JBo ss Enterpri se Appl i cati o n P l atfo rm 6 . x.x
Q ui ckstarts を見つけ、D o wnl o ad オプションをクリックします。
6. ディレクトリーに Z IP ファイルを保存するよう促されます。ディレクトリーを選択し、ファイルを
保存します。
7. ディレクトリーにアーカイブを展開します。
14
⁠第3章製品のダウンロードおよびインストール
手順3.8 R ed H at JB o ss D evelo p er Pro g ram でのクイックスタートのダウンロード
この手順は、Red Hat JBoss D eveloper Program に参加している場合に実行します。このプログラムの詳
細については、「Red Hat JBoss D eveloper Program について」を参照してください。
1. Web ブラウザーを開き、URL http://www.jboss.org/products/eap/ にアクセスします。
2. ページの左側の D o wnl o ad JBo ss EAP リンクをクリックして、製品ダウンロード情報を表示
します。
3. D o wnl o ad JBo ss EAP 以下で、Q ui ckstarts リンクをクリックしてサンプルを含む Z ip
アーカイブをダウンロードします。
4. ディレクトリーに Z IP ファイルを保存するよう促されます。ディレクトリーを選択し、ファイルを
保存します。
5. ディレクトリーにアーカイブを展開します。
バグを報告する
15
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
第4章インストール後の手順
4 .1. 開発環境の設定
4 .1.1. Red Hat JBoss Developer St udio のインストールの概要
本書では、Red Hat JBoss D eveloper Studio の最も単純なインストールパスの手順を提供します。完全な
インストール手順については、Red Hat JBoss D eveloper Studio 向けのインストールガイド
(https://access.redhat.com/site/documentation/en-US/Red_Hat_JBoss_D eveloper_Studio/) を参照して
ください。
バグを報告する
4 .1.2. Red Hat JBoss Developer St udio のダウンロード
1. https://www.jboss.org/products/devstudio.html に移動します。
2. D o wnl o ad ボタンをクリックします。Z IP ファイルを任意のディレクトリーに保存するよう求め
られます。
バグを報告する
4 .1.3. Red Hat JBoss Developer St udio のインストール
1. ターミナルを開き、ダウンロードされた . jar ファイルを含むディレクトリーに移動します。
2. 次のコマンドを実行して GUI インストールプログラムを起動します。
java -jar jbdevstudio-build_version.jar
注記
または、. jar ファイルをダブルクリックしてインストールプログラムを起動することもで
きます。
3. Next をクリックしてインストールを開始します。
4. I accept the terms o f thi s l i cense ag reement を選択し、Next をクリックしま
す。
5. インストールパスを調整し、Next をクリックします。
注記
インストールパスのフォルダーが存在しない場合はメッセージが表示されます。O k をク
リックしてフォルダーを作成します。
6. デフォルトの JVM が選択されます。他の JVM を選択するか、そのまま Next をクリックします。
16
⁠第4 章インストール後の手順
7. Red Hat JBoss D eveloper Studio には、Red Hat JBoss Enterprise Application Platform が含ま
れます。以前にインストールされた場合は、No を選択します。それ以外の場合は、Y es を選択し
てインストールし、Red Hat JBoss D eveloper Studio での使用のために設定します。
8. インストールの詳細を確認し、Next をクリックします。
9. インストールが完了したら Next をクリックします。
10. Red Hat JBoss D eveloper Studio のデスクトップショートカットを設定し、Next をクリックし
ます。
11. D o ne をクリックします。
バグを報告する
4 .1.4 . Red Hat JBoss Developer St udio の起動
Red Hat JBoss D eveloper Studio を起動するには、インストール中に作成されたデスクトップショート
カットをダブルクリックするか、コマンドラインで起動します。このトピックでは、コマンドラインを使用
して Red Hat JBoss D eveloper Studio を使用する方法について説明します。
手順4 .1 R ed H at JB o ss D evelo p er St u d io を起動するコマンド
1. ターミナルを開き、Red Hat JBoss D eveloper Studio インストールディレクトリーに移動しま
す。
2. 次のコマンドを実行して Red Hat JBoss D eveloper Studio を起動します。
Linux の場合:
[localhost]$ ./jbdevstudio
Microsoft Windows の場合:
C:\JBDS_INSTALL_DIRECTORY > jbdevstudio.bat
バグを報告する
4 .1.5. Define New Server を使用した JBoss EAP Server の追加
これらの手順では、Red Hat JBoss D eveloper Studio を初めて使用し、Red Hat JBoss Enterprise
Application Platform サーバーが追加されていないことを前提とします。また、D efi ne New Server
ウィザードを使用して JBoss EAP サーバーを追加します。
手順4 .2 サーバーの追加
1. Servers タブを開きます。Servers タブがない場合は次のようにパネルへ追加します。
a. Win d o w → Sh o w View → O t h er... の順にクリックします。
b. Servers フォルダーより Server を選択し、O K をクリックします。
2. No servers are avai l abl e. C l i ck thi s l i nk to create a new server. . . を
クリックするか、空白の Server パネル内で右クリックし、N ew → Server を選択します。
17
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
図4 .1 新しいサーバーの追加 - 使用できるサーバーがない場合
3. JBo ss Enterpri se Mi d d l eware を展開し、JB o ss En t erp rise Ap p licat io n Plat f o rm
6 .1+ を選択します。" JBoss Enterprise Application Platform 6.4" などのサーバー名を入力
し、Next をクリックして JBoss ランタイムを作成し、サーバーを定義します。次回に新しいサー
バーを定義するときに、このダイアログには、新しいランタイム定義とともに Server runti me
envi ro nment が表示されます。
18
⁠第4 章インストール後の手順
図4 .2 新しいサーバーの定義
4. サーバーアダプターを作成して、サーバーの起動と停止を管理します。デフォルト値を保持
し、Next をクリックします。
19
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
図4 .3 新しいサーバーアダプターの作成
5. 名前 (" JBoss EAP 6.4 Runtime" など) を入力します。Ho me D i recto ry 以下で、Bro wse をク
リックし、JBoss EAP インストールの場所に移動します。次に、Next をクリックします。
20
⁠第4 章インストール後の手順
図4 .4 新しいサーバーランタイム環境の追加
注記
一部のクイックスタートでは、異なるプロファイルまたは追加の引数を使用してサーバーを
起動する必要があります。ful l プロファイルが必要なクイックスタートをデプロイするに
は、新しいサーバーを定義し、C o nfi g urati o n fi l e として stand al o neful l . xml を指定する Server R unti me Envi ro nment を追加する必要があります。
6. 新しいサーバーの既存のプロジェクトを設定します。この時点でプロジェクトは存在しないた
め、Fi ni sh をクリックします。
21
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
図4 .5 新しい JB o ss サーバーのリソースの変更
結果
JBoss EAP Runtime Server が Servers タブにリストされます。
22
⁠第4 章インストール後の手順
図4 .6 サーバーがサーバーリストに表示される
バグを報告する
4 .2. Maven の設定
4 .2.1. Maven について
Apache Maven は、ソフトウェアプロジェクトの作成、管理、構築を行う Java アプリケーションの開発
で使用される分散型ビルド自動化ツールです。Maven は Project Object Model (POM) と呼ばれる標準の設
定ファイルを利用して、プロジェクトの定義や構築プロセスの管理を行います。POM はモジュールやコン
ポーネントの依存関係、ビルドの順番、結果となるプロジェクトパッケージングのターゲットを記述し、
XML ファイルを使用して出力します。こうすることで、プロジェクトが正しく統一された状態で構築され
るようにします。
Maven は、リポジトリーを使用してアーカイブを行います。Maven リポジトリーには Java ライブラ
リー、プラグイン、その他のビルドアーティファクトが格納されています。デフォルトのパブリックリポ
ジトリーは Maven 2 Central Repository ですが、複数の開発チームの間で共通のアーティファクトを共有
する目的で、社内のプライベートおよび内部リポジトリーとすることが可能です。また、サードパーティー
のリポジトリーもあります。JBoss EAP には、Java EE 開発者が JBoss EAP 6 でアプリケーションを構
築する際に利用する要件の多くが含まれる Maven リポジトリーが含まれます。
Maven の詳細については、Welcome to Apache Maven を参照してください。
Maven リポジトリーの詳細については、Apache Maven Project - Introduction to Repositories を参照し
てください。
JBoss EAP での Maven の使用方法に関する詳細については、カスタマーポータルにある Red Hat JBoss
Enterprise Application Platform 向け開発ガイド
(https://access.redhat.com/site/documentation/JBoss_Enterprise_Application_Platform/) の章「Maven
ガイド」を参照してください。
バグを報告する
4 .2.2. Maven の設定
アプリケーションをビルドし、JBoss EAP 6 にデプロイするのに必要なアーティファクトと依存関係は、
パブリックリポジトリーでホストされます。アプリケーションをビルドするときにこのリポジトリーを使用
するよう Maven を設定する必要があります。これを行う方法は、アプリケーションをビルドおよびデプロ
イするために Red Hat JBoss D eveloper Studio を使用するか、Maven コマンドラインを使用するかに
よって異なります。
23
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
Red Hat JBoss D eveloper Studio には Maven が含まれるため、個別にダウンロードし、インストールす
る必要はありません。Red Hat JBoss D eveloper Studio を使用してアプリケーションをビルドおよびデプ
ロイする場合は、「Red Hat JBoss D eveloper Studio 向け Maven の設定」に記載された手順に従って
Maven を設定します。
Maven コマンドラインを使用してアプリケーションをビルドおよびデプロイする場合は、「Maven のダウ
ンロードとインストール」に記載された手順に従って最初に Maven をダウンロードおよびインストールす
る必要があります。次に、「コマンドラインでの使用向け Maven 設定」に記載された手順に従って
Maven を設定します。
バグを報告する
4 .2.3. Red Hat JBoss Developer St udio 向け Maven の設定
4 .2 .3.1 . Re d Hat JBo ss De ve lo pe r St udio 向け Mave n の設定
アプリケーションをビルドし、Red Hat JBoss Enterprise Application Platform にデプロイするのに必要
なアーティファクトと依存関係は、パブリックリポジトリーでホストされます。アプリケーションをビル
ドするときにこのリポジトリーを使用するよう Maven を設定する必要があります。このトピックでは、
Red Hat JBoss D eveloper Studio を使用してアプリケーションをビルドおよびデプロイする場合に
Maven を設定する手順について説明します。
Maven コマンドラインを使用してアプリケーションをビルドおよびデプロイする場合は、このトピックを
省略できます。代わりに、「コマンドラインでの使用向け Maven 設定」に記載された手順に従ってくださ
い。
Maven は Red Hat JBoss D eveloper Studio で配布されるため、個別にインストールする必要がありませ
ん。ただし、JBoss EAP へのデプロイメントのために Java EE Web Project ウィザードで使用する
Maven を設定する必要があります。以下の手順は、Red Hat JBoss D eveloper Studio 内から Maven 設定
ファイルを編集して JBoss EAP での使用のために Maven を設定する方法を示しています。
手順4 .3 R ed H at JB o ss D evelo p er St u d io での Maven の設定
1. Win d o w→Pref eren ces をクリックし、JBo ss T o o l s を展開して、JBo ss Maven
Integ rati o n を選択します。
図4 .7 Pref eren ces ウィンドウの JB o ss Maven 統合ペイン
24
⁠第4 章インストール後の手順
2. C o nfi g ure Maven R epo si to ri es をクリックします。
3. Ad d R epo si to ry をクリックして、JBoss GA Tech Preview Maven リポジトリーを設定しま
す。Ad d Maven R epo si to ry ダイアログで以下の手順を実行します。
a. P ro fi l e ID 、R epo si to ry ID 、および R epo si to ry Name の値を jbo ss-g arepo si to ry に設定します。
b. R epo si to ry UR L 値を
http: //maven. repo si to ry. red hat. co m/techprevi ew/al l に設定します。
c. Acti ve by d efaul t チェックボックスをクリックして Maven リポジトリーを有効に
します。
d. O K をクリックします。
図4 .8 Ad d Maven R ep o sit o ry - JB o ss 技術プレビュー
4. Ad d R epo si to ry をクリックして JBoss Early Access Maven リポジトリーを設定しま
す。Ad d Maven R epo si to ry ダイアログで以下の手順を実行します。
a. P ro fi l e ID 、R epo si to ry ID 、および R epo si to ry Name の値を jbo ssearl yaccess-repo si to ry に設定します。
b. R epo si to ry UR L 値を
http: //maven. repo si to ry. red hat. co m/earl yaccess/al l / に設定します。
25
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
c. Acti ve by d efaul t チェックボックスをクリックして Maven リポジトリーを有効に
します。
d. O K をクリックします。
図4 .9 Maven リポジトリーの追加 - JB o ss Early Access
5. リポジトリーを確認し、Fi ni sh をクリックします。
26
⁠第4 章インストール後の手順
図4 .10 Maven リポジトリーの確認
6. " Are you sure you want to update the file 'MAVEN_HOME/settings.xml'?" というメッセージが表
示されます。Y es をクリックして設定を更新します。O K をクリックしてダイアログを閉じます。
JBoss EAP Maven リポジトリーが Red Hat JBoss D eveloper Studio での使用向けに設定されま
す。
バグを報告する
4 .2.4 . コマンドライン向け Maven の設定
4 .2 .4 .1 . Mave n のダウンロードとインストール
Maven コマンドラインを使用してアプリケーションをビルドし、JBoss EAP にデプロイする場合は、
Maven をダウンロードし、インストールする必要があります。Red Hat JBoss D eveloper Studio を使用
してアプリケーションをビルドおよびデプロイする場合、Maven は Red Hat JBoss D eveloper Studio で
配布されるため、この手順を省略できます。
1. Apache Maven Project - D ownload Maven へアクセスし、ご使用のオペレーティングシステムに
対応する最新のディストリビューションをダウンロードします。
27
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
2. ご使用のオペレーシングシステムに Apache Maven をダウンロードおよびインストールする方法に
ついては、Maven のドキュメントを参照してください。
バグを報告する
4 .2 .4 .2 . コマンドラインでの使用向け Mave n 設定
JBoss EAP 6 に対するアプリケーションのビルドおよびデプロイに必要なアーティファクトと依存関係
は、パブリックリポジトリーでホストされます。Red Hat JBoss D eveloper Studio を使用してアプリケー
ションをビルドおよびデプロイする場合は、このトピックを省略できます。代わりに、「Red Hat JBoss
D eveloper Studio 向け Maven の設定」に記載された手順に従ってください。ただし、Maven コマンドラ
インを使用する場合は、Maven 設定を使用してプロジェクト全体で JBoss EAP 6 Maven リポジトリーを
使用するよう Maven を指定する必要があります。
Maven コマンドラインでの使用向けに 2 つの設定方法があります。
クイックスタートに同梱された事前定義済み setti ng s. xml ファイルをコピーします。
Maven setti ng s. xml ファイルを手動で編集します。
このトピックでは、両方の方法について説明します。クイックスタートをダウンロードした場合は、最初の
設定方法が最も単純です。
要件
設定を開始する前に、Maven をインストールする必要があります。詳細については、「Maven のダウン
ロードとインストール」を参照してください。
手順4 .4 クイックスタートサンプルの設定を使用した Maven の設定
Red Hat JBoss Enterprise Application Platform クイックスタートには、オンライン JBoss EAP Maven
リポジトリーを使用するよう設定された setti ng s. xml ファイルが同梱されています。クイックスター
トをダウンロードした場合は、この設定方法が最も簡単です。
1. この手順では、既存の Maven 設定ファイルが上書きされるため、既存の Maven setti ng s. xml
ファイルをバックアップする必要があります。
a. Maven インストールディレクトリーの場所を確認します。通常、USER_HOME/. m2/ ディ
レクトリーにインストールされています。
オペレーティングシステムが Linux または Mac の場合は、~ /. m2/ になります。
Windows の場合は、\D o cuments and Setti ng s\USER_NAME\. m2\ または
\Users\USER_NAME\. m2\ になります。
b. 既存の USER_HOME/. m2/setti ng s. xml ファイルがある場合、名前を変更してバック
アップコピーを作成し、後で復元できるようにします。
2. クイックスタートをまだダウンロードしていない場合は、「クイックスタートのダウンロード」に
記載された手順に従ってください。
3. QUICKSTART_HOME/setti ng s. xml ファイルを USER_HOME/. m2/ ディレクトリーへコピー
します。
4. Red Hat JBoss D eveloper Studio の実行中に setti ng s. xml ファイルを変更する場合
は、Refresh the Red Hat JBoss Developer Studio User Settingsというトピックの最後に記載された
手順に従ってください。
手順4 .5 オンラインの JB o ss EAP Maven リポジトリーを使用するよう手作業で Maven 設定を編集およ
び設定する
28
⁠第4 章インストール後の手順
び設定する
手作業で JBoss EAP プロファイルを既存の Maven 設定ファイルへ追加できます。
1. Maven インストールディレクトリーの場所を確認します。通常、USER_HOME/. m2/ ディレクト
リーにインストールされています。
オペレーティングシステムが Linux または Mac の場合は、~ /. m2/ になります。
Windows の場合は、\D o cuments and Setti ng s\USER_NAME\. m2\ または
\Users\USER_NAME\. m2\ になります。
2. setti ng s. xml ファイルが見つからない場合は、USER_HOME/. m2/co nf/ ディレクトリーの
setti ng s. xml ファイルを USER_HOME/. m2/ ディレクトリーへコピーします。
3. 次の XML をファイルの <pro fi l es> 要素へコピーします。
< !-- Configure the JBoss GA Maven repository -->
< profile>
<id>jboss-ga-repository</id>
<repositories>

<id>jboss-ga-repository</id>

<url>http://maven.repository.redhat.com/techpreview/all</url>

</releases>

<enabled>false</enabled>

</snapshots>

</repository>
</repositories>
<pluginRepositories>

<id>jboss-ga-plugin-repository</id>

<url>http://maven.repository.redhat.com/techpreview/all</url>

</releases>

<enabled>false</enabled>

</snapshots>

</pluginRepository>
</pluginRepositories>
< /profile>
< !-- Configure the JBoss Early Access Maven repository -->
< profile>
<id>jboss-earlyaccess-repository</id>
<repositories>

<id>jboss-earlyaccess-repository</id>

<url>http://maven.repository.redhat.com/earlyaccess/all/</url>

<enabled>true</enabled>
29
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド

</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>jboss-earlyaccess-plugin-repository</id>

<url>http://maven.repository.redhat.com/earlyaccess/all/</url>

</releases>

<enabled>false</enabled>

</snapshots>

</pluginRepository>
</pluginRepositories>
< /profile>
次の XML を setti ng s. xml ファイルの <acti veP ro fi l es> 要素へコピーします。
< activeProfile>jboss-ga-repository</activeProfile>
< activeProfile>jboss-earlyaccess-repository</activeProfile>
4. Red Hat JBoss D eveloper Studio の実行中に setti ng s. xml ファイルを変更する場合
は、Refresh the Red Hat JBoss Developer Studio User Settingsというトピックの最後に記載された
手順に従ってください。
手順4 .6 R ed H at JB o ss D evelo p er St u d io ユーザー設定の更新
Red Hat JBoss D eveloper Studio の実行中に setti ng s. xml ファイルを変更する場合は、ユーザー設
定を更新する必要があります。
1. メニューより、Win d o w → Pref eren ces を選択します。
2. P references ウインドウで Maven を展開し、User Setti ng s を選択します。
3. Upd ate Setti ng s ボタンをクリックし、Red Hat JBoss D eveloper Studio で Maven のユー
ザー設定を更新します。
30
⁠第4 章インストール後の手順
図4 .11 Maven ユーザー設定の更新
重要
Maven リポジトリーに古いアーティファクトが含まれる場合は、プロジェクトをビルドまたはデプ
ロイしたときに以下のいずれかの Maven エラーメッセージが表示されることがあります。
Missing artifact ARTIFACT_NAME
[ERROR] Failed to execute goal on project PROJECT_NAME; Could not resolve
dependencies for PROJECT_NAME
この問題を解決するには、最新の Maven アーティファクトをダウンロードするためにローカルリポ
ジトリーのキャッシュバージョンを削除します。キャッシュバージョンは ~ /. m2/repo si to ry/
サブディレクトリー (Linux の場合) または
%SystemDrive%\Users\USERNAME\. m2\repo si to ry\ サブディレクトリー (Windows の場
合) に存在します。
31
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
バグを報告する
32
⁠第5章実践
第5章実践
5.1. クイックスタートの実行
5.1.1. Red Hat JBoss Developer St udio でのクイックスタートの実行
この項では、Red Hat JBoss D eveloper Studio を使用してクイックスタートをデプロイし、Arquillian テ
ストを実行する方法について説明します。
手順5.1 R ed H at JB o ss D evelo p er St u d io へのクイックスタートのインポート
各クイックスタートには、クイックスタートのプロジェクトおよび設定情報が含まれる POM (プロジェク
トオブジェクトモデル) ファイルが同梱されています。この POM ファイルを使用すると、簡単にクイック
スタートを Red Hat JBoss D eveloper Studio へインポートすることができます。
重要
Red Hat JBoss D eveloper Studio へのインポート時にクイックスタートプロジェクトフォルダが
ID E ワークスペース内にある場合、ID E は無効なプロジェクト名と WAR アーカイブ名を生成しま
す。作業を開始する前に、クイックスタートプロジェクトフォルダが ID E ワークスペース外にある
ことを確認してください。
1. 「コマンドラインでの使用向け Maven 設定」に記載された手順に従ってください (まだこれらの手
順を実行していない場合)。
2. Red Hat JBoss D eveloper Studio を起動します。
3. メニューより File → Imp o rt と選択します。
4. 選択リストより Maven → Exist in g Maven Pro ject s と選択し、Next をクリックします。
33
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
図5.1 既存の Maven プロジェクトのインポート
5. テストするクイックスタートのディレクトリー (hel l o wo rl d クイックスタートなど) を参照
し、O K をクリックします。P ro jects リストボックスに、選択したクイックスタートプロジェク
トの po m. xml ファイルが示されます。
34
⁠第5章実践
図5.2 Maven プロジェクトの選択
6. Fi ni sh をクリックします。
手順5.2 hel l o wo rl d クイックスタートのビルドとデプロイ
hel l o wo rl d クイックスタートは最も単純なクイックスタートの 1 つです。このクイックスタートを使
用すると、JBoss サーバーが適切に設定および実行されていることを検証することができます。
1. Servers タブが表示されない場合やサーバーがまだ定義されていない場合は、「D efine New
Server を使用した JBoss EAP Server の追加」に記載された手順に従ってください。ful l プロ
ファイルまたは追加の起動引数が必要なクイックスタートをデプロイする場合は、クイックスター
トの手順に記載されたようにサーバーランタイム環境を作成してください。
2. P ro ject Expl o rer タブで jbo ss-hel l o wo rl d プロジェクトを右クリックし、R u n As を
選択します。このときに、選択肢のリストが提供されます。次に、R u n o n Server を選択しま
す。
35
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
図5.3 R u n As - R u n o n Server
3. サーバーリストから JBo ss EAP 6 . 1+ R unti me Server を選択し、Next をクリックしま
す。
図5.4 サーバー上での実行
4. 次の画面にサーバーで設定されたリソースが表示されます。ユーザーに対して jbo sshel l o wo rl d クイックスタートが設定されています。Fi ni sh をクリックしてクイックスタート
をデプロイします。
36
⁠第5章実践
図5.5 サーバーで設定されたリソースの変更
5. 結果を確認します。
Server タブで、JBoss EAP 6.x Runtime Server ステータスが [Started , R epubl i sh] に
変わります。
サーバーの C o nso l e タブに、JBoss EAP 6.x サーバーの起動と helloworld クイックスター
トのデプロイに関するメッセージが表示されます。
hel l o wo rl d タブに、URL http://localhost:8080/jboss-helloworld/HelloWorld と " Hello
World!" というテキストが表示されます。
C o nso l e の以下のメッセージにより、jbo ss-hel l o wo rl d . war ファイルのデプロイメン
トが確認されます。
37
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
JBAS018210: Register web context: /jboss-helloworld
JBAS018559: Deployed "jboss-helloworld.war" (runtime-name :
"jboss-helloworld.war")
デプロイされたアプリケーションへアクセスする URL を提供するため、登録された Web コン
テキストの前には http: //l o cal ho st: 80 80 が追加されます。
6. hel l o wo rl d クイックスタートが JBoss サーバーに正しくデプロイされたことを確認するに
は、Web ブラウザーを開き、URL http://localhost:8080/jboss-helloworld にあるアプリケーショ
ンにアクセスします。
手順5.3 bean-val i d ati o n クイックスタート Arq u illian テストの実行
一部のクイックスタートは、ユーザーインターフェースレイヤーの代わりに Arquillian テストを提供して
サンプルコードのデモを行います。bean-val i d ati o n クイックスタートは、Arquillian テストを提供す
るクイックスタートのサンプルです。
1. 上記の手順に従って、 bean-val i d ati o n クイックスタートを Red Hat JBoss D eveloper
Studio にインポートします。
2. Servers タブでサーバーを右クリックし、St art を選択して JBoss EAP サーバーを起動しま
す。Servers タブが表示されない場合やサーバーがまだ定義されていない場合は、「D efine New
Server を使用した JBoss EAP Server の追加」に記載された手順に従ってください。
3. P ro ject Expl o rer タブで jbo ss-bean-val i d ati o n プロジェクトを右クリックし、R u n
As を選択します。このときに、選択肢のリストが提供されます。次に、Maven B u ild を選択しま
す。
4. Ed i t C o nfi g urati o n ダイアログの G o al s 入力フィールドに、cl ean test -P arq jbo ssas-remo te と入力します。
次に、R un をクリックします。
38
⁠第5章実践
図5.6 設定の編集
5. 結果を確認します。
サーバーの C o nso l e タブに、JBoss EAP サーバーの起動に関するメッセージと beanval i d ati o n クイックスタート Arquillian テストの出力が表示されます。
------------------------------------------------------T E S T S
------------------------------------------------------Running
org.jboss.as.quickstarts.bean_validation.test.MemberValidationTest
Tests run: 5, Failures: 0, Errors: 0, Skipped: 0, Time elapsed:
2.189 sec
Results :
Tests run: 5, Failures: 0, Errors: 0, Skipped: 0
39
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
[INFO] ----------------------------------------------------------------------[INFO] BUILD SUCCESS
[INFO] ----------------------------------------------------------------------バグを報告する
5.1.2. コマンドラインを使用したクイックスタートの実行
手順5.4 コマンドラインを使用したクイックスタートのビルドおよびデプロイ
コマンドラインを使用すると簡単にクイックスタートをビルドおよびデプロイできます。コマンドラインを
使用し、JBoss サーバーを起動する必要がある場合、ユーザーがサーバーを起動する必要があるため注意し
てください。
1. 「コマンドラインでの使用向け Maven 設定」に記載された手順に従ってください (まだこれらの手
順を実行していない場合)。
2. クイックスタートのルートディレクトリにある R EAD ME. html ファイルを確認してください。
このファイルにはシステム要件に関する一般的な情報、Maven の設定方法、ユーザーの追加方法、
クイックスタートの実行方法が含まれています。クイックスタートを始める前に必ず読むようにし
てください。
このファイルには使用可能なクイックスタートの一覧表も含まれています。この表にはクイックス
タート名と使用する技術が記載され、各クイックスタートの簡単な説明と設定するために必要な経
験レベルが記載されています。クイックスタートの詳細については、クイックスタート名をクリッ
クしてください。
他のクイックスタートを改良または拡張するために作成されたクイックスタートもあります。この
ようなクイックスタートは P rereq ui si tes 列に記載されています。クイックスタートに前提条
件がある場合は、クイックスタートを使用する前にこれらをインストールする必要があります。
オプションコンポーネントのインストールや設定が必要になるクイックスタートもあります。これ
らのコンポーネントは、クイックスタートが必要とする場合のみインストールしてください。
3. hel l o wo rl d クイックスタートを実行します。
hel l o wo rl d クイックスタートは最も単純なクイックスタートの 1 つです。このクイックスター
トを使用すると、JBoss サーバーが適切に設定および実行されていることを検証することができま
す。hel l o wo rl d クイックスタートのルートにある R EAD ME. html ファイルを開きます。この
ファイルにはクイックスタートのビルドおよびデプロイ方法や実行しているアプリケーションへの
アクセス方法の詳細手順が含まれています。
4. 別のクイックスタートを実行します。
各クイックスタートのルートフォルダーにある R EAD ME. html ファイルの手順に従ってサンプル
を実行します。
バグを報告する
40
インストールプログラムのスクリーンショット
インストールプログラムのスクリーンショット
A.1. 言語の選択
図A.1 JB o ss EAP インストールプログラムの言語の選択
バグを報告する
A.2. 使用許諾契約書
41
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
図A.2 JB o ss EAP インストールプログラムの使用許諾契約書
バグを報告する
A.3. インストールパス
42
インストールプログラムのスクリーンショット
図A.3 JB o ss EAP インストールプログラムのインストールパス
バグを報告する
A.4 . インストールするパックの選択
インストールするパックを選択または選択解除します。必要なパックは選択解除できません。
43
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
図A.4 JB o ss EAP インストールプログラムでインストールするパックの選択
バグを報告する
A.5. 管理ユーザーの作成
44
インストールプログラムのスクリーンショット
図A.5 JB o ss EAP インストールプログラム管理ユーザーの作成
バグを報告する
A.6. クイックスタートのインストール
45
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
図A.6 JB o ss EAP インストールプログラムクイックスタートのセットアップ
バグを報告する
A.7. Maven リポジトリーのセットアップ
46
インストールプログラムのスクリーンショット
図A.7 JB o ss EAP インストールプログラムでの Maven リポジトリーのセットアップ
バグを報告する
A.8. ソケットバインディングのセットアップ
デフォルトのバインディングを使用するかどうかを決定するか、カスタムバインディングを設定します。
47
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
図A.8 JB o ss EAP インストールプログラムデフォルトソケットバインディング
バグを報告する
A.9. サーバーの起動
48
インストールプログラムのスクリーンショット
図A.9 JB o ss EAP インストールプログラムサーバーの起動
バグを報告する
A.10. ロギングレベルの設定
49
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
図A.10 JB o ss EAP インストールプログラムでロギングレベル設定を省略する
バグを報告する
A.11. ランタイム環境の設定
50
インストールプログラムのスクリーンショット
図A.11 JB o ss EAP インストールプログラムでのランタイム環境の設定 - デフォルト
バグを報告する
A.12. インストールコンポーネントの確認
51
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
図A.12 JB o ss EAP インストールプログラムで選択されたコンポーネントの確認
バグを報告する
A.13. インストールの進捗
52
インストールプログラムのスクリーンショット
図A.13 JB o ss EAP インストールプログラムコンポーネントのインストールの進捗
バグを報告する
A.14 . インストール処理の完了
53
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
図A.14 JB o ss EAP インストールプログラム処理の完了
バグを報告する
A.15. ショートカットの作成
54
インストールプログラムのスクリーンショット
図A.15 JB o ss EAP インストーラーでのショートカットの作成
バグを報告する
A.16. インストールスクリプトの生成
55
JBoss Ent erprise Applicat ion Plat form 6 .4 スタートガイド
図A.16 JB o ss EAP インストールプログラムでのインストールスクリプトの生成
バグを報告する
56
改訂履歴
改訂履歴
改訂 6 .4 .0- 10
T u esd ay Ap ril 14 2015
Red Hat JBoss Enterprise Application Platform 6.4.0.GA
Lu cas C o st i
57

Download Report