手順2.1 ZIP ファイルのダウンロード

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 オプションをクリックします。

手順2.2 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 アーカイブのコンテンツを展開します。

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

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 オプションをクリックします。

手順2.5 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. 以下の表の手順を実行します。

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

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

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

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

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

1. ターゲットマシンへの JBoss EAP 6 のインストール中に、JBoss EAP 6 をインストールしたディレクトリーに Uninstaller というディレクトリーが作成されます。このディレクトリーには、uninstaller.jar というファイルが含まれています。ターミナルウィンドウでこのディレクトリーに移動します。
2. 次のコマンドを実行して、GUI アンインストーラーを起動します。

   java -jar uninstaller.jar

   コマンドを実行すると、下図のとおり、グラフィカルアンインストーラーが起動します。JBoss EAP 6 インストールディレクトリーを削除したい場合はチェックボックスを選択します。

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

   
3. Uninstall ボタンを押して、アンインストールプロセスを開始します。
4. アンインストールプロセスが終了したら、Quit ボタンを押してアンインストーラーを終了します。アンインストールが成功したら、アンインストーラーを起動した場所から Uninstaller ディレクトリーを手動で削除することをお勧めします。

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

1. コンソールで、インストールプロセス中に作成された Uninstaller ディレクトリーに移動します。これは、EAP_HOME の 1 つ上のレベルにあります。
2. 次のコマンドを実行して、テキストベースのアンインストーラーを起動します。

   java -jar uninstaller.jar -console

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

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

1. PackageKit を起動します。

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

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

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

手順2.10 JBoss EAP 6 のインストール (テキストベースの RPM インストール)

1. RPM パッケージをインストールします

   YUM を使用して、groupinstall コマンドでデフォルトの JBoss EAP 6 グループパッケージをインストールします。

   yum groupinstall jboss-eap6

2. 初期化オプションを設定します。

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

手順2.11 自動インストール

• ターミナルで次のコマンドを実行し、自動インストールスクリプトを使用して JBoss EAP 6 をインストールします。

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

  備考

  自動インストールに自動インストールスクリプト (auto.xml) を使用すると、インストーラーはデフォルトですべてのパスワードを入力するためのプロンプトを生成します。

• ターミナルで次のコマンドのいずれかを入力して、ネットワーク上の現在の場所に自動インストールスクリプト (別のネットワーク上の場所にある) を指定します。
  HTTP 経由でインストールスクリプトにアクセスするには、次のコマンドを入力し、network-host を FTP または HTTP サーバーのホスト名に置き換え、auto.xml をインストールスクリプトのファイル名に置き換えます。

  java -jar jboss-eap-6.x.x-installer.jar http://network-host/auto.xml

  FTP 経由でインストールスクリプトにアクセスするには、次のコマンドを入力します。

  java -jar jboss-eap-6.x.x-installer.jar ftp://network-host/auto.xml

手順2.12

1. 変数ファイルにキー値を入力します。

   JBoss EAP 6 インストーラーは、自動インストールスクリプトと自動インストール変数ファイルを作成します。自動インストール変数ファイルには、自動インストールに必要なキーとパスワードのパラメーターのリストが含まれています。キー値を入力するには、自動インストール変数ファイルを開きます。各キーパラメーターに対して有効なキー/パスワード値を入力します。以下に例を示します。

   adminPassword = password#2
   vault.keystorepwd = vaultkeystorepw
   ssl.password = user12345

2. 可変ファイル filename 引数を指定してインストーラーを実行し、自動インストールを開始します。

   variablefile 引数を指定してインストーラーを実行することにより、完全に自動化された JBoss EAP インストールを開始できます。この引数は、変数ファイルのキー/パスワード値 (手順 1) をインストーラーに提供します。完全自動インストールを開始するには、ターミナルを開き、auto.xml と auto.xml.variables をファイルの名前に置き換えて次のコマンドを入力します。

   java -jar jboss-eap-6.x.x-installer.jar auto.xml -variablefile auto.xml.variables

手順2.13

