1. Web版統合運用管理コンソール

1.1. Web版統合運用管理コンソールとは

Web版統合運用管理コンソールとは、以前の WebOTXでは各コンポーネントが個々に提供していた運用管理コンソールを、JMXをベースとして統合したものです。Web版統合運用管理コンソール（以降、コンソール）は、Webアプリケーションとして動作します。

1.2. コンソールの利用方法

コンソールは Webブラウザを起動し、下記のアドレスにアクセスすることにより実行します

http://<ホスト名>:<ポート番号>/manager/

Windows の場合は、スタートメニュー - プログラム - WebOTX - Web版統合運用管理コンソール からも起動できます。
ポート番号は、domain.xml 内の <network-listener name="admin-listener" …>要素の port 属性の値です。既定値は "5858" です。
運用管理コマンドでは、以下のコマンドで確認することができます。

otxadmin> get server.network-config.network-listeners.network-listener.admin-listener.port

1.3. コンソールの GUI の紹介

1.3.1. メイン画面

コンソールのメイン画面は、リンクバー、メニュービュー、ツリービュー、メインビュー、 履歴・変更・検索結果ビュー、ログビューから構成されます。画面を次に示します。

詳しくは各ビューの紹介を参照してください。

コンソール画面の表示サイズはユーザマシンの設定（解像度）により、自動的に調整されます。

使用の便利性のため、「1208*1024」以上を推奨します。

1.3.2. リンクバー

選択された管理対象のパスは画面のリンクバー領域に表示します：

リンクバーには、ツリー構造が表示されます。親ノードをクリックすることで、親ノードの画面をメイン画面に表示します。

例で説明します：

リンクバーに表示している内容はdomain1 -> アプリケーションサーバ->JavaEEサーバで、メイン画面に、JavaEEサーバの属性画面が表示されています。

リンクバーで、親ノードのアプリケーションサーバ のリンクをクリックすると、メイン画面はアプリケーションサーバ の関連の画面に遷移します、また、リンクバーにアプリケーションサーバ までのノードを表示します。

1.3.3. メニュービュー

メニュービューで画面表示や属性の表示などの設定ができます。

1.3.3.1. ビューの表示

コンソールではログビューと履歴・変更・検索結果ビューを提供しています。ここではビューの表示可否の設定ができます。

ログにチェックを入れた場合、コンソール画面の一番下に、ビューを表示します。

履歴・変更・検索結果にチェックを入れた場合、コンソールのツリービューの下方に、ビューを表示します。

1.3.3.2. 設定

コンソールで提供しているシステム設定機能について説明します。システム設定機能は、ユーザが必要に応じてコンソールでの情報表示レベルなどを変更するために使用します。

メニュービューで「設定」をクリックすると、「システム設定」ウインドウを表示します。「システム設定」ウインドウの説明を次に示します。

システム設定ウインドウ：

画面表示の設定：

管理対象は重要度によって表示を制御する 画面で基本レベル〜全レベルの表示レベルの値を設定することができます。基本レベルは、ユーザの関心度が最も高いことを示しています。全レベルはあまり重要性のない、特別な場合だけ必要な情報であることを意味しています。JMX仕様では設定値について明確に規定されていないので、WebOTXでは以下のガイドラインを設定しています。

• 基本レベル： 常に表示される運用上必須の 管理対象
  
• 詳細レベル： 詳細設定、オプションなど通常の運用には必要ない管理対象
  
• 全レベル： システム上必要な管理対象。ユーザも利用可能だが変更を推奨していない管理対象
  

オプションの設定：

システム設定画面から、「オプション」のタブを選択することで、設定情報保存項目を設定することができます。

オプションのタブで設定できる項目は以下のとおりです：

1.3.3.3. リフレッシュ

サーバから最新の情報を取得して、画面に表示します。リフレッシュ後は「ようこそ」画面を表示し、他のビューは全て初期化されます。

コンソールで何か変更を行っている場合、リフレッシュボタン押下時に、確認ダイアログを表示します。「はい」をクリックした場合、変更された内容を廃棄して、画面を最新表示します。

1.3.3.4. ドメイン管理

「ドメイン管理」ボタンによって、WebOTXの管理サーバを接続し、各ドメインを設定、操作することができます。詳しい内容は[1.8. ドメイン管理]を参照してください。

1.3.3.5. モニター

「モニター」ボタンによって、モニターの追加、削除、開始、停止を行うことができます。「モニター」ボタンを押下すると、次のようなリストが表示されます。詳しい内容は[1.10. モニター管理]を参照してください。

リストで表示された操作により、モニターの追加、削除、開始、停止を行うことができます。

1.3.4. ツリービュー

サーバから取得したドメインの構成情報をツリー形式でこの領域に表示します。ユーザドメインで管理されている全ての 管理対象を取得し、その親子関係を元にツリーに表示します。ツリーは次のとおりです。

ツリーに表示される内容は「システム設定」の「オプション」-「サーバからNotificationを受信する」の設定にしたがって、管理ノードの追加や削除などが行われた場合に自動的に更新されます。

配備されているWebモジュールのタイプが「system-all」の場合、ツリーに表示しません。また、コンソールの関連管理対象も表示しません。

1.3.4.1. 管理対象のアイコン一覧

表1.3.4.1-1

