Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

第3章 JBoss EAP のインストール

3.1. ZIP インストール

3.1.1. JBoss EAP のダウンロード (ZIP インストール)

JBoss EAP の ZIP ファイルは Red Hat カスタマーポータルから入手できます。ZIP ファイルのインストールはプラットフォームに依存します。

JBoss EAP の ZIP ファイルのダウンロード

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

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

JBoss EAP の ZIP インストールファイルをダウンロードしたら、パッケージの内容を展開するとインストールできます。

  1. 必要な場合は、JBoss EAP をインストールするサーバーおよび場所に ZIP ファイルを移動します。

    • JBoss EAP を実行するユーザーは、このディレクトリーへの読み書きアクセスが必要になります。
  2. ZIP アーカイブを展開します。

    $ unzip jboss-eap-7.x.x.zip
    注記

    Windows Server の場合は ZIP ファイルを右クリックし、すべて展開 を選択します。

ZIP アーカイブを展開して作成したディレクトリーは、JBoss EAP インストールの最上位ディレクトリーとなります。このディレクトリーを EAP_HOME と呼びます。

3.2. インストーラーによるインストール

3.2.1. JBoss EAP のダウンロード (インストーラーによるインストール)

JBoss EAP JAR インストーラーは Red Hat カスタマーポータルから入手できます。.jar アーカイブを使用して、グラフィカルまたはテキストベースのインストーラーを実行できます。サポートされるすべてのプラットフォームでは、インストーラーを用いて JBoss EAP をインストールする方法が推奨されます。

JBoss EAP インストーラーのダウンロード

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

3.2.2. JBoss EAP インストーラーの実行

JBoss EAP JAR インストーラーは、グラフィカルまたはテキストモードで実行できます。

