インテリジェント統合管理基盤定義ファイル(imdd.properties)
形式
server.port=ポート番号 jp1.imdd.proxy.server[n].host=プロキシサーバー[n]のホスト名 jp1.imdd.proxy.server[n].port=プロキシサーバー[n]のポート番号 jp1.imdd.proxy.server[n].user=プロキシサーバー[n]の認証ユーザーID jp1.imdd.proxy.target[n].host= プロキシサーバーを利用するREST APIのターゲットホスト[n] jp1.imdd.proxy.target[n].serverHost=接続先のプロキシサーバーのターゲットホスト名[n] jp1.imdd.gui.settings.contentViews.<custom UI Id>.title=[カスタムUI]タブに表示するタイトル jp1.imdd.gui.settings.contentViews.<custom UI Id>.url=[ユーザー定義の画面表示領域]に表示するhtmlファイルのパス jp1.imdd.gui.settings.contentViews.<custom UI Id>.sid=ユーザー定義の画面を表示するIM管理ノードのツリーSID jp1.imdd.gui.settings.contentViews.<custom UI Id>.target=ユーザー定義の画面を表示するIM管理ノードのSID jp1.im.db.DEFAULT.portNo=IMデータベースが使用するポート番号 jp1.im.db.DEFAULT.logicalHostNum=論理ホスト用のIMデータベースで論理ホストを識別する番号 jp1.imdd.gui.settings.linkedUnit.impact.unKnownDisplay=影響不明アイコンの表示/非表示 jp1.imdd.event.stormCompatible=繰り返しイベントの表示抑止機能の互換設定 jp1.imdd.gui.settings.eventSearchCount=イベント取得での検索回数 jp1.imdd.authBasic=Basic認証の有効/無効
ファイル
imdd.properties
imdd.properties.model(インテリジェント統合管理基盤定義ファイルのモデルファイル)
格納先ディレクトリ
- Windowsの場合
-
- 物理ホストのとき
-
Managerパス\conf\imdd\
- 論理ホストのとき
-
共有フォルダ\jp1imm\conf\imdd\
- UNIXの場合
-
- 物理ホストのとき
-
/etc/opt/jp1imm/conf/imdd/
- 論理ホストのとき
-
共有ディレクトリ/jp1imm/conf/imdd/
説明
インテリジェント統合管理基盤のシステムの設定を定義するファイルです。
定義の反映時期
JP1/IM - Managerを起動すると,定義情報の設定が有効になります。
記述内容
インテリジェント統合管理基盤定義ファイルには,次に示す規則があります。
-
行の先頭に#(0x23)を指定すると,その行はコメント行になります。
-
プロパティ名は英小文字,英大文字を区別します。
-
定義ファイルはUTF-8で,BOM(byte order mark)が付与されないように保存してください。
-
無効なプロパティの場合は,その行を無視して処理を続行します。
-
プロパティに指定できる値以外を指定した場合は,動作を保証できません。
- server.port=ポート番号
-
インテリジェント統合管理基盤サービスでHTTP通信を受け付ける任意のポート番号を指定します。
指定するポート番号はシステムで一意である必要があります。また,セットアップで作成するホスト単位でも一意の値とします。
指定できる値は,5001〜65535です。デフォルトは20703です。
- jp1.imdd.proxy.server[n].host=プロキシサーバー[n]のホスト名
-
プロキシサーバー[n]のホスト名を指定します。
名前解決ができるプロキシサーバーのホスト名を指定します。不正なホスト名を指定した場合,製品プラグインからのAPIの実行に失敗します。
ASCII文字で指定します。
このプロパティを複数指定する場合は,[n]には0からの通番を指定してください。
- jp1.imdd.proxy.server[n].port=プロキシサーバー[n]のポート番号
-
プロキシサーバー[n]のポート番号を指定します。
指定できる値は,1〜65535です。指定できる範囲以外の値を指定した場合は,KAJY52016-Wメッセージを出力して,プロキシサーバー[n]の設定を無効にします。
このプロパティを複数指定する場合は,[n]には0からの通番を指定してください。
- jp1.imdd.proxy.server[n].user=プロキシサーバー[n]の認証ユーザーID
-
プロキシサーバー[n]の認証ユーザーのユーザーIDを指定します。
プロキシサーバーの認証を使用する場合,このオプションの指定と,プロキシサーバーの認証情報の設定が必要です。プロキシサーバーの認証情報の設定は「jddsetproxyuser」(1. コマンド)を参照してください。
このプロパティを複数指定する場合は,[n]には0からの通番を指定してください。
プロキシサーバーの認証を使用しない場合は,このオプションの指定は不要です。
- jp1.imdd.proxy.target[n].host=プロキシサーバーを利用するREST APIのターゲットホスト[n]
-
プロキシサーバーを利用するREST APIの実行対象となるターゲット[n]のホストを指定します。ターゲット[n]のホスト名には,REST APIのURLのホスト部を指定します。
例えば,REST APIが「」の場合は,「hitacih.co.jp」を指定します。
ASCII文字で指定します。
このプロパティを複数指定する場合は,[n]には0からの通番を指定してください。
- jp1.imdd.proxy.target[n].serverHost=接続先のプロキシサーバーのターゲットホスト名[n]
-
接続先のプロキシサーバー[n]のターゲットホスト名を指定します。
設定した値がプロキシサーバー[n]に設定されていない場合,または無効な値の場合は,KAJY52018-Wメッセージを出力し,ターゲットホスト[n]の設定を無効にします。
ASCII文字で指定します。
このプロパティを複数指定する場合は,[n]には0からの通番を指定してください。
- jp1.imdd.gui.settings.contentViews.<custom UI Id>.title=[カスタムUI]タブに表示するタイトル
-
カスタムUI表示機能を使用する場合に,[カスタムUI]タブに表示するタイトルを指定します。
タイトルは,制御文字および機種依存文字を含まない255文字以内の文字列で指定します。
なお,マルチバイト文字を指定する場合はUnicode(\udddd表記)に変換してください。その場合の文字数は,Unicodeに変換済みの文字列の文字数でカウントされます。
一つの<custom UI Id>に対して,必ず指定してください。
- jp1.imdd.gui.settings.contentViews.<custom UI Id>.url=[ユーザー定義の画面表示領域]に表示するhtmlファイルのパス
-
カスタムUI表示機能を使用する場合に,[ユーザー定義の画面表示領域]に表示するhtmlファイルのパスを,「public」からの相対パス形式で指定します。htmlファイルの配置先を次に示します。
- Windowsの場合
-
Managerパス\public\customUI\
- UNIXの場合
-
/opt/jp1imm/public/customUI/
htmlファイルのパスは,制御文字および機種依存文字を含まない255文字以内の文字列で指定します。パス区切り文字は「/」を使用します。
なお,マルチバイト文字を指定する場合はUnicode(\udddd表記)に変換してください。その場合の文字数は,Unicodeに変換済みの文字列の文字数でカウントされます。半角スペース「 」を含む場合でも,前後を引用符「"」で囲む必要はありません。
一つの<custom UI Id>に対して,必ず指定してください。
- jp1.imdd.gui.settings.contentViews.<custom UI Id>.sid=ユーザー定義の画面を表示するIM管理ノードのツリーSID
-
カスタムUI表示機能を使用する場合に,ユーザー定義の画面を表示するIM管理ノードのツリーSIDを指定します。
IM管理ノードのツリーSIDは,1,048,576文字以内で指定します。指定できる文字は,指定したツリーSIDの仕様に準じます。
IM管理ノードのツリーSIDは,正規表現で指定できます。正規表現で指定する場合,すべての文字に一致する表現の「.*」を多用すると,検索に時間が掛かることがあります。「.*」を使用する場合は,必要な個所にだけ「.*」を使用するようにしてください。
なお,指定したツリーSIDが存在するかどうかはチェックされません。
一つの<custom UI Id>に対して,sidまたはtargetのどちらかの指定が必要です。
- jp1.imdd.gui.settings.contentViews.<custom UI Id>.target=ユーザー定義の画面を表示するIM管理ノードのSID
-
カスタムUI表示機能を使用する場合に,ユーザー定義の画面を表示するIM管理ノードのSIDを指定します。
IM管理ノードのSIDは,1,048,576文字以内で指定します。指定できる文字は,指定したSIDの仕様に準じます。
IM管理ノードのSIDは,正規表現で指定できます。正規表現で指定する場合,すべての文字に一致する表現の「.*」を多用すると,検索に時間が掛かることがあります。「.*」を使用する場合は,必要な個所にだけ「.*」を使用するようにしてください。
なお,指定したSIDが存在するかどうかはチェックされません。
一つの<custom UI Id>に対して,sidまたはtargetのどちらかの指定が必要です。
- jp1.im.db.DEFAULT.portNo=IMデータベースが使用するポート番号
-
IMデータベースが使用するポート番号を指定します。
物理ホストの場合,統合監視DBのセットアップ時に使用したセットアップ情報ファイルのIMDBPORTオプションに指定した値を指定します。IMDBPORTオプションがデフォルトの設定の場合,jp1.im.db.DEFAULT.portNoの指定は不要です。
セットアップ情報ファイルについては「セットアップ情報ファイル(jimdbsetupinfo.conf)」を参照してください。
論理ホストの場合,統合監視DBのセットアップ時に使用したクラスタセットアップ情報ファイルのIMDBPORTオプションに指定した値を指定します。
クラスタセットアップ情報ファイルについては「クラスタセットアップ情報ファイル(jimdbclustersetupinfo.conf)」を参照してください。
- jp1.im.db.DEFAULT.logicalHostNum=論理ホスト用のIMデータベースで論理ホストを識別する番号
-
論理ホスト用のIMデータベースで論理ホストを識別する番号を指定します。
統合監視DBのセットアップ時に使用したクラスタセットアップ情報ファイルのLOGICALHOSTNUMBERオプションに指定した値を指定します。
jp1.im.db.DEFAULT.portNoで論理ホストを指定した場合,このオプションを指定します。
クラスタセットアップ情報ファイルについては「クラスタセットアップ情報ファイル(jimdbclustersetupinfo.conf)」を参照してください。
- jp1.imdd.gui.settings.linkedUnit.impact.unKnownDisplay=影響不明アイコンの表示/非表示
-
[業務フロー]タブおよび[連携ユニット]ダイアログで,後続ルートジョブネットへの影響の有無が不明であることを表すアイコン(
アイコン)を表示するかどうかを指定します。
「true」または「false」のどちらかを指定します。アイコンを表示する場合は「true」,表示しない場合は「false」です。デフォルト値は「true」です。
- jp1.imdd.event.stormCompatible=繰り返しイベントの表示抑止機能の互換設定
-
バージョン12-00では,jcoimdefコマンドの-stormオプションの設定がONでも,繰り返しイベントの表示が抑止されません。このため,バージョン12-00からバージョンアップした場合,繰り返しイベントの表示抑止機能を使用するには,繰り返しイベントの表示抑止機能の互換設定を無効(false)にする必要があります。
なお,バージョン12-10を新規インストールした場合,繰り返しイベントの表示抑止機能の互換設定はあらかじめ無効(false)に設定されています。
「true」または「false」のどちらかを指定します。
「true」を設定すると12-00と同様に繰り返しイベントの表示を抑止しません。「false」を設定すると,繰り返しイベントの表示を抑止します。
デフォルト値は「true」です。
jcoimdefコマンドの-stormオプションの繰り返しイベントの監視抑止の設定がONで,かつjp1.imdd.event.stormCompatibleオプションの設定がfalseの場合に,繰り返しイベントの表示抑止機能が有効になります。
jcoimdefコマンドの-stormオプションの繰り返しイベントの監視抑止の設定がOFFの場合は,jp1.imdd.event.stormCompatibleオプションの設定に関わらず,繰り返しイベントの表示抑止機能は無効となります。
- jp1.imdd.gui.settings.eventSearchCount=イベント取得での検索回数
-
統合オペレーション・ビューアーがイベント一覧を表示するために行うイベント取得での検索回数を設定します。
イベント取得では,選択したIM管理ノードにマッピングされているイベントを対象に検索します。表示するページに応じて検索開始位置,検索方向を決定し,検索対象のイベント100件を決定します。ユーザーフィルターなどによりイベントが100件取得できなかった場合は,次のイベント100件を対象として繰り返し検索します。
この繰り返し行うイベント検索回数の上限値を設定します。検索回数が設定した値に達した場合は検索を中断し,イベント一覧には中断までに取得したイベントを表示します。
指定できる値は,0〜120000(単位:回)です。0を指定した場合は,無制限となります。デフォルトは10回です。指定できる範囲以外の値を指定した場合は,デフォルトの値を仮定して動作します。
- jp1.imdd.authBasic=Basic認証の有効/無効
-
インテリジェント統合管理基盤の任意のREST APIでは,REST APIに付加したログイン情報による認証方式(Basic認証)を使用できます。このBasic認証を有効にするかどうかを設定します。
「true」または「false」のどちらかを指定します。
「true」を設定すると,Basic認証を有効にします。
デフォルト値は「false」です。
REST APIについては,別途提供するドキュメントを参照してください。
注意事項
インテリジェント統合管理基盤サービスを起動した際にこの定義ファイルが存在しない場合,または読み込みに失敗した場合は,統合トレースログにKAJY00015-W,KAJY00016-Wのメッセージを出力し,デフォルトの値をプロパティに仮定して起動します。
定義例
server.port=20703 jp1.imdd.proxy.server[0].host=ProxyServer jp1.imdd.proxy.server[0].port=443 jp1.imdd.proxy.server[0].user=UserID jp1.imdd.proxy.target[0].host=HostA jp1.imdd.proxy.target[0].serverHost=ProxyServer jp1.imdd.gui.settings.contentViews.sample.title=\u30ab\u30b9\u30bf\u30e0UI1 jp1.imdd.gui.settings.contentViews.sample.url=./customUI/sample/index.html jp1.imdd.gui.settings.contentViews.sample.target=^(?=.*MYHOST).*$ jp1.imdd.gui.settings.contentViews.sample2.title=\u30ab\u30b9\u30bf\u30e0UI2 jp1.imdd.gui.settings.contentViews.sample2.url=./customUI/sample2/index.html jp1.imdd.gui.settings.contentViews.sample2.sid=_ROOT_AllSystems jp1.im.db.DEFAULT.portNo=20700 jp1.im.db.DEFAULT.logicalHostNum=[1-9] jp1.imdd.gui.settings.linkedUnit.impact.unKnownDisplay=true jp1.imdd.event.stormCompatible=false jp1.imdd.gui.settings.eventSearchCount=10 jp1.imdd.authBasic=false