• 変数引数を使用してインストーラーを実行します

  variables 引数を指定してインストーラーを実行し、変数リストを指定して、自動インストールを開始します。variables は、インストール中に変数とそのキーまたはパスワードの値を指定します。インストールプロセスを開始するには、ターミナルを開き、ファイル名 auto.xml と変数の値を独自のものに置き換えて次のコマンドを入力します。

  java -jar jboss-eap-6.x.x-installer.jar auto.xml -variables adminPassword=password#2,vault.keystorepwd=vaultkeystorepw,ssl.password=user12345

  備考

  正常にインストールするには、変数名 (adminPassword、keystorepwd、ssl.password) を空のスペースなしで指定することが重要です。

手順2.14 ネイティブコンポーネントのダウンロードとインストール

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 サブシステムのネイティブコンポーネントをアクティブ化します。

   /subsystem=web:write-attribute(name=native,value=true)

4. JBoss EAP 6 サーバーを再起動して変更を適用します。

手順2.15 ネイティブユーティリティーのダウンロードとインストール

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

手順2.16 ネイティブコンポーネントとネイティブユーティリティーのインストール

1. ネイティブコンポーネントとユーティリティーをインストールします。

   Red Hat Enterprise Linux 5、6、および 7 にネイティブコンポーネントとユーティリティー (およびそれらの依存関係) をインストールするには、管理者アカウントを使用して次のコマンドを実行します。その際に、package_name をインストールする必要のあるネイティブコンポーネントの名前に置き換えます。

   yum install package_name

   次のネイティブコンポーネントをインストールできます: mod_cluster-native、mod_jk、mod_rt、mod_snmp、apache-commons-daemon-jsvc-eap6、httpd、httpd-devel、jbossas-hornetq-native、jbossas-jbossweb-native。

   重要

   yum groupinstall jboss-eap6 コマンドを実行して JBoss EAP 6 グループパッケージをインストールすると、デフォルトでネイティブコンポーネントである jbossas-hornetq-native および jbossas-jbossweb-native がインストールされます。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 コマンドを実行する場合、パッケージ httpd を httpd22 に置き換える必要があります。

2. サーバーの再起動

   JBossEAP6 サーバーを再起動して変更を適用します。

手順2.17 Red Hat Enterprise Linux で RPM メソッドを使用して JBoss EAP 6 をサービスとして設定

1. JBoss EAP 6 をインストールします。

   上記の前提条件セクションにリストされている手順の 1 つを使用し、RPM メソッドを介して JBoss EAP 6 をインストールします。

2. サービスを有効にします。

   JBoss EAP 6 の RPM インストール方法は、必要なサービスファイルを正しい場所にインストールします。サービスとして設定するために必要なのは、次のコマンドを発行することだけです。

   chkconfig jbossas on

   ドメインモードでサービスとして設定するには、次のコマンドを発行します。

   chkconfig jbossas-domain on

手順2.18 サービスの設定

1. 起動スクリプトと設定ファイルを見つけます。

   起動スクリプトと関連の設定ファイルは EAP_HOME/bin/init.d/ ディレクトリーにあります。

2. jboss-eap.conf ファイルの起動オプションをカスタマイズします。

   ファイル jboss-as.conf をテキストエディターで開きます。jboss-as.conf ファイルにはいくつかのオプションがあります。少なくとも、JBOSS_HOME および JBOSS_USER 変数の値を正しく指定ください。これらの変数がない場合は追加します。

3. ファイルをシステムディレクトリーにコピーします。

   1. まだ存在しない場合は /etc/jboss-as を作成します。

      sudo mkdir /etc/jboss-as

   2. 変更した設定ファイルを /etc/jboss-as ディレクトリーにコピーします。

      sudo cp EAP_HOME/bin/init.d/jboss-as.conf /etc/jboss-as

   3. 起動スクリプトを /etc/init.d ディレクトリーにコピーします。

      sudo cp EAP_HOME/bin/init.d/jboss-as-standalone.sh /etc/init.d

      起動スクリプトを実行可能にします。

      sudo chmod +x /etc/init.d/jboss-as-standalone.sh

4. 起動スクリプトをサービスとして追加します。

   jboss-as-standalone.sh サービス管理コマンドを使用して、自動的に起動されるサービスのリストに新しい jboss-eap-rhel.sh サービスを追加します。

   sudo chkconfig --add jboss-as-standalone.sh