JBoss EAP グラフィカルインストーラーの実行

  1. ターミナルを開き、ダウンロードした JBoss EAP インストーラーの JAR ファイルが含まれるディレクトリーに移動します。
  2. 以下のコマンドを実行して、グラフィカルインストーラーを起動します。

    java -jar jboss-eap-7.x.x-installer.jar
    注記

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

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

    または

    java -jar -d64 jboss-eap-7.x.x-installer.jar
  3. 以下の表の手順を実行します。

    表3.1 JBoss EAP インストーラー画面

    画面の名前表示されるタイミング説明

    言語の選択

    常時

    インストーラーの言語を選択し、OK をクリックします。

    ライセンス同意書

    常時

    RED HAT JBOSS MIDDLEWARE のエンドユーザーライセンス契約。

    「I accept the terms of this license agreement (ライセンス契約の内容に同意します)」を選択し、Next をクリックします。

    インストールパス

    常時

    JBoss EAP のインストールパスを選択し、Next をクリックします。

    コンポーネントの選択

    常時

    インストールするコンポーネントを選択します。必要なコンポーネントは選択を解除できません。

    図3.1 JBoss EAP インストーラー: コンポーネント選択画面

    JBoss EAP Installer - Component Selection Screen

    管理ユーザーの作成

    常時

    管理ユーザーを作成し、パスワードを割り当てます。次に Next をクリックします。

    インストールの概要

    常時

    インストールオプションを確認した後、Next をクリックします。

    コンポーネントのインストール

    常時

    インストールの処理が完了したら、Next をクリックします。

    ランタイム環境の設定

    常時

    JBoss EAP インストールのデフォルト設定を選択するか、インストーラーで詳細設定を実行することができます。デフォルト設定を選択しても、後で JBoss EAP 管理インターフェースを使用して設定を変更できます。

    Perform default configuration または Perform advanced configuration を選択し、設定する項目を選択してから Next をクリックします。

    図3.2 JBoss EAP インストーラー: ランタイム環境設定画面

    JBoss EAP Installer - Configure Runtime Environment Screen

    パスワード vault の設定

    ランタイム環境の詳細設定でパスワード vault のインストールを選択したとき。

    Configure a password vault to store all your sensitive passwords in an encrypted keystore, then click Next. For more information, see the password vault documentation in the How To Configure Server Security guide.

    図3.3 JBoss EAP インストーラー: パスワード vault 設定画面

    JBoss EAP Installer - Configure Password Vault Screen

    SSL セキュリティー

    ランタイム環境の詳細設定で SSL セキュリティーの有効化を選択したとき。

    Specify an SSL keystore and the keystore password for securing the JBoss EAP management interfaces, then click Next. For more information, see the documentation on securing the management interfaces in the How To Configure Server Security guide.

    警告

    Red Hat では、影響するすべてのパッケージで TLSv1.1 または TLSv1.2 を利用するために SSLv2、SSLv3、および TLSv1.0 を明示的に無効化することを推奨しています。

    LDAP の設定

    ランタイム環境の詳細設定で LDAP 認証の有効化を選択したとき。

    Enable LDAP authentication to use an LDAP directory server as the authentication source for the management console, management CLI, and management API. When you are done, click Next. For more information, see the LDAP documentation in the How to Configure Identity Management guide.

    図3.4 JBoss EAP インストーラー: LDAP 設定画面

    JBoss EAP Installer - LDAP Configuration Screen

    LDAP セキュリティーレルムの設定

    ランタイム環境の詳細設定で LDAP 認証の有効化を選択したとき。

    前のステップで定義された LDAP 接続を使用して、新しいセキュリティーレルムが作成され、管理インターフェースに関連付けされます。

    Specify the values for your LDAP environment, then click Next. For more information, see the LDAP documentation in the How to Configure Identity Management guide.

    図3.5 JBoss EAP インストーラー: LDAP セキュリティーレルム設定画面

    JBoss EAP Installer - LDAP Security Realm Configuration Screen

    Infinispan の設定

    ランタイム環境の詳細設定で Infinispan キャッシュのインストールを選択したとき。

    Create an Infinispan cache for managing cached data. Give an Infinispan name and configure the other fields, then click Next. For more information, see the Infinispan documentation in the Configuration Guide.

    図3.6 JBoss EAP インストーラー: Infinispan 設定画面

    JBoss EAP Installer - Infinispan Configuration Screen

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

    ランタイム環境の詳細設定でセキュリティードメインの追加を選択したとき。

    Configure a security domain for the JBoss EAP server instance. Most of the fields are already populated with default values and do not need modification. When you are done, click Next. For more information, see Security Domains in the Security Architecture Guide.

    図3.7 JBoss EAP インストーラー: セキュリティードメイン設定画面

    JBoss EAP Installer - Security Domain Configuration Screen

    JSSE 設定

    ランタイム環境の詳細設定でセキュリティードメインの追加を選択したとき。

    キーストアまたはトラストストアのいずれかを使用して、前のステップで定義されたセキュリティードメインの Java Secure Socket Extension (JSSE) を設定します。設定が終わったら Next をクリックします。

    図3.8 JBoss EAP インストーラー: JSSE 設定画面

    JBoss EAP Installer - JSSE Configuration Screen

    クイックスタート

    ランタイム環境の詳細設定でクイックスタートのインストールを選択したとき。

    クイックスタートのインストールパスを選択し、Next をクリックします。

    Maven リポジトリーのセットアップ

    ランタイム環境の詳細設定でクイックスタートのインストールを選択したとき。

    Maven リポジトリーと設定ファイルを選択します。

    図3.9 JBoss EAP インストーラー: Maven リポジトリーセットアップ画面

    JBoss EAP Installer - Installer - Maven Repository Setup Screen

    ソケットバインディング

    ランタイム環境の詳細設定でサーバーポートバインディングの設定を選択したとき。

    インストールでデフォルトのポートバインディングを使用するかどうか、すべてのデフォルトバインディングにポートオフセットを設定するかどうか、またはカスタムポートバインディングを設定するかどうかを決定します。

    ポートオフセットの設定を選択した場合は、オフセット番号を選択します。

    カスタムバインディングの設定を選択した場合は、ポートを設定するモード (スタンドアロンモード、ドメインモード、または両方のモード) を選択します。

    ホストが IPv6 専用で設定されている場合は、Enable pure IPv6 configuration (ピュア IPv6 設定を有効化) チェックボックスを選択します。これにより、インストーラーによって必要な設定変更が行われます。

    Next をクリックします。

    図3.10 JBoss EAP インストーラー: ソケットバインディング画面

    JBoss EAP Installer - Socket Bindings Screen

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

    スタンドアロンモードにカスタムポートバインディングを設定することを選択したとき。

    各スタンドアロン設定 (standalonestandalone hastandalone full、および standalone full-ha) にポートおよびシステムプロパティーを設定し、Next をクリックします。

    図3.11 JBoss EAP インストーラー: スタンドアロン設定のカスタムソケットバインディングの画面

    JBoss EAP Installer - Custom Socket Bindings for Standalone Configurations Screen

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

    ドメインモードにカスタムポートバインディングを設定することを選択したとき。

    ホスト設定 (domain host) および各ドメインプロファイル (domain defaultdomain hadomain full、および domain full-ha) にポートおよびシステムプロパティーを設定し、Next をクリックします。

    図3.12 JBoss EAP インストーラー: ドメイン設定のカスタムソケットバインディングの画面

    JBoss EAP Installer - Custom Socket Bindings for Domain Configurations Screen

    ロギングのオプション

    ランタイム環境の詳細設定でロギングレベルの設定を選択したとき。

    希望するロギングレベルを選択し、Next をクリックします。

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

    ランタイム環境の詳細設定で JDBC ドライバーをインストールすることを選択したとき。

    Install and setup a JDBC driver. Choose the appropriate driver vendor from the drop down list and specify the driver JAR location(s). When you are done, click Next. For more information, see the datasource JDBC driver section in the Configuration Guide.

    図3.13 JBoss EAP インストーラー: JDBC ドライバーセットアップ画面

    JBoss EAP Installer - JDBC Driver Setup Screen

    データソースのセットアップ

    ランタイム環境の詳細設定で JDBC ドライバーとデータソースのインストールを選択したとき。

    Configure a datasource which can be used by applications. Provide a datasource name and configure the other options, then click Next. For more information, see the details of datasource management in the Configuration Guide.

    図3.14 JBoss EAP インストーラー: データソースセットアップ画面

    JBoss EAP Installer - Datasource Setup Screen

    サーバーの設定

    常時

    設定の処理が完了したら Next をクリックします。

    ショートカットの設定

    常時

    Create shortcuts in the Start-Menu (スタートメニューにショートカットを作成) チェックボックスを選択してショートカットを作成します。英数字、ダッシュ (-)、および アンダースコア (_) のみを使用できます。Microsoft Windows では、スラッシュ (/) とバックスラッシュ (\) も使用できます。Next をクリックします。

    インストールの完了

    常時

    選択したインストールオプションを後々自動インストールで使用する場合は Generate installation script and properties file (インストールスクリプトおよびプロパティーファイルの生成) をクリックします。次に、Done (完了) をクリックします。

    インストールが完了しました。インストーラーによって作成されたディレクトリーはサーバーの最上位ディレクトリーとなります。このディレクトリーを EAP_HOME と呼びます。

