インストールガイド

JBoss Enterprise Application Platform 6.3

Red Hat JBoss Enterprise Application Platform 6 向け

Red Hat カスタマーコンテンツサービス JBoss EAP チーム

概要

本書は、Red Hat JBoss Enterprise Application Platform 6 およびそのパッチリリースに関するガイドです。

第1章 製品の概要

1.1. Red Hat JBoss Enterprise Application Platform 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. JBoss EAP 6 の機能

表1.1 6.3.0 機能

機能 説明
Java 証明書 認定された Java Enterprise Edition 6 の Full Profile と Web Profile。
管理対象ドメイン
  • 複数のサーバーインスタンスおよび物理ホストを一元管理し、スタンドアロンサーバーで単一のサーバーインスタンスを使用することを可能にします。
  • 設定、デプロイメント、ソケットバインディング、モジュール、拡張機能、およびシステムプロパティーをサーバーグループごとに管理します。
  • アプリケーションのセキュリティー (セキュリティードメインを含む) の管理を一元化および簡略化します。
管理コンソールおよび管理 CLI 新しいドメインまたはスタンドアロンサーバー管理インターフェース。XML 設定ファイルの編集は必要なくなりました。管理 CLI には、管理タスクをスクリプト化および自動化できるバッチモードも含まれます。
単純化されたディレクトリーレイアウト modules ディレクトリーにはすべてのアプリケーションサーバーモジュールが含まれるようになりました。共通でサーバー固有の lib ディレクトリーは廃止されました。domain ディレクトリーと standalone ディレクトリーには、それぞれドメインデプロイメント用のアーティファクトおよび設定ファイルと、スタンドアロンデプロイメント用のアーティファクトおよび設定ファイルが含まれます。
モジュラークラスローディングメカニズム モジュールはオンデマンドでロードおよびアンロードされます。これにより、パフォーマンスが向上し、セキュリティーの利点が提供され、起動および再起動の時間が短縮されます。
簡略化されたデータソース管理 データベースドライバーは他のサービスと同様にデプロイされます。また、データソースは、管理コンソールまたは管理 CLI で直接作成および管理されます。
リソースの使用の削減と効率化 JBoss EAP 6 はより少ないシステムリソースを使用し、以前のバージョンよりも効率的に使用します。その他の利点として、JBoss EAP 6 では JBoss EAP 5 よりも起動および停止時間が短縮されます。

第2章 はじめに

2.1. Red Hat カスタマーポータルについて

Red Hat カスタマーポータル は、Red Hat のナレッジリソースやサブスクリプションリソースを管理する集中プラットフォームです。以下を行う場合に Red Hat カスタマーポータル を使用します。
  • Red Hat エンタイトルメントやサポート契約の管理および維持。
  • 正式サポートされたソフトウェアのダウンロード。
  • 製品ドキュメントや Red Hat ナレッジベースの利用。
  • グローバルサポートサービスへの連絡。
  • Red Hat 製品のバグの登録。
カスタマーポータルには https://access.redhat.com からアクセスできます。

第3章 システム要件

3.1. JBoss EAP 6 インストールの要件

JBoss EAP 6 では、インストールプロセスごとに複数の要件があります。ここでは、一般的な要件とインストール固有の要件について取り上げます。

一般的な要件

ZIP またはインストーラーの要件

  • インストールディレクトリーの管理権限。
  • 選択した JDK が展開 (またはインストール) されていることを確認してください。展開やインストール方法については、JDK のドキュメントを参照してください。
  • Microsoft Windows Server では、JAVA_HOME および PATH 環境変数が設定されていることを確認します。設定されていないと、ショートカットが動作しません。
  • Hewlett-Packard HP-UX では、unzip ユーティリティーがインストールされていることを確認します。

RPM の要件

  • Red Hat Network でサーバーを登録してください。
  • ご使用の Red Hat Enterprise Linux のバージョンに適した Red Hat Enterprise Linux Server ベースのソフトウェアチャンネルをサブスクライブしてください。
  • JBoss Enterprise Platform グループの JBoss Application Platform for Server サブチャンネルをサブスクライブしてください。
  • Red Hat Enterprise Linux 5 では、JDK 7 のみを使用する場合でも JDK 6 をインストールする必要があります。Red Hat Enterprise Linux 6 以上では、JDK 7 のみが必要です。これは、ご使用の Red Hat Enterprise Linux インストールの supplementary ソフトウェアチャンネルにサブスクライブすると取得できます。たとえば、i386 アーキテクチャーにインストールされている Red Hat Enterprise Linux バージョン 6 のチャンネルは rhel-i386-server-supplementary-6 になります。

ppc64 の要件

  • Red Hat Enterprise Linux 6 の場合は、 rhel-ppc64-server-optional-6 チャネルにサブスクライブします。
  • Red Hat Enterprise Linux 7 の場合は、rhel-7-server-optional-rpms-7Server リポジトリーにサブスクライブします。

第4章 インストール手順

4.1. JBoss EAP 6 のインストール方法

JBoss EAP 6 をインストールするには複数の異なる方法があります。状況によって最適な方法は異なります。このトピックでは、各インストールタイプの概要と、関連するインストールプロセスに関する項へのリンクが提供されます。

表4.1 インストール方法

方法
説明
手順
Zip インストール
Zip アーカイブを使用したインストールは、サポートされるすべてのオペレーティングシステムに適しています。
JAR インストーラー
JAR インストーラーはコンソールで実行したり、グラフィカルウィザードとして実行することが可能です。いずれの場合も、サーバーインスタンスインストールおよび設定方法がステップごとに表示されます。クイックスタートや Maven リポジトリなどもインストーラーで追加設定できます。
RPM インストール
JBoss EAP 6 は、サポートされる RPM パッケージグラフィカルインストーラーまたはコマンドラインインターフェースを使用してインストールすることができます。この方法は Red Hat Enterprise Linux 5 および 6 のサポートされるインストールに適しています。

4.2. Zip インストール

4.2.1. JBoss EAP 6 のダウンロード (Zip インストール)

概要

JBoss EAP 6 の Zip ファイルは Red Hat カスタマーポータルから入手できます。Zip ファイルのインストールはプラットフォームに依存します。この方法は、JBoss EAP 6 を、サポートされるすべてのプラットフォームにインストールする場合に推奨されます。ここでは、アーカイブをダウンロードする手順を示します。