MO タイプ	アイコン	MO タイプ	アイコン
Default		Server
WebOTXAdminDomain		Ejb
Application		Webmodule
Ejbmodule		Webserver
Web_component		Resources
Service		mail-resource
Jdbc-datasource		connector-resource
persistence-manager-factory-resource		Container
connector-connection-pool		log_service
Java_config		jacc provider
monitor_service		auth-realm
Security_service		StatsHoldBean
audit module		servers
http-listener		WebOTXSYSTPP
config		WebOTXIIOPListener
MonitorBean		WebOTXOLFTPListener
WebOTXVDResource		WebOTXIIOPResource
Service Repository		Web Module
ApplicationClient		OSGi Module
Lifecycle Module		Web Service

1.3.4.2. 管理対象の状態一覧

管理対象アイコンの色によって 管理対象の状態を表示します。詳細を次に示します。

表1.3.4.2-1

状態	色	例(JavaEEServer)
starting	黄色
running	緑色
stopping	橙色
stopped	赤色
failed	赤色(アイコンの左下に「×」を追加)

1.3.5. メインビュー

 ツリービューで 管理対象を選択すると、メインビューを表示します。

表示されるタブページの種類には配備、属性、MO情報、操作、統計情報があります。表示されるタブの種類は管理対象によって異なります。また、「設定」の「画面表示設定」-「属性の表示レベル」の設定によっても変わります。

注：「設定」の「画面表示設定」-「属性の表示レベル」で「全レベル」を設定しない場合、「MO情報」タブは表示されません。

注意：選択した管理対象に関する項目があるのみ、タブやボタンを表示します。

Virtualノード

ツリービューで情報を持っていないノード（以降、Virtualノード）を選択すると、 Virtualノードのサブノードを表示します。
なお、右側で、サブノードをクリックすると、ツリーでそのサブノードをクリックするのと同じく、該当サブノードの情報をメインビューで表示します。

1.3.6. 操作

選択された管理対象に操作がある場合、操作のタブページを表示します、このタブをクリックすると、操作のページが表示されます。

操作ページには二つの領域があります、左側が操作リストの領域、右側が操作内容の領域です。操作のタブページを選択したときは、操作内容の領域には何も表示されません。操作リストの領域から操作を選択してください。

操作リストで操作を選択すると、 操作内容の領域に操作関連の内容を表示し、編集できます。この時、タブ名は選択された操作名となります。

操作内容の領域に関連のパラメータを入力して、「実行」ボタンで操作が実行できます。操作の結果はログビューに表示されます。

1.3.7. 履歴・変更・検索結果ビュー

コンソールでは履歴ビュー、変更ビューと検索結果ビューを提供しています。 このビューは「ビューの表示」と「設定」メニューの設定より表示します。

履歴ビュー

選択した管理対象ノードの履歴はこの履歴ビューに表示されます。操作順に表示され、最新のものが一番上にきます。 履歴ビューに表示されるノードをクリックすると、選択した管理対象ノードのメイン画面を直接表示します。

変更ビュー

未反映の変更がある管理対象ノードは変更ビューに表示され、ノード名は赤になります。 変更内容更新後は、変更ビューから削除されます。

検索結果ビュー

管理対象の表示名と管理対象の属性に対して、検索を行うことができます。

例えば、「サーバ」と入力すると、表示名に「サーバ」を含む管理対象がリストされます。 項目をクリックすると、メインビューに表示します。

管理対象だけではなく、管理対象の属性を検索することもできます。

例えば、ツリービューの「TPシステム」を選択した場合、表示名に「naming」と入力すると、表示名に「naming」を含む属性がリストされます。 項目をクリックすると、メインビューに表示します。

属性の検索結果は管理対象と違い、すべて赤い点で表示されます。

1.3.8. ログビュー

利用者の動作によって、属性の更新、操作の実行など関連ログはログビューに表示されます。

システム設定で以下のログ表示のレベルがあります：

• 情報：全てのログを表示します。
• 警告：警告とエラーのログを表示します。
• エラー：エラーのログしか表示しません。

「ログ詳細」のチェックボックスを外す場合、ログの詳細を表示しなくなります。もう一回チェックすると、ログ詳細を表示することになります。

1.3.9. キーボードのサポート

• Tab・方向キーが使用できます。
• メニュービューのボタンではショートカットキーが利用できます。
• メインビューのボタンではショートカットキーが利用できます。

利用しているブラウザとユーザの設定により、ショートカットキーは異なります。

例えば：IEのブラウザを利用する場合、メインビューで「再表示」ボタンのショートカットキーは： Shift + Alt + B です。

1.3.10. セッションタイムアウト

タイムアウトした場合、ログイン画面へ転送し、「セッションはタイムアウトしました。再接続してください。」というメッセージを表示します。

コンソールのタイムアウト時間の設定：

• ${AS_INSTALL}/lib/install/applications/webcapps/manager_war/WEB-INF/web.xmlのファイルに
  <session-config>
  <session-timeout>2</session-timeout>
  </session-config>
  でタイムアウト時間を設定します。（単位：分）
• 設定しない場合、タイムアウト時間はデフォルトで30分になります。
• 設定時間は0の場合、コンソールはいつもタイムアウトしません。

1.4. ログイン・ログアウト

1.4.1. ログイン

ログイン画面で、ユーザ名と対応のパスワードを正しく入力すると、最新の情報を取得し、「ようこそ画面」を表示します。

ログインに成功すると、下記の初期画面を表示します。