JBoss EAP のテキストベースインストーラーの実行

  1. ターミナルを開き、ダウンロードした JBoss EAP インストーラーの JAR が含まれるディレクトリーに移動します。
  2. 以下のコマンドを実行して、テキストベースのインストーラーを起動します。

    java -jar jboss-eap-7.x.x-installer.jar -console
  3. 指示に従って JBoss EAP をインストールします。インストーラーによって作成されたディレクトリーはサーバーの最上位ディレクトリーとなります。このディレクトリーを EAP_HOME と呼びます。

3.3. RPM インストール

注記

Red Hat Satellite を使用して JBoss EAP インストールを管理するユーザーは、JBoss EAP 7 インストールの管理に Red Hat Satellite 6 を使用することが推奨されますが、Satellite 5 のユーザー向けに以下の Red Hat Network (RHN) チャンネルも提供されます。

  • Red Hat Enterprise Linux 6 向け:

    • jbappplatform-7.0-i386-server-6-rpm
    • jbappplatform-7.0-x86_64-server-6-rpm
  • Red Hat Enterprise Linux 7 向け:

    • jbappplatform-7.0-x86_64-server-7-rpm

Red Hat Satellite 6 ユーザーは、リポジトリーの選択 に記載されているリポジトリーを使用できます。

注記

Red Hat Enterprise Linux 7 より、チャンネル という表現は リポジトリー に変更になりました。これらの手順では、リポジトリー という表現のみが使用されています。

3.3.1. リポジトリーの選択

RPM から JBoss EAP をインストールするには、Red Hat Enterprise Linux Server ベースのソフトウェアリポジトリーへのサブスクリプションと、特定の JBoss EAP リポジトリーへのサブスクリプションの両方が必要になります。

