設定手順¶
掲載:18 件(S/A/B/C × 用途、S 級は期待出力サンプル付き)(定番のみ)。除外項目は 11. 対象外項目 を参照。
重要度 × 用途 マトリクス¶
| 重要度\用途 | ObjectServer | Probe | Gateway / SMAC | Process Agent | セキュリティ | Web GUI | 連携 |
|---|---|---|---|---|---|---|---|
| S | cfg-objserv-create cfg-trigger-deploy |
cfg-probe-syslog | cfg-failover-pair cfg-smac-aggregation |
cfg-pa-deploy | cfg-ssl-objserv | cfg-webgui-waapi | — |
| A | cfg-objserv-http cfg-aen-enable |
cfg-probe-snmp cfg-probe-eif |
cfg-smac-collection cfg-smac-display |
— | — | — | cfg-scala-link |
| B | — | cfg-probe-glf cfg-probe-http-cmd |
— | — | — | — | — |
| C | — | — | cfg-proxy-deploy | — | — | — | — |
詳細手順¶
cfg-objserv-create: ObjectServer の新規作成と起動¶
重要度: S / 用途: ObjectServer
目的: 新規 ObjectServer インスタンス(NCOMS 等)の作成、omni.dat への登録、interfaces 生成、起動、生死確認まで。
前提: OMNIbus 本体 IM インストール済、$NCHOME / $OMNIHOME 環境変数設定済、Process Agent(cfg-pa-deploy)配置済または手動運用。
手順:
-
ObjectServer インスタンス作成
-
omni.dat 編集(
$NCHOME/etc/omni.dat) -
interfaces 生成
-
プロパティファイル準備(
$OMNIHOME/etc/NCOMS.props) -
起動(手動 or PA 配下)
-
生死確認
期待出力(実機サンプル):
nco_dbinit 成功時:
ObjectServer NCOMS created in $OMNIHOME/db/NCOMS
Catalog and master tables initialized.
Default groups, roles, restriction filters loaded.
NCOIM0011I: Database initialization successful.
nco_objserv 起動時 log($OMNIHOME/log/NCOMS.log):
Information: I-OBJ-100-029: NCOMS: ObjectServer started, listening on port 4100.
Information: I-OBJ-100-031: NCOMS: IDUC listening on port 4101.
Information: I-OBJ-100-035: NCOMS: Trigger 'generic_clear' enabled.
Information: I-OBJ-100-040: NCOMS: All initial triggers loaded.
nco_sql 接続成功時:
失敗時に出る代表メッセージ:
E-OBJ-100-002(プロパティファイル不正)E-OBJ-100-009(指定ポート占有)E-OBJ-100-014(Memstore.DataDirectory配下に既存 DB ファイルあり、または書込権限なし)
検証: nco_pa_status -server <PA> で RUNNING、nco_sql で接続可能、log に ObjectServer started が出ていること。
ロールバック: nco_pa_stop または kill。$OMNIHOME/db/<name> ディレクトリ削除で完全クリーン化(再作成可)。
関連: cfg-pa-deploy, cfg-trigger-deploy, inc-objserv-startup-fail
出典: S_OMN_BP, S_OMN_QSG, S_OMN_ADMIN
cfg-trigger-deploy: 標準 trigger / procedure の有効化と custom trigger 投入¶
重要度: S / 用途: ObjectServer
目的: delete_clears / generic_clear / hk_set_expiretime / hk_de_escalate_events 等の標準 trigger が enabled であることを確認し、必要なら custom trigger を投入。
前提: ObjectServer 起動済、nco_sql 権限。
手順:
-
標準 trigger group の状態確認
-
必要な group を enabled に
-
custom trigger 投入(ファイルから読み込む例)
my_custom_trigger.sqlの例(hk_de_escalate_events形式):create or replace trigger custom_de_escalate group housekeeping priority 5 every 86400 seconds begin for each row this_event in alerts.status begin if (this_event.Severity = 5 and this_event.LastOccurrence < (now - 259200)) then set this_event.Severity = 4; elseif (this_event.Severity = 4 and this_event.LastOccurrence < (now - 172800)) then set this_event.Severity = 3; elseif (this_event.Severity = 3 and this_event.LastOccurrence < (now - 86400)) then set this_event.Severity = 2; end if; end; end; go -
profiling で性能影響確認
期待出力(実機サンプル):
alter trigger group housekeeping enabled; 成功時:
profiling 結果(高コスト trigger 順):
NAME NUMZEROES AVERAGETIME TOTALTIME
custom_de_escalate 1 12000000 12000000
hk_set_expiretime 5 8500000 42500000
generic_clear 42 1200000 50400000
delete_clears 42 450000 18900000
失敗時:
E-SQL-001-014(trigger 構文エラー、行 / 列番号付き)E-SQL-002-021(指定 trigger group が存在しない)
検証: select count(*) from alerts.status where Severity = 0 and StateChange < (now - 120); が時間と共に減ること(delete_clears が動作している証拠)。
ロールバック: alter trigger group <name> disabled;、または個別 drop trigger <name>;。
関連: cfg-objserv-create, inc-alerts-status-bloat
出典: S_OMN_BP(Chapter 4)
cfg-probe-syslog: Syslog Probe 配置と rules 設計¶
重要度: S / 用途: Probe
目的: nco_p_syslog を配置、Identifier 組成 / Severity マッピングを rules で設計、ObjectServer に接続してイベント INSERT を確認する。
前提: ObjectServer 起動済 + omni.dat にエントリ済 + interfaces 生成済、Probe ホストに OMNIbus Probe バイナリ配置済。
手順:
-
Probe プロパティファイル準備(
$OMNIHOME/probes/linux2x86/syslog.props) -
rules ファイル編集(
$OMNIHOME/probes/linux2x86/syslog.rules) -
Probe 起動(PA 配下推奨、開発時は手動)
-
テストイベント投入(local syslog 経由)
-
ObjectServer 側で受信確認
期待出力(実機サンプル):
Probe 起動 log:
2026-04-01 10:00:00 [INFO] : Reading rules file: syslog.rules
2026-04-01 10:00:00 [INFO] : Rules file parsed successfully (32 rule blocks).
2026-04-01 10:00:00 [INFO] : Connected to ObjectServer NCOMS (4100/tcp).
2026-04-01 10:00:00 [INFO] : nco_p_syslog ready, listening on syslog stream.
select 結果:
失敗時:
Probe rules parse error at line 12: unknown tokenFailed to connect to ObjectServer NCOMS: Connection refused(inc-probe-conn-fail)
検証: 1 時間運用して alerts.status に Syslog 行が蓄積、Identifier の deduplication(Tally インクリメント)が動作。
ロールバック: Probe 停止 → rules 元戻し → Probe 再起動。
関連: cfg-failover-pair(Server に virtual 名指定), inc-rules-syntax-error
出典: S_OMN_BP(Chapter 5), S_OMN_PROBE_SYSLOG
cfg-failover-pair: Aggregation 二重化(AGG_GATE bidirectional Gateway)¶
重要度: S / 用途: Gateway / SMAC
目的: Aggregation 層の Primary(AGG_P)+ Backup(AGG_B)+ bidirectional Gateway(AGG_GATE)で fail-over を組み、controlled failback で resync する。
前提: AGG_P / AGG_B が両方起動、両 ObjectServer の trigger / schema が一致。
手順:
-
Gateway プロパティファイル(
$OMNIHOME/etc/AGG_GATE.props)Gate.ObjectServerA.Server : 'AGG_P' Gate.ObjectServerA.BufferSize : 50 Gate.ObjectServerB.Server : 'AGG_B' Gate.ObjectServerB.BufferSize : 50 Resync.LockType : PARTIAL MaxLogFileSize : 2048 Gate.MapFile : '$OMNIHOME/etc/AGG_GATE.map' Gate.Reader.IducFlushRate : 60 PropsFile : '$OMNIHOME/etc/AGG_GATE.props' -
mapping table(複製対象)定義(
$OMNIHOME/etc/AGG_GATE.map) -
virtual ObjectServer 名 omni.dat 登録
-
Gateway 起動
-
Probe 側 Server プロパティを virtual 名に変更
-
failover テスト:AGG_P を停止 → Probe が AGG_B へ自動切替を確認 → AGG_P 再起動 → Gateway resync → controlled failback。
期待出力(実機サンプル):
Gateway 起動 log:
2026-04-01 10:00:00 [INFO] : AGG_GATE: Connected to AGG_P (primary).
2026-04-01 10:00:00 [INFO] : AGG_GATE: Connected to AGG_B (backup).
2026-04-01 10:00:00 [INFO] : AGG_GATE: Resync.LockType=PARTIAL.
2026-04-01 10:00:01 [INFO] : AGG_GATE: Initial resynchronisation complete.
failover 中(AGG_P 停止):
2026-04-01 11:00:00 [WARN] : AGG_GATE: Lost connection to AGG_P, will retry.
2026-04-01 11:00:00 [INFO] : Probe ServerBackup AGG_B is taking over for AGG_V clients.
failback 中(AGG_P 再起動):
2026-04-01 12:00:00 [INFO] : AGG_GATE: AGG_P reconnected.
2026-04-01 12:00:00 [INFO] : AGG_GATE: Resync started, target AGG_P locked (PARTIAL).
2026-04-01 12:00:30 [INFO] : AGG_GATE: Resync complete (gw_resync_finish signal raised).
2026-04-01 12:00:30 [INFO] : AGG_GATE: Target AGG_P unlocked, clients can reconnect.
失敗時:
Resync timeout exceeded→ Gateway log で Status Serial 確認、mapping 漏れ調査。
検証: 24 時間運用で AGG_P / AGG_B の select count(*) from alerts.status; が一致を維持。
ロールバック: Gateway 停止 → AGG_P / AGG_B 単独運用に戻す。Probe Server を AGG_P に戻して再起動。
関連: cfg-smac-aggregation, inc-failover-resync-fail
出典: S_OMN_BP(Chapter 7), S_OMN_FAILOVER
cfg-smac-aggregation: SMAC Aggregation 層構築¶
重要度: S / 用途: Gateway / SMAC
目的: SMAC の中段である Aggregation 層を構築(AGG_P + AGG_B + AGG_GATE + 標準 SQL 投入)。
前提: ObjectServer インスタンス AGG_P / AGG_B 作成済(cfg-objserv-create)。
手順:
-
$OMNIHOME/extensions/multitier/objectserver/aggregation.sqlの投入 -
AGG_GATE 配置(cfg-failover-pair を実施)
-
accelerated_inserts trigger group の有効化
-
resync_completesignal trigger の動作確認:Gateway resync 完了で synthetic event が両 ObjectServer に挿入されることを確認。
関連: cfg-smac-collection, cfg-smac-display, cfg-failover-pair
出典: S_OMN_BP(Chapter 7), S_OMN_SMAC
cfg-pa-deploy: Process Agent(nco_pad)配置¶
重要度: S / 用途: Process Agent
目的: nco_pad を OS サービスとして起動し、ObjectServer / Probe / Gateway を PA 配下にして自動再起動を実現。
前提: OMNIbus 本体配置済、netcool ユーザ作成(root 起動回避)。
手順:
-
nco_pad プロパティ準備(
$OMNIHOME/etc/<PA>.props) -
process entries 定義(PA 設定ファイル内)
-
systemd unit(Linux 例)(
/etc/systemd/system/nco_pa.service)[Unit] Description=Netcool OMNIbus Process Agent After=network.target [Service] Type=forking User=netcool ExecStart=/opt/IBM/tivoli/netcool/omnibus/bin/nco_pad -name NCO_PA -authenticate PAM -secure ExecStop=/opt/IBM/tivoli/netcool/omnibus/bin/nco_pa_shutdown -server NCO_PA -user paadmin Restart=on-failure [Install] WantedBy=multi-user.target -
systemd 登録 / 起動
-
状態確認
関連: cfg-objserv-create, cfg-probe-syslog, inc-pa-process-down
出典: S_OMN_BP(Chapter 10), S_OMN_PA
cfg-ssl-objserv: ObjectServer SSL/TLS(SecureMode)有効化¶
重要度: S / 用途: セキュリティ
目的: ObjectServer / Probe / Gateway の通信を SSL/TLS(GSKit ベース)で暗号化、必要なら FIPS 140-2 モード。
前提: GSKit 同梱済、nc_gskcmd 使用可。
手順:
-
鍵 DB 作成
-
サーバ証明書作成 / インポート
-
ObjectServer プロパティに SecureMode
-
Probe / Gateway 側でも同 kdb を参照、または public 証明書のみ取り込み。
-
再起動 → SSL 接続テスト:
nco_sql -fips等で接続。
関連: cfg-objserv-create, 03-glossary > SecureMode
出典: S_OMN_ADMIN, S_GSKIT
cfg-webgui-waapi: Web GUI 構築と WAAPI による設定自動化¶
重要度: S / 用途: Web GUI
目的: Jazz/DASH 上に Web GUI をデプロイ、WAAPI でユーザ・フィルタ・ビューを XML で一括投入。
前提: WAS / DASH 構築済、Web GUI バイナリ IM インストール済。
手順:
- Web GUI を WAS 上にデプロイ(IM)。
- Web GUI のデータソースとして AGG_V(virtual 名)を登録。
-
WAAPI コマンドファイル(XML)を準備:
-
runwaapi -user wasadmin -file create_user.xml -outfile resp.xmlで投入。 -
Web GUI で AEL を開いて事象が流れているか確認。
関連: cfg-objserv-http, inc-waapi-error
出典: S_OMN_WAAPI, S_OMN_WEBGUI
cfg-objserv-http: ObjectServer HTTP/REST インタフェース有効化¶
重要度: A / 用途: ObjectServer
目的: REST 経由の event INSERT、外部システム(カスタム dashboard 等)からの SQL 発行を可能にする。
手順:
-
ObjectServer プロパティに
-
libnhttpd.json内で許可エンドポイント / CORS / SSL 設定。 -
再起動 → curl でテスト:
関連: cfg-ssl-objserv
出典: S_OMN_NHTTPD
cfg-aen-enable: Accelerated Event Notification(AEN)有効化¶
重要度: A / 用途: ObjectServer
目的: Critical イベントだけ Granularity を待たず Display 層へ即時配信。
手順:
-
accelerated_insertstrigger group enabled -
Probe rules 内でフラグ列セット
-
nco_aen 起動(PA 配下推奨)
出典: S_OMN_BP(Chapter 6), S_OMN_AEN
cfg-probe-snmp: SNMP Trap Probe(nco_p_mttrapd)配置¶
重要度: A / 用途: Probe
目的: UDP 162 で SNMP Trap を受信し、MIB に基づいて alerts.status へマッピング。
手順:
- MIB Manager で MIB → rules 変換、
Generating SNMP trapsの Number of Traps を必要数(例:5000)に。 - 生成された rules を
mttrapd.rulesに include。 - Probe プロパティ:
NetworkPort : 162、Server : COL_V_1。 - Probe 起動(root 権限が必要なポート 162 のため、setcap または PA 配下で root で起動)。
関連: cfg-probe-syslog, inc-mib-trap-truncate
出典: S_OMN_PROBE_MTTRAPD, S_OMN_MIB_MGR
cfg-probe-eif: Tivoli EIF Probe + Predictive Event 連携¶
重要度: A / 用途: Probe
目的: ITM 等から EIF イベントを受け、Predictive Event を含めて alerts.status へ。
手順:
nco_p_tivoli_eif配置、tivoli_eif.propsで Server / RulesFile 設定。tivoli_eif.rules内のinclude "predictive_event.rules"のコメントアウトを解除。- ITM 側で EIF 送信先として Probe ホスト:ポート を設定。
- C-based EIF アプリの環境変数
LIBPATH/LD_LIBRARY_PATHに GSKit を含める。
出典: S_OMN_EIF, S_OMN_ITM
cfg-smac-collection: SMAC Collection 層構築¶
重要度: A / 用途: Gateway / SMAC
目的: Probe を直接受ける Collection ObjectServer と Aggregation 層への uni-directional Gateway を配置。
手順:
- COL_P_1 / COL_B_1 の ObjectServer 作成 +
collection.sql投入(col_expiretrigger 込み)。 - C_TO_A_GATE_P_1 / C_TO_A_GATE_B_1(uni-directional)配置。
- Probe
Server : COL_V_1で接続。
出典: S_OMN_BP(Chapter 7)
cfg-smac-display: SMAC Display 層構築¶
重要度: A / 用途: Gateway / SMAC
目的: Web GUI / Impact 接続用の Display ObjectServer + Aggregation → Display Gateway を配置。
手順:
- DSP_P / DSP_B の ObjectServer 作成 +
display.sql投入(dsd_triggers等)。 - A_TO_D_GATE_P / A_TO_D_GATE_B(uni-directional)配置。
- Web GUI のデータソースを DSP_V に変更。
関連: cfg-smac-aggregation, cfg-webgui-waapi
出典: S_OMN_BP(Chapter 7)
cfg-scala-link: Operations Analytics(SCALA)連携¶
重要度: A / 用途: 連携
目的: alerts.status の更新を SCALA に送出してログ分析統合。
手順:
$OMNIHOME/extensions/scala/scala_triggers.jarをnco_confpack -importで投入。- SCALA エンドポイント(host / port)を
scala_triggersgroup の procedure 内で設定。 - trigger group enabled。
出典: S_OMN_SCALA
cfg-probe-glf: Generic Log File Probe 配置¶
重要度: B / 用途: Probe
目的: アプリ独自ログをパースして alerts.status へ。1 ホストで複数インスタンス起動可。
手順:
glf.propsでLogFile/RulesFile設定、複数インスタンスはNameを変えて Process Agent 経由で起動。- rules で正規表現 + Identifier 組成。
関連: cfg-probe-syslog
出典: S_OMN_PROBE_GLF
cfg-probe-http-cmd: Probe HTTP Command Interface 有効化¶
重要度: B / 用途: Probe
目的: Probe 再起動なしで rules reload / status 取得をするために HTTP インタフェースを有効化。
手順:
- Probe プロパティに
EnableHTTP : TRUE、HTTPPort : 8001等。 - HTTP 認証 / SSL 必須(DMZ 越しでは特に注意)。
curl -k -u user:pwd https://probe-host:8001/probes/syslog/reloadでテスト。
関連: cfg-probe-syslog
出典: S_OMN_PROBE_GW
cfg-proxy-deploy: Proxy Server 配置(DMZ 経由 Probe 集約)¶
重要度: C / 用途: Gateway / SMAC
目的: 多数の Probe を DMZ Proxy Server 経由で内部 ObjectServer に集約、firewall を 1 経路に集約。
手順:
- DMZ ホストに
nco_proxyserv -name DMZ_PROXY -secureで起動(SecureMode 必須)。 - Probe
Server : DMZ_PROXYで接続。 - firewall は DMZ_PROXY → 内部 AGG_V のみ開放。
関連: cfg-failover-pair, cfg-ssl-objserv
出典: S_OMN_PROXY
出典 ID は 07. 出典一覧 を参照。