ログインに失敗した場合、ログイン画面に赤い文字のエラーメッセージを表示します。

1.4.2. ログアウト

メニュービューのログアウトボタンで、ログインしているドメインからログアウトすることができます。ボタンをクリックし、ログアウトする前に、確認ダイアログを表示します。「はい」をクリックした場合、全ての保存してない変更が廃棄され、ドメインからログアウトします。

1.5. アプリケーション管理

コンソールではアプリケーション管理の機能を提供しています。アプリケーションサーバに対して、各種類のコンポーネントのアプリケーションの配備・配備解除、配備されたコンポーネントの開始・停止などの管理が行えます。

1.5.1. 機能詳細

1.5.1.1. 配備画面

ツリービューで「アプリケーション」を選択した場合、「配備」ページを表示します。このページから配備操作を行うことができます。

コンポーネントの配備画面は以下の図で表示します。

コンポーネントタイプ

「コンポーネントタイプ」の項目で選択できるコンポーネントタイプはサーババージョン・接続先ドメインのエディションによって異なります。選択できるタイプには以下のものがあります。

• Java EEアプリケーション
• EJBコンポーネント
• Webコンポーネント
• リソースアダプタ
• アプリケーションクライアントコンポーネント
• CORBAアプリケーション
• 共有コンポーネント
• OSGiモジュール

ファイル

「参照」ボタン、あるいは、IE10/Firefox24/Chrome30にてドラッグ＆ドロップで、ローカルマシン上の配備ファイルを選択できます。
ドラッグ＆ドロップの場合、ファイル拡張子は以下のものに限定します：

ファイル拡張子	説明
.ear	Java EEアプリケーションとして配備します。
.jar	「コンポーネントタイプ」がEJBコンポーネント、且つ、選択されたファイルの拡張子がすべて.jarであれば、EJBコンポーネントとして配備します。 「コンポーネントタイプ」がアプリケーションクライアントコンポーネント、且つ、選択されたファイルの拡張子がすべて.jarであれば、アプリケーションクライアントコンポーネントとして配備します。 ドラッグ&ドロップで、複数のファイルを配備するとき、異なる種類の拡張子が混在している場合、jarは、OSGIモジュールとして扱います。
.war	Webコンポーネントとして配備します。
.rar	リソースアダプタとして配備します。
.cpk	CORBAアプリケーションとして配備します。
.spk	共有コンポーネントとして配備します。

「詳細項目の表示」ボタン：

「配備」のタブページには「詳細項目の表示」ボタンがあります。 このボタンをクリックすると、アプリケーション配備の詳細項目を表示します。

「プロパティ」パラメータ：

配備の詳細項目に「プロパティ」パラメータがあります。この項目で配備する際のオプションリストを「キー=値」の形式より指定できます。指定できるオプションとその説明は以下の通りです。

キー	値	デフォルド値	説明
jar-signing-alias	署名に使用するセキュリティ証明書の別名	s1as	アプリケーションクライアントコンテナJARファイルの署名に使用するセキュリティ証明書の別名を指定します。Java Web Startで権限を必要とするコードを実行する場合、署名が必要となります。
java-web-start-enabled	trueまたはfalse	true	CARでJava Web Startのアクセスを許可するかどうかを指定します。
compatibility	v8	なし	Java EE 6では、EAR内のJARファイルについての可視性がJava EE 5よりも厳密になっていますので、アプリケーションのJARの可視性について、旧バージョンと互換性を維持するかどうかを指定します。
keepSessions	trueまたはfalse	false	配備の詳細項目にある「状態保持」パラメータの機能のうち、Webセッションのみに特化したものです。「状態保持」パラメータでの指定が優先されます。
preserveAppScopedResources	trueまたはfalse	false	再配備時にアプリケーションスコープのリソースを保持するかどうか指定します。

「配備」ボタン：

配備ボタンをクリックすると、配備操作を呼び出します。 配備処理中は、配備処理完了まで、ローディング画面を表示します。 配備処理を完了するとログビューに処理結果メッセージを表示します。

「置換」タブページ：

ツリービューで「アプリケーション」を選択し、「置換」タブページをクリックすると、置換操作画面を表示します。 インタフェースやオペレーション単位に設定した情報を引き継いだまま、配備済みのアプリケーションを置換したい場合は、置換操作を行ってください。
「置換」を行う際、置換するアプリケーションのファイル名は、配備時と同じにしてください。
次に該当する場合のみ、「置換」操作を行えます。該当しない場合は、「配備」操作で強制（再）配備を行ってください。

• プロセスグループに配備したアプリケーションである。
• EJBの場合、リモートインタフェース、リモートホーム、リモー トビジネスインタフェースに変更がない。
• EJB 3.0のEJBタイマーを利用している場合、@Timeoutで指定した コールバックメソッドの名前に変更がない。
• Webサービス化されたEJBを利用している場合、Webサービスエン ドポイントのURIに変更がない。
• WARの場合、コンテキストルートに変更がない。
• EARの場合、内包するEJBおよびWARに増減がなく、なおかつ上記 の条件を満たしている。

1.5.1.2. 配備実行

配備実行：

配備画面でアプリケーションの配備が行えます。

配備画面で「コンポーネントタイプ」に配備するコンポーネントのタイプを選択し、 「ファイル」の項目に配備するコンポーネントのファイルを入力します。そして、他の必要の情報を入力して、「配備」ボタンを押して、コンポーネントの配備を行います。