JBoss EAP リポジトリーでは、現行の JBoss EAP リポジトリーまたはマイナー JBoss EAP リポジトリーのいずれかのサブスクリプションが必要になります。

現行の JBoss EAP リポジトリー

現行の リポジトリーは最新の JBoss EAP 7 リリースを提供します。JBoss EAP インストールを更新するときに、マイナーアップグレードを含む JBoss EAP 7 のすべてのアップグレードが提供されます。

たとえば、このリポジトリーから更新を行うと、JBoss EAP 7.0 から JBoss EAP 7.1 へのアップグレードが含まれます (7.1 がリリース済みの場合)。

マイナー JBoss EAP リポジトリー

マイナーリポジトリーは、JBoss EAP 7 の特定のマイナーリリースと適用対象となるすべてのパッチを提供します。これにより、JBoss EAP 7 の同じマイナーバージョンを維持しながら最新の深刻度が高いパッチとセキュリティーパッチを適用できます。

たとえば、このリポジトリーから更新を行うと、指定の JBoss EAP マイナーバージョンのパッチおよびセキュリティー更新が含まれますが、JBoss EAP 7.0 から JBoss EAP 7.1 へのアップグレードは含まれません (7.1 がリリース済みの場合)。

注記

本番環境では、マイナー JBoss EAP リポジトリーの使用が推奨されます。これにより、サブシステムモジュールで予期せぬ変更が発生するリスクや、予期せぬ JBoss EAP のアップグレードによって設定の変更が必要になるリスクを軽減します。アップグレードを受信したい場合は、後でいつでも リポジトリーを変更 できます。

3.3.1.1. 現行の JBoss EAP 7 リポジトリーのサブスクリプション

  1. Red Hat サブスクリプションマネージャーを使用して、Red Hat Enterprise Linux システムがお持ちのアカウントに登録されているようにしてください。詳細は、Red Hat Subscription Management に関する情報 を参照してください。
  2. Red Hat サブスクリプションマネージャーを使用して以下のコマンドを実行し、「現行」のJBoss EAP 7 リポジトリーへサブスクライブします。ご使用の Red Hat Enterprise Linux のバージョンに応じて、RHEL_VERSION6 または 7 に置き換えます。

    subscription-manager repos --enable=jb-eap-7-for-rhel-RHEL_VERSION-server-rpms

3.3.1.2. マイナー JBoss EAP 7 リポジトリーのサブスクリプション

  1. Red Hat サブスクリプションマネージャーを使用して、Red Hat Enterprise Linux システムがお持ちのアカウントに登録されているようにしてください。詳細は、Red Hat Subscription Management に関する情報 を参照してください。
  2. Red Hat サブスクリプションマネージャーを使用して以下のコマンドを実行し、マイナー JBoss EAP 7 リポジトリーへサブスクライブします。必ず以下を行なってください。

    • EAP_MINOR_VERSION を目的の JBoss EAP マイナー バージョンに置き換えてください。たとえば、本リリースのマイナーバージョンの場合は 7.0 を入力します。
    • ご使用の Red Hat Enterprise Linux のバージョンに応じて、RHEL_VERSION6 または 7 に置き換えてください。
    subscription-manager repos --enable=jb-eap-EAP_MINOR_VERSION-for-rhel-RHEL_VERSION-server-rpms

3.3.2. JBoss EAP のインストール (RPM インストール)

  1. 以下のコマンドを実行して、サブスクライブしたリポジトリーから JBoss EAP をインストールします。

    yum groupinstall jboss-eap7

インストールが完了します。 RPM インストールのデフォルトの EAP_HOME パスは /opt/rh/eap7/root/usr/share/wildfly になります。

3.3.3. リポジトリーの変更

JBoss EAP インストールのライフサイクルの間に、サブスクライブする JBoss EAP リポジトリーを変更する必要が生じる可能性があります。リポジトリーの変更は以下の場合のみサポートされます。

「現行」のリポジトリーからマイナーリポジトリーへの変更
最新のマイナーリポジトリーへ変更する場合はサポートされます。
マイナーリポジトリーから他のマイナーリポジトリーへの変更
JBoss EAP の次のマイナーバージョンへ変更する場合はサポートされます。たとえば、JBoss EAP 7.0 から JBoss EAP 7.1 への変更はサポートされますが、 JBoss EAP 7.0 から JBoss EAP 7.2 への変更はサポートされません。
マイナーリポジトリーから「現行」のリポジトリーへの変更
最新のマイナーリポジトリーから変更する場合はサポートされます。

