Red Hat JBoss Enterprise Application Platform のインストール方法

手順

1. ターミナルエミュレーターを開き、ダウンロードした jboss-eap-installation-manager が含まれるディレクトリーに移動します。

2. 次のコマンドを実行して JBoss EAP をインストールします。

   構文

   ./jboss-eap-installation-manager.sh install --profile eap-8.0 --dir eap-8

   例:

   ./jboss-eap-installation-manager install --profile eap-8.0 --dir eap-8
   Installing profile: eap-8.0
   Using channels:
   # eap-8.0
     manifest: org.jboss.eap.channels:eap-8.0
     repositories:
       id: mrrc
       url: https://maven.repository.redhat.com/ga/

   使用許諾契約書を確認し、その後のプロンプトに従って JBoss EAP をインストールします。

   Accept the agreement(s) [y/N]y
   
   Feature-packs resolved.
   Packages installed.
   Downloaded artifacts.
   JBoss modules installed.
   Configurations generated.
   JBoss examples installed.

手順

1. ターミナルエミュレーターを使用して、jboss-eap-installation-manager が含まれるディレクトリーに移動します。

2. インストールした JBoss EAP のすべてのバージョンの履歴を表示します。

   ./jboss-eap-installation-manager.sh history --dir eap-8

   注記

   このコマンドは、すべての JBoss EAP インストールと更新をそれぞれのインストール状態 ID とともに表示します。

3. 更新時に JBoss EAP に加えられた具体的な変更点を調査します。

   ./jboss-eap-installation-manager.sh history --dir eap-8 --revision <Installation state>

   このコマンドは、更新された特定の JBoss EAP コンポーネントを表示します。

4. 以下のコマンドで JBoss EAP バージョンのインストール状態を指定して、JBoss EAP を元に戻します。

   構文

   ./jboss-eap-installation-manager.sh revert perform --dir eap-8 --revision <Installation state>

   重要

   必ず JBoss EAP バージョンのインストール状態を指定してください。

   例:

   ./jboss-eap-installation-manager revert perform --dir eap-8 --revision 6a6f55eb
   Feature-packs resolved.
   Packages installed.
   Downloaded artifacts.
   JBoss modules installed.
   Configurations generated.
   JBoss examples installed.
   
   Reverted server prepared, comparing changes
   No changes found

   その後のプロンプトに従って、JBoss EAP 更新を元に戻します。

   Continue with revert [y/N]: y
   Applying changes
   
   Server reverted to state ea768519.
   Operation completed in 55.39 seconds.

手順

1. Maven リポジトリーアーカイブファイルを展開します。
2. ターミナルエミュレーターを開き、展開された Maven リポジトリーファイルを含むディレクトリーに移動します。

3. 次のコマンドを実行して JBoss EAP をインストールします。

   ./jboss-eap-installation-manager.sh install --profile eap-8.0 --dir eap-8 --repositories file:maven-repository

手順

1. JBoss EAP インストールチャネルの管理

   1. 次のコマンドを使用して、JBoss EAP インストールが現在サブスクライブしているチャネルを調査します。

      ./jboss-eap-installation-manager.sh channel list --dir eap-8

   2. 次のコマンドを使用して、JBoss EAP インストールを新しいチャネルにサブスクライブします。

      ./jboss-eap-installation-manager.sh channel add --channel-name <CHANNEL_NAME> --manifest <GROUP_ID:ARTIFACT_ID> --repositories <ID::REPOSITORY_URL> --dir eap-8

   3. 次のコマンドを使用して、JBoss EAP インストールをチャネルからサブスクライブを解除します。

      jboss-eap-installation-manager channel remove --channel-name <CHANNEL_NAME> --dir eap-8

   4. 次のコマンドを使用して、サーバーのスナップショットをエクスポートします。

      jboss-eap-installation-manager clone export --dir=<directory> --path=<target_archive>

手順

1. Red Hat カスタマーポータル にログインします。
2. Product Downloads リストから Red Hat JBoss Enterprise Application Platform を選択します。
3. ダウンロード をクリックします。
4. Version ドロップダウンリストから、8.0 を選択します。

手順

1. ターミナルを開き、ダウンロードした JBoss EAP インストーラーファイルが含まれるディレクトリーに移動します。

2. 以下のコマンドを実行して、グラフィカルインストーラーを起動します。

   $ java -jar jboss-eap-8.0.0-installer.jar