配備成功：

配備成功の場合、配備されたアプリケーションはツリービューのアプリケーションの配下に追加されます。また、配備の情報はログビューに追加されます。

配備失敗：

配備失敗の場合、失敗の情報はログビューに表示されます。また、配備失敗の原因となった項目をオレンジの色で表示します：

1.5.1.3. コンポーネント操作

配備されたコンポーネントに対していくつかの操作が行えます。

ツリービューでコンポーネントを選択して、メインビューに「操作」のタブページを選択すると、このコンポーネントに対する「開始」、「停止」、「配備解除」などの操作リストが表示されます：

この操作リストでコンポーネントの管理ができます。

1.5.1.4. 配備解除

配備されたコンポーネントの操作リストを利用して配備解除することができます。

選択されたコンポーネントの操作リスト一覧で「コンポーネントの配備解除」を選択すると、操作パラメータの領域に配備解除の詳細情報を表示します：

配備解除のタブページで「実行」をクリックすると、選択されたコンポーネントが配備解除されます。処理結果の情報はログビューに追加されます。

1.5.1.5. アプリケーション一覧画面

コンソールでは、Webモジュールにアプリケーションの管理画面を提供しています。

ツリービューでWebモジュールのノードをクリックすると、管理画面を表示します。メイン画面は以下の画面に遷移します。

Webモジュールへの「開始」、「停止」、「配備解除」の操作はこのアプリケーションの管理画面で実施できます。

1.5.1.6. OSGiモジュール一覧画面

コンソールでは、OSGiモジュールの一覧画面を提供しています。

ツリービューでosgi-bundleのノードをクリックすると、一覧画面を表示します。メイン画面は以下の画面に遷移します。

1.6. 管理対象の管理

コンソールで提供している管理対象の管理機能について説明します。

1.6.1. 管理対象の属性の表示・編集

ツリーで属性がある管理対象を選択すると、メインビューで、該当管理対象の各属性をタブページに表示します。属性のタブをクリックすると、該当属性の内容がこのタブページに表示されます。表示される属性の タブは「設定」の「属性の表示レベル」によって変わります。属性のタブページを次に示します。

1つの属性しかない場合の画面は以下のとおりです。この属性のタブ名は「設定」です。

タブ数が多い場合、複数行で表示します。

ツリーに属性がない管理対象が選択された場合、「設定」タブは表示されません。

1.6.1.1. 属性の表示形式について

配列属性の処理

リスト

編集

編集したい配列の要素をクリックして、編集することができます。

ここでは属性のデータタイプにしたがって、テキストボックス、ドロップリストまたはチェックボックスを表示します。

配列を編集した後、配列の後ろに編集アイコンを表示します。

行の追加

「行の追加」ボタンをクリックすると、配列の一番上に新しい列を追加します。

新しい列に内容を入力する前に、無効であります。配列の前に編集アイコンがなくで、タブ名の色も変更がない、他の管理対象のメイン画面に入って戻った後、内容のないこの新しい列はなくなります。

新しい列に要素内容を入力した後、この列は有効になる、配列の前に編集アイコンを表示します、他の管理対象のメイン画面に入って戻った後、内容のあるこの新しい列は内容を持って表示します。

行の削除

配列の要素の列の先頭に行の削除というボタンがあります、このボタンをクリックして、ボタンの存在する行を削除できます。

列を削除した後、配列の後ろに編集アイコンを表示します。

テーブル

編集

編集したい配列の要素をクリックして、編集することができます。

ここでは属性のデータタイプにしたがって、テキストボックス、ドロップリストまたはチェックボックスを表示します。

配列を編集した後、配列の後ろに編集アイコンを表示します。

行の追加

「行の追加」ボタンをクリックすると、配列の一番上に新しい列を追加します。

追加された列は属性のデータタイプにしたがって、テキストボックス、ドロップリストまたはチェックボックスを表示します。

新しい列に内容が入力されていない場合は、無効です。配列の前に編集アイコンがなく、タブ名の色も変更がない場合、他の管理対象のメイン画面に入って戻った後、内容のないこの新しい列はなくなります。

新しい列に要素内容を入力した後、この列は有効になり、配列の前に編集アイコンを表示します。他の管理対象のメイン画面に入って戻った後、内容のあるこの新しい列は入力した内容を表示します。

行の削除

配列の要素の列の先頭に行の削除というボタンがあります、このボタンをクリックして、ボタンの存在する行を削除できます。

列を削除した後、配列の後ろに編集アイコンを表示します。

属性値の入力条件

属性名の後に属性値の入力条件を表示する場合があります。表示の条件にしたがって入力しなければ、更新が失敗する可能性があります。入力条件は次の順序で表示します。

必須性, 種類:範囲, その他の条件

必須性

「必須」と表示されている項目は、属性値の入力を省略できません。

種類

範囲

その他の条件

1.6.1.2. 属性値変更の関連事項

preset操作

変更する属性が他の属性に影響する可能性があれば、関連する属性を自動的に変更します。自動的に変更された属性の項目にimpactMessageを追加します。

「初期化」ボタンを押すと、preset操作が発生する可能性があります。

ある属性を更新したあと、他の属性に影響する可能性もありますが、コンソールの制限として、属性を更新したあと画面表示は自動的に更新しません。

