Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

JBoss EAP でのインストール

Red Hat Fuse 7.5

Red Hat JBoss Enterprise Application Platform 7.2.3 での Red Hat Fuse 7.5 のインストール

Fuse Documentation Team

概要

JBoss EAP で実行される Fuse アプリケーションの開発を有効にするインストール手順および管理手順。

はじめに

JBoss EAP で実行される Fuse アプリケーションをプログラマーが JBoss EAP で開発できるようにするために、管理者は Red Hat Fuse を Red Hat JBoss Enterprise Application Platform にインストールすることができます。JBoss EAP の詳細は、JBoss EAP の紹介 を参照してください。

Fuse on JBoss EAP をインストールするには、以下を参照してください。

第1章 Fuse on JBoss EAP のインストール

JBoss EAP で Fuse アプリケーションを開発するには、JBoss EAP をインストールしてから Fuse をインストールします。

前提条件

  • Red Hat カスタマーポータルのログイン認証情報がある。

  • サポートされるバージョンの Java ランタイムがインストールされている。

    Red Hat Fuse でサポートされる構成 に、各オペレーティングシステムでサポートされる Java ランタイムが記載されています。

手順

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

    1. Red Hat カスタマーポータルの Enterprise Application Platform の Software Downloads ページ に移動します。
    2. プロンプトが表示されたら、お客様のアカウントにログインします。
    3. Version ドロップダウンメニューで 7.2 を選択し ます。
    4. Red Hat JBoss Enterprise Application Platform 7.2 Installer パッケージの Download リンクをクリックします。

    5. ダウンロードしたインストーラーを実行します。以下の例の DOWNLOAD_LOCATION は、お使いのシステムでの JBoss EAP インストーラーの場所に置き換えてください。 

      java -jar DOWNLOAD_LOCATION/jboss-eap-7.2-installer.jar
      Copy to Clipboard
    6. 契約条件に同意します。
    7. JBoss EAP ランタイムのインストールパス (以下 EAP_HOME と表記) を選択します。
    8. 管理ユーザーを作成し、この管理ユーザーの認証情報を書き留めておきます。これは Fuse Management Console のログインに必要です。
    9. 残りの画面では、デフォルト設定を許可します。

  2. Enterprise Application Platform Software Downloads > Patches ページに移動し、JBoss EAP 7.2 Update 03 ファイルをダウンロードします。

    Update 03 ファイルの詳細は、リリースノート を参照してください。

  3. JBoss EAP 7.2 Update 03 をインストールします。たとえば、Red Hat Enterprise Linux では、以下のコマンドを使用します。 

    bin/jboss-cli.sh "patch apply jboss-eap-7.2.3-patch.zip"
    Copy to Clipboard

    パッチが正常にインストールされていると、以下の応答が表示されます。 

    {
    "outcome" : "success",
    "result" : {}
}
    Copy to Clipboard
  4. Red Hat Fuse での JBoss EAP パッチの互換性に関する注記やアドバイスは、Red Hat Fuse でサポートされる設定 を確認してください。該当する場合は、追加の JBoss EAP パッチをインストールします。

  5. JBoss EAP 7.2.3 に Fuse 7.5 をインストールします。

    1. Red Hat カスタマーポータルの Red Hat Fuse の Software Downloads ページに移動します。
    2. プロンプトが表示されたら、お客様のアカウントにログインします。
    3. Version ドロップダウンメニューで 7.5.0 を選択 し ます。
    4. Red Hat Fuse 7.5.0 on EAP Installer パッケージの Download リンクをクリックします。
    5. シェルプロンプト (Windows の場合はコマンドプロンプト) を開きます。
    6. Red Hat JBoss Enterprise Application Platform インストールのルートディレクトリーである EAP_HOME ディレクトリーに移動します。

    7. ダウンロードしたインストーラーを実行します。以下の例の DOWNLOAD_LOCATION は、お使いのシステムにダウンロードした Fuse インストーラーの場所に置き換えてください。 

      java -jar DOWNLOAD_LOCATION/fuse-eap-installer-7.5.0.fuse-750024-redhat-00002.jar
      Copy to Clipboard
  6. インストーラーはプロンプトなしで実行され、そのアクティビティーのログが画面に表示されます。