3. インストーラーで使用する言語を選択し、OK をクリックします。
4. "I accept the terms of this license agreement" を選択して EULA for RED HAT JBOSS MIDDLEWARE に同意して、Next をクリックします。

5. インストールパスを選択するか、JBoss EAP の Maven ソースリポジトリーを選択し、Next をクリックします。

   

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

   

手順

1. ターミナルを開き、EAP_HOME/Uninstaller に移動します。

2. 以下のコマンドを実行して、グラフィカルアンインストーラーを起動します。

   $ java -jar uninstaller.jar

   

3. プロンプトが表示されたら、Uninstall をクリックしてアンインストールプロセスを開始します。
4. アンインストールプロセスが完了したら、Quit をクリックしてアンインストーラーを終了します。

手順

1. ターミナルエミュレーターを開き、ダウンロードした jboss-eap-installation-manager が含まれるディレクトリーに移動します。

2. 機能パックを提供する、JBoss EAP サーバーのサブスクライブ先のチャネルを定義します。

   ./jboss-eap-installation-manager channel add \
     --channel-name feature-pack-channel \
     --repositories https://fp.repo.org/maven \
     --manifest com.example:feature-pack

3. 追加のアーティファクトを提供するチャネルを作成して、JBoss EAP インストールをそのチャネルにサブスクライブします。詳細は、追加のアーティファクトを提供するチャネルを作成して JBoss EAP インストールをサブスクライブする を参照してください。

1. インストールに必要なレイヤーを指定します。

   $ ./jboss-eap-installation-manager feature-pack add \
     --fpl com.example:feature-pack \
     --layers layer-one,layer-two \
     --dir jboss-eap8

2. インストールに必要なレイヤーを指定し、変更する設定ファイルを選択します。

   $ ./jboss-eap-installation-manager feature-pack add \
     --fpl com.example:feature-pack \
     --layers layer-one,layer-two \
     --target-config standalone-ha.xml
     --dir jboss-eap8

   注記
   • --target-config パラメーターを使用すると、デフォルトの機能パック設定ファイルを変更できます。このパラメーターで、変更を受け取る standalone/configuration フォルダー内の設定ファイルを選択します。
   • 選択した設定ファイルを以前に変更したことがある場合、その設定ファイルは更新によって上書きされません。代わりに、変更は .glnew で終わる名前を持つ新しいファイルに保存されます。競合がある場合は、手動で処理してマージする必要があります。
   • 機能パックはスタンドアロン設定ファイルのみを変更でき、マネージドドメイン内のファイルは変更できません。
   • --target-config パラメーターでサポートされている値は、ベース EAP8/XP5 サーバーによって提供される設定ファイルの名前です。追加の機能パックにより、追加の設定を指定しないでください。

手順

1. ターミナルエミュレーターを開き、jboss-eap-installation-manager を含むディレクトリーに移動します。

2. provisioning.xml ファイルを作成し、インストールする機能パックを定義します。

   <?xml version="1.0" ?>
   
   <installation xmlns="urn:jboss:galleon:provisioning:3.0">
       <feature-pack location="org.jboss.eap:wildfly-ee-galleon-pack:zip">
           <packages>
               <include name="docs.examples.configs"/>
           </packages>
       </feature-pack>
       <feature-pack location="<FEATURE_PACK_GROUP_ID>:<FEATURE_ARTIFACT_ID>:zip">
           <default-configs inherit="false"/>
           <packages inherit="false"/>
       </feature-pack>
       <config model="standalone" name="standalone.xml">
           <layers>
               <include name="<FEATURE_PACK_LAYER>"/>
           </layers>
       </config>
   </installation>

3. channels.yaml ファイルを作成し、JBoss EAP のサブスクライブ先のチャネルを定義します。

     schemaVersion: "2.0.0"
     name: "eap-8.0"
     repositories:
       - id: "mrrc"
         url: "file:/Users/spyrkob/workspaces/set/prospero/prod-prospero/jboss-eap-8.0.0.GA-maven-repository/maven-repository"
     manifest:
       maven:
         groupId: "org.jboss.eap.channels"
         artifactId: "eap-8.0"
     ---
     schemaVersion: "2.0.0"
     name: "feature-pack-channel"
     repositories:
       - id: "feature-pack-repository"
         url: "https://repository.example.com/feature-pack"
     manifest:
       maven:
         groupId: "com.example.channels"
         artifactId: "feature-pack"

