Apache Karaf へのインストール

手順

1. Fuse をインストールするシステムで、以下を確認します。

   • 250 MB の空きディスク領域がある
   • 2 GB の RAM がある

   このハードウェア要件は、Fuse on Apache Karaf の完全なインストール用です。さらに、Fuse を実行しているシステムでは、キャッシュ、永続メッセージストア、およびその他の機能用に領域が必要です。実際の要件は、Fuse アプリケーションの用途によって異なります。

2. Fuse をインストールするシステムがサポート対象のプラットフォームを実行していることを確認します。Red Hat は、Red Hat Fuse でサポートされる構成 に記載のプラットフォームで、Fuse 製品をテストおよびサポートします。
3. システムが Fuse on Apache Karaf でサポートされる Java ランタイムを実行していることを確認します。Red Hat Fuse でサポートされる構成 で、サポート対象の Java バージョンを確認してください。
4. Java ランタイムが空白を含むディレクトリーパスにインストールされていないことを確認してください。たとえば、C:\Program Files\Java\jdk8 は受け入れ可能なパスではありません。パスに空白があると、実行時に Fuse on Apache Karaf で予期しないエラーが発生します。
5. Red Hat Fuse でサポートされる構成 のリストを確認し、サポート対象の標準ソフトウェアを使用していることを確認します。

手順

1. ブラウザーで Fuse Software Downloads ページに移動します。

   Red Hat カスタマーポータルにログインしていない場合は、ログインのプロンプトが表示され、ダウンロードページが表示されます (アカウントが Red Hat Fuse サブスクリプションに関連付けられている必要があります)。

2. Fuse の Software Downloads ページの Red Hat Fuse 7.12 on Karaf Installer の右側にある Download をクリックし、ローカル zip ファイルを取得します。

3. zip ファイルのコンテンツを、すべてのパーミッションが設定されたディレクトリーに展開します。

   パス名に空白文字や #、%、^、" などの特殊文字が含まれるディレクトリーに、この Zip ファイルを 展開しない でください。たとえば、C:\Documents and Settings\Greco#Roman\Desktop\fuse に展開しないでください。

4. IBM JDK を使用している場合は、以下の追加の手順を実行します。

   1. Fuse インストールディレクトリーの /lib/endorsed ディレクトリーで、saaj-api .jar ファイルを削除します。以下に例を示します。

      rm lib/endorsed/org.apache.servicemix.specs.saaj-api-1.3-2.9.0.jar

   2. JAVA_OPTS 環境変数を設定します。

      JAVA_OPTS=-Xshareclasses:none

      Karaf コンテナーを起動する前に、JAVA_OPTS 環境変数を設定する必要があります。

5. 管理ユーザーを追加して、Fuse on Karaf コンテナーへのリモートアクセスを有効にし、Fuse Console にアクセスします。

   デフォルトでは、コンテナーにはユーザーが定義されていません。この場合、フォアグラウンドでコンテナーを実行できますが、コンテナーにリモートでアクセスすることはできず、バックグラウンドで実行することはできません。以下の手順に従い、少なくとも admin ロールのあるユーザーを 1 人作成することが推奨されます。

   1. テキストエディターで、Fuse インストールディレクトリーにある etc/users.properties ファイルを開きます。

   2. 以下の行を探します。

      #admin = admin,_g_:admingroup
      #_g_\:admingroup = group,admin,manager,viewer,systembundles,ssh

   3. 各行について、その行をコメント解除するために先頭の # 文字を削除します。
   4. 最初の行で、最初のインスタンスの admin を、user1 などの希望するユーザー名に変更します。

   5. 同じ行で、2 番目のインスタンスの admin を、そのユーザーのパスワードに変更します (例:passw0rd)。

      以下に例を示します。

      user1 = passw0rd,_g_:admingroup
      _g_\:admingroup = group,admin,manager,viewer,systembundles,ssh

   6. ファイルを保存してから閉じます。
6. Fuse を起動するには、Linux/Unix で bin/fuse、Windows では bin\fuse.bat を実行します。
7. 任意で、Fuse Console にアクセスするには、Web ブラウザーで提供された URL を開き、etc/users.properties ファイルで設定したユーザー名およびパスワードを使用してログインします。Fuse Console の使用に関する詳細は、Managing Fuse を参照してください。

手順

1. Red Hat カスタマーポータル にログインします。
2. Red Hat カスタマーポータル → Downloads → Red Hat Fuse → Downloads ページに移動します。
3. Software Downloads ページの Version ドロップダウンリストから 7.12.0 を選択します。

4. Red Hat Fuse 7.12.0 Extras アーカイブをダウンロードします。

   extras アーカイブファイルには、ネストされた以下のアーカイブファイルが含まれます。

   • apache-camel-2.23.2.fuse-790054-redhat-00001.zip
   • apache-cxf-3.3.6.fuse-790049-redhat-00001.zip
5. これらのファイルを目的の場所にコピーし、プラットフォームに適したユーティリティーを使用して展開します。

手順

1. アップグレードする前に、Fuse on Apache Karaf インストールの完全バックアップを作成します。