要件

JBoss EAP リポジトリーの変更

  1. リポジトリーを変更する前に、以下のコマンドを実行して JBoss EAP インストールに適用できる更新がすべて適用されるようにしてください。

    yum update
  2. Red Hat サブスクリプションマネージャーを使用して、現在サブスクライブしているリポジトリーのサブスクリプションを解除し、変更する新しいリポジトリーにサブスクライブします。以下のコマンドの EXISTING_REPOSITORY および NEW_REPOSITORY は適切なリポジトリー名に置き換えてください。

    subscription-manager repos --disable=EXISTING_REPOSITORY --enable=NEW_REPOSITORY

3.4. 自動インストーラーによるインストール

JAR インストーラーを使用して JBoss EAP をインストールすると、以前のインストールから生成されたインストールスクリプトを使用して、今後のインストールを同じ設定内容で自動化できます。

警告

自動化インストーラーは後方互換性を維持しません。旧バージョンの JBoss EAP から生成されたインストールスクリプトを自動インストーラーに使用することはできません。同じマイナーバージョンの JBoss EAP (JBoss EAP 7.0 など) から生成されたインストールスクリプトのみを使用してください。

要件

  • JAR インストーラーを使用して自動インストールスクリプトを生成します。自動インストールスクリプトは XML ファイルです。

自動インストーラーによるインストール

  1. ターミナルを開き、ダウンロードした JBoss EAP インストーラーの JAR ファイルが含まれるディレクトリーに移動します。
  2. 以下のコマンドを実行し、自動インストールスクリプトの XML ファイルを使用して JBoss EAP をインストールします。

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

    デフォルトでは、JBoss EAP の設定に必要なパスワードを入力するよう求められます。インストール用のパスワードを事前設定すると、無人インストールを実行できます。

    注記

    自動インストールスクリプトの XML ファイルをネットワークホストに保存し、そのファイルをインストールで使用するよう、HTTP または FTP を使用してインストーラーを示すことができます。例は次のとおりです。

    java -jar jboss-eap-7.x.x-installer.jar http://network-host.local/auto.xml
    java -jar jboss-eap-7.x.x-installer.jar ftp://network-host.local/auto.xml

3.4.1. 無人自動インストーラーによるインストール

要件

  • JAR インストーラーを使用して自動インストールスクリプトを生成します。自動インストールスクリプトは XML ファイルです。

無人自動インストーラーによるインストールを実行するには、JBoss EAP のインストールに必要なパスワードを事前設定する必要があります。

以前のインストーラーによるインストールからインストールスクリプトの XML ファイルが生成されると、未完成のインストールスクリプト変数ファイルも生成されます。このファイル名はインストールスクリプトファイルと同じですが、末尾に .variables が付きます。

この変数ファイルには、無人自動インストールに必要なキーおよびパスワードパラメーターのリストが含まれています。

必要はパスワードは、完全な変数ファイルまたはインストーラーコマンド実行時の引数として指定できます。

変数ファイルを使用した無人自動インストーラーによるインストール

  1. テキストエディターで .variables ファイルを開き、各キーにパスワードの値を指定します。例を以下に示します。

    adminPassword = password#2
    vault.keystorepwd = vaultkeystorepw
    ssl.password = user12345
  2. 自動インストールスクリプトの XML ファイルを使用してインストーラーを実行します。完全な変数ファイルがインストールスクリプトの XML ファイルと同じディレクトリーにあり、ファイル名が変更されていなければ、インストーラーによって変数ファイルが自動的に検出されます。

    java -jar jboss-eap-7.x.x-installer.jar auto.xml
    
    Checking for corresponding .variables file
    Variables file detected: auto.xml.variables
    [ Starting automated installation ]
    ...

    別の方法として、-variablefile を使用して変数ファイルへのパスを指定することもできます。

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

-variables 引数を使用した無人自動インストーラーによるインストール

  1. 自動インストールスクリプトの XML ファイルを使用してインストーラーを実行し、-variables 引数を使用して、必要なパスワードをキーと値のペアとして指定します。例を以下に示します。

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

    -variables のキーと値のペアを指定するとき、空白を入れないことが重要になります。