スタートガイド

手順3.1 Full Red Hat JBoss Commercial Program の下でカスタマーポータルから JBossEAP インストールプログラムをダウンロードする

1. ブラウザーを開き、https://access.redhat.com のカスタマーポータルにログインします。
2. Downloads をクリックします。
3. Product Downloads リストの Red Hat JBoss Enterprise Application Platform をクリックします。
4. Version ドロップダウンメニューから正しい JBoss EAP バージョンを選択します。
5. リストから Red Hat JBoss Enterprise Application Platform 6.x.x インストーラー を見つけ、Download オプションをクリックします。
6. JAR ファイルを選択したディレクトリーに保存するように求められます。ディレクトリーを選択してファイルを保存します。

手順3.2 Red Hat JBoss Developer Program の下で jboss.org から JBoss EAP インストールプログラムをダウンロードします

1. ブラウザーを開き、次の URL にアクセスします。http://www.jboss.org/products/eap。
   • 製品の現在の GA 出荷バージョンのインストールプログラムをダウンロードするには、ページの右側にある Download ボタンをクリックします。
   • 次の手順に従って、最新のアルファ版またはベータ版のリリース、および製品の以前のバージョンを含む代替バージョンを選択してください。
     1. ページの左側にある Download JBoss EAP リンクをクリックします。
     2. 正しい製品バージョンについては、Download 列の下にある Installer リンクをクリックしてください。
2. JAR ファイルを選択したディレクトリーに保存するように求められます。ディレクトリーを選択してファイルを保存します。

手順3.3 JBoss EAP インストールプログラムを実行します

1. ターミナルを開き、ダウンロードしたインストールプログラムの JAR を含むディレクトリーに移動します。
2. 以下のコマンドを入力します。

   java -jar jboss-eap-6.x.x-installer.jar

   注記
   Hewlett-Packard HP-UX または Solaris 環境では、-d32/-d64 スイッチを使用して必要なアーキテクチャーを指定できます。以下のいずれかのコマンドを実行してインストーラーを起動します。

   java -jar -d64 jboss-eap-6.x.x-installer.jar

   または

   java -jar -d32 jboss-eap-6.x.x-installer.jar

3. 以下の表の手順を実行します。

手順3.4 テキストベースのインストールプロセス

1. ターミナルを開き、ダウンロードしたインストールプログラムの JAR を含むディレクトリーに移動します。
2. 次のコマンドを実行して、テキストベースのインストーラーを起動します。

   java -jar jboss-eap-6.x.x-installer.jar -console

3. 手順に従って JBoss EAP 6 をインストールします。

手順3.5 Full Red Hat JBoss Commercial Program のカスタマーポータルから ZIP ファイルをダウンロードします