5. サービスを起動します。

   Red Hat Enterprise Linux の次のコマンドのいずれかを使用して、サービスが正しくインストールされていることをテストします。
   • Red Hat Enterprise Linux 5 および 6 の場合:

     sudo service jboss-as-standalone.sh start

   • Red Hat Enterprise Linux 7 の場合:

     sudo service jboss-as-standalone start

   すべてが正常に行われた場合は、緑色の OK が表示されます。エラーが発生した場合は、エラーログを確認し、設定ファイルでパスが正しいことを確認してください。

   注記

   Red Hat Enterprise Linux 7 では緑色の OK は表示されません。

6. サーバーを再起動すると、サービスが自動的に開始されるようにします。

   サーバーの再起動時に自動的に開始されるサービスのリストにサービスを追加するには、次のコマンドを発行します。

   sudo chkconfig jboss-as-standalone.sh on

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

1. サービスが実行中の場合は最初にターミナルを開き、サービス名を指定して stop コマンドを実行し、サービスを停止します。

   sudo service jboss-as-standalone.sh stop

2. サービスのリストから JBoss EAP を削除します。

   sudo chkconfig --del jboss-as-standalone.sh

3. システムディレクトリーファイルを削除します。
   1. サービス起動スクリプトを削除します。

      sudo rm /etc/init.d/jboss-as-standalone.sh

   2. サービス設定ファイルを削除します。

      sudo rm /etc/jboss-as/jboss-as.conf

      重要

      /etc/jboss-as は標準のシステムディレクトリーではありません。使用されている他のファイルがない場合にのみ、ディレクトリー自体も削除してください。

      sudo rm -rf /etc/jboss-as/

手順2.20 Microsoft Windows で JBoss EAP 6 のサービスを設定

1. システム環境変数を作成します。

   以下の 2 つのシステム環境変数を作成します。
   • JBoss EAP 6 インストールディレクトリーを示す JBOSS_HOME
   • NOPAUSE=1

2. まだ設定されていない場合は、アーキテクチャーのネイティブユーティリティーパッケージをダウンロードして抽出します。

   Windows Server パッケージのネイティブユーティリティーが Jboss EAP 6 の一部としてインストールされていない場合は、適切な 32 ビットまたは 64 ビットパッケージを Red Hat カスタマーポータル https://access.redhat.com からダウンロードします。JBoss EAP 6 インストールを介してネイティブユーティリティーアーカイブを抽出します。
   これにより、JBoss EAP 6 インストールの EAP_HOME\modules\system\layers\base\ に native ディレクトリーが作成されます

3. サービスをインストールします。

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

   表2.4 service install オプション

   引数またはスイッチ	説明
   /startup	自動起動するサービスを示します。指定しない場合、サービスは手動で開始されるように設定されます。
   /controller HOST:PORT	管理インターフェイスのホストとポート。省略した場合、デフォルトは localhost:9999 です。
   /host [DOMAIN_HOST]	オプションのホストコントローラー名でドメインモードを使用することを示します。ホストコントローラー名を省略した場合は、デフォルトの名前 master が使用されます。
   /loglevel LEVEL	サービスのログレベル: ERROR、INFO、WARN、または 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 が指定されている場合に必要です。
   /config XML_FILE	使用する server-config を指定します。デフォルトは standalone.xml または domain.xml です。
   /hostconfig XML_FILE	ドメインモードでのみ使用するホスト設定を指定します。デフォルトは host.xml です。
   /base directory	サーバー/ドメインコンテンツのベースディレクトリーを完全修飾パスとして指定します。デフォルトは %JBOSS_HOME%\standalone または %JBOSS_HOME%\domain です。
   /logpath path	ログファイルのパスを指定します。/base は、/logpath が定義されてない場合に適用されます。デフォルトは、ドメインモードまたはスタンドアロンモードにより異なり、それぞれ %JBOSS_HOME%\domain\log または %JBOSS_HOME%\standalone\log です。
   /debug	サービスインストールをデバッグモードで実行します。

   以下は、スタンドアロンモードまたはドメインモードで新しいサービスを作成するための基本的な install コマンドの例です。以下のコマンドを実行します。 サービスのログレベルは必要に応じて変更してください。
   • スタンドアロンモード:

     service.bat install /loglevel INFO

   • ドメインモード:
     JBoss EAP 6 ドメインコントローラーのデフォルトマスターを使用していない場合は、master を JBoss EAP 6 ドメインコントローラーの正しいホスト名またはエイリアスに置き換えます。

     service.bat install /host master /loglevel INFO

   JBossEAP6 という名前の新しい Windows サービスが作成されます。