次のステップ

  • JBoss EAP を起動し、Fuse が実行されていることを確認して、Fuse ユーザーを JBoss EAP に追加します。次の章では、これらのタスクの実行方法を説明します。
  • 任意の推奨設定: Maven を Fuse プロジェクトとローカルで使用するように設定します。これについては、7章Maven のローカルでの設定 で説明します。

関連情報

第2章 JBoss EAP の起動

Fuse を起動する前に JBoss Enterprise Application Platform インスタンスを起動する必要があります。これは、Fuse コンポーネントは JBoss Enterprise Application Platform コンテナーで実行されるためです。ここで説明するコマンドは、JBoss EAP をスタンドアロンサーバーとして起動します。

前提条件

  • JBoss EAP 7.2.3 がインストールされている。

手順

  • Red Hat Enterprise Linux の場合は、以下のコマンドを実行します。

    EAP_HOME/bin/standalone.sh

  • Microsoft Windows Server の場合は、以下のコマンドを実行します。

    EAP_HOME\bin\standalone.bat

関連情報

  • 起動スクリプトに渡すことのできるパラメーターの一覧が必要な場合は、-h パラメーターを入力します。
  • 代替および詳細な方法を使用して JBoss Enterprise Application Platform を起動および停止する場合の詳細は Red Hat JBoss Enterprise Application Platform 設定ガイド を参照してください。

第3章 Fuse on JBoss EAP のインストールの確認

Fuse on JBoss EAP のインストール後に、インストールが正常に完了したことを確認します。

前提条件

  • Fuse 7.5 on JBoss EAP 7.2.3 がインストールされている。
  • JBoss EAP サーバーが稼働している。

手順

  1. 以下のファイルを開き、エラーメッセージがログに記録されているかどうかを確認します。

    EAP_HOME/standalone/log/server.log

  2. ブラウザーで Fuse Management Console を開きます。
  3. JBoss EAP のインストール時に作成した管理者の認証情報を入力してログインします。

結果

Fuse Management Console が実行され、ログインできる場合は、Fuse は正常にインストールされています。

第4章 Fuse ユーザーの JBoss EAP への追加

JBoss EAP の add-user スクリプトを実行し、Fuse ユーザーを JBoss EAP に追加します。

前提条件

  • JBoss EAP が実行されている。

手順

  1. EAP_HOME/bin に移動します。

  2. add-user スクリプトを実行します。以下に例を示します。

    ./add-user.sh

  3. プロンプトに応答して新規ユーザーを作成します。

    • Management User は、JBoss EAP での Fuse 管理ユーザーです。
    • Application User は、JBoss EAP での Fuse の非管理ユーザーです。

第5章 JBoss EAP の停止

以下の手順では、管理コマンドラインインターフェイス (CLI) を使用して JBoss EAP を停止します。

前提条件

  • JBoss EAP 7.2.3 が稼働している。

手順

  1. 以下を実行して管理 CLI を起動します。 

    $ EAP_HOME/bin/jboss-cli.sh
    Copy to Clipboard

  2. connect コマンドを実行してサーバーに接続します。 

    [disconnected /] connect
    Copy to Clipboard

  3. shutdown コマンドを実行してサーバーを停止します。 

    [standalone@localhost:9999 /] shutdown
    Copy to Clipboard

  4. quit コマンドを実行して管理 CLI を閉じます。 

    [standalone@localhost:9999 /] quit
    Copy to Clipboard

代替方法

次の方法で JBoss EAP を停止することもできます。

  1. JBoss EAP が実行されているターミナルに移動します。
  2. Ctrl+C を押して JBoss Enterprise Application Platform を停止します。

第6章 Fuse on JBoss EAP インストールへのパッチの適用

この章では、Fuse のホットフィックスパッチを既存の Fuse on JBoss EAP インストールに適用する方法について説明します。これには、以下のトピックが含まれます。

JBoss EAP のアップグレード