表示項目の重要度が修正されることが可能となるため、表示項目数の変更は可能となります。この場合、コンソール画面で、項目の表示・非表示を行います。この時、値の変更も保存されます。そうすると、再表示の場合元の値を表示することは可能になります。

impactMessage

属性の変更による影響を通知するメッセージ(impactMessage)があれば、属性名の後ろにツールチップの形式で表示します。次に表示例を示します。

自動的な入力チェック

属性の画面に入力された内容は自動にチェックされます。入力不正がある場合、不正の項目の色はオレンジになります、この場合、更新或いは一括更新すると、操作不成功になり、ログビューにエラーの情報を記述します。

自動チェックする内容は以下のとおりです：

• null値の許容性チェック
• エントリに基づく妥当性チェック
• 正規表現のチェック
• ASCII以外の文字に対する許容性チェック
• 指定範囲に基づく妥当性チェック
• 最小/最大値に基づく許容性チェック

1.6.2. 属性の更新

「更新」ボタンで、編集された属性をサーバへ反映することかできます。管理対象の属性タブページを表示してから変更していない場合、更新ボタンは利用できません：

属性項目のいずれかに変更がある場合、このタブページ名は赤くなり、変更された項目の前に「鉛筆」マークの編集アイコンを追加します。また、「更新」ボタンが利用可能になります。

変更がある属性の画面で更新ボタンを押すと、更新を行います、正常に更新された後、この属性ページのタブの色は元に戻って、編集アイコンも消えます。また、操作結果の情報をログビューに追加します。

1.6.3. 属性の一括更新

管理対象には複数の属性がある場合があります。この場合、属性は複数のタブページに表示します。属性Aの修正中に、属性Bの修正をすることもできます。修正中の状態は属性のタブページの色で識別できます。編集中のタブは、赤い色になります。

この画面に「更新」ボタンのほかに「一括更新」のボタンが表示されます。「更新」ボタンでは表示されている属性だけをサーバへ反映できます。それに対して「一括更新」ボタンは、同時にこの管理対象の全ての属性をサーバへ反映することができます。正常に一括更新をした後、この管理対象の全ての属性ページの タブの色は通常の状態になります。また、更新結果の情報をログビューに追加し、この管理対象を変更ビューから削除します。

1.6.4. 管理対象の再表示

管理対象の属性表示画面に「再表示」のボタンがあります。この「再表示」ボタンでサーバから管理対象の最新情報を取得し、画面に表示します。

選択された管理対象に修正がある場合、再表示をすると全ての編集内容を廃棄します。

再表示すると、属性画面の更新・一括更新ボタンは無効になり、管理対象の状態は未編集になります。また、表示されるタブページは一番上の属性タブページに遷移します。さらに、この管理対象を変更ビューから削除します。

1.6.5. 属性の既定値

管理対象の初期値をサーバから取得し、画面に表示します。

選択された管理対象に編集がある場合、最新情報を取得すると、編集された内容を廃棄します。

初期値と最新情報に間違いがある場合、初期化した後、この管理対象は編集された状態になり、変更ビューに追加します。初期化の内容は更新ボタンで、サーバに更新します。

1.6.6. タブページの表示順

メインビューで表示可能なタブは以下のとおりです。

• 統計情報
• 配備
  
• 属性
• MO 情報
• 操作
  

メインビューでのタブの表示順

各タブの表示順（左から右）は「統計情報」、「配備」、「属性」、「MO情報」、「操作」です。

1.6.7. 操作

メインビューで表示可能なタブは以下のとおりです。

メインビューで操作がある管理対象を選択すると、ツリービューで該当管理対象の「操作」タブを表示します。「操作」タブをクリックすると、該当管理対象に対してできる操作がカテゴリの形式で「操作」タブページに表示します。「操作」タブページを次に示します。

1.6.7.1. 操作画面

「操作」タブページ

注：「操作」の初期状態は、「操作リスト」だけ表示します、操作内容のページは空であります。

ある操作が選択した後の「操作」タブページ

ツリーで操作がない管理対象が選択された場合、「操作」タブを表示しません。

1.6.7.2. パラメータ値変更の関連事項

preInvoke操作

変更するパラメータが他のパラメータに影響する可能性があれば、｢実行｣ボタンをクリックすると、ログビューに影響される内容を表示します。

impactMessage

属性のimpactMessageと同じです。属性値変更の関連事項のimpactMessageを参照してください。

「操作」タブページの切り替え

「操作」タブページから他のページへ切り替える時に、あるいは操作グループ間で切り替える時に、操作タブページの編集している内容は保存できます。

操作タブページに変更がある場合、タブページ名の色は赤くなります。変更したパラメータ値を保存して、他のタブページに遷移できます。 そして、操作タブページに戻ると、修正された内容を表示します。

各「操作」間の切り替え

操作リストの各操作間で切り替える時に、パラメータ値に変更がある場合は、次の操作に切り替えると、前の変更したパラメータ値は廃棄されます。

1.6.7.3. 実行について

操作実行

管理対象には複数の操作があります。ツリービューで管理対象を選択して、メイン画面に操作のタブページを表示し、操作リストの操作をクリックすると、右のパラメータの領域にこの操作に関連する内容を表示します。必要なパラメータを入力して、「実行」ボタンを押すと、操作の実行ができます。

自動的な入力チェック

