Nagios XI設定インポート準備ツールの使用

Nagios XI – 設定インポート準備ツールの使用
目的
この資料では、Nagios XI 設定ファイルインポート準備ツールの使い方について説明します。この
準備ツールは、ネイティブの Nagios Core 設定ファイルを Nagios XI Web インターフェースで管理で
きる形式に事前処理するために使用します。
対象読者
この資料は、既存の Nagios Core インストレーションから設定ファイルをインポートしたい Nagios 管
理者を対象としています。インポート準備ツールは Nagios Core 設定ファイルを Nagios XI に含まれ
る Nagios Core Configration Manager にインポートする前に使用してください。
このツールがすること
このインポート準備ツールは、Nagios Core のオブジェクト定義ファイルを解析し、サービス定義を
1つ以上の設定ファイルに分割します(ファイル名はサービス定義に関連するホスト名となります)。
その他のオブジェクト定義(ホスト、ホストグループなど)は元の設定ファイルと同じ名前のファイル
に書き込まれます。
新しく作成された設定ファイルは現在の作業ディレクトリに書き込まれます。このため、元ファイル
は現在の作業ディレクトリとは別のディレクトリに置いて下さい。
元ファイルに以下のサービスが定義されている場合、準備ツールは2つの設定ファイルに定義を
書き込みます。
define service{
host somehost
description Ping
}
somehost.cfg
define service{
host somehost
description Load
}
define service{
host www.acme.com
description Ping
}
www.acme.com.cfg
Nagios XI 設定インポート準備ツールの使用
rev 1.1
1
Nagios XI – 設定インポート準備ツールの使用
複数のホスト名を参照するまたはホストグループを参照するサービス定義は、
_multiple_hosts.cfg という特別な設定ファイルに書き込まれます:
define service{
host host1,host2
description Ping
}
_multiple_hosts.cfg
define service{
hostgroup hg1
description Load
}
その他のオブジェクト定義(ホスト、ホストグループなど)は元の設定ファイルと同じ名前のファイル
に書き込まれます。例えば、元のファイル名が chicago.cfg の場合、これらのオブジェクト定義
は全く同じ名前のファイルに書き込まれます。
define host{
host_name host1
address 192.168.1.1
...
}
chicago.cfg
define hostgroup{
hostgroup_name hg1
...
}
元ファイルが複数ある場合
インポート準備ツールスクリプトは1回に1つの設定ファイルを処理します。処理が必要なオブジェ
クト定義ファイルが複数ある場合は、各設定ファイルに対してこのツールを実行する必要がありま
す。
ツールの場所とコマンドライン構文
インポート準備ツールは Nagios XI version 2009R1 以降に同梱されています。インポート準備ツー
ルスクリプトは Nagios XI 監視サーバーの以下のディレクトリにあります:
/usr/local/nagiosxi/tools
以下の構文でスクリプトを実行します:
php /usr/local/nagiosxi/tools/xiprepimport.php <元の設定ファイル>
Nagios XI 設定インポート準備ツールの使用
rev 1.1
2
Nagios XI – 設定インポート準備ツールの使用
<元の設定ファイル> には、設定ファイルへのパスを指定します。元の設定ファイルを現在の作業
ディレクトリに置かないでください。
設定インポート準備ツールの使用
以下の手順でツールを使用します。
Step 1.
ターミナルを開き、Nagios XI サーバーに root ユーザーでログインします。
Step 2.
以下のようなコマンドを実行し、変換後の設定ファイルを保持する一時ディレクトリを作
成します。このディレクトリは/usr/local/nagios/etc ディレクトリ構造の配下にな
ければなりません。
コマンド例:
mkdir /usr/local/nagios/etc/cfgprep
Step 3.
以下のようなコマンドを実行し、インポート準備を行いたいオリジナルの設定ファイルを
保存するためのサブディレクトリを作成します。
コマンド例:
mkdir /usr/local/nagios/etc/cfgprep/orig
Step 4.
SSH またはその他で Nagios Core インスタンスからこのディレクトリ
(例: /usr/local/nagios/etc/cfgprep/orig)にオリジナルの設定ファイルを
アップロードします。
Step 5.
以下のコマンドを実行し、オリジナルのファイルのアップロードが完了したら、作成した設
定準備ディレクトリ (例: /usr/local/nagios/etc/cfgprep)に移動します。
コマンド例:
cd /usr/local/nagios/etc/cfgprep
Step 6.
以下のコマンドを実行し、アップロードした設定ファイルをリストします。
ls -al orig
Step 7.
オリジナルの設定ファイルのリストを確認します。以下は例です(ファイル名とファイル数
は環境によって異なります)。
Nagios XI 設定インポート準備ツールの使用
rev 1.1
3
Nagios XI – 設定インポート準備ツールの使用
total 112
drwxr-xr-x
drwxr-xr-x
-rw----r--rw----r--rw----r--rw----r--rw----r--rw----r--rw----r--rw----r--rw----r--
2
3
1
1
1
1
1
1
1
1
1
root
root
root
root
root
root
root
root
root
root
root
root
root
root
root
root
root
root
root
root
root
root
4096 2009-12-20 10:30 .
4096 2009-12-20 10:30 ..
11905 2009-12-20 10:30 commands.cfg
2622 2009-12-20 10:30 contacts.cfg
152 2009-12-20 10:30 dependencies.cfg
1714 2009-12-20 10:30 hostgroups.cfg
6664 2009-12-20 10:30 hosts.cfg
101 2009-12-20 10:30 servicegroups.cfg
48263 2009-12-20 10:30 services.cfg
12641 2009-12-20 10:30 templates.cfg
3209 2009-12-20 10:30 timeperiods.cfg
オリジナルの設定ファイルごとに設定準備ツールを実行します。
例:
php
php
php
php
php
php
php
php
php
/usr/local/nagiosxi/tools/xiprepimport.php
/usr/local/nagiosxi/tools/xiprepimport.php
/usr/local/nagiosxi/tools/xiprepimport.php
/usr/local/nagiosxi/tools/xiprepimport.php
/usr/local/nagiosxi/tools/xiprepimport.php
/usr/local/nagiosxi/tools/xiprepimport.php
/usr/local/nagiosxi/tools/xiprepimport.php
/usr/local/nagiosxi/tools/xiprepimport.php
/usr/local/nagiosxi/tools/xiprepimport.php
orig/commands.cfg
orig/contacts.cfg
orig/dependencies.cfg
orig/hostgroups.cfg
orig/hosts.cfg
orig/servicegroups.cfg
orig/services.cfg
orig/templates.cfg
orig/timeperiods.cfg
ツールの実行結果にエラーが発生していないか確認します。エラーはオリジナルファイルのパーミ
ッションが正しくない、またはオリジナルのファイルが現在の作業ディレクトリに存在する場合に発
生します。続行する前にエラーを解決して下さい。
Step 8.
orig ディレクトリ内のすべてのファイルを1つの短いコマンドで処理させたい場合は、以
下のコマンドを実行します。
cd /usr/local/nagios/etc/cfgprep
for f in orig/* ; do /usr/local/nagiosxi/tools/xiprepimport.php $f ; done
Step 9.
設定準備ツールが完了したら、以下のコマンドを実行し、現在のディレクトリの内容をリ
ストします。
ls –al
Step 10. 作成されたファイルを確認します。以下は例です。
Nagios XI 設定インポート準備ツールの使用
rev 1.1
4
Nagios XI – 設定インポート準備ツールの使用
total 116
drwxr-xr-x 3 root root 4096 2009-12-20 10:36 .
drwsrwsr-x 10 apache nagios 4096 2009-12-20 10:29 ..
-rw-r--r--1 root root 5946 2009-12-20 10:36 commands.cfg
-rw-r--r--1 root root 827 2009-12-20 10:36 contacts.cfg
-rw-r--r--1 root root 132 2009-12-20 10:36 dependencies.cfg
-rw-r--r--1 root root 185 2009-12-20 10:36 dev1.cfg
-rw-r--r--1 root root 1370 2009-12-20 10:36 www.nagios.com.cfg
-rw-r--r--1 root root 129 2009-12-20 10:36 em01b.cfg
-rw-r--r--1 root root 3091 2009-12-20 10:36 _empty_host.cfg
-rw-r--r--1 root root 2773 2009-12-20 10:36 filer.cfg
-rw-r--r--1 root root 962 2009-12-20 10:36 hostgroups.cfg
-rw-r--r--1 root root 4442 2009-12-20 10:36 hosts.cfg
-rw-r--r--1 root root 6993 2009-12-20 10:36 linksys-switch.cfg
-rw-r--r--1 root root 2284 2009-12-20 10:36 mpc.cfg
-rw-r--r--1 root root 16252 2009-12-20 10:36 _multiple_hosts.cfg
drwxr-xr-x 2 root root 4096 2009-12-20 10:30 orig
-rw-r--r--1 root root 78 2009-12-20 10:36 servicegroups.cfg
-rw-r--r--1 root root 0 2009-12-20 10:36 services.cfg
-rw-r--r--1 root root 1318 2009-12-20 10:36 task.cfg
-rw-r--r--1 root root 6330 2009-12-20 10:36 templates.cfg
-rw-r--r--1 root root 531 2009-12-20 10:36 temptraxe1.cfg
-rw-r--r--1 root root 1400 2009-12-20 10:36 timeperiods.cfg
次の作業
Nagios XI 用に形式を変更した Nagios Core 設定ファイルは、Nagios XI にインポートできます。次の
設定ファイルのアップロード作業については、設定ファイルのインポート文書をお読みください。
Nagios Core オリジナルの設定ファイルではなく、設定インポート準備ツールで生成された変換済
みファイルを忘れずにアップロードしてください。
お問い合わせ
弊社では、Nagios XI に関するご意見、フィードバックをお待ちしております。
Nagios XI についてご不明な点がございましたら、以下までお問い合わせください。
ジュピターテクノロジー株式会社(Jupiter Technology Corp.)
住所:
URL:
電話番号:
FAX 番号:
購入前のお問い合わせ先:
〒183-0023 東京都府中市宮町 2-15-13 第 15 三ツ木ビル 8F
http://www.jtc-i.co.jp/
042-358-1250
042-360-6221
https://www.jtc-i.co.jp/contact/scontact.php または
[email protected]
購入後のお問い合わせ先: https://www.jtc-i.co.jp/support/customerportal/
Nagios XI 設定インポート準備ツールの使用
rev 1.1
5
Nagios XI – 設定インポート準備ツールの使用
日本語マニュアル発行日 2014 年 6 月 25 日
本マニュアル原文 Nagios XI – Using The Config Import Prep Tool
Revision 1.0 – June, 2014
ジュピターテクノロジー株式会社
Nagios XI 設定インポート準備ツールの使用
rev 1.1