基礎となるバージョンの JBoss EAP を、Fuse によってサポートされる別のバージョンにアップグレードすることもできます。その場合、Fuse on JBoss EAP を再インストールおよび再デプロイする必要はありません。詳細は、JBoss EAP のパッチおよびアップグレードガイド を参照してください。

重要

JBoss EAP は、Fuse でサポートされる構成 ページにサポート対象として掲載されているバージョンにのみアップグレードできます。

6.1. Fuse on JBoss EAP のホットフィックスパッチ

Fuse のホットフィックスパッチには、Fuse on JBoss EAP インストールの特定ファイルの更新バージョンが含まれています。通常、これには 1 つ以上の重大なバグの修正のみが含まれています。ホットフィックスパッチは、既存の Red Hat Fuse ディストリビューションに適用され、既存の Fuse ファイルのサブセットのみを更新します。

Fuse on JBoss EAP へのパッチ適用は 2 段階のプロセスです。パッチファイルがまずパッチリポジトリーに追加され、その後 JBoss EAP サーバーにインストールされます。次の図は、JBoss EAP での Fuse パッチ適用プロセスの概要を示しています。

Fuse ホットフィックスのパッチ適用プロセス
パッチリポジトリー
パッチリポジトリーは、JBoss EAP サーバーと同じ JVM で実行される Fuse on JBoss EAP パッチの保持領域です。パッチがリポジトリーに存在していても、JBoss EAP サーバーにパッチがインストールされているとは限りません。最初にリポジトリーにパッチを追加してから、パッチをリポジトリーから JBoss EAP サーバーにインストールする必要があります。
fusepatch ユーティリティー
fusepatch ユーティリティーは、Fuse on JBoss EAP にパッチを適用するためのコマンドラインツールです。Fuse on EAP パッケージのインストール後、fusepatch.sh スクリプト (Linux および UNIX) および fusepatch.bat (Windows) スクリプトは、JBoss EAP サーバーの bin ディレクトリーで利用できます。

6.2. JBoss EAP での Fuse ホットフィックスパッチのインストール

Fuse ホットフィックスパッチは、既存の Fuse インストールにインストールする必要があります。ここでは、fuse-eap-distro-VERSION.fuse-MODULE_ID-BASE_ID がすでに含まれている既存の Fuse インストールにホットフィックスパッチ fuse-eap-distro-VERSION.fuse-MODULE_ID.HOTFIX_ID.zip をインストールする方法を説明します。

前提条件

  • 「Fuse on JBoss EAP のホットフィックスパッチ」。
  • Red Hat サポートからオンデマンドで入手可能なホットフィックスパッチの .zip ファイルをダウンロードする。
  • インストールに必要な追加のステップがある場合に備えて、ホットフィックスパッチファイルに付随する readme.txt ファイルの手順を確認する。
  • パッチを適用する前に、Fuse on JBoss EAP インストールの完全バックアップを作成する。

手順

  1. ホットフィックスパッチファイルを EAP_HOME ディレクトリーにコピーします。

  2. パッチリポジトリーに正しいベースバージョンがすでに追加され、JBoss EAP サーバーにインストールされていることを確認します。たとえば、ベースインストールに MODULE_ID と BASE_ID が含まれる場合は、これらがリポジトリーにインストールされていることを確認します。 

    $ bin/fusepatch.sh --query-repository fuse-eap-distro-VERSION.fuse-MODULE_ID-redhat-BASE_ID
    Copy to Clipboard

    JBoss EAP サーバーに同じ ID がインストールされていることを確認します。 

    $ .bin/fusepatch.sh --query-server fuse-eap-distro-VERSION.fuse-MODULE_ID-redhat-BASE_ID
    Copy to Clipboard

  3. ワンオフホットフィックスパッチファイル fuse-eap-distro-VERSION.fuse-MODULE_ID.HOTFIX_ID.zip の場合は、次のコマンドを入力して、これをリポジトリーに追加し、ベースインストールに関連付けます。 

    $ bin/fusepatch.sh --add file:fuse-eap-distro-VERSION.fuse-MODULE_ID.HOTFIX_ID.zip --one-off fuse-eap-distro-VERSION.fuse-MODULE_ID-BASE_ID
    Copy to Clipboard

  4. JBoss EAP サーバーのベースモジュール fuse-eap-distro-VERSION.fuse-MODULE_ID-BASE_ID を最新バージョンに更新します。 

    $ .bin/fusepatch.sh --update fuse-eap-distro-VERSION.fuse-MODULE_ID-BASE_ID
    Copy to Clipboard
  5. パッチの手順に記載されているインストール後のステップを実行します。

