インストールガイド

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

1. https://access.redhat.com にログインします。
2. ダウンロード → RED HAT JBOSS MIDDLEWARE → ダウンロード とメニューの項目を選択します。
3. Product (製品) ドロップダウンメニューより Application Platform (アプリケーションプラットフォーム) を選択します。
4. Version (バージョン) ドロップダウンメニューから正しい JBoss EAP のバージョンを選択します。
5. Application Platform 6.1.0 オプションの隣にある Download (ダウンロード) をクリックします。

手順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 アーカイブの内容を展開します。

手順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 に依存する初期化スクリプトまたは他のスクリプトを作成した場合は、これらを削除します。

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

1. https://access.redhat.com にログインします。
2. ダウンロード → RED HAT JBOSS MIDDLEWARE → ダウンロード とメニューの項目を選択します。
   

   図4.1

3. 次の画面に表示される Product (製品) ドロップダウンメニューより Application Platform (アプリケーションプラットフォーム) を選択します。
4. Application Platform 6.1.0 Installer を選択します。
5. ダウンロード (Download) をクリックします。

手順4.5 インストーラーの起動

1. 次のいずれかのコマンドを実行してインストールプロセスを開始します。

   • グラフィカルモード

     java -jar jboss-eap-6.1.1.ER4-installer.jar

   • テキストモード

     java -jar jboss-eap-6.1.1.ER4-installer.jar -console

2. 手順に従います。

手順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 インストールディレクトリーを削除したい場合はチェックボックスを選択します。
   

   図4.2 グラフィカルインストーラーを使用した 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 をアンイストールします。

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

1. PackageKit の起動

   PackageKit は、Red Hat Enterprise Linux の一部としてインストールされるオープンソースのパッケージ管理ソフトウェアです。ターゲットマシンで システム → 管理 → ソフトウェアの追加/削除 と選択し、PackageKit を起動します。
2. タイプ

   jboss-eap6

   Find (検索) ボタンを押します。結果ボックスに JBoss EAP 6 パッケージが表示されます。
3. JBoss EAP 6 パッケージを選択し、Apply (適用) ボタンを押します。下図を参照してください。
   

   図4.3 JBoss EAP 6 PackageKit インストール

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

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

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

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

   [user@host ~]$ yum groupinstall jboss-eap6

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

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

手順4.10 自動インストール

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

  java -jar jboss-eap-6.1.0-installer.jar SCRIPT_NAME.xml

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

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

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

2. サービスの有効化

   JBoss EAP 6 の RPM インストール方法を使用すると、必要なサービスファイルが適切な場所にインストールされます。次のコマンドを実行するだけでサービスとして設定することができます。

   chkconfig jbossas on

手順4.12 サービスの設定

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 サービスを起動する標準的な構文を使用して、サービスが正しくインストールされたかテストします。

   [user@host bin]$sudo service jboss-as-standalone.sh start

   すべて適切にインストールされている場合は、緑色の [OK] が表示されるはずです。エラーが発生した場合、エラーログを確認し、設定ファイルに正しいパスが指定されていることを確認します。

6. サーバーの再起動時にサービスが自動的に起動されるようにします。

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

   [user@host init.d]$sudo chkconfig jboss-as-standalone.sh on

手順4.13 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 コマンドを使用して新しいサービスを作成できます (以下の表に利用可能なオプションが示されています)。
   Expand

   表4.3 service install オプション

   引数またはスイッチ	説明
   /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 が指定された場合に必要)。

   Show more
   以下に、スタンドアロンまたはドメインモードで新しいサービスを作成する 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

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

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

  net stop JBossEAP6

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

  service uninstall

手順5.1 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 で閲覧できます。

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

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

   yum update

   重要

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

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

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

   重要

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

   警告

   設定ファイルは、以前のバージョンから新しいインストールにコピーしないでください。変更は手動で行う必要があります。
4. 以前のインストールの bin ディレクトリーに行われた変更を確認し、新しいディレクトリーに同等の変更を行います。

   警告

   bin ディレクトリー内のファイルは、 以前のバージョンのファイルで上書きしないでください。変更は手作業で行う必要があります。
5. 以前のインストールから変更された残りのファイルを確認し、これらの変更を新しいインストールに移動します。これらのファイルには以下が含まれることがあります。
   • welcome-content ディレクトリー。
   • modules ディレクトリー内のカスタムモジュール。
   • bundles ディレクトリー内のカスタムバンドル。

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

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

   [user@host] yum update

2. 変更を含む、作成された各 *.rpmnew ファイルを本番環境設定ファイルに手動でマージします。

手順5.7 6.1 での JBoss EAP クラスターのセットアップ

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