4. --defining パラメーターと --channel パラメーターを使用して機能パックをインストールします。

   ./jboss-eap-installation-manager.sh install \
     --definition provisioning.xml \
       --channel channels.yaml \
       --dir jboss-eap8
   Installing galleon provisioning definition: provisioning.xml
   Using channels:
   # eap-8.0
     manifest: org.jboss.eap.channels:eap-8.0
     repositories:
       id: mrrc
       url: file:/tmp/jboss/jboss-eap-8.0.0.GA-maven-repository/maven-repository
   #feature-pack-channel
     manifest: com.example.channels:feature-pack
     repositories:
       id: feature-pack-repository
       url: https://repository.example.com/feature-pack
   
   ===============
   END USER LICENSE AGREEMENT RED HAT JBOSS® MIDDLEWARE™
   ===============
   [...]
   ===============
   
   
   Accept the agreement(s) [y/N]y
   
   Feature-packs resolved.
   Packages installed.
   Downloaded artifacts.
   JBoss modules installed.
   Configurations generated.
   JBoss examples installed.
   
   Server created in /tmp/jboss/jboss-eap8
   Operation completed in 16.30 seconds

手順

1. ターミナルエミュレーターを開き、jboss-eap-installation-manager を含むディレクトリーに移動します。

2. 必要な機能パックを JBoss EAP にインストールし、--repositories パラメーターを使用してオフラインリポジトリーを指定します。

   $ ./jboss-eap-installation-manager feature-pack add \
     --fpl com.example:feature-pack \
     --layers layer-one,layer-two \
     --repositories file:/path/to/eap8/offline_repo,file:/path/to/feature_pack/offline_repo
     --dir jboss-eap8

手順

1. ターミナルエミュレーターを開き、ダウンロードした jboss-eap-installation-manager が含まれるディレクトリーに移動します。

2. JBoss EAP サーバーに追加されたすべての機能パックの履歴を調査します。

   $ ./jboss-eap-installation-manager.sh history --dir jboss-eap-8.0
   [79a553e7] 2023-08-23T13:39:10Z - feature_pack [org.jboss.eap.channels:eap-8.0::1.0.1.GA][com.example.channels:myfaces::1.0.0]
   [744013d2] 2023-08-23T13:38:16Z - config_change
   [928fe586] 2023-08-23T13:22:11Z - install [org.jboss.eap.channels:eap-8.0::1.0.1.GA]

3. JBoss EAP サーバーを停止します。

4. 以前のバージョンに戻します。

   $ ./jboss-eap-installation-manager.sh revert perform --revision 744013d2 --dir jboss-eap-8.0
   Reverting server /tmp/jboss/jboss-eap-8.0 to state 744013d2
   
   Feature-packs resolved.
   Packages installed.
   Downloaded artifacts.
   JBoss modules installed.
   Configurations generated.
   JBoss examples installed.
   
   Reverted server prepared, comparing changes
   Changes found:
     org.jboss.eap:eap-myfaces-feature-pack                8.0.0.GA-redhat-20230816 ==>  []
     org.apache.myfaces.core:myfaces-api                   4.0.0                ==>  []
     org.jboss.eap:eap-myfaces-injection                   8.0.0.GA-redhat-20230816 ==>  []
     org.apache.myfaces.core:myfaces-impl                  4.0.0                ==>  []
   Continue with revert [y/N]: y
   Applying changes
   
   Server reverted to state 977f97dd.
   Operation completed in 51.17 seconds.

手順

1. ターミナルエミュレーターを開き、jboss-eap-installation-manager を含むディレクトリーに移動します。

2. manifest.yaml ファイルを作成します。

   schemaVersion: 1.0.0
   name: MyFaces manifest file
   streams:
     - groupId: org.apache.myfaces.core
       artifactId: myfaces-impl
       version: 4.0.0
     - groupId: org.apache.myfaces.core
       artifactId: myfaces-api
       version: 4.0.0

3. マニフェストをローカルリポジトリーにデプロイします。

   mvn deploy:deploy-file -Dfile=manifest.yaml \
     -DgroupId=com.example.channels -DartifactId=myfaces \
     -Dclassifier=manifest -Dpackaging=yaml -Dversion=1.0.0 \
     -Durl=file:/path/to/local/repository