4. Services コンソールで新規サービスを検証します。

   ターミナルで次のコマンドを実行して、Windows Services コンソールを開きます。

   services.msc

   デフォルトのサービス名が使用された場合は、Windows サービスのリストに新しいサービスの名前 JBoss EAP6 が表示されます。サービスコンソールからサービスを起動および停止でき、さらにサービスの起動方法および起動時に関する設定を変更できます。

5. ターミナルから JBoss EAP 6 サービスを起動および停止します。

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

   net start JBossEAP6

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

   net stop JBossEAP6

手順2.21 Microsoft Windows Server からの JBoss EAP 6 サービスのアンインストール

• サービスが実行中の場合は最初にターミナルを開き、サービス名を指定して net stop コマンドを実行し、サービスを停止します。

  net stop JBossEAP6

  ターミナルで、ディレクトリーを EAP_HOME\modules\system\layers\base\native\sbin に変更し、次のコマンドを実行します。

  service uninstall

手順3.5 RPM メソッドで JBoss 製品にパッチを適用

1. JBoss ウォッチメーリングリストのサブスクライバーになるか、JBoss ウォッチメーリングリストアーカイブを参照して、セキュリティーパッチに関する通知を受け取ります。
2. セキュリティーパッチのエラータを読み、ご使用の環境の JBoss 製品に適用されることを確認します。
3. ご使用の環境の JBoss 製品にセキュリティーパッチが適用される場合は、リンクをたどって、エラータに含まれている更新された RPM パッケージをダウンロードしてください。
4. 下記を使用して、

   yum update

   パッチをインストールします。
   重要

   RPM インストールを更新すると、JBoss 製品は RPM でリリースされたすべての修正で累積的に更新されます。

手順3.6 JBoss Watch List のサブスクライブ

1. 次のリンクをクリックして、JBoss Watch メーリングリストページに移動します: JBossWatch メーリングリスト。
2. Subscribing to Jboss-watch-list セクションにメールアドレスを入力します。
3. [名前を入力して、自分のパスワードを選択できます。これはオプションですが、推奨されます。]
4. Subscribe ボタンを押して、サブスクリプションプロセスを開始します。
5. メーリングリストのアーカイブを参照するには、JBoss Watch Mailing List Archives にアクセスします。

手順3.7 JBoss EAP 6 の最新バージョンへのアップグレード

1. ダウンロードした ZIP アーカイブを目的の場所に移動します。既存の JBoss EAP 6 インストールとは別の場所を選択することが推奨されます。
   重要

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

   設定ファイルが以前の JBoss EAP 6 インストールからコピーされると、新しいサブシステムなどの新リリースの新機能はアクティベートされないことがあります。これらの新機能を使用するには、以前の設定ファイルを新バージョンの設定ファイルと比較し、更新する必要があります。
4. 以前のインストールの bin ディレクトリーに加えられた変更を確認し、同等の変更を新しいディレクトリーに追加します。
   警告

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

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

1. ターミナルで次のコマンドを実行して、インストールをアップグレードします。

   yum update

2. 変更を含む作成済みの各 *.rpmnew ファイルを本番設定ファイルに手動でマージします。

手順3.9 JBoss EAP クラスターの設定

1. 6.4 で JBoss EAP クラスターを設定する方法については、J『JBoss EAP 6.4 Administration and Configuration Guide』 の 『HTTP Clustering and Load Balancing』 の章を参照してください。
2. 『JBoss EAP 6.4 Administration and Configuration Guide』 の 『Migrate Traffic between Clusters』 の章で概説されている手順を使用して、すべてのトラフィックをこの新しいクラスターに移行します。