Fuse on Karaf スタンドアロンの管理

手順

1. コマンドラインで、Red Hat Fuse をインストールしたディレクトリーに移動し、以下のコマンドを実行して Fuse スタンドアロンを起動します。

   ./bin/fuse

   Karaf コンソールが起動し、バージョン情報、デフォルトの Fuse Console URL、および一般的なコマンドのリストが表示されます。

2. ブラウザーで URL を入力し、Fuse Console に接続します。例: http://localhost:8181/hawtio
3. ログインページでユーザー名とパスワードを入力し、Log In をクリックします。

手順

1. HTTPS を必須のプロトコルとして設定するには、$KARAF_HOME/etc/system.properties ファイルの hawtio.http.strictTransportSecurity プロパティーを以下の例のように設定します。

   hawtio.http.strictTransportSecurity = max-age=31536000; includeSubDomains; preload

2. 公開鍵を使用して応答をセキュアにするには、$KARAF_HOME/etc/system.properties ファイルの hawtio.http.publicKeyPins プロパティーを以下の例のように設定します。

   hawtio.http.publicKeyPins = pin-sha256="cUPcTAZWKaASuYWhhneDttWpY3oBAkE3h2+soZS7sWs"; max-age=5184000; includeSubDomains

3. (AWS のみにデプロイする場合) Fuse Console のプロキシーサーブレットを無効にするには、以下の例のように $KARAF_HOME/etc/system.properties ファイルで hawtio.disableProxy プロパティーを true に設定します。

   hawtio.disableProxy = true;

4. SSL/TLS セキュリティーを有効にする方法の詳細は、Apache Karaf セキュリティーガイド の「Apache Karaf コンテナーで Undertow の SSL/TLS を有効にする」を参照してください。
5. Red Hat Single Sign-On で Fuse Console をセキュアにする方法については、Red Hat Single Sign On アプリケーションおよびサービスのセキュリティー保護ガイド の「Hawtio 管理コンソールのセキュリティー保護」セクションを参照してください。

6. 以下の手順に従ってユーザーロールを設定し、必要な Fuse Console 操作を実行できる権限をユーザーに付与します。

   1. エディターで Red Hat Fuse etc/users.properties ファイルを開きます。

   2. ユーザー名、パスワード、およびロールのエントリーを追加します。

      たとえば、etc/users.properties ファイルの以下のエントリーは管理ユーザーを定義し、管理ロールを割り当てます。

      admin = secretpass,admin

   3. ファイルを保存します。

手順

1. ブランディングプラグインの例を https://github.com/hawtio/hawtio/tree/master/examples/branding-plugin から任意のローカルディレクトリーにダウンロードします。

2. 任意のエディターで、Fuse Console ブランディングプラグインの src/main/webapp/plugin/brandingPlugin.js ファイルを開き、Fuse Console ブランディングをカスタマイズします。

   表A.1「Fuse Console 設定プロパティー」 に記載されている設定プロパティーの値を変更できます。

3. 変更を保存します。

4. 任意のエディターで、Fuse Console ブランディングプラグインの pom.xml ファイルを開き、<parent> セクションに移動します。

   <parent>
       <groupId>io.hawt</groupId>
       <artifactId>project</artifactId>
       <version>2.9-SNAPSHOT</version>
       <relativePath>../..</relativePath>
     </parent>

5. 以下のように <parent> セクションを編集します。

   1. <version> プロパティーの値を Fuse on Karaf インストールのバージョンに一致するよう変更します。たとえば、Fuse on Karaf インストールディレクトリー名が 2.0.0.fuse-760015 の場合は、バージョンを 2.0.0.fuse-760015 に設定します。

   2. <relativePath>../..</relativePath> 行を削除します。

      以下に例を示します。

      <parent>
          <groupId>io.hawt</groupId>
          <artifactId>project</artifactId>
          <version> 2.0.0.fuse-760015</version>
            </parent>

6. ターミナルウィンドウで、以下のコマンドを実行し、branding-plugin プロジェクトをビルドします。

   mvn clean install