操作のパラメータの領域に入力された内容は自動で入力値がチェックされます。何らかのエラーが発生した場合、不正の項目の色はオレンジになります。また、エラーメッセージをログビューに追加します。この不正の項目の内容を修正すると項目の色は元に戻ります：

自動的にチェックできる内容は次のとおりです。

• null値の許容性チェック
• エントリに基づく妥当性チェック
• 正規表現のチェック
• ASCII以外の文字に対する許容性チェック
• 指定範囲に基づく妥当性チェック
• 最小/最大値に基づく許容性チェック

成功の場合

操作の結果がサーバから受信されると、操作ビューに操作結果を表示します。同時に、ログビューに詳細なメッセージを表示します。ログビューを閉じている場合、操作結果のみを参照できます。

返却値の表示は、返却値のタイプにより異なります。返却値のタイプを下記に示します。

返却値のタイプがvoid の場合は、返却値を表示しません。

上記以外のタイプの場合は、返却値を文字列に変換して表示します。

失敗の場合

操作の結果がサーバから受信されると、操作ビューにエラー情報の概要を表示します。同時に、ログビューに詳細なメッセージを表示します。ログビューを閉じている場合、操作結果の概要だけが見え ます。エラー画面の例を次に示します。

エラーの詳細情報には、例外のメッセージ、例外のタイプ、例外の原因があれば表示します。
操作を実行した後、管理対象に関する最新情報（状態）を管理対象サーバから取得して、ツリーを更新します。

• 状態が変わっている場合、アイコンなどを変更します。
• 
  
• 選択した管理対象が削除されている場合、ノードもツリーから削除されます。

確認

選択した操作に関するメッセージがある場合は、｢実行｣ボタンをクリックすると、確認画面にメッセージを表示します。

1.7. 状態管理

コンソールで提供している状態管理機能について説明します。

1.7.1. 機能詳細

メニューで統計グラフをクリックすると、「統計グラフ」画面を表示します。

WebSocketが利用できる、且つブラウザがFirefox/Chromeの場合、新ウィンドで表示します。

WebSocketが利用できない、あるいはブラウザがInternet Explorerの場合、メインビューにタブで表示します。

統計開始した後の「統計グラフ」は以下の通りです。

1.7.2. 収集開始

統計情報に収集開始ボタンで統計の収集を開始します。収集開始した後、統計種類、統計要素と統計ラインを選択できます、統計画面に統計種類と統計要素 で選択した内容を表示します。収集情報の表示は選択された統計要素の色と形によって画面に表示します。

収集間隔ごとに、サーバから統計情報を取得します。取得された値は統計画面に反映されます。サーバから統計情報を取得できない場合、統計画面にデータは、追加されませんが、グラフの時間は更新されます。

画面の表示は、見やすくするため、時間点が多い場合、一部の時間点の文字を表示しません。

統計情報を収集していない時は、「収集開始」ボタンになり、クリックすると収集を開始します。統計情報を収集している時は、「収集停止」ボタンになり、クリックすると収集を停止します。停止時には、最新の統計情報を取得し、グラフを更新します。

1.7.3. グラフ更新

統計情報の収集中に「グラフ更新」のボタンクリックで、グラフが最新情報で表示されます。

WebSocketが利用できる場合、グラフが自動的最新情報で表示されます。下記の手順でWebSocketが利用できます。

• Adminリスナのプロトコル種類をhttp(nio)に選択し、更新して、ドメインを再起動します。
  

  
  図1.7.3-1

• Internet Explorer 10、Firefox 24、Chrome 30のいずれからコンソールをアクセスします。

1.7.4. 統計データ保存

統計情報の収集中または収集完了時、「保存」のボタンで収集したデータを保存することができます。 統計データ保存機能は一つの統計要素を保存することと、全ての統計要素を保存するという二つ機能を提供します。

一つの統計要素の統計データの保存：

収集データを保存するには、まずボタン「収集開始」でデータ収集を行います。

データ収集開始後に、統計要素リストに保存したい統計要素を選択します。

統計要素を選択した後、ボタン「保存」をクリックすると、ファイル保存ダイアログが表示されます。保存されるファイルは「CSV」形式です。

＊保存されるデータは、グラフで表示されたデータと同じです。最新の統計情報を保存するためには、保存前に 「グラフ更新」をクリックしてください。

保存したファイルを次に示します。（Microsoft ExcelでのCSVファイルの表示例）

ヘッダ部分に「統計対象名」、「開始時間」、「停止時間」、「収集間隔」の四つの項目があります。 各項目の説明は下記の表を参照ください：

時間軸部分に表示された「サンプリング時刻」は統計情報を収集した時刻です。

コンテンツ部分に属性の統計データに「統計類別」、「統計属性名」、「単位」および具体な統計データがあります、 詳しくは下記の表を参照してください：

※：「統計類別」、「統計属性名」などの意味は、次に示します。

全ての統計要素の統計データの保存：

「保存」ボタンの▼をクリックすると、「一括保存」が表示されます。

「一括保存」で統計対象の全ての統計要素の情報を保存することができます。

「一括保存」をクリックした後の操作は、直接「保存」ボタンをクリックした場合と同じです。

1.7.5. 統計データの印刷

「印刷レイアウト」の「印刷」ボタンで統計図を印刷することができます。

統計対象のデータの収集を開始すると、メインビューの「統計情報」タブページで「印刷」ボタンをクリックすることができます。