4. JBoss EAP サーバーを新しいチャネルにサブスクライブします。

   $ ./jboss-eap-installation-manager channel add \
     --channel-name myfaces-channel \
     --repositories https://repo1.maven.org/maven2,file:/path/to/local/repository \
       --manifest com.example.channels:myfaces \
     --dir jboss-eap8

手順

1. Red Hat カスタマーポータル にログインします。
2. Downloads をクリックします。
3. Product Downloads リストから Red Hat JBoss Enterprise Application Platform を選択します。
4. Version ドロップダウンリストで、8.0 を選択します。
5. リストで Red Hat JBoss Enterprise Application Platform 8.0.0 を見つけ、Download リンクをクリックします。
6. オプション: JBoss EAP のインストール先のサーバーおよび場所に、アーカイブファイルを移動します。

7. オペレーティングシステムに合わせて、以下のいずれかのオプションを選択します。

   • Red Hat Enterprise Linux の場合は、管理 CLI で次のコマンドを入力してアーカイブファイルを展開します。

     $ unzip jboss-eap-8.0.0.zip

   • Windows Server の場合は、アーカイブファイルを右クリックし、Extract All を選択します。

     注記

     EAP_HOME は、JBoss EAP インストールの最上位ディレクトリーです。アーカイブファイルを展開してディレクトリーを作成してください。

手順

1. インストールディレクトリーを削除して JBoss EAP をアンインストールします。
2. マシンにインストールされた JBoss EAP に依存するスクリプトを削除します。

手順

1. Red Hat Subscription Manager を入力します。

   重要

   Red Hat Enterprise Linux サーバーベースリポジトリーとマイナー JBoss EAP リポジトリーをサブスクライブするには、以下のコマンドのいずれかを入力します。

2. EAP_MINOR_VERSION を JBoss EAP の目的の マイナー バージョンに置き換えます。たとえば、8.0 などです。

   subscription-manager repos --enable=jb-eap-EAP_MINOR_VERSION-for-rhel-RHEL_VERSION-ARCH-rpms

手順

1. JBoss EAP と JDK 17 をインストールします。

   dnf groupinstall jboss-eap8

2. JBoss EAP と JDK 11 をインストールします。JDK 11 は Red Hat Enterprise Linux 8 以降で使用できます。

   • Red Hat Enterprise Linux 8:

     dnf groupinstall jboss-eap8-jdk11

1. 次のいずれかの方法でデフォルトの JDK を変更します。

   • alternatives コマンドを使用して、システム全体の設定を変更します。

     alternatives --config java

   • JAVA_HOME プロパティーを使用して、JBoss EAP を使用する JDK を変更します。インストールが完了します。RPM インストール場合、デフォルトの EAP_HOME パスは /opt/rh/eap8/root/usr/share/wildfly です。

手順

1. Red Hat Subscription Manager を使用して、既存のリポジトリーからサブスクライブを解除し、新しいリポジトリーにサブスクライブします。

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

手順

1. テキストエディターで jboss-eap.conf を開いて、jboss-eap.conf ファイルの起動オプションを設定し、JBoss EAP インストールのオプションを設定します。

2. サービスの初期化ファイルと設定ファイルをシステムディレクトリーにコピーします。

   1. 変更したサービス設定ファイルを /etc/default ディレクトリーにコピーします。

      注記

      この手順のコマンドを実行するには、root 権限が必要です。su - を実行して root ユーザーに切り替えるか、コマンドの前に sudo で追加します。

      $ sudo cp EAP_HOME/bin/init.d/jboss-eap.conf /etc/default

   2. サービス起動スクリプトを /etc/init.d ディレクトリーにコピーし、実行パーミッションを付与します。

      $ sudo cp EAP_HOME/bin/init.d/jboss-eap-rhel.sh /etc/init.d
      $ sudo chmod +x /etc/init.d/jboss-eap-rhel.sh
      $ sudo restorecon /etc/init.d/jboss-eap-rhel.sh

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

   $ sudo chkconfig --add jboss-eap-rhel.sh

4. 次のコマンドを使用して、サービスが正しくインストールされていることを確認します。

   $ sudo service jboss-eap-rhel start