7. Fuse が稼働していない場合は、以下のコマンドを実行して起動します。

   Linux/Unix の場合: bin/fuse

   Windows の場合: bin\fuse.bat`

8. Karaf CLI プロンプトで以下のコマンドを入力し、Fuse Console ブランディングプラグインをインストールします。<version> は Fuse on Karaf インストールのバージョンに置き換えます。

   Linux/Unix の場合: install -s mvn:io.hawt/branding-plugin/<version>/war

   Windows の場合: install -s mvn:io.hawt\branding-plugin\<version>\war

9. Web ブラウザーで、7. の起動コマンドによって返された URL を使用して、Fuse Console を開きます (デフォルトの URL は http://localhost:8181/hawtio/ です)。

手順

1. Fuse Console の右上隅にあるユーザーアイコンをクリックして、Preferences をクリックします。

   

2. Maximum collection size オプションの値を大きくします (デフォルトは 50,000)。
3. Close をクリックします。

手順

1. hawtio-web バンドル ID を特定するには、以下のコマンドを使用して Fuse Console が使用する Fuse バンドルをリストします。

   osgi:list | grep hawtio

2. バンドルを停止するには、osgi:stop コマンドを使用します。たとえば、hawtio :: Web console バンドルの ID が 246 の場合、以下のコマンドを入力します。

   osgi:stop 246

手順

1. MBean 属性を表示および編集するには、以下を行います。

   1. ツリービューで MBean を選択します。
   2. Attributes タブをクリックします。
   3. 属性をクリックしてその詳細を表示します。

2. 操作を実行するには、以下を行います。

   1. ツリービューで MBean を選択します。
   2. Operations タブをクリックし、リストにある操作の 1 つを展開します。
   3. Execute をクリックし、操作を実行します。

3. チャートを表示するには、以下を行います。

   1. ツリービューで項目を選択します。
   2. Chart タブをクリックします。

手順

1. Fuse Console で Quartz タブをクリックします。

   Quartz ページには、Quartz スケジューラーのツリービューと、Scheduler、Triggers、および Jobs タブがあります。

2. スケジューラーを一時停止または起動するには、Scheduler タブのボタンをクリックします。

3. Triggers タブをクリックして、ジョブを実行するタイミングを決定するトリガーを表示します。たとえば、トリガーは、一日の指定の時刻 (ミリ秒単位) に、指定した日数、または指定した回数もしくは特定の回数繰り返してジョブを開始するように指定できます。

   • トリガーのリストをフィルタリングするには、ドロップダウンリストから State、Group、Name、または Type を選択します。続いて、入力フィールドに選択または入力することで、さらにリストをフィルターできます。
   • トリガーを一時停止、再開、更新、または手動で実行するには、Action 列のオプションをクリックします。
4. Jobs タブをクリックして実行中のジョブのリストを表示します。テーブルの Group、Name、Durable、Recover、Job ClassName、および Description の列でリストをソートできます。

手順

1. ロードされたクラスのインスタンス数や、これらのインスタンスが使用するバイト数を取得するには、Class Histogram をクリックします。操作が繰り返し行われた場合、最後の操作実行との差異がタブに表示されます。
2. JVM 診断のフラグ設定を表示するには、JVM flags をクリックします。
3. 稼働中の JVM でもフラグ設定を変更できます。

手順

1. Runtime タブをクリックし、Threads サブタブをクリックします。Threads ページには、アクティブなスレッドと各スレッドのスタックトレースの詳細が表示されます。デフォルトでは、スレッドリストにはすべてのスレッドが ID 値が大きい順に表示されます。
2. ID 値が小さい順に表示するには、ID 列ラベルをクリックします。
3. 任意で、スレッドの状態 (例: Blocked) やスレッド名でリストを絞り込むことができます。
4. ロッククラス名やスレッドのフルスタックトレースなど、特定スレッドの詳細情報を表示するには、Actions 列で More をクリックします。

手順

1. ログエントリーのリストを表示するには、Log Entries タブをクリックします。

   デフォルトでは、リストのログエントリーは昇順で表示されます。

   各ログエントリーをドリルダウンすると、ログエントリーに関する詳細情報が表示されます。

2. ログのリストを絞り込み、特定のログタイプを表示するには、Action Bar をクリックします。テキスト文字列またはログレベルを基にしてログエントリーセクションを絞り込むことができます。

3. Fuse Console のデフォルト設定を変更するには、以下を行います。

   1. Fuse Console の右上隅にあるユーザーアイコンをクリックして、ドロップダウンメニューの Preferences をクリックします。

      

   2. デフォルトのソート順序を変更するには、Server Logs を選択し、ログエントリーリンクをクリックして、バンドル名、スレッド、完全なメッセージテキストなどのログエントリーに関する詳細を表示します。

   3. 必要に応じて、ログメッセージの保存に関する次の設定をカスタマイズできます。

      • Fuse Console に保持するログステートメントの数 (デフォルトは 100)。
      • グローバルログレベル: INFO (デフォルト)、OFF、ERROR、WARN、および DEBUG。
      • hawtio-oauth や hawtio-core-utils など、含める子レベルのメッセージ。
   4. Fuse Console のログ設定をデフォルトの値に戻すには、Reset → Reset settings とクリックします。