関連情報

  • fusepatch コマンドの詳細は、以下を入力してください。 

    bin/fusepatch.sh --help
    Copy to Clipboard

第7章 Maven のローカルでの設定

一般的な Fuse アプリケーションの開発では、Maven を使用してプロジェクトをビルドおよび管理します。

以下のトピックでは、Maven をローカルで設定する方法を説明します。

7.1. Maven 設定の準備

Maven は、Apache の無料のオープンソースビルドツールです。通常は、Maven を使用して Fuse アプリケーションを構築します。

手順

  1. Maven ダウンロードページ から最新バージョンの Maven をダウンロードします。

  2. システムがインターネットに接続していることを確認します。

    デフォルトの動作では、プロジェクトのビルド中、Maven は外部リポジトリーを検索し、必要なアーティファクトをダウンロードします。Maven はインターネット上でアクセス可能なリポジトリーを探します。

    このデフォルト動作を変更し、Maven によってローカルネットワーク上のリポジトリーのみが検索されるようにすることができます。これは Maven をオフラインモードで実行できることを意味します。オフラインモードでは、Maven によってローカルリポジトリーのアーティファクトが検索されます。「ローカル Maven リポジトリーの使用」 を参照してください。

7.2. Maven への Red Hat リポジトリーの追加

Red Hat Maven リポジトリーにあるアーティファクトにアクセスするには、Red Hat Maven リポジトリーを Maven の settings.xml ファイルに追加する必要があります。Maven は、ユーザーのホームディレクトリーの .m2 ディレクトリーで settings.xml ファイルを探します。ユーザー指定の settings.xml ファイルがない場合、Maven は M2_HOME/conf/settings.xml にあるシステムレベルの settings.xml ファイルを使用します。

前提条件

Red Hat リポジトリーを追加する settings.xml ファイルがある場所を把握している。

手順

以下の例のように、settings.xml ファイルに Red Hat リポジトリーの repository 要素を追加します。 

<?xml version="1.0"?>
<settings>

  <profiles>
    <profile>
      <id>extra-repos</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
      <repositories>
       <repository>
            <id>redhat-ga-repository</id>
            <url>https://maven.repository.redhat.com/ga</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
        <repository>
            <id>redhat-ea-repository</id>
            <url>https://maven.repository.redhat.com/earlyaccess/all</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
        <repository>
          <id>jboss-public</id>
          <name>JBoss Public Repository Group</name>
          <url>https://repository.jboss.org/nexus/content/groups/public/</url>
        </repository>
      </repositories>
      <pluginRepositories>
        <pluginRepository>
            <id>redhat-ga-repository</id>
            <url>https://maven.repository.redhat.com/ga</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </pluginRepository>
        <pluginRepository>
            <id>redhat-ea-repository</id>
            <url>https://maven.repository.redhat.com/earlyaccess/all</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </pluginRepository>
        <pluginRepository>
          <id>jboss-public</id>
          <name>JBoss Public Repository Group</name>
          <url>https://repository.jboss.org/nexus/content/groups/public</url>
        </pluginRepository>
      </pluginRepositories>
    </profile>
  </profiles>

  <activeProfiles>
    <activeProfile>extra-repos</activeProfile>
  </activeProfiles>

</settings>
Copy to Clipboard

7.3. ローカル Maven リポジトリーの使用

インターネットへ接続せずに Apache Karaf コンテナーを実行し、オフライン状態では使用できない依存関係を持つアプリケーションをデプロイする場合、Maven 依存関係プラグインを使用してアプリケーションの依存関係を Maven オフラインリポジトリーにダウンロードすることができます。ダウンロード後、このカスタマイズされた Maven オフラインリポジトリーをインターネットに接続していないマシンに提供することができます。