5. 必要に応じて、RHEL サーバーの起動時にサービスが自動的に起動するようにするには、以下のコマンドを実行します。

   $ sudo chkconfig jboss-eap-rhel.sh on

手順

1. サービスが実行中の場合、ターミナルを開き、以下のコマンドの 1 つを使用してサービスを停止します。

   $ sudo service jboss-eap-rhel.sh stop

   注記

   この手順のコマンドを実行するには、root 権限が必要です。su - を実行して root ユーザーに切り替えるか、コマンドの前に sudo で追加します。

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

   $ sudo chkconfig --del jboss-eap-rhel.sh

3. 設定ファイルと起動スクリプトを削除します。

   $ sudo rm /etc/init.d/jboss-eap-rhel.sh
   $ sudo rm /etc/default/jboss-eap.conf

手順

1. JBoss Core Services Jsvc パッケージをインストールします。

   JBoss Core Services Jsvc パッケージをダウンロードして展開します (まだ設定していない場合)。

   1. ブラウザーを開き、Red Hat カスタマーポータルで JBoss の Software Downloads ページにログインします。
   2. Product ドロップダウンメニューから Apache Jsvc を選択します。
   3. Version ドロップダウンメニューで最新のバージョンを選択します。
   4. システムのプラットフォームとアーキテクチャーに対応する Red Hat JBoss Core Services Apache Jsvc を見つけ、Download リンクをクリックします。
   5. ダウンロードしたアーカイブファイルを、JBoss EAP インストールディレクトリーを含むディレクトリーに展開します。

   6. これにより、JBoss EAP インストールディレクトリーと同じレベルに jbcs-jsvc-<VERSION>` ディレクトリーが作成されます。以下に例を示します。

      C:\Program Files
      ├── jboss-eap-8.0
      │   ├── bin
      │   └── ...
      └── jbcs-jsvc-<VERSION>

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

   1. ターミナルを開き、ディレクトリーを EAP_HOME\bin に変更します。

      以下は、スタンドアロンサーバーまたはマネージドドメインのサーバーに新しいサービスを作成する基本的な service.bat install コマンドの例になります。可能なオプションをすべて表示するには、引数を指定せずに service.bat を実行します。

      重要

      /jbossuser および /jbosspass パラメーターを指定する場合は、JBoss EAP ユーザーのパスワードにハッシュ (#) またはセミコロン (;) が含まれないようにする必要があります。

3. 必要に応じてサービスのログレベルを調整します。

   1. スタンドアロンサーバーの場合:

      service.bat install /loglevel INFO

   2. マネージドドメインのサーバーの場合

      /host パラメーターを使用して、サービスによって管理される JBoss EAP ホストコントローラーの名前を指定します。名前の有効な値をリストするには、管理 CLI で ls/host を実行します。

      以下のコマンドの EAP_HOST_NAME を JBoss EAP ホストコントローラー名に置き換えます。JBoss EAP ホストコントローラー名を指定せずに `/host パラメーターを指定した場合、名前はデフォルトで master になります。

      service.bat install /host EAP_HOST_NAME /loglevel INFO

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

4. サービスコンソールで新しい Service を確認します。

   1. Windows のサービスコンソール (services.msc) を開き、サービスが作成されたことを確認します。

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

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

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

      net start JBossEAP8

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

      net stop JBossEAP8

手順

1. setx コマンドを使用して、2 つの環境変数を設定します。

   1. JBOSS_HOME 変数のパスを JBoss EAP のインストールディレクトリーに設定します。
   2. jboss-cli.bat スクリプトには、コードの "x%NOPAUSE%" == "x" pause の行が含まれます。このコードを使用すると、pause コマンド発行時にステータスメッセージが作成されます。これらのメッセージを無効にするには、NOPAUSE 変数の値を指定する必要があります。たとえば、NOPAUSE 変数を NOPAUSE=true に設定すると、スクリプトの完了時にステータスメッセージが表示されなくなります。
2. setx コマンドを使用して、JBOSS_HOME と NOPAUSE の 2 つのシステム環境変数を作成します。

手順

1. サービスが実行中の場合はコマンドプロンプトを開き、サービス名を指定して net stop コマンドを使用することでサービスを停止します。

   net stop JBossEAP8

2. コマンドプロンプトで、EAP_HOME\bin ディレクトリーに移動し、以下のコマンドを実行します。

   service.bat uninstall