統計要素リストに印刷したい統計要素を選択して、「印刷」ボタンをクリックすると、画面は「標準レイアウト」から「印刷レイアウト」になります。

＊「印刷」ボタンをクリックする前に表示されている画面は「標準レイアウト」と言います。

印刷レイアウト画面各部分の説明について、次に示します。

「印刷レイアウト」では、印刷ダイアログを表示します。これにより、ブラウザの印刷機能でグラフを印刷することができます。

また、「印刷レイアウト」の「印刷」ボタンからブラウザの印刷機能を実行することもできます。

＊最新の統計データグラフを印刷するには、「標準レイアウト」で「印刷」ボタンをクリックする前に、「グラフ更新」ボタンをクリックしてください。

「印刷レイアウト」の「戻る」をクリックすると、「印刷レイアウト」は「標準レイアウト」に戻ります。

1.8. ドメイン管理

WebOTXの管理用ドメイン「WebOTX管理ドメイン」の管理機能について説明します。

1.8.1. ドメインの接続

メニューバーの「ドメイン管理」ボタンを押下すると、

メインビューで次のような「接続・切断」タブページを表示します。

「接続・切断」タグ画面で必要な情報を入力し、「接続」ボタンを押下すると、接続を行います。

接続成功の場合：

接続成功の場合、「接続・切断」タブページの各入力項目は入力不可になり、「接続」ボタンは「切断」ボタンに変更されます。

同時に、ドメインに関する属性や操作などのタブページも表示されます。

ドメインに関する属性と操作のタブページについての操作は[1.6. 管理対象の管理]を参照してください。

接続失敗の場合：

接続失敗の場合、「接続・切断」タブページの各入力項目はユーザの各項目は接続する時と同じです。

接続失敗したエラーメッセージはログビューに表示します。

1.8.2. ドメインの切断

WebOTX管理ドメインに接続している場合、「切断」ボタンでWebOTX管理ドメインとの接続を切断することができます。 ボタン「切断」をクリックした場合、「接続・切断」タブページは全部入力可能になります。ボタン「切断」は 「接続」になります。

同時に、接続していた時表示する管理ドメインの属性、操作などのタブページは全部消えます。接続先リストに切断された管理ドメインのアイコンは灰色になります。

1.8.3. 基本操作

接続済みの管理ドメインで、メインビューに「基本操作」というタブが表示されます。それをクリックすると、該当管理ドメインの基本操作画面が表示されます。基本操作の画面は次のとおり

1.9. サーバ一覧

サーバ一覧機能で、ドメイン、サーバ、ポートなどの稼動状況を確認することができます。

ツリービューの「サーバ一覧」をクリックすると、メインビューに「サーバ一覧」の画面を表示します。

「サーバ一覧」の各タブページについて、次に説明します。

1.9.1. プロセス動作状況

タブ「プロセス動作状況」をクリックした場合、ドメインのJVMプロセスに対するヒープやパーマネント消費量を一覧表示します。

「プロセス動作状況」タブページは以下のとおりです。

毎プロセスに対して、下記の項目を表示します：

プロセスのネーミングについて

プロセスのネーミングは、プロセスグループ名と所属アプリケーショングループ名を組み合わせたものです。

TPシステムに「a」というアプリケーショングループがあり、アプリケーショングループ「a」に「b」というプロセスグループがある場合を例に説明します。

「プロセス動作状況」でプロセスグループ「b」を表示する場合、「a-b」のように表示します。

プロセスグループの「プロセス制御」タブページの「プロセス数」を「1」以上設定した場合、

「プロセス動作状況」で複数の行で表示します。プロセス名は同じですが、「プロセスID」で区別できます。

1.9.2. ドメイン動作状況

ツリービューの「サーバ一覧」をクリックして、メインビューに「ドメイン動作状況」を選択した場合、ドメイン動作状況の画面を表示します。

「ドメイン動作状況」機能は接続しているドメインの動作状況を表示する機能です。この画面では、最新情報が自動更新されます。

「ドメイン動作状況」ページの説明は次に示します。

「表示設定」について

「ドメイン動作状況」で確認したい属性だけを表示することができます。「ドメイン動作状況」の初期画面では全ての属性が表示されます。「表示設定」の各項目に全てチェックを入れた状態です。要らない属性を削除するには、「表示設定」でその属性のチェックを外してください。また消した属性を再表示させたい場合、「表示設定」でその属性のチェックボックスに再度チェックを入れてください。

1.9.3. ポート番号一覧

ツリービューの「サーバ一覧」をクリックし、メインビューで「ポート番号一覧」タブを選択した場合、ポート番号一覧の画面が表示されます。

「ポート番号一覧」では、接続しているドメインで使用しているポート名と番号一覧を表示します。

「ポート番号一覧」ページの説明は次に示します。

ポート番号一覧は自動的に最新情報に更新されないため、最新のボート番号を表示するには 「再表示」ボタンをクリックしてください。

1.9.4. ユーザ一覧

ツリービューの「サーバ一覧」をクリックして、メインビューに「ユーザ一覧」タブを選択した場合、ユーザ一覧の画面を表示します。

「ユーザ一覧」機能は接続したドメインにあるユーザとグループをリストで表示する機能です。

「ユーザ一覧」ページの説明は次に示します。

ユーザ一覧は自動的に最新情報に更新されないため、最新のユーザを表示するには 「再表示」ボタンをクリックしてください。

1.10. モニター管理