2. 端末を開き、Apache Karaf サーバーで Fuse を起動します。

   [user@FUSE_HOME/bin ~] $ ./fuse

3. 必要に応じて、カスタマーポータルから必要なパッチをダウンロードして、手順 5 に進みます。

4. patch:find コマンドを入力し、Maven リポジトリーで利用可能なパッチを検索します。以下に例を示します。

   karaf@root()> patch:find
   Found new remote patch at mvn:org.jboss.redhat-fuse/fuse-karaf-patch-repository/7.8.0.fuse-sb2-780040/zip
   You can add the patch using "patch:add mvn:org.jboss.redhat-fuse/fuse-karaf-patch-repository/7.8.0.fuse-sb2-780040/zip" command, or simply use "patch:find --add" option.

   注記

   --add オプションを指定して patch:find コマンドを使用し、最新のパッチを見つけ、コンテナーの環境に追加できます。

5. patch:add コマンドを入力して、コンテナーの環境にパッチを追加します。以下に例を示します。

   karaf@root()> patch:add mvn:org.jboss.redhat-fuse/fuse-karaf-patch-repository/7.8.0.fuse-sb2-780040/zip
   [name]                                             [installed] [rollup] [description]                                      [CVEs]
   fuse-karaf-maintenance-patch-7.8.0.fuse-sb2-780040 false       false    fuse-karaf-maintenance-patch-7.8.0.fuse-sb2-780040 CVE-2020-28052
   
   Current patch mechanism version: 7.8.0.fuse-780038
   New patch mechanism version detected: 7.8.0.fuse-780040
   Please run "patch:update" command to upgrade patching mechanism to version 7.8.0.fuse780040

   注記

   patch:add コマンドを使用する代わりに、.zip パッチファイルを FUSE_HOME/patches ディレクトリーにコピーしてパッチファイルを自動的に追加することもできます。

6. 任意手順: patch:update コマンドを入力し、パッチメカニズム自体を更新します。

   karaf@root()> patch:update
   Current patch mechanism version: 7.8.0.fuse-780038
   New patch mechanism version detected: 7.8.0.fuse-780040
   Uninstalling patch features in version 7.8.0.fuse-780038
   Installing patch features in version 7.8.0.fuse-780040

7. patch:simulate コマンドを入力して、パッチのインストールをシミュレートします。

   これにより、パッチのインストール時にコンテナーに加えられる変更のログが生成されますが、実際にはコンテナーに何の変更も加えません。シミュレーションログを確認し、これらの変更を確認します。

8. patch:list コマンドを入力し、追加されたパッチの一覧を表示します。このリストで、[name] 見出しの下にあるエントリーはパッチ ID です。

   karaf@root()> patch:list
   [name]                                             [installed] [rollup] [description]                                      [CVEs]
   fuse-karaf-maintenance-patch-7.8.0.fuse-sb2-780040 false       false    fuse-karaf-maintenance-patch-7.8.0.fuse-sb2-780040 CVE-2020-28052

9. パッチに明示的な CVE メタデータが含まれる場合は、patch:show コマンドを入力して詳細を表示できます。

   karaf@root()> patch:show fuse-karaf-maintenance-patch-7.8.0.fuse-sb2-780040
   Patch ID: fuse-karaf-maintenance-patch-7.8.0.fuse-sb2-780040
   Patch Commit ID: a2d7cf58e21116cde66c97232aea4be1ec304400
   #### 1 CVE fix:
    - CVE-2020-28052: bouncycastle: password bypass in OpenBSDBCrypt.checkPassword utility possible
      Bugzilla link: https://bugzilla.redhat.com/show_bug.cgi?id=1912881
      CVE link: https://cve.mitre.org/cgi-bin/cvename.cgi?name=2020-28052

10. patch:install コマンドを入力し、適用するパッチのパッチ ID を指定して、コンテナーにパッチを適用します。以下に例を示します。

    patch:install fuse-karaf-maintenance-patch-7.8.0.fuse-sb2-780040

手順

1. patch:list コマンドを入力し、直近にインストールされたパッチのパッチ ID を取得します。

2. 更新されたバンドルをロールバックするには、以下のコマンドを入力します。

   karaf@root()> patch:rollback my-patch-x
   INFO : org.jboss.fuse.modules.patch.patch-management (2): Rolling back non-rollup patch "my-patch-x"
   removing overriden feature: hawtio-rbac/2.0.0.fuse-000117
   refreshing features
   Enter feature:info command to view the information about the feature.

   karaf@root()> feature:info hawtio-rbac
   Feature hawtio-rbac 2.0.0.fuse-000117
   Details:
         Installs the hawtio RBAC enabler bundle(s)
   Feature has no configuration
   Feature has no configuration files
   Feature has no dependencies.
   Feature contains followed bundles:
         mvn:io.hawt/hawtio-osgi-jmx/2.0.0.fuse-000117
   Feature has no conditionals.

手順

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

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

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

   このデフォルト動作を変更し、Maven によってローカルネットワーク上のリポジトリーのみが検索されるようにすることができます。これは 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

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

2. このカスタマイズされた Maven オフラインリポジトリーを、インターネットに接続していない内部のマシンに提供します。