手順4.1 Zip ファイルのダウンロード

  1. ブラウザーを開き、カスタマーポータル (https://access.redhat.com) にログインします。
  2. ダウンロード をクリックします。
  3. 製品のダウンロード (Product Downloads) リストで Red Hat JBoss Enterprise Application Platform をクリックします。
  4. Version (バージョン) ドロップダウンメニューから正しい JBoss EAP のバージョンを選択します。
  5. リストで Red Hat JBoss Enterprise Application Platform 6.x.x を見つけ、Download オプションをクリックします。
結果

ターゲットマシンに JBoss EAP 6 がダウンロードされ、インストールする準備が整います。

4.2.2. JBoss EAP 6 のインストール (ZIP インストール)

概要

ここでは、ダウンロードした ZIP ファイルを使用して JBoss EAP 6 をインストールする手順を説明します。

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

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

    ZIP ファイルを、JBoss EAP 6 をインストールするサーバーとディレクトリーに移動します。サーバーを起動および停止するユーザーは、このディレクトリーへの読み書きアクセス許可を持っている必要があります。
  2. 適切なアプリケーションを使用して ZIP アーカイブを希望の場所に展開します。

    Red Hat Enterprise 環境では、unzip ユーティリティーを使用して ZIP アーカイブの内容を抽出します。
    Microsoft Windows の環境では、ファイルを右クリックし、Extract All (すべて展開) を選択します。
    Hewlett-Packard HP-UX 環境では、unzip ユーティリティーを使用して ZIP アーカイブの内容を展開します。
結果

JBoss EAP 6 が正常にインストールされます。ZIP アーカイブを展開して作成されたディレクトリーは、サーバーの最上位ディレクトリーとなります。このディレクトリーの名前は、EAP_HOME/ となります。

4.2.3. JBoss EAP 6 のアンイストール (Zip インストール)

要件

変更された設定ファイルとデプロイメントが今後のインスタンスで再使用される可能性がある場合、バックアップする必要があります。

概要

ここでは、JBoss EAP 6 の Zip インストールをアンインストールするために必要な手順について説明します。

手順4.3 JBoss EAP 6 のアンイストール (Zip インストール)

  1. Zip ファイルから JBoss Enterprise Application Platform 6 フォルダーを展開したディレクトリーに移動します。
  2. インストールディレクトリーを削除します。

    Zip インストール方法を使用する場合、JBoss Enterprise Application Platform 6 は単一のディレクトリーにインストールされます。JBoss EAP 6 をアンインストールするには、このインストールディレクトリーを削除します。
  3. オプション: 作成した初期化スクリプトを削除します。

    コンピューターにインストールされている JBoss EAP 6 に依存する初期化スクリプトまたは他のスクリプトを作成した場合は、これらを削除します。
結果

JBoss EAP 6 がサーバーからアンインストールされます。

4.3. インストーラー

4.3.1. JBoss EAP 6 のダウンロード (インストーラー)

概要

JBoss EAP 6 のインストーラーアーカイブは Red Hat カスタマーポータルから入手できます。.jar アーカイブを使用して、グラフィカルまたはテキストベースのインストーラーを実行できます。ここでは、アーカイブをダウンロードする手順を示します。

手順4.4 インストーラーのダウンロード

  1. ブラウザーを開き、カスタマーポータル (https://access.redhat.com) にログインします。
  2. ダウンロード をクリックします。
  3. 製品のダウンロード (Product Downloads) リストで Red Hat JBoss Enterprise Application Platform をクリックします。
  4. Version (バージョン) ドロップダウンメニューから正しい JBoss EAP のバージョンを選択します。
  5. リストで Red Hat JBoss Enterprise Application Platform 6.x.x インストーラー を見つけ、Download オプションをクリックします。
結果

ターゲットマシンに JBoss EAP 6 がダウンロードされ、インストールする準備が整います。

4.3.2. JBoss EAP インストールプログラムの実行

JBoss EAP インストールプログラムは、グラフィカルモードまたはテキストモードで実行できます。このトピックでは、グラフィカルモードでインストールプログラムを実行するコマンドについて説明します。

手順4.5 JBoss EAP インストールプログラムの実行

  1. ターミナルを開き、ダウンロードされたインストールプログラム JAR を含むディレクトリーに移動します。
  2. 以下のコマンドを入力します。
    java -jar jboss-eap-6.3.0-installer.jar
  3. 以下の表の手順を実行します。

表4.2 JBoss EAP インストールプログラムの画面

画面の名前
表示されるタイミング
説明
常時
インストールプログラムの言語を選択し、OK をクリックします。
常時
RED HAT JBOSS MIDDLEWARE の EULA。
「I accept the terms of this license agreement (ライセンス契約の内容に同意します)」を選択し、Next (次へ) をクリックします。
常時
JBoss EAP のインストールパスを選択し、Next (次へ) をクリックします。新しいディレクトリーを作成するか、指定されたディレクトリーを置き換える (ディレクトリーが存在する場合) よう求められます。
常時
インストールするパックを選択します。必須パックは選択解除できません。
常時
管理ユーザーを作成し、パスワードを割り当てます。パスワードは少なくとも 8 文字長である必要があり、1 つの英字、1 つの数字、および英数字以外の 1 つの文字を使用します。次に、Next (次へ) をクリックします。
常時
クイックスタートサンプルをインストールします。クイックスタートサンプルをインストールする場合は、Yes (はい) を選択し、インストールパスを選択します。クイックスタートサンプルをインストールしない場合は、No (いいえ) を選択します。次に、Next (次へ) をクリックします。
クイックスタートサンプルのインストールを選択したとき
クイックスタートでは、パブリックでホストされた Maven リポジトリーを使用できます。デフォルトの選択では、インストールでこのリポジトリーを使用するよう自動的に設定されます。これはクイックスタートを実行する最も簡単な方法です。必要な場合は、ローカルにインストールされたリポジトリーへのパスを指定します (Maven 設定ファイルがデフォルトの場所にない場合はパスを指定します)。
常時
インストールでデフォルトポートバインディングを使用するか、カスタムポートバインディングを設定するか、すべてのデフォルトバインディングのポートオフセットを設定するかを決定します。カスタムバインディングを選択する場合は、スタンドアロンモード、ドメインモード、またはその両方のポートを設定するかどうかを選択します。ポートオフセットを設定する場合は、オフセットを選択します。次に、Next (次へ) をクリックします。
スタンドアロンモードにカスタムポートバインディングを設定することを選択したとき
さまざまなスタンドアロンモードに対してポートプロパティーとシステムプロパティーを選択し、 Next (次へ) をクリックします。
ドメインモードにカスタムポートバインディングを設定することを選択したとき
さまざまなドメインモードに対してポートプロパティーとシステムプロパティーを選択し、 Next (次へ) をクリックします。
常時
インストールプロセスの完了時に必要な起動オプションを選択します。次に、Next (次へ) をクリックします。
常時
Yes (はい) を選択してログレベルを設定するか、No (いいえ) を選択してこの設定を省略します。次に、Next (次へ) をクリックします。
常時
Perform default configuration (デフォルト設定の実行) を選択し、Next (次へ) をクリックして作業を続行します。
常時
選択を確認し、Next (次へ) をクリックします。
常時
インストールが完了すると、Next (次へ) をクリックします。
ランタイム環境の詳細設定のパスワードボールトをインストールすることを選択したとき
暗号化されたキーストアにすべての機密パスワードを保存するようパスワードボールトを設定し、Next (次へ) をクリックします。詳細については、『管理および設定ガイド』の「キーストアパスワードのマスキングとパスワード vault の初期化」を参照してください。
ランタイム環境の詳細設定の SSL セキュリティーを有効にすることを選択したとき
EAP 管理インターフェースをセキュアにするために SSL キーストアを設定します。次に、Next (次へ) をクリックします。詳細については、『セキュリティーガイド』の「SSL 暗号化キーおよび証明書の生成」を参照してください。
ランタイム環境の詳細設定の LDAP 設定を有効にすることを選択したとき
LDAP ディレクトリーサーバーを管理コンソール、管理 CLI、または管理 API の認証ソースとして使用するよう LDAP 認証を有効にします。有効にしたら、Next (次へ) をクリックします。詳細については、『管理および設定ガイド』の「管理インターフェースに対する LDAP を使用した認証」を参照してください。
ランタイム環境の詳細設定の Infinispan キャッシュをインストールすることを選択したとき
キャッシュされたデータを管理するために Infinispan キャッシュを作成します。Infinispan の名前を指定し、他のフィールドを設定して、Next (次へ) をクリックします。詳細については、『管理および設定ガイド』の第 14 章「Infinispan」を参照してください。
ランタイム環境の詳細設定でセキュリティードメインを追加することを選択したとき
PicketBox により提供されたサービスを JBoss EAP サービスインスタンスに組み込むようにセキュリティードメインを設定します。ほとんどのフィールドにはすでにデフォルト値が設定されており、変更は必要ありません。設定後に、Next (次へ) をクリックします。詳細については、『管理および設定ガイド』の「セキュリティードメイン」を参照してください。
ランタイム環境の詳細設定で JDBC ドライバーをインストールすることを選択したとき
アプリケーションコードを該当するデータベース言語に変換するために、JDBC ドライバーをインストールし、セットアップします。「Driver Vendor (ドライバーベンダー)」ドロップダウンリストに表示されたサポート対象ドライバーのリストから適切なドライバーを選択します。詳細については、『管理および設定ガイド』の第 6 章「データソース管理」を参照してください。
ランタイム環境の詳細設定でデータソースをインストールすることを選択したとき
アプリケーションで使用できるデータソースを設定します。データソースの名前を指定し、他のフィールドを設定して、Next (次へ) をクリックします。詳細については、『管理および設定ガイド』の「データソース設定」を参照してください。
常時
処理が完了したら、Next (次へ) をクリックします。
常時
ショートカットを作成するかどうかと、ショートカットの設定方法を選択します。次に、Next (次へ) をクリックします。
常時
選択されたインストールオプションを使用する場合は、Generate installation script and properties file (インストールスクリプトおよびプロパティーファイルの生成) をクリックします。次に、Done (完了) をクリックします。
インストールが完了します。
結果

インストールが完了し、ターゲットマシンに JBoss EAP 6 がインストールされます。

4.3.3. JBoss EAP 6 のアンイストール (インストーラー)

概要

ここでは、グラフィカルインストーラーまたはテキストベースインストーラーを使用してインストールされた JBoss EAP 6 のインスタンスをアンインストールするために必要な手順について説明します。

手順4.6 JBoss EAP 6 のアンイストール (グラフィカルインストール)

  1. ターゲットマシンに JBoss EAP 6 をインストールした場合に、JBoss EAP 6 をインストールしたディレクトリーに Uninstaller という名前のディレクトリーが作成されます。このディレクトリーには uninstaller.jar という名前のファイルが含まれています。ターミナルウインドウでこのディレクトリーに移動します。
  2. 次のコマンドを実行して、 GUI アンインストーラーを起動します。
    java -jar uninstaller.jar
  3. このコマンドを実行すると、下図のようにグラフィカルアンインストーラーが起動されます。JBoss EAP 6 インストールディレクトリーを削除したい場合はチェックボックスを選択します。
    グラフィカルインストーラーを使用した JBoss EAP 6 のアンインストール

    図4.1 グラフィカルインストーラーを使用した JBoss EAP 6 のアンインストール

  4. Uninstall (アンインストール) ボタンを押して、アンインストールプロセスを開始します。
  5. アンインストールプロセスが終了したら、Quit (終了) ボタンを押してアンインストーラーを終了します。
  6. 正しくアンインストールされた後、アンインストーラーを起動した場所にある Uninstaller ディレクトリーを削除したい場合は手作業で削除します。

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

  1. コンソールで、インストールプロセス中に作成された Uninstaller ディレクトリーへ移動します。このディレクトリーは EAP_HOME の 1 つ上のレベルにあります。
  2. 次のコマンドを実行して、テキストベースアンインストーラーを起動します。
    java -jar uninstaller.jar -console
  3. 手順に従って JBoss EAP 6 をアンイストールします。
Result:

JBoss EAP 6 がサーバーからアンインストールされます。

4.4. グラフィカル RPM インストール

4.4.1. JBoss EAP 6 (グラフィカル RPM インストール)

概要

グラフィカル RPM パッケージを使用した JBoss EAP 6 のインストールは、Red Hat Enterprise Linux 5 と Red Hat Enterprise Linux 6 で可能です。ここでは、インストールに必要な手順を示します。

手順4.8 JBoss EAP 6 (グラフィカル RPM インストール)

PackageKit を使用して、ターゲットマシンに JBoss EAP 6 をグラフィカルにインストールします。
  1. PackageKit を起動します。

    PackageKit は、Red Hat Enterprise Linux の一部としてインストールされるオープンソースのパッケージ管理ソフトウェアです。ターゲットマシンで システム管理ソフトウェアの追加/削除 と選択し、PackageKit を起動します。
  2. 以下の文字列を入力します。
    jboss-eap6
    Find (検索) ボタンを押します。結果ボックスに JBoss EAP 6 パッケージが表示されます。
  3. JBoss EAP 6 パッケージを選択し、Apply (適用) ボタンを押します。下図を参照してください。
    JBoss EAP 6 PackageKit のインストール

    図4.2 JBoss EAP 6 PackageKit のインストール

  4. 残りの手順に従って、JBoss EAP 6 をターゲットマシンにインストールします。
結果

インストールが完了し、JBoss EAP 6 がターゲットマシンにインストールされます。

4.5. テキストベースの RPM インストール

4.5.1. JBoss EAP 6 のインストール (テキストベースの RPM インストール)

概要

RPM パッケージを使用した JBoss EAP 6 のインストールは、Red Hat Enterprise Linux 5、Red Hat Enterprise Linux 6、および Red Hat Enterprise Linux 7 に適しています。ここでは、コマンドラインを使用したインスタンスのインストールに必要な手順を示します。

手順4.9 テキストベースのインストール手順

Red Hat Network を介して YUM インストールを使用して、RPM パッケージにアクセスし、インストールします。
  1. YUM と Red Hat Network を使用して、RPM パッケージをインストールします。

    YUM では、groupinstall コマンドを使用して、デフォルトの JBoss EAP 6 グループパッケージをインストールします。
    [user@host ~]$ yum groupinstall jboss-eap6
  2. 初期化オプションを設定します。

    RPM インストールには、サーバーを起動する初期化スクリプトが含まれます。初期化スクリプトの設定は、複数の追加ファイルに含まれます。これらのファイルと含まれるオプションの詳細については、「JBoss EAP 6 用 RPM インストール設定ファイル」を参照してください。
結果

インストールが完了します。RPM インストールのデフォルトの EAP_HOME パスは /usr/share/jbossas になります。インストールされたすべてのパッケージの完全なリストについては、「JBoss EAP 6 用 RPM パッケージリスト」 を参照してください。

4.6. 自動インストール

4.6.1. JBoss EAP 6 のインスタンスを複数インストールする (インストーラー)

要件

概要

グラフィカルまたはテキストベースのインストーラーを使用してインストールプロセス中に生成された自動インストールスクリプトを使用すると、JBoss EAP 6 の同一インスタンスを複数インストールすることができます。このトピックでは、生成されたスクリプトを使用して JBoss EAP 6 をインストールするのに必要な手順を示します。

手順4.10 自動インストール

  • ターミナルで次のコマンドを実行し、自動インストールスクリプトを使用して JBoss EAP 6 をインストールします。
    java -jar jboss-eap-6.3.0-installer.jar auto.xml

    注記

    インストールの自動化に自動インストールスクリプト (auto.xml) を使用する場合は、インストーラーによりデフォルトですべてのパスワードの入力を要求するプロンプトが生成されます。
結果

自動インストールスクリプトに基づいて、JBoss EAP 6 の同一インスタンスがインストールされます。

4.6.2. JBoss EAP 6 をインストールするために異なるソースから自動インストールスクリプト (auto.xml) を使用する

インストーラーは、どのネットワークの場所からでも自動インストールスクリプト (auto.xml) を使用できます (実行を開始する場所は関係ありません)。したがって、インストーラー (jboss-eap-6.3.0-installer.jar) と自動インストールスクリプト (auto.xml) は異なるマシンに配置できます。このトピックでは、異なるネットワークの場所から JBoss EAP 6.3 を自動的にインストールする手順について説明します。
  • ターミナルで、以下のいずれかのコマンドを入力して、現在のネットワークの場所に対して自動インストールスクリプト (別の場所に存在する) を指定します。
    java -jar jboss-eap-6.3.0-installer.jar http://network-host/auto.xml (HTTP の場合)
    java -jar jboss-eap-6.3.0-installer.jar ftp://network-host/auto.xml (FTP の場合)
結果

JBoss EAP 6 がマシンにインストールされます。

4.7. 自動インストール方法

4.7.1. 自動化されたインストール方法について

要件

インストーラーを実行し、グラフィカルまたはテキストベースのインストーラーを使用して自動インストールスクリプトを生成します ( 「JBoss EAP インストールプログラムの実行」)。

概要

以下の 2 つの方法を使用して、インストーラーにより生成された自動インストールスクリプトで JBoss EAP 6 を自動的にインストールできます。

  • 最初の方法では、自動インストール変数ファイルで自動インストールに必要なキー/パスワードの値を指定します。
  • 2 番目の方法では、インストール中にキー/パスワードの値を指定します。

4.7.2. 自動インストール変数ファイルでキー/パスワードの値を事前に設定して JBoss EAP 6 をインストールする

以下の手順に従い、自動インストール変数ファイルでキー/パスワードの値を事前に設定して JBoss EAP 6 を自動的にインストールします。

手順4.11

  1. 変数ファイルでキー値を入力する

    JBoss EAP 6 インストーラーは、自動インストールスクリプトと自動インストール変数ファイルを作成します。自動インストール変数ファイルには、自動インストールに必要なキー/パスワードパラメーターのリストが含まれます。キー値を入力するには、自動インストール変数ファイルを開きます。各キーパラメーターに対して有効なキー/パスワードの値を入力します。例は以下のとおりです。
    adminPassword = password#2
    vault.keystorepwd = vaultkeystorepw
    ssl.password = user12345
  2. 変数ファイルのファイル名引数を使用してインストーラーを実行し自動インストールを開始する

    完全に自動化された EAP インストーラーは、変数ファイル auto.xml.variablefile の引数を使用してインストーラーを実行することにより開始できます。この引数は、変数ファイルのキー/パスワードの値 (手順 1) をインストーラーに提供します。完全に自動化されたインストールを開始するには、ターミナルを開き、以下のコマンドを該当するファイル名とともに入力します。
    java -jar jboss-eap-6.3.0-installer.jar auto.xml -variablefile auto.xml.variablefile
結果

JBoss EAP 6 がマシンにインストールされます。

4.7.3. インストール中にキー/パスワードの値を指定して JBoss EAP 6 を自動的にインストールする

以下の手順に従い、インストール中にキー/パスワードの値を指定して JBoss EAP 6.3 を自動的にインストールします。

手順4.12

  • 変数引数でインストーラーを実行する

    自動インストールは、変数引数でインストーラーを実行し、変数リストを指定することによって、開始できます。この変数引数により、インストール中の値/パスワードの値とともに変数を定義できるようになります。インストールプロセスを開始するには、ターミナルを開き、以下のコマンドを該当するファイル名とともに入力します。
    java -jar jboss-eap-6.3.0-installer.jar auto.xml -variables adminPassword=password#2,vault.keystorepwd=vaultkeystorepw,ssl.password=user12345

    注記

    正常なインストールを行うには、空白のスペースを使用せずに変数名 (adminPassword、keystorepwd、および ssl.password) を指定する必要があります。

4.8. ネイティブコンポーネントおよびユーティリティーのインストール

ネイティブコンポーネントは、特定のオペレーティングシステムおよびアーキテクチャー用に最適化するためにコンパイルされたオプションのコンポーネントです。場合によっては、ネイティブコンポーネントを使用すると、パフォーマンスが向上することがあります。ネイティブコンポーネントには、HornetQ (AIO) のネイティブサポートと Tomcat ネイティブライブラリが含まれます。
ネイティブユーティリティーは、サポートされた各オペレーティングシステムおよびアーキテクチャーに固有なオプションのユーティリティーです。これには、オペレーティングシステムで JBoss EAP 6 をサービスとしてインストールし、SSL 暗号化キーおよび証明書を生成するためのスクリプトとユーティリティーが含まれます。
ネイティブコンポーネントとネイティブユーティリティーに加えて、ロードバランシングとクラスタリングのために Webserver コネクターネイティブが使用されます。Webserver コネクターネイティブを設定するには、『管理および設定ガイド』を参照してください。

4.8.1. ネイティブコンポーネントおよびネイティブユーティリティーのインストール (Zip、インストーラー)

要件

  • Zip インストール、グラフィカルインストーラー、またはテキストベースインストーラーを使用して JBoss EAP 6 をインストールする必要があります。
  • JBoss EAP 6 サーバーの管理 CLI または管理コンソールにアクセスします。『管理設定ガイド』の「管理 CLI の起動」または「管理コンソールへログイン」を参照してください。
  • ネイティブコンポーネントの場合:
    • Red Hat Enterprise Linux 6 および 7 環境では、Apache Portability Runtime (APR) および OpenSSL ライブラリがインストールされていることを確認してください。JBoss EAP ネイティブコンポーネントに含まれる Tomcat ネイティブライブラリを使用する場合は、インストールする前にオペレーティングシステムパッケージ tomcatjss を削除する必要があります。
    • HP-UX 環境では、OpenSSL をインストールする必要があります。

手順4.13 ネイティブコンポーネントをダウンロードおよびインストールする

  1. Red Hat カスタマーポータルから、使用しているオペレーティングシステムとアーキテクチャー用のネイティブコンポーネントパッケージをダウンロードします。パッケージは、「JBoss EAP 6 のダウンロード (Zip インストール)」で指定されたのと同じ場所からダウンロードできます。
  2. ダウンロードされたネイティブコンポーネントの zip アーカイブを JBoss EAP 6 インストールに抽出します。
    抽出の成功は、EAP_HOME/modules/system/layers/base/org/jboss/as/web/main/lib/ に、使用しているオペレーティングシステムとアーキテクチャー用の新しいフォルダーがあるかどうかをチェックして確認できます。
  3. 管理 CLI を使用して、以下のコマンドで Web サブシステムのネイティブコンポーネントをアクティブ化します。
    [standalone@localhost:9999 /] /subsystem=web:write-attribute(name=native,value=true)
  4. 変更を適用するために JBoss EAP 6 サーバーを再起動します。

手順4.14 ネイティブユーティリティーをダウンロードおよびインストールする

  1. Red Hat カスタマーポータルから、使用しているオペレーティングシステムとアーキテクチャー用のネイティブユーティリティーパッケージをダウンロードします。パッケージは、「JBoss EAP 6 のダウンロード (Zip インストール)」で指定されたのと同じ場所からダウンロードできます。
  2. ダウンロードされたネイティブコンポーネントの zip アーカイブを JBoss EAP 6 インストールに抽出します。
    抽出の成功は、native ディレクトリーが EAP_HOME/modules/system/layers/base/ にあるかどうかをチェックして確認できます。
  3. 特定のネイティブユーティリティー機能を設定するには、JBoss EAP ドキュメンテーションスイートと Red Hat カスタマーポータルにある手順を参照してください。

4.8.2. ネイティブコンポーネントおよびネイティブユーティリティーのインストール (RPM インストール)

RPM インストール方法を使用して EAP をインストールした場合のみ、RPM インストール方法を使用してネイティブコンポーネント、ユーティリティー、および対応するすべての依存関係をインストールできます。Red Hat Enterprise Linux 5、6、および 7 では、RPM パッケージ方法でネイティブをインストールすることが適切です。このトピックでは、コマンドラインを使用してネイティブコンポーネントおよびユーティリティーをインストールするのに必要な手順について説明します。

手順4.15 ネイティブコンポーネントおよびネイティブユーティリティーのインストール

  1. ネイティブコンポーネントおよびユーティリティーをインストールする

    Red Hat Enterprise Linux 5、6、および 7 でネイティブコンポーネントおよびユーティリティーを (依存関係とともに) インストールするには、管理アカウントを使用して以下のコマンドを実行します (package_name を、インストールする必要があるネイティブコンポーネントの名前に置き換えます)。
    yum install package_name
    インストールできるネイティブコンポーネント: mod_cluster-nativemod_jkmod_rtmod_snmpapache-commons-daemon-jsvc-eap6httpdhttpd-develjbossas-hornetq-nativejbossas-jbossweb-native

    重要

    ネイティブコンポーネント jbossas-hornetq-native および jbossas-jbossweb-native は、yum groupinstall jboss-eap6 コマンドを実行して JBoss EAP 6 グループパッケージをインストールするときにデフォルトでインストールされます。JBoss EAP 6 インストールで「JBoss EAP 6 (グラフィカル RPM インストール)」または「JBoss EAP 6 のインストール (テキストベースの RPM インストール)」を使用した場合は、jbossas-hornetq-native および jbossas-jbossweb-native をインストールする必要はありません。

    注記

    特定のネイティブコンポーネントをインストールするには、正しいパッケージ名を指定することが重要です。パッケージ名では大文字と小文字を区別します。Red Hat Enterprise Linux 7 では、httpd パッケージの名前は httpd22 です。したがって、Red Hat Enterprise Linux 7 に Apache HTTP をインストールするために yum install package_name を実行する場合は、パッケージ httpdhttpd22 に置き換える必要があります。
  2. サーバーを再起動する

    変更を適用するために JBoss EAP 6 サーバーを再起動します。

4.9. サービス設定

4.9.1. JBoss EAP 6 を Red Hat Enterprise Linux でサービスとして設定する (RPM)

要件

概要

RHN (RPM) を使用してインストールを行った場合は、次の手順を実行して JBoss EAP 6 を Red Hat Enterprise Linux のサービスとしてインストールします。

手順4.16 RPM を使用して JBoss EAP 6 を Red Hat Enterprise Linux でサービスとして設定する

  1. JBoss EAP 6 のインストール

    上記の要件のセクションに記載されているいずれかの手順を実行して RPM で JBoss EAP 6 をインストールします。
  2. サービスの有効化

    JBoss EAP 6 の RPM インストール方法を使用すると、必要なサービスファイルが適切な場所にインストールされます。次のコマンドを実行するだけでサービスとして設定することができます。
    chkconfig jbossas on
    ドメインモードでサービスとしてセットアップするには、以下のコマンドを発行します。
    chkconfig jbossas-domain on
結果

JBoss EAP 6 は、Red Hat Enterprise Linux がデフォルトのランレベルに到達したときに自動的に起動し、オペレーティングシステムでシャットダウンルーチンが完了した時に自動的に終了します。

4.9.2. 1JBoss EAP 6 を Red Hat Enterprise Linux でサービスとして設定する (Zip、インストーラー)

要件

概要

zip、テキスト、またはグラフィカルの方法を使用してインストールを行った場合は、次の手順を用いて JBoss EAP 6 を Red Hat Enterprise Linux のサービスとしてインストールします。このプロセスは RHN (RPM) の方法を使用してインストールを行った場合は適用されません。

手順4.17 サービスをセットアップする

注記

以下の手順は、JBoss EAP 6 をスタンドアロンモードでサービスとして実行することを示しています。JBoss EAP 6 をドメインモードでサービスとして実行するには、同じ手順を使用し、jboss-as-standalone.shjboss-as-domain.sh に置き換えます。
  1. 起動スクリプトおよび設定ファイルを見つけます。

    起動スクリプトと、関連する設定ファイルは、EAP_HOME/bin/init.d/ ディレクリーに存在します。設定ファイル jboss-as.conf を開き、編集します。
  2. jboss-as.conf ファイルの起動オプションをカスタマイズします。

    jboss-as.conf ファイル内に複数のオプションがあります。最低でも、JBOSS_HOME および JBOSS_USER 変数に適切な値を指定してください。これらの変数がない場合は追加してください。
  3. システムディレクトリーにファイルをコピーします。

    1. 変更した設定ファイルを /etc/jboss-as ディレクトリーにコピーします。
      [user@host init.d]$ sudo mkdir /etc/jboss-as
      [user@host init.d]$ sudo cp jboss-as.conf /etc/jboss-as/
    2. 起動スクリプトを /etc/init.d ディレクトリーにコピーします。
      [user@host init.d]$ sudo cp jboss-as-standalone.sh /etc/init.d
  4. 起動スクリプトをサービスとして追加します。

    chkconfig サービス管理コマンドを使用して、新しい jboss-as-standalone.sh サービスを自動的に起動されるサービスのリストに追加します。
    [user@host init.d]$ sudo chkconfig --add jboss-as-standalone.sh
  5. サービスを起動します。

    Red Hat Enterprise Linux の以下のいずれかのコマンドを使用して、サービスが正しくインストールされていることをテストします。
    • Red Hat Enterprise Linux 5 および 6 の場合:
      [user@host bin]$ sudo service jboss-as-standalone.sh start
    • Red Hat Enterprise Linux 7 の場合:
      [user@host bin]$ sudo service jboss-as-standalone start
    すべて適切にインストールされている場合は、緑色の [OK] が表示されるはずです。エラーが発生した場合、エラーログを確認し、設定ファイルに正しいパスが指定されていることを確認します。

    注記

    Red Hat Enterprise Linux 7 の場合は、緑色の [OK] が表示されません。
  6. サーバーの再起動時にサービスが自動的に起動されるようにします。

    サーバーの再起動時に自動的に起動されるサービスのリストにサービスを追加するには、以下のコマンドを発行します。
    [user@host init.d]$ sudo chkconfig jboss-as-standalone.sh on
結果

JBoss EAP 6 は、Red Hat Enterprise Linux がデフォルトのランレベルに到達したときに自動的に起動し、オペレーティングシステムでシャットダウンルーチンが完了した時に自動的に終了します。

手順4.18 Red Hat Enterprise Linux から JBoss EAP 6 サービスをアンイストールする

  • サービスが実行中の場合は、最初にターミナルを開き、stop コマンドをサービスの名前で実行してサービスを停止します。
    sudo service jboss-as-standalone.sh stop
    ターミナルで、サービスのリストから EAP を削除します。
    sudo chkconfig --del jboss-as-standalone.sh
    ターミナルで、サービス起動スクリプト /etc/init.d/jboss-as-standalone.sh (ドメインの場合は /etc/init.d/jboss-as-domain.sh) を削除します。

    警告

    /etc/jboss-as は標準的なディレクトリーではありません。このコマンドは、/etc/jboss-asjboss-as.conf 以外のファイルがない場合にのみ使用します。
    sudo rm -rf /etc/jboss-as/
    他のタスクで /etc/jboss-as ディレクトリーを使用している場合は、次のコマンドを使用します。
    sudo rm /etc/jboss-as/jboss-as.conf
結果

JBoss EAP 6 サービスがサーバーからアンインストールされます。

4.9.3. Microsoft Windows Server で JBoss EAP 6 をサービスとして設定する (Zip、インストーラー)

要件

重要

システム環境変数を設定するときに、set コマンドを Windows Server コマンドプロンプトで使用する場合、環境変数は永続的に設定されません。setx コマンドまたは コントロールパネルシステム インターフェースを使用する必要があります。
概要

以下の手順に従って、Microsoft Windows Server で JBoss EAP 6 をサービスとして設定します。

手順4.19 Microsoft Windows Server で JBoss EAP 6 用サービスを設定する

  1. システム環境変数を作成する

    以下の 2 つのシステム環境変数を作成します。
    • JBoss EAP 6 インストールディレクトリーを参照する JBOSS_HOME
    • NOPAUSE=1
  2. まだ設定されていない場合は、使用しているアーキテクチャー用のネイティブユーティリティーをダウンロードし、展開する

    Windows Server パッケージ用ネイティブユーティリティーが JBoss EAP 6 インストールの一部としてインストールされていない場合は、Red Hat カスタマーポータル (https://access.redhat.com) から該当する 32 ビットまたは 64 ビットパッケージをダウンロードします。JBoss EAP 6 インストール上にネイティブユーティリティー Zip アーカイブを展開します。
    この結果、native ディレクトリーが JBoss EAP 6 インストールの EAP_HOME\modules\system\layers\base\ に生成されます。
  3. サービスをインストールする

    ターミナルを開き、ディレクトリーを EAP_HOME\modules\system\layers\base\native\sbin に変更します。
    service install コマンドを使用して新しいサービスを作成できます (以下の表に利用可能なオプションが示されています)。

    表4.3 service install オプション

    引数またはスイッチ 説明
    /controller HOST:PORT
    管理インターフェースのホストおよびポート。デフォルト値は localhost:9999 です。
    /host [DOMAIN_HOST]
    ドメインモードが使用されることを示します (オプションで、ドメインコントローラーの名前を指定します)。ドメインコントローラー名が省略された場合、デフォルトの名前は master になります。
    /loglevel LEVEL
    サービスのログレベル (ERRORINFOWARN、または DEBUG)。省略された場合、デフォルト値は INFO になります。
    /name SERVICE_NAME
    作成するサービスの名前にはスペースが含まれないようにする必要があります。省略された場合、デフォルト値は JBossEAP6 になります。
    /desc "DESCRIPTION"
    サービスの説明。省略された場合、デフォルト値は "JBoss Enterprise Application Platform 6" になります。
    /serviceuser DOMAIN\USERNAME
    サービスを実行するアカウントの名前を指定します。アカウント名は DOMAIN\USERNAME の形式で使用します。省略された場合、サービスはローカルシステムアカウントとして実行されます。
    /servicepass PASSWORD
    /serviceuser アカウントのパスワード。
    /jbossuser USERNAME
    shutdown コマンドで使用するオプションの JBoss EAP 6 ユーザー名。
    /jbosspass PASSWORD
    /jbossuser アカウントのパスワード (/jbossuser が指定された場合に必要)。
    以下に、スタンドアロンまたはドメインモードで新しいサービスを作成する install コマンドの基本的な例を示します。以下のコマンドを実行して、サービスのログレベルを必要に応じて調整します。
    • スタンドアロンモード:
      service.bat install /loglevel INFO
    • ドメインモード:
      JBoss EAP 6 ドメインコントローラーにデフォルトマスターを使用していない場合は、master を正しいホスト名または JBoss EAP 6 ドメインコントローラーのエイリアスに置き換えます。
      service.bat install /host master /loglevel INFO
    新しい Windows サービスが、JBossEAP6 という名前で作成されます。
  4. サービスコンソールで新しいサービスを検証する

    ターミナルで以下のコマンドを実行して、Windows サービスコンソールを開きます。
    services.msc
    デフォルトのサービス名が使用された場合は、Windows サービスのリストで、新しいサービスの名前 JBoss Enterprise Application Platform 6 が表示されます。サービスコンソールからは、サービスを起動および停止し、サービスをいつどのように起動するかに関する設定を変更できます。
  5. ターミナルから JBoss EAP 6 サービスを起動および停止する

    ターミナルからサービスを起動するには、以下のコマンドを使用します(必要な場合は、サービス名を変更します)。
    net start JBossEAP6
    ターミナルからサービスを停止するには、以下のコマンドを使用します(必要な場合は、サービス名を変更します)。
    net stop JBossEAP6
結果

JBoss EAP 6 サービスが Microsoft Windows Server で設定されます。

手順4.20 JBoss EAP 6 サービスを Microsoft Windows Server からアンイストールする

  • サービスが実行中の場合は、最初にターミナルを開き、net stop コマンドをサービスの名前で実行してサービスを停止します。
    net stop JBossEAP6
    ターミナルでディレクトリーを EAP_HOME\modules\system\layers\base\native\sbin に変更し、以下のコマンドを実行します。
    service uninstall
結果

JBoss EAP 6 サービスが Microsoft Windows Server からアンイストールされます。

第5章 JBoss EAP 6 のパッチとアップグレード

5.1. パッチおよびアップグレード

JBoss EAP 6 のパッチ適用により、JBoss EAP 6 の特定のマイナーバージョン (JBoss EAP 6.2 など) で利用可能なアップデートが適用されます。パッチには、個別アップデートまたは累積アップデートが含まれます。
アップグレードは、新しいメジャーバージョン (たとえば、5.0 から 6.0) または新しいマイナーバージョン (たとえば、6.1 から 6.2) に移行するプロセスであり、パッチ適用で実行することはできません。

5.2. JBoss EAP 6 のパッチ適用

5.2.1. パッチ適用の仕組み

JBoss のパッチは、zip (全製品) と RPM (製品のサブセット) の 2 つの形式で配布されます。

重要

JBoss 製品のインストールは、必ず zip パッチまたは RPM パッチのいずれかの方法を使用して更新する必要があります。セキュリティーパッチと累積パッチは RPM でのみ配布され、RPM インストールを使用しているユーザーは zip パッチを使用して更新できません。
JBoss のパッチは非同期更新または計画更新のいずれかです。
  • 非同期更新: 既存製品の通常の更新サイクル以外にリリースされる個別のパッチ。これらには、セキュリティーパッチや、Red Hat Global Support Services (GSS) が特定の問題を修正するために提供する他の個別パッチなどがあります。
  • 計画更新: これらには、累積パッチと、既存製品のマイクロアップグレード、マイナーアップグレード、またはメジャーアップグレードなどがあります。累積パッチには、製品の該当バージョンに対してすでに開発された更新がすべて含まれます。
パッチが計画された更新の一部としてリリースされるか、または随時の更新としてリリースされるかは、修正される問題の深刻度によって決まります。通常、深刻度が低い問題は先送りされ、対象製品の次の累積パッチまたはマイナーリリースで解決されます。深刻度が中程度以上の問題は、対象製品の随時の更新で重要度の高い順に解決されます (特定の問題の修正のみが含まれます)。
JBoss 製品のセキュリティー更新はエラータによって提供されます (zip および RPM の両方)。エラータは、解決された欠陥、それらの深刻度、影響する製品、欠陥の詳細、およびパッチへの参照が含まれるリストをカプセル化します。バグ修正の更新はエラータによって通知されません。

重要

パッチの適用後は、実行時に取得される jar が EAP_HOME/modules/system/layers/base/.overlays/$PATCH_ID/$MODULE ディレクトリーから取得されることに注意してください。元のファイルは EAP_HOME/modules/system/layers/base/$MODULE に残ったままになります。セキュリティー上の理由のため、パッチ適用メカニズムにより元の jar ファイルが無効な状態になります。つまり、モジュールを更新するパッチを適用すると、元のモジュールの jar ファイルが変更され使用不可の状態になります。パッチがロールバックされると、元のファイルが使用可能な状態に戻ります。これは、適用されたどのパッチをロールバックするにも、適切なロールバック手順に従う必要があることを意味します。適切なロールバック手順については、「パッチ管理システムを使用して Zip 形式のパッチ適用をロールバックする」を参照してください。
JBoss セキュリティーの欠陥に対する Red Hat の評価の詳細については、「JBoss セキュリティーパッチの深刻度および影響度」を参照してください。
Red Hat は、セキュリティー関連の欠陥をサブスクライバーに通知するメーリングリストを管理しています。「パッチメーリングリストへのサブスクライブ」を参照してください。

5.2.2. Zip/インストーラーインストールへのパッチ適用

5.2.2.1. パッチ管理システム

JBoss EAP 6 パッチ管理システムは、ダウンロードされた zip パッチを単一の JBoss EAP 6 サーバーに適用するために使用されます。JBoss EAP 6 パッチ管理システムには、管理 CLI で patch コマンドを使用するか、管理コンソールを使用してアクセスできます。パッチ管理システムは、管理ドメイン全体で JBoss EAP 6 サーバーインスタンスを自動的にパッチを適用するために使用できませんが、管理ドメインの各サーバーインスタンスにはパッチを個別に適用できます。

重要

RPM を使用してインストールされた JBoss EAP 6 サーバーインスタンスは、パッチ管理システムを使用して更新できません。RPM でインストールされた JBoss EAP 6 サーバーを更新するには、「RPM インストールへのパッチ適用」を参照してください。

注記

パッチ管理システムは、JBoss EAP 6.2 以降のバージョン用に作成されたパッチでのみ使用できます。JBoss EAP 6.2 よりも前のバージョン用のパッチについては、該当するバージョンのドキュメンテーション (https://access.redhat.com/site/documentation/) を参照してください。
パッチの適用以外に、パッチ管理システムはインストールされたパッチの状態に関する基本的な情報を提供し、パッチの適用をすぐにロールバックする方法も提供します。
パッチの適用またはロールバック操作を開始する前に、パッチ管理システムは変更するモジュールとその他のファイルでユーザーによる変更がないかをチェックします。ユーザーによる変更が検出され、conflict-handling スイッチが指定されていない場合は、パッチ管理システムが操作を中止し、競合が存在することを警告します。警告には、競合があるモジュールと他のファイルのリストが含まれます。操作を完了するには、競合の解決方法 (ユーザーによる変更を保持するか、または上書きするか) を指定するスイッチを使用して再試行する必要があります。
以下の表には、管理 CLI の patch コマンドの引数とスイッチがリストされています。

表5.1 patch コマンドの引数とスイッチ

引数またはスイッチ 説明
apply パッチを適用します。
--override-all 競合がある場合に、パッチ操作によりユーザーの変更が上書きされます。
--override-modules モジュールが変更された結果、競合が発生した場合、このスイッチにより、これらの変更がパッチ操作の内容で上書きされます。
--override=path(,path) 指定されたその他のファイルの場合は、競合する変更済みファイルがパッチ操作のファイルで上書きされます。
--preserve=path(,path) 指定されたその他のファイルの場合は、競合する変更済みファイルが保持されます。
--host=HOST_NAME これはドメインモードで使用でき、パッチ操作を実行するホストを指定します。
info 現在インストールされているパッチに関する情報を返します。
history パッチ適用履歴に関する情報を返します。
rollback パッチのアプリケーションがロールバックします。
--patch-id=PATCH_ID ロールバックに必要です。ロールバックするパッチの ID を指定します。
--reset-configuration=TRUE|FALSE ロールバックに必要です。ロールバック操作の一部としてサーバー設定ファイルを復元するかどうかを指定します。
--rollback-to ロールバックするパッチが個別 (1 回だけ) のパッチである場合は、この引数を使用すると、ロールバック操作によって、指定されたパッチの上に適用された他のすべての 1 回だけのパッチもロールバックされます。

5.2.2.2. パッチ管理システムを使用した Zip 形式パッチのインストール

概要

zip 形式のパッチは、管理 CLI または管理コンソールから JBoss EAP 6 パッチ管理システムを使用してインストールできます。

重要

パッチ管理システムは、JBoss EAP 6.2 で追加された機能です。JBoss EAP 6.2 よりも前のバージョンでは、zip 形式のパッチをインストールするプロセスが異なります。該当するバージョンのドキュメンテーション (https://access.redhat.com/site/documentation/) を参照してください。

要件

  • Red Hat カスタマーポータルへの有効なアクセスおよびサブスクリプション。
  • zip 形式でインストールされた JBoss 製品の現在のサブスクリプション。
  • JBoss EAP 6 サーバーを更新するには、管理 CLI または管理コンソールにアクセスします。『管理設定ガイド』の「管理 CLI の起動」または「管理コンソールへログイン」を参照してください。

警告

パッチをインストールする前に、JBoss 製品とカスタマイズされた設定ファイルをすべてバックアップする必要があります。

手順5.1 管理 CLI を使用して zip パッチを JBoss EAP 6 サーバーインスタンスに適用する

  1. カスタマーポータル ( https://access.redhat.com/downloads/) からパッチ zip ファイルをダウンロードします。
  2. 管理 CLI から、以下のコマンドでパッチファイルへの適切なパスを指定してパッチを適用します。
    [standalone@localhost:9999 /] patch apply /path/to/downloaded-patch.zip
    パッチを適用するときに競合が発生した場合、patch ツールは警告を発します。コマンドを再実行して競合を解決する場合に利用可能な patch コマンドのスイッチについては、「パッチ管理システム」を参照してください。
  3. 以下のコマンドを実行して、パッチを適用するために JBoss EAP 6 サーバーを再起動します。
    [standalone@localhost:9999 /] shutdown --restart=true

手順5.2 管理コンソールを使用して zip パッチを JBoss EAP 6 サーバーインスタンスに適用する

  1. カスタマーポータル ( https://access.redhat.com/downloads/) からパッチ zip ファイルをダウンロードします。
  2. 管理コンソールで以下の操作を行います。
    • スタンドアロンサーバーの場合: 画面の上部にある Runtime (ランタイム) タブをクリックし、次に Patch Management (パッチ管理) をクリックします。
    • 管理ドメインの場合: 画面の上部にある Domain (ドメイン) タブをクリックし、Host (ホスト) ドロップダウンメニューからパッチを適用するホストを選択して、Patch Management (パッチ管理) をクリックします。
  3. Apply a New Patch (新規パッチの適用) をクリックします。
    1. 管理ドメインホストにパッチを適用する場合は、次の画面でホストのサーバーをシャットダウンするかどうかを選択し、Next (次へ) をクリックします。
  4. Browse (参照) ボタンをクリックし、適用するダウンロード済みパッチを選択して、Next (次へ) をクリックします。
    1. パッチを適用する場合に競合がある場合は、警告が表示されます。View error details (エラー詳細の表示) をクリックして競合の詳細を表示します。競合がある場合は、操作をキャンセルするか、Override all conflicts (すべての競合のオーバーライド) チェックボックスを選択します。競合をオーバーライドすると、すべてのユーザーの変更がパッチの内容によって上書きされます。
  5. パッチが正常に適用されたら、パッチを有効にするために JBoss EAP 6 サーバーを再起動するかどうかを選択し、Finish (完了) をクリックします。
結果

JBoss EAP 6 サーバーインスタンスに、最新のパッチが適用されます。

5.2.2.3. パッチ管理システムを使用して Zip 形式のパッチ適用をロールバックする

概要

JBoss EAP 6 パッチ管理システムは、以前に適用された zip パッチの適用を管理 CLI または管理コンソールを使用してロールバックするために使用できます。

警告

パッチ管理システムを使用したパッチ適用のロールバックは、一般的なアンインストール機能として使用するものではありません。不適切な結果をもたらしたパッチ適用の直後に使用することを目的としています。

重要

パッチ管理システムは、JBoss EAP 6.2 で追加された機能です。JBoss EAP 6.2 よりも前のバージョンでは、zip 形式のパッチをロールバックするプロセスが異なります。該当するバージョンのドキュメンテーション (https://access.redhat.com/site/documentation/) を参照してください。

要件

  • JBoss EAP 6 パッチ管理システムを使用して以前に適用されたパッチ。
  • JBoss EAP 6 サーバーの管理 CLI または管理コンソールにアクセスします。『管理設定ガイド』の「管理 CLI の起動」または「管理コンソールへログイン」を参照してください。

警告

いずれかの手順に従う場合は、Reset Configuration オプションの値を指定するときに注意してください。
TRUE に設定された場合、パッチロールバックプロセスにより JBoss EAP 6 サーバー設定ファイルがパッチ適用前の状態にロールバックされます。パッチの適用後に JBoss EAP 6 サーバー設定ファイルに行われたすべての変更は失われます。
FALSE に設定された場合、サーバー設定ファイルはロールバックされません。この状況では、ネームスペースなどの設定がパッチにより変更され (設定は有効でなくなり、手動で修正する必要があります)、ロールバック後にサーバーを起動できないことがあります。

手順5.3 管理 CLI を使用して JBoss EAP 6 サーバーインスタンスからパッチをロールバックする

  1. 管理 CLI から patch info コマンドを使用して、ロールバックするパッチの ID を見つけます。
    • 累積パッチの場合、パッチ ID は patch info 出力に表示された最初の cumulative-patch-id の値です。
    • 個別セキュリティーまたはバグ修正 ID は、patch info 出力に表示された最初の patches の値としてリストされます (最も最近に適用された 個別パッチが最初にリストされます)。
  2. 管理 CLI から、以前の手順の適切なパッチ ID を持つパッチをロールバックします。
    [standalone@localhost:9999 /] patch rollback --patch-id=PATCH_ID --reset-configuration=TRUE
    パッチをロールバックするときに競合が発生した場合、patch ツールは警告を発します。コマンドを再実行して競合を解決する場合に利用可能な patch コマンドのスイッチについては、「パッチ管理システム」を参照してください。
  3. パッチのロールバックを反映するために、JBoss EAP 6 サーバーを再起動します。
    [standalone@localhost:9999 /] shutdown --restart=true

手順5.4 管理コンソールを使用して JBoss EAP 6 サーバーインスタンスからパッチをロールバックする

  1. 管理コンソールで以下の操作を行います。
    • スタンドアロンサーバーの場合: 画面の上部にある Runtime (ランタイム) タブをクリックし、次に Patch Management (パッチ管理) をクリックします。
    • 管理ドメインの場合: 画面の上部にある Domain (ドメイン) タブをクリックし、Host (ホスト) ドロップダウンメニューから該当するホストを選択して、Patch Management (パッチ管理) をクリックします。
  2. Recent Patch History (最近のパッチ履歴) テーブルで、ロールバックするパッチを選択し、Rollback (ロールバック) をクリックします。
    1. 管理ドメインホストの場合は、次の画面でホストのサーバーをシャットダウンするかどうかを選択し、Next (次へ) をクリックします。
  3. ロールバックプロセスのオプションを選択し、Next (次へ) をクリックします。
  4. オプションとロールバックするパッチを確認し、Next (次へ) をクリックします。
    1. Override all (すべてのオーバーライド) オプションが選択されておらず、パッチをロールバックするときに競合がある場合は、警告が表示されます。View error details (エラー詳細の表示) をクリックして競合の詳細を表示します。競合がある場合は、操作をキャンセルするか、Choose Options (オプションの選択) をクリックし、Override all (すべてのオーバーライド) チェックボックスを選択した状態で操作を再試行します。競合をオーバーライドすると、すべてのユーザーの変更がロールバック操作によって上書きされます。
  5. パッチが正常にロールバックされたら、変更を反映するために JBoss EAP 6 サーバーを今すぐ再起動するかどうかを選択し、Finish (完了) をクリックします。
結果

パッチ (およびオプションでサーバー設定ファイル) は、JBoss EAP 6 サーバーインスタンスでロールバックされます。

5.2.3. RPM インストールへのパッチ適用

概要

JBoss パッチは、zip (全製品) と RPM (製品のサブセット) の 2 つの形式で配布されます。このタスクでは、RPM 形式でパッチをインストールするのに実行する必要がある手順を示します。

要件

  • Red Hat Network への有効なサブスクリプション。
  • RPM パッケージでインストールされた JBoss 製品の現在のサブスクリプション。

手順5.5 RPM 形式で JBoss 製品へパッチを適用する

JBoss 製品のセキュリティー更新はエラータによって提供されます (zip および RPM)。エラータは、解決された欠陥、それらの深刻度、影響する製品、欠陥の詳細、およびパッチへの参照のリストをカプセル化します。
JBoss 製品の RPM ディストリビューションでは、更新済みの RPM パッケージへの参照がエラータに含まれます。yum を使用して、パッチをインストールすることが可能です。

警告

パッチをインストールする前に、JBoss 製品とカスタマイズされた設定ファイルをすべてバックアップする必要があります。
  1. JBoss watch メーリングリストにサブスクライブするか、JBoss watch メーリングリストのアーカイブを閲覧して、セキュリティーパッチに関する情報を入手します。
  2. エラータを読んでセキュリティーパッチに関する情報を取得し、使用環境の JBoss 製品に適用されることを確認します。
  3. セキュリティーパッチが使用環境の JBoss 製品に適用される場合は、リンク先よりエラータに含まれている更新済みの RPM パッケージをダウンロードします。
  4. パッチをインストールするには、以下のコマンドまたは同様のコマンドを実行します。
    yum update

    重要

    RPM インストールを更新する場合、JBoss 製品は RPM でリリースされた修正で累積的に更新されます。
結果

RPM 形式を使用して JBoss 製品に最新の更新が適用されます。

5.2.4. パッチメーリングリストへのサブスクライブ

概要

Red Hat の JBoss チームは、Red Hat JBoss Middleware 製品のセキュリティーに関する情報をお知らせするメーリングリストを管理しています。ここでは、このリストをサブスクライブする方法について取り上げます。

要件

  • なし

手順5.6 JBoss Watch List をサブスクライブする

  1. 次のリンクをクリックして、JBoss Watch メーリングリストのページへ移動します: JBoss Watch Mailing List
  2. Subscribing to Jboss-watch-list (Jboss-watch-list へのサブスクライブ) にメールアドレスを入力します。
  3. 名前を入力し、パスワードを選択することも可能です。名前とパスワードの指定は任意ですが推奨されます。
  4. Subscribe (サブスクライブ) ボタンを押してサブスクリプションプロセスを開始します。
  5. メーリングリストのアーカイブは JBoss Watch Mailing List Archives で閲覧できます。
結果

メールアドレスの確認後に、JBoss パッチメーリングリストへのサブスクライブが完了し、セキュリティー関連の通知を受け取るようになります。

5.2.5. JBoss セキュリティーパッチの深刻度および影響度

JBoss のセキュリティー欠陥のリスクを伝達するため、Red Hat は low (低)、moderate (中)、important (高)、critical (重大) の 4 段階の深刻度を使用します。さらに、欠陥の影響度を特定するため、CVSS (Common Vulnerability Scoring System: 共通脆弱性評価システム) のバージョン 2 をベースにしたスコアも使用します。

表5.2 JBoss セキュリティーパッチの深刻度

深刻度 説明
Critical (重大)
非認証のリモート攻撃者が簡単に悪用でき、ユーザーとやりとりしなくてもシステムが危険にさらされる (任意コード実行) 欠陥にこの深刻度が適用されます。ワームによって悪用される脆弱性になります。認証されたリモートユーザー、ローカルユーザー、または想定外の設定を必要とする欠陥は重大な欠陥とは分類されません。
Important (高)
リソースの機密性、整合性、または可用性が簡単に危険にさらされる欠陥にこの深刻度が付けられます。ローカルユーザーが権限を取得できる場合、非認証のリモートユーザーが認証によって保護されるリソースを閲覧できる場合、認証されたリモートユーザーが任意コードを実行できる場合、あるいはサービス拒否がローカルまたはリモートユーザーによって引き起こされる場合、この脆弱性タイプになります。
Moderate (中)
悪用するのは比較的困難であっても、リソースの機密性、整合性、または可用性が一部危険にさらされる原因となる欠陥にこの深刻度が付けられます。重大または重要な影響を与える可能性はあっても、欠陥の技術評価を基にするとそれほど簡単には悪用できなかったり、想定外の設定に影響しない脆弱性のタイプになります。
Low (低)
セキュリティーに影響する問題で、前述の深刻度に該当しないものにこの深刻度が適用されます。想定外の状況でのみ悪用される可能性があるとみられる脆弱性や、悪用されても影響が最小限にとどまる脆弱性のタイプになります。
CVSS v2 スコアの影響度は、機密性 (C: Confidentiality)、整合性 (I: Integrity)、可用性 (A: Availability) の 3 つの潜在的な影響を組み合わせて評価します。これら 3 つの要素に、なし (N: None)、一部的 (P: Partial)、または全面的 (C: Complete) のいずれかを評価します。
JBoss サーバープロセスは非特権ユーザーとして実行され、ホストのオペレーティングシステムから分離されているため、JBoss のセキュリティー欠陥に対する影響の評価は N または P のみになります。

例5.1 CVSS v2 の影響スコア

以下の例は、欠陥の悪用によるシステムの機密性への影響はなく、システムの整合性は一部影響があり、システムの可用性は全面的に影響がある場合 (カーネルクラッシュなど、システムが完全に使用できなくなる場合) の CVSS v2 の影響スコアを表しています。
C:N/I:P/A:C
深刻度と CVSS スコアに応じて、固有の環境で発生する問題のリスクを把握し、状況に応じてアップグレードをスケジュールできます。
CVSS2 の詳細は、「CVSS2 Guide」を参照してください。

5.3. JBoss EAP 6 のアップグレード

5.3.1. JBoss EAP 6 ZIP インストールのアップグレード

要件

  • ベースオペレーティングシステムが最新であることを確認します。
  • JBoss EAP 6 がインストールされた以降に変更されたファイルを調べます。
  • 変更されたすべての設定ファイル、デプロイメント、およびユーザーデータをバックアップします。
概要

この手順では、マイナーバージョン間 (JBoss EAP 6.1 から 6.2) で JBoss EAP 6 ZIP インストールをアップグレードします。特定のマイナーバージョンのパッチをインストールするには、節「パッチインストール」を参照してください。JBoss EAP 6 の最新リリースにアップグレードするには、最初に既存のインストールをバックアップする必要があります。

警告

管理対象ドメインについて、各ホストコントローラーをアップグレードする前に、マスターホストコントローラー (または、ドメインコントローラー) インスタンスを最初にアップグレードする必要があります。

手順5.7 JBoss EAP 6 の最新バージョンにアップグレードする

  1. ダウンロードされた ZIP アーカイブを任意の場所に移動します。既存の JBoss EAP 6 インストールとは異なる場所にすることが推奨されます。

    重要

    最新バージョンの JBoss EAP 6 を既存のインストールと同じディレクトリーの場所にインストールする場合は、作業を続行する前に既存のインストールを異なる場所に移動する必要があります。これにより、変更された設定ファイル、デプロイメント、およびアップグレードが失われないようになります。
  2. アーカイブを展開します。この手順により、JBoss EAP 6 の最新リリースのクリーンなインスタンスがインストールされます。
  3. 以前のインストールディレクトリーにある EAP_HOME/domain/ およびEAP_HOME/standalone/ ディレクトリーを、新しいインストールディレクトリーにコピーします。

    注記

    設定ファイルが古い JBoss EAP 6 インストールからコピーされる場合は、新しいリリースの新機能 (新しいサブシステムなど) を有効化できません。これらの新機能を使用するには、古い設定ファイルと新しいバージョンの設定ファイルを比較し、更新する必要があります。
  4. 以前のインストールの bin ディレクトリーに行われた変更を確認し、新しいディレクトリーに同等の変更を行います。

    警告

    bin ディレクトリー内のファイルは、 以前のバージョンのファイルで上書きしないでください。変更は手作業で行う必要があります。
  5. 以前のインストールから変更された残りのファイルを確認し、これらの変更を新しいインストールに移動します。これらのファイルには以下が含まれることがあります。
    • welcome-content ディレクトリー。
    • modules ディレクトリー内のカスタムモジュール。
    • bundles ディレクトリー内のカスタムバンドル。
  6. オプション: JBoss EAP 6 をサービスとして実行するよう以前に設定された場合は、既存のサービスを削除し、アップグレードされたインストールの新しいサービスを設定します。
結果

JBoss EAP 6 ZIP インストールが正常に最新リリースにアップグレードされます。

5.3.2. JBoss EAP 6 RPM インストールのアップグレード

要件

  • ベースオペレーティングシステムが最新の状態であるようにし、システムが Base OS チャンネルへサブスクライブして、このチャンネルから更新を取得できるようにしてください。
  • 正しい JBoss EAP 6 の RHN チャンネルが有効であることを確認します。たとえば、x86 の 64 ビットアーキテクチャーの場合、これは JBoss Application Platform (v 6) の 6Server x86_64 チャンネル (jbappplatform-6-x86_64-server-6-rpm) になります。
  • 変更されたすべての設定ファイル、デプロイメント、およびユーザーデータをバックアップします。
概要

JBoss EAP 6 の最新リリースにアップグレードする場合は、最初に既存のインストールをバックアップする必要があります。このトピックでは、Red Hat Network (RHN) を使用した RPM インストールのアップグレードについて説明します。

警告

管理対象ドメインについて、各ホストコントローラーをアップグレードする前に、マスターホストコントローラー (または、ドメインコントローラー) インスタンスを最初にアップグレードする必要があります。

手順5.8 JBoss EAP 6 の最新リリースへのアップグレード

  1. ターミナルで以下のコマンドを実行してインストールをアップグレードします。
    [user@host] yum update
  2. 変更を含む、作成された各 *.rpmnew ファイルを本番環境設定ファイルに手動でマージします。
結果

JBoss EAP 6 が正常にアップグレードされます。

5.3.3. JBoss EAP のクラスターを 6.2 から 6.3 にアップグレードする

要件

  • なし
概要

JBoss EAP 6.3 は、ノードが異なるバージョンの JBoss EAP サーバーで構成されるクラスターの作成をサポートしていません。したがって、異なるバージョンに基づく混合クラスターはサポートされず、クラスター内のすべてのノードは同じバージョン (6.3) である必要があります。

警告

6.2 クラスターから 6.3 クラスターにトラフィックを移行するアップグレードプロセスでは、すべてのトラフィックを 6.3 クラスターに転送した後、6.2 クラスターのサーバーまたはノードをシャットダウンします。

手順5.9 6.3 で JBoss EAP クラスターをセットアップする

  1. JBoss EAP のクラスターを 6.3 でセットアップする方法については、『JBoss EAP 6.3 管理および設定ガイド』の章「HTTP クラスタリングおよび負荷分散」を参照してください。
  2. JBoss EAP 6.3 管理設定ガイド』の章「クラスター間のトラフィックの転送」に記載されている手順に従って、新しいクラスターにすべてのトラフィックを移行します。
結果

JBoss EAP 6.2 のクラスターが JBoss EAP 6.3 ベースのクラスターへ移行されます。

付録A リファレンス資料

A.1. JBoss EAP 6 に利用可能なダウンロード

JBoss EAP 6 には、さまざまなインストールタイプとオプションコンポーネントが含まれます。これらは、Red Hat カスタマーポータル (https://access.redhat.com/) でダウンロードできます。以下の表は、さまざまなオプションについて説明しています。一部のコンポーネントは、特定のオペレーティングシステムまたはアーキテクチャーにのみ対応しています。

表A.1 利用可能なダウンロード

名前 説明 オペレーティングシステム
Apache HTTP Server
サポートされた各オペレーティングシステムおよびアーキテクチャーのスタンドアロン Apache HTTP サーバーインスタンス。この HTTP サーバーは JBoss EAP 6 と連携して動作することが検証されています。
Red Hat Enterprise Linux 5、Red Hat Enterprise Linux 6、Microsoft Windows Server 2008、Solaris 10、および 11
ネイティブコンポーネント
特定のプラットフォームに最適化するようコンパイルされたコンポーネント。たとえば、Microsoft Windows Server 環境には DLL が提供されます。一部のケースでは、ネイティブコンポーネントによりパフォーマンスが向上することがあります。
Red Hat Enterprise Linux 5、Red Hat Enterprise Linux 6、Microsoft Windows Server 2008、Solaris 10 および 11、Hewlett-Packard HP-UX
ネイティブユーティリティー
サポートされた各オペレーティングシステムおよびアーキテクチャに固有なユーティリティー (オペレーティングシステムで JBoss EAP 6 をサービスとしてインストールし、SSL 暗号化キーおよび証明書を生成するためのスクリプトやユーティリティーなど)。
Red Hat Enterprise Linux 5、Red Hat Enterprise Linux 6、Microsoft Windows Server 2008、Solaris 10 および 11、Hewlett-Packard HP-UX
Web サーバーコネクターネイティブ
Apache、Microsoft、および Oracle iPlanet Web サーバー用プリコンパイルモジュール (HTTP 負荷分散および高可用性機能向け)。これらのバイナリーは広範にテスト済みであり、JBoss EAP 6 と問題なく動作することが確認されています。
Red Hat Enterprise Linux 5、Red Hat Enterprise Linux 6、Microsoft Windows Server 2008、Solaris 10 および 11、Hewlett-Packard HP-UX
Javadoc
JBoss EAP 6 により公開されたすべてのパブリック API 向けドキュメンテーション。これらは、ローカルの HTTP サーバーまたは IDE にインストールしたり、ローカルマシンで表示したりできます。
プラットフォーム非依存
インストーラー
JBoss EAP 6 の Java インストーラー。クイックスタートと Maven リポジトリのインストール手順が含まれます。
プラットフォーム非依存
Maven リポジトリー
ダウンロードし、ローカル開発環境で使用でき、JBoss EAP 6 でビルドされるアプリケーションに共通のアーティファクトを含む Maven リポジトリー。Maven リポジトリーは JBoss EAP 6 インストーラーからも利用可能です。
プラットフォーム非依存
クイックスタート
JBoss EAP 6 で提供される API を使用して Java EE 6 アプリケーションを開発するのに役に立つサンプルアプリケーション。クイックスタートは JBoss EAP 6 インストーラーからも利用可能です。
プラットフォーム非依存
ソースコード
JBoss EAP 6 用 Java ソースコード (独自の環境で再コンパイルしたり、独自に監査したりできます)。
プラットフォーム非依存
アプリケーションプラットフォーム
インストールして、サポート対象の各プラットフォームで実行できる Zip インストールパッケージ。これは、JBoss EAP 6 をインストールする最も一般的な方法です。
プラットフォーム非依存

重要

RPM インストール方法のダウンロードは、カスタマーポータルではなく Red Hat Network (RHN) より利用可能です。

A.2. JBoss EAP 6 のディレクトリー構造

概要

JBoss EAP 6 には、以前のバージョンと比べて単純なディレクトリー構造が含まれます。ここでは、ディレクトリーのリストと、各ディレクトリーの内容物の説明を示します。

standalone/ および domain/ フォルダーのディレクトリー構造も含まれています。

表A.2 最上位のディレクトリーとファイル

名前 目的
appclient/ アプリケーションクライアントコンテナの設定詳細が含まれます。
bin/ Red Hat Enterprise Linux および Microsoft Windows 用 JBoss EAP 6 向け起動スクリプトが含まれます。
bundles/ JBoss EAP 6 の内部機能に関する OSGi バンドルが含まれます。
docs/ ライセンスファイル、スキーマ、およびサンプル
domain/ JBoss EAP 6 が管理対象ドメインとして実行された時に使用される設定ファイル、デプロイメントコンテンツ、および書き込み可能領域。
modules/ サービスが要求したときに JBoss EAP 6 により動的にロードされるモジュール。
standalone/ JBoss EAP 6 がスタンドアロンドメインとして実行された時に使用される設定ファイル、デプロイメントコンテンツ、および書き込み可能領域。
welcome-content/ デフォルトインストールのポート 8080 で利用可能な Welcome Web アプリケーションにより使用されるコンテンツが含まれます。
jboss-modules.jar
モジュールをロードするブートストラップメカニズム。

表A.3 domain/ ディレクトリーにあるディレクトリー

名前 目的
configuration/ 管理ドメイン用の設定ファイル。これらのファイルは管理コンソールや管理 CLI で変更し、直接編集するためのものではありません。
data/ デプロイされたサービスの情報。サービスは、デプロイメントスキャナーではなく、管理コンソールや管理 CLI を使用してデプロイするため、このディレクトリーにファイルを手動で置かないようにしてください。
log/ ローカルインスタンスで実行されるホストおよびプロセスコントローラー用実行時ログファイルが含まれます。
servers/ ドメイン内の各サーバーインスタンス用の同等の data/log/、および tmp/ ディレクトリーが含まれます。これらのディレクトリーには、最上位の domain/ ディレクトリー内の同じディレクトリーに類似したデータが含まれます。
tmp/ 管理対象ドメインに対してローカルユーザーを認証するために管理 CLI で使用される共有キーメカニズムに関するファイルなどの一時データが含まれます。

表A.4 standalone/ ディレクトリーにあるディレクトリー

名前 目的
configuration/ スタンドアロンサーバー用の設定ファイル。これらのファイルは管理コンソールや管理 CLI で変更し、直接編集するためのものではありません。
deployments/ デプロイしたサービスの情報。スタンドアロンサーバーには、デプロイメントスキャナーが含まれているため、このディレクトリーにデプロイ用のアーカイブを置くことができます。しかし、管理コンソールあるいは管理 CLI を使いデプロイメントを管理する方法が推奨されます。
lib/ スタンドアロンサーバーモードに関連する外部ライブラリ。デフォルトは空です。
tmp/ サーバーに対してローカルユーザーを認証するために管理 CLI で使用される共有キーメカニズムに関連するファイルなどの一時データが含まれます。

A.3. JBoss EAP 6 用 RPM パッケージリスト

概要

JBoss EAP 6 は、YUM パッケージグループ JBoss EAP 6 を使用して Red Hat Enterprise Linux 6 上にインストールされます。このグループは以下のパッケージから構成されます。

表A.5 パッケージリスト

パッケージ 説明
jbossas-appclient JEE アプリケーションクライアントコンテナ
jbossas-bundles OSGi バンドル
jbossas-core コアコンポーネント。すべての設定で必要になります。
jbossas-domain ドメイン設定
jbossas-hornetq-native JBoss AS HornetQ ファイルのコンテナ
jbossas-jbossweb-native JBoss Enterprise Web Platform
jbossas-modules-eap JBoss EAP モジュール
jbossas-product-eap 製品設定コンポーネント。製品の実行をカスタマイズします。
jbossas-standalone スタンドアロン設定
jbossas-welcome-content-eap 起動メッセージとコンソールページで使用されるウェルカムコンテンツ

重要

jbossas-hornetq-native パッケージは、JBoss EAP 6 で高可用性を実現するために含まれ、デフォルトで有効になります。

A.4. JBoss EAP 6 用 RPM インストール設定ファイル

概要

JBoss EAP 6 の RPM インストールには、ZIP インストールの追加設定ファイルが 3 つ含まれています。これらのファイルは、アプリケーションサーバーの起動環境を指定するために、サービス初期化スクリプトによって使用されます。これらのファイルの 1 つはすべての JBoss EAP 6 インスタンスに適用され、他の 2 つはスタンドアロンおよびドメインモードサーバーのオーバーライドを提供します。

表A.6 追加 RPM 設定ファイル

ファイル (File) 説明
/etc/jbossas/jbossas.conf このファイルは最初に読み取られ、すべての JBoss EAP 6 インスタンスに適用されます。
/etc/sysconfig/jbossas スタンドアロンサーバーに固有な設定。スタンドアロンサーバーとして実行された場合、ここで指定された値は、jbossas.conf の値よりも優先されます。
/etc/sysconfig/jbossas-domain ドメインモードサーバーに固有な設定。ドメインモードサーバーとして実行された場合、ここで指定された値は jbossas.conf の値よりも優先されます。
下表は使用可能な設定プロパティーとデフォルト値のリストになります。

表A.7 RPM インストール設定プロパティー

プロパティー 説明
JBOSS_USER
JBoss EAP 6 を実行しているシステムユーザーアカウント。このユーザーもファイルの所有権を持ちます。
デフォルト値: jboss
JBOSS_GROUP
JBoss EAP 6 ファイルが属するシステムユーザーグループ。
デフォルト値: jboss
JBOSS_STARTUP_WAIT
start または restart コマンドを受け取った後にサーバーが正常に起動されたことを確認するまで、初期化スクリプトが待機する秒数。
デフォルト値: 60
JBOSS_SHUTDOWN_WAIT
stop または restart コマンドを受け取ったときにサーバーをシャットダウンするまで初期化スクリプトが待機する秒数。
デフォルト値: 20
JBOSS_CONSOLE_LOG
コンソールログハンドラーがリダイレクトされるファイル。
デフォルト値: /var/log/jbossas/$JBOSSCONF/console.log
JAVA_HOME
Java Runtime Environment がインストールされたディレクトリー。
デフォルト値: /usr/lib/jvm/jre
JBOSS_HOME
アプリケーションサーバーファイルがインストールされたディレクトリー。
デフォルト値: /usr/share/jbossas
JAVAPTH
Java 実行可能ファイルがインストールされたパス。
デフォルト値: $JAVA_HOME/bin
JBOSSCONF
このサーバーを起動するサーバーモード (standalone または domain)。
デフォルト値: サーバーモードに応じて standalone または domain
JBOSSSH
サーバーを起動するために使用されるスクリプト。
デフォルト値: $JBOSS_HOME/bin/$JBOSSCONF.sh
JBOSS_SERVER_CONFIG
使用するサーバー設定ファイル。
このプロパティーのデフォルト値はありません。開始時に standalone.xml または domain.xml を指定できます。
JBOSS_HOST_CONFIG このプロパティーにより、ユーザーはホスト設定 (host.xml など) を指定できます。デフォルトとして設定される値はありません。

付録B インストーラーのスクリーンショット

B.1. 言語の選択

Choose the desired language for the installation program.

図B.1 JBoss EAP インストールプログラムの言語の選択

B.2. 使用許諾契約書

Agree to the End User License Agreement to continue.

図B.2 JBoss EAP インストールプログラムの使用許諾契約書

B.3. インストールパス

Define the installation path for the JBoss EAP instance.

図B.3 JBoss EAP インストールプログラムのインストールパス

B.4. インストールするパックの選択

インストールするパックを選択または選択解除します。必要なパックは選択解除できません。
JBoss EAP インストールプログラムでインストールするパックの選択

図B.4 JBoss EAP インストールプログラムでインストールするパックの選択

B.5. 管理ユーザーの作成

Create an administrative user.

図B.5 JBoss EAP インストールプログラム管理ユーザーの作成

B.6. クイックスタートのインストール

Install the JBoss EAP quickstarts.

図B.6 JBoss EAP インストールプログラムクイックスタートのセットアップ

B.7. Maven リポジトリーのセットアップ

JBoss EAP インストールプログラムでの Maven リポジトリーのセットアップ

図B.7 JBoss EAP インストールプログラムでの Maven リポジトリーのセットアップ

B.8. ソケットバインディングのセットアップ

デフォルトのバインディングを使用するかどうかを決定するか、カスタムバインディングを設定します。
Use the default bindings for standalone and domain mode.

図B.8 JBoss EAP インストールプログラムデフォルトソケットバインディング

Configure custom port bindings.

図B.9 JBoss EAP インストールプログラムカスタムポートソケットバインディング

Configure an offset for all default bindings.

図B.10 JBoss EAP インストールプログラムのデフォルトソケットバインディングのオフセット設定

B.9. スタンドアロン設定のカスタムソケットバインディング

スタンドアロンモードのカスタムポートバインディングを設定する場合は、次の一連の画面が表示されます。
Configure custom socket bindings for standalone mode.

図B.11 JBoss EAP インストーラースタンドアロンソケットバインディングの設定

Configure custom socket bindings for standalone HA mode.

図B.12 JBoss EAP インストーラースタンドアロン HA ソケットバインディングの設定

Configure custom socket bindings for standalone full mode.

図B.13 JBoss EAP インストーラースタンドアロン完全スタンドアロンソケットバインディングの設定

Configure custom socket bindings for standalone full HA mode.

図B.14 JBoss EAP インストーラースタンドアロン完全 HA スタンドアロンソケットバインディングの設定

B.10. ドメイン設定のカスタムソケットバインディング

ドメインモードのカスタムポートバインディングを設定する場合は、次の一連の画面が表示されます。
Configure custom socket bindings for the domain host.

図B.15 JBoss EAP インストーラードメインホストソケットバインディングの設定

Configure custom socket bindings for default domain mode.

図B.16 JBoss EAP インストーラーデフォルトドメインソケットバインディングの設定

Configure custom socket bindings for HA domain mode.

図B.17 JBoss EAP インストーラー HA ドメインソケットバインディングの設定

Configure custom socket bindings for full domain mode.

図B.18 JBoss EAP インストーラー完全ドメインソケットバインディングの設定

Configure custom socket bindings for full HA domain mode.

図B.19 JBoss EAP インストーラー完全 HA ドメインソケットバインディングの設定

B.11. サーバーの起動

Select the startup option desired on completion of the installation process

図B.20 JBoss EAP インストールプログラムサーバーの起動

B.12. ロギングレベルの設定

Choose No to skip configuration of logging level.

図B.21 JBoss EAP インストールプログラム設定ロギングレベル

B.13. ランタイム環境の設定

Perform advanced configuration (詳細設定の実行) を選択して、セキュリティー、キャッシュ、LDAP、およびデータソースオプションのインストールおよび設定をカスタマイズします。
JBoss EAP インストールプログラムでのランタイム環境の設定 - デフォルト

図B.22 JBoss EAP インストールプログラムでのランタイム環境の設定 - デフォルト

JBoss EAP インストールプログラムでのランタイム環境の設定 - 詳細

図B.23 JBoss EAP インストールプログラムでのランタイム環境の設定 - 詳細

B.14. インストールコンポーネントの確認

Review the list of selected components. Click the Next to continue or Previous to go back and make changes.

図B.24 JBoss EAP インストールプログラムで選択されたコンポーネントの確認

B.15. インストールの進捗

When the installation progress completes, click Next.

図B.25 JBoss EAP インストールプログラムコンポーネントのインストールの進捗

B.16. パスワードボールトの設定

Configure passwords and other options for the password vault.

図B.26 JBoss EAP インストールパスワードボールトの設定

B.17. SSL セキュリティーの設定

Configure SSL Security.

図B.27 JBoss EAP インストールでの SSL セキュリティーの設定

B.18. LDAP の設定

Configure the LDAP server as the authentication and authorization authority for applications and the management interface.

図B.28 JBoss EAP インストールでの LDAP の設定

B.19. Infinispan の設定

Configure Infinispan cache.

図B.29 JBoss EAP インストールでの Infinispan の設定

B.20. セキュリティードメインの設定

Configure a security domain.
Configure a jsse security domain element.

図B.30 JBoss EAP インストールでのセキュリティードメインの設定

B.21. JDBC ドライバーのセットアップ

Configure a JDBC Driver.

図B.31 JBoss EAP インストールでの JDBC ドライバーの設定

B.22. データソースのセットアップ

Configure the datasource for the JDBC Driver.

図B.32 JBoss EAP インストールでのデータソースのセットアップ

B.23. インストール処理の完了

JBoss EAP インストールプログラム処理の完了

図B.33 JBoss EAP インストールプログラム処理の完了

B.24. ショートカットの作成

Choose whether to create shortcuts and how to configure them. Then click Next.

図B.34 JBoss EAP インストーラーでのショートカットの作成

B.25. インストールスクリプトの生成

Choose whether to generate an installation script containing the selected install options. Then click Done to finsh.

図B.35 JBoss EAP インストールプログラムでのインストールスクリプトの生成

付録C 改訂履歴

改訂履歴
改訂 6.3.0-30Monday August 4 2014Sande Gilda
Red Hat JBoss Enterprise Application Platform 6.3.0.GA

法律上の通知

Copyright © 2014 Red Hat, Inc..
This 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, OpenShift, 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 Torvalds 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.
The 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.