コンソールでモニター管理機能が提供しています。

この機能により、リアルタイムでドメイン内の状態を確認する、 ドメイン内で発生した障害や、統計情報の閾値超過などの事象を監視することができます。

また、コンソールでモニターの起動・停止・削除、モニター対象の追加及びモニター対象属性の編集・設定、モニター通知を受けることができます。

詳しい内容は次の説明ご参照ください。

1.10.1. モニター対象追加

メニューバーの「モニター」ボタンの「モニター対象追加」およびツリービューで「モニター」ノードをクリックすることで、モニターを追加することができます。

モニターの追加画面について、次のとおりです。

モニターを登録する方法について説明します：

1. 「モニター」メニューから「モニター対象追加」メニューを選択する、あるいは、コンソール画面の一番左のツリービューから「モニター」ノードを選択することによって、「モニター対象追加」の画面が開けます。
2. メイン画面で表示された「モニター対象追加」画面のドメインツリーの中から、監視したい対象を選択し、モニター属性とモニタータイプを選択します。
3. 表示された設定画面にモニター属性により異なる、監視に必要な属性を設定します。
4. 「登録」ボタンを押し、登録されたモニターが、コンソール画面の一番左のツリー上に追加されます。

1.10.2. モニターの起動・停止・削除

ツリービュー登録されたモニターを登録し、メインビューで表示された画面で「操作」タブをクリックすると、次のような画面が表示され、モニターの操作ができます。

状態は停止（アイコンの色は赤）のモニターを選択する時、操作リストに「モニター開始」と「モニター対象削除」を選択することができます。状態は実行中（アイコンの色は緑）のモニターを選択する時、操作リストに「モニター停止」と「モニター対象削除」を選択することができます。
次は各操作の詳細動作です。

• 操作リストに「モニター停止」を選択し、「実行」ボタンを押下する際、該当モニターが停止され、モニターのアイコンの色は赤になります。
• 操作リストに「モニター開始」を選択し、「実行」ボタンを押下する際、該当モニターが起動され、モニターのアイコンの色は緑になります。
• 操作リストに「モニター対象削除」を選択し、「実行」ボタンを押下する際、該当モニターが削除され、モニターはツリーから消えます。
• また、ツリービューの任意の追加されたモニターを選択された場合、メインビューの「モニター」ボタンの「モニター開始/モニター停止」、「モニター対象削除」も使用できるようになります。

1.10.3. モニター通知の表示

モニターが監視を行っている際、モニターの設定よりモニター通知をログビューで表示されます。モニター通知の種類は、次の二つあります。

モニター通知

「モニター通知」ログのフォーマット：(情報): [<日付>]モニター通知：<メッセージ>

状態監視

「状態監視」ログのフォーマット：(エラー): [<日付>] 状態監視：<メッセージ>

1.11. ログファイル参照

メインビューで、サーバのログファイルを自由に参照できます。

1.11.1. 設定

有効化：

デフォルトでサーバのログファイルはコンソールから参照できません。本機能を有効するために、下記のようにコンソールのweb.xmlに「context-param」要素を追加して、ドメインを再起動してください。

• ${AS_INSTALL}\lib\install\applications\webcapps\manager_war\WEB-INF\web.xml：
  　　   <context-param>
  　　     <param-name>enableLogReference</param-name>
  　　     <param-value>true</param-value>
  　　   </context-param>

上記のように設定した場合、ツリーに表示されている「ログ参照」ノードを選択すると、メインビューにログファイル参照画面を表示します。

表示するファイルサイズの上限：

メインビューに表示するファイルサイズの上限はデフォルトで2MBです。そのサイズを調整するために、下記のようにコンソールのweb.xmlに「context-param」要素を追加して、ドメインを再起動してください。

• ${AS_INSTALL}\lib\install\applications\webcapps\manager_war\WEB-INF\web.xml：
  　　   <context-param>
  　　     <param-name>referenceLogLimitSize</param-name>
  　　     <param-value>2</param-value>
  　　   </context-param>

param-valueの単位がMBです。正整数に設定してください。

1.11.2. ログ内容の表示

選択したファイルのサイズが表示出来る範囲内の場合は以下の画面を表示します。

1.12. オペレーションログ

運用管理エージェントに対して行った操作は、オペレーションログに記録されます。オペレーションログの内容は監査や障害解析に役立てることができます。

1.12.1. 出力の制御

デフォルトオペレーションログは出力します、${com.nec.webotx.instanceRoot}/logs/agent配下にadminconsole_operations.logのログファイルが生成します。

でも、オペレーションログを出力した場合、ユーザ名、パスワードのような秘密情報が出力される可能性もありますので、ご注意ください。

出力しない場合、下記のようにコンソールのweb.xmlに「context-param」要素の値を変更します、ドメインを再起動してください。

• ${AS_INSTALL}\lib\install\applications\webcapps\manager_war\WEB-INF\web.xml：
  　　   <context-param>
  　　     <param-name>operationLogEnabled</param-name>
  　　     <param-value>false</param-value>
  　　   </context-param>

1.12.2. ログを出力する操作対象

本節ではどんな操作を行う時、オペレーションログを出力することについて記述します。

1.12.3. ログのフォーマット

ログファイルでは、実行した操作ごとに下記の情報が表示されます。

1.13. メッセージ一覧

1.14. 注意事項と制限事項

1.14.1. 注意事項

1.14.2. 制限事項