1. ブラウザーを開き、Red Hat カスタマーポータル (https://access.redhat.com) にログインします。
2. Downloads をクリックします。
3. Product Downloads リストの Red Hat JBoss Enterprise Application Platform をクリックします。
4. Version ドロップダウンメニューから正しい JBoss EAP バージョンを選択します。
5. リストから Red Hat JBoss Enterprise Application Platform 6.x.x を見つけ、Download オプションをクリックします。
6. 選択したディレクトリーに ZIP ファイルを保存するように求められます。ディレクトリーを選択してファイルを保存します。

手順3.6 Red Hat JBoss Developer Program の下で jboss.org から ZIP ファイルをダウンロードします

1. Web ブラウザーを開き、次の URL にアクセスします。http://www.jboss.org/products/eap/
2. ページの左側にある Download JBoss EAP リンクをクリックします。
3. 正しい製品バージョンについては、Download 列の下にある ZIP リンクをクリックしてください。
4. 選択したディレクトリーに ZIP ファイルを保存するように求められます。ディレクトリーを選択してファイルを保存します。

手順3.7 ZIP ファイルのインストール

1. ZIP アーカイブを目的の場所に移動します。

   ZIP ファイルを JBoss EAP 6 をインストールする予定のサーバーとディレクトリーに移動します。サーバーを起動および停止するユーザーは、このディレクトリーへの読み取りおよび書き込みアクセス権を持っている必要があります。

2. 適切なアプリケーションを使用して、ZIP アーカイブを目的の場所に展開します。

   Red Hat Enterprise Linux 環境では、unzip ユーティリティーを使用して ZIP アーカイブのコンテンツを展開します。
   Microsoft Windows 環境では、ファイルを右クリックして Extract All を選択します。
   Hewlett-Packard HP-UX 環境では、unzip ユーティリティーを使用して ZIP アーカイブのコンテンツを展開します。

手順3.8 Full Red Hat JBoss Commercial Program の下でクイックスタートをダウンロードする

1. ブラウザーを開き、Red Hat カスタマーポータル (https://access.redhat.com) にログインします。
2. Downloads をクリックします。
3. Product Downloads リストの Red Hat JBoss Enterprise Application Platform をクリックします。
4. Version ドロップダウンメニューから正しい JBoss EAP バージョンを選択します。
5. リストの中から Red Hat JBoss Enterprise Application Platform6.x.x Quickstarts を探し、Download オプションをクリックします。
6. Zip ファイルを選択したディレクトリーに保存するように求められます。ディレクトリーを選択してファイルを保存します。
7. 選択したディレクトリーでアーカイブを解凍します。

手順3.9 Red Hat JBoss Developer Program で Quickstarts をダウンロードします

1. Web ブラウザーを開き、次の URL にアクセスします。http://www.jboss.org/products/eap/
2. ページの左側にある Download JBoss EAP リンクをクリックして、製品のダウンロード情報を表示します。
3. Download JBoss EAP で、Quickstarts リンクをクリックして、例を含む Zip アーカイブをダウンロードします。
4. 選択したディレクトリーに ZIP ファイルを保存するように求められます。ディレクトリーを選択してファイルを保存します。
5. 選択したディレクトリーでアーカイブを解凍します。

1. https://www.jboss.org/products/devstudio.html にアクセスします。
2. Download ボタンをクリックします。選択したディレクトリーに ZIP ファイルを保存するように求められます。

1. ターミナルを開き、ダウンロードした .jar ファイルを含むディレクトリーに移動します。
2. 次のコマンドを実行して、GUI インストールプログラムを起動します。

   java -jar jboss-devstudio-build_version-installer-eap.jar

   注記

   または、.jar ファイルをダブルクリックしてインストールプログラムを起動できる場合もあります。
3. Next をクリックして、インストールプロセスを開始します。
4. I accept the terms of this license agreement を選択し、Next をクリックします。
5. インストールパスを調整し、Next をクリックします。
   注記
   インストールパスフォルダーが存在しない場合は、プロンプトが表示されます。OK をクリックしてフォルダーを作成します。
6. JVM を選択するか、デフォルトの JVM を選択したままにして、Next をクリックします。
7. Red Hat JBoss Developer Studio には、Red Hat JBoss Enterprise Application Platform が含まれています。以前にインストールされている場合は、No を選択します。それ以外の場合は、Yes を選択してインストールし、Red Hat JBoss Developer Studio で使用できるように設定します。
8. インストールの詳細を確認し、Next をクリックします。
9. インストールプロセスが完了したら、Next をクリックします。
10. Red Hat JBoss Developer Studio のデスクトップショートカットを設定し、Next をクリックします。
11. 完了 をクリックします。

手順4.1 Red Hat JBoss Developer Studio を起動するコマンド

1. ターミナルを開き、Red Hat JBoss Developer Studio のインストールディレクトリーに移動します。
2. 次のコマンドを実行して、Red Hat JBoss Developer Studio を起動します。
   Linux の場合

   [localhost]$ ./jbdevstudio

   Microsoft Windows の場合

   C:\JBDS_INSTALL_DIRECTORY > jbdevstudio.bat

手順4.2 サーバーを追加します

1. Servers タブを開きます。Servers タブがない場合は、次のようにパネルに追加します。
   1. Window → Show View → Other...をクリックします。
   2. Server フォルダーから Servers を選択し、OK をクリックします。
2. 以下をクリックします、No servers are available。このリンクをクリックして、新しいサーバーを作成します。または、必要に応じて、空白のサーバーパネル内を右クリックし、New → Server を選択します。

   図4.1 新しいサーバーを追加する - No servers available

   

   
   [D]
3. JBoss Enterprise Middleware を展開し、JBoss Enterprise Application Platform 6.1+ を選択します。JBoss Enterprise Application Platform 6.4 などのサーバー名を入力し、Next をクリックして JBoss ランタイムを作成し、サーバーを定義します。次回新しいサーバーを定義するとき、このダイアログには、新しいランタイム定義を含む Server runtime environment の選択が表示されます。

   図4.2 新しいサーバーを定義する

   

   
   [D]
4. サーバーの起動と停止を管理するサーバーアダプターを作成します。デフォルトのままにして、Next をクリックします。

   図4.3 新しいサーバーアダプターを作成する

   

   
   [D]
5. JBoss EAP 6.4 Runtime などの名前を入力します。Home Directory で、Browse をクリックして、JBoss EAP のインストール場所に移動します。Next をクリックします。

   図4.4 新しいサーバーランタイム環境を追加する

   

   
   [D]
   注記
   一部のクイックスタートでは、別のプロファイルまたは追加の引数を使用してサーバーを実行する必要があります。full プロファイルを必要とするクイックスタートをデプロイするには、新しいサーバーを定義し、Configuration file に standalone-full.xml を指定する Server Runtime Environment を追加する必要があります。新しいサーバーにはわかりやすい名前を付けてください。
6. 新しいサーバー用に既存のプロジェクトを設定します。この時点ではプロジェクトがないため、Finish をクリックします。

   図4.5 新しい JBoss サーバーのリソースを変更します

   

   
   [D]

手順5.1 クイックスタートを Red Hat JBoss Developer Studio にインポートします

1. まだ行っていない場合は、 「コマンドラインで使用するための Maven の設定」。

2. Red Hat JBoss Developer Studio を起動します。

3. メニューから File → Import を選択します。

4. 選択リストで、Maven → Existing Maven Projects を選択し、Next をクリックします。

   図5.1 既存の Maven プロジェクトのインポート

   

   
   [D]

5. テストする予定のクイックスタートのディレクトリー (たとえば、helloworld クイックスタート) を参照し、OK をクリックします。Projects リストボックスに、選択したクイックスタートプロジェクトの pom.xml ファイルが示されます。

   図5.2 Maven プロジェクトの選択

   

   
   [D]

6. Finish をクリックします。

手順5.2 helloworld クイックスタートをビルドしてデプロイする

1. Servers タブが表示されない場合、またはサーバーをまだ定義していない場合は、次の手順に従ってください。「Define New Server を使用して JBossEAP サーバーを追加します」。full プロファイルまたは追加のスタートアップ引数を必要とするクイックスタートをデプロイする場合は、クイックスタートの手順に記載されているように、必ずサーバーランタイム環境を作成してください。
2. Project Explorer タブで jboss-helloworld プロジェクトを右クリックし、Run As を選択します。選択肢のリストが提供されます。Run on Server を選択します。

   図5.3 Run As - Run on Server

   

   
   [D]
3. サーバーリストから JBoss EAP 6.1+ Runtime Server を選択し、Next をクリックします。

   図5.4 Run on Server

   

   
   [D]
4. 次の画面には、サーバーで設定されているリソースが表示されます。jboss-helloworld クイックスタートが設定されています。Finish をクリックしてクイックスタートをデプロイします。

   図5.5 サーバーで設定されたリソースの変更

   

   
   [D]
5. 結果を表示します。

   • Server タブで、JBoss EAP 6.x ランタイムサーバーのステータスが [Started, Republish] に変わります。
   • サーバーの Console タブには、JBoss EAP 6.x サーバーの起動と helloworld クイックスタートのデプロイメントの詳細を示すメッセージが表示されます。
   • URL (http://localhost:8080/jboss-helloworld/HelloWorld) とテキスト Hello World! を示す helloworld タブが表示されます。
   • Console の次のメッセージは、jboss-helloworld.war ファイルのデプロイを確認します。

     JBAS018210: Register web context: /jboss-helloworld
     JBAS018559: Deployed "jboss-helloworld.war" (runtime-name : "jboss-helloworld.war")
     

     登録された Web コンテキストは http://localhost:8080 に追加され、デプロイされたアプリケーションへのアクセスに使用される URL を提供します。
6. JBoss サーバーに正常にデプロイされた helloworld クイックスタートを確認するには、Web ブラウザーを開き、次の URL でアプリケーションにアクセスします。http://localhost:8080/jboss-helloworld

手順5.3 bean-validation クイックスタート Arquillian テストの実行

1. 上記の手順に従って、bean-validation クイックスタートを Red Hat JBoss Developer Studio にインポートします。
2. Servers タブでサーバーを右クリックし、Start を選択して JBoss EAP サーバーを起動します。Servers タブが表示されない場合、またはサーバーをまだ定義していない場合は、次の手順に従ってください。「Define New Server を使用して JBossEAP サーバーを追加します」。
3. Project Explorer タブで jboss-bean-validation プロジェクトを右クリックし、Run As を選択します。選択肢のリストが提供されます。Maven Build を選択します。
4. Edit Configuration ダイアログの Goals 入力フィールドに、次のように入力します clean test -Parq-jbossas-remote。
   次に、Run をクリックします。

   図5.6 設定の編集

   

   
   [D]
5. 結果を表示します。
   サーバーの Console タブには、JBoss EAP サーバーの起動と bean-validation クイックスタート 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
   
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   

手順5.4 コマンドラインを使用してクイックスタートをビルドおよびデプロイする

1. まだ行っていない場合は、 「コマンドラインで使用するための Maven の設定」 。
2. クイックスタートのルートディレクトリーにある README.html ファイルを確認します。
   このファイルには、システム要件、Maven の設定方法、ユーザーの追加方法、およびクイックスタートの実行方法に関する一般的な情報が含まれています。始める前に必ず読んでください。
   また、利用可能なクイックスタートを一覧表示する表も含まれています。この表には、各クイックスタート名とそれが示すテクノロジーがリストされています。各クイックスタートと、それを設定するために必要な経験のレベルについて簡単に説明します。クイックスタートの詳細は、クイックスタート名をクリックしてください。
   一部のクイック起動は、他のクイック起動を強化または拡張するように設計されています。これらは、Prerequisites の列に記載されています。クイックスタートに前提条件がリストされている場合は、クイックスタートを使用する前にまずそれらをインストールする必要があります。
   一部のクイックスタートでは、オプションのコンポーネントのインストールと設定が必要です。クイックスタートで必要な場合を除いて、これらのコンポーネントをインストールしないでください。
3. helloworld クイックスタートを実行します。
   helloworld クイックスタートは最もシンプルなクイックスタートの 1 つであり、JBoss サーバーが正しく設定され実行されていることを確認するための良い方法です。helloworld クイックスタートのルートにある README.html ファイルを開きます。クイックスタートをビルドしてデプロイし、実行中のアプリケーションにアクセスする方法の詳細な手順が含まれています
4. 他のクイックスタートを実行します。
   各クイックスタートのルートフォルダーにある README.html ファイルの指示に従って、例を実行します。