手順

  1. pom.xml ファイルが含まれるプロジェクトディレクトリーで、以下のようなコマンドを実行し、Maven プロジェクトのリポジトリーをダウンロードします。 

    mvn org.apache.maven.plugins:maven-dependency-plugin:3.1.0:go-offline -Dmaven.repo.local=/tmp/my-project
    Copy to Clipboard

    この例では、プロジェクトのビルドに必要な Maven 依存関係とプラグインは /tmp/my-project ディレクトリーにダウンロードされます。

  2. etc/org.ops4j.pax.url.mvn.cfg ファイルを編集し、org.ops4j.pax.url.mvn.offline を true に設定します。これによりオフラインモードが有効になります。 

    ##
# If set to true, no remote repository will be accessed when resolving artifacts
#
org.ops4j.pax.url.mvn.offline = true
    Copy to Clipboard
  3. このカスタマイズされた Maven オフラインリポジトリーを、インターネットに接続していない内部のマシンに提供します。

7.4. Maven アーティファクトおよびコーディネート

Maven ビルドシステムでは、アーティファクト が基本的なビルディングブロックです。ビルド後のアーティファクトの出力は、通常 JAR や WAR ファイルなどのアーカイブになります。

Maven の主な特徴として、アーティファクトを検索し、検索したアーティファクト間で依存関係を管理できる機能が挙げられます。Maven コーディネート は、特定のアーティファクトの場所を特定する値のセットです。基本的なコーディネートには、以下の形式の 3 つの値があります。

groupId:artifactId:version

Maven は、packaging の値、または packaging 値と classifier 値の両方を使用して基本的なコーディネートを拡張することがあります。Maven コーディネートには以下の形式のいずれかを使用できます。 

groupId:artifactId:version
groupId:artifactId:packaging:version
groupId:artifactId:packaging:classifier:version
Copy to Clipboard

値の説明は次のとおりです。

groupdId
アーティファクトの名前の範囲を定義します。通常、パッケージ名のすべてまたは一部をグループ ID として使用します。たとえば、org.fusesource.example です。
artifactId
グループ名に関連するアーティファクト名を定義します。
version
アーティファクトのバージョンを指定します。バージョン番号には n.n.n.n のように最大 4 つの部分を使用でき、最後の部分には数字以外の文字を使用できます。たとえば 1.0-SNAPSHOT の場合は、最後の部分が英数字のサブ文字列である 0-SNAPSHOT になります。
packaging
プロジェクトのビルド時に生成されるパッケージ化されたエンティティーを定義します。OSGi プロジェクトでは、パッケージングは bundle になります。デフォルト値は jar です。
classifier
同じ POM からビルドされた内容が異なるアーティファクトを区別できるようにします。

次に示すように、アーティファクトの POM ファイル内の要素で、アーティファクトのグループ ID、アーティファクト ID、パッケージング、およびバージョンを定義します。 

<project ... >
  ...
  <groupId>org.fusesource.example</groupId>
  <artifactId>bundle-demo</artifactId>
  <packaging>bundle</packaging>
  <version>1.0-SNAPSHOT</version>
  ...
</project>
Copy to Clipboard

前述のアーティファクトの依存関係を定義するには、以下の dependency 要素を POM ファイルに追加します。 

<project ... >
  ...
  <dependencies>
    <dependency>
      <groupId>org.fusesource.example</groupId>
      <artifactId>bundle-demo</artifactId>
      <version>1.0-SNAPSHOT</version>
    </dependency>
  </dependencies>
  ...
</project>
Copy to Clipboard
注記

前述の依存関係に bundle パッケージを指定する必要はありません。バンドルは特定タイプの JAR ファイルであり、jar はデフォルトの Maven パッケージタイプであるためです。依存関係でパッケージタイプを明示的に指定する必要がある場合は、type 要素を使用できます。

法律上の通知

Copyright © 2023 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
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, the Red Hat 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 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.
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat