====== Pandora FMS 6.0 から 7.0 への機能のマイグレーション ======
[[:ja:quickguides:start|クイックガイド一覧に戻る]]
Always keep in mind that when upgrading from Pandora FMS version 6.0 **you will only be able to migrate up to version 7.0 NG 759**. From there you will have to keep upgrading to successive versions (consult the PFMS [[:es:documentation:08_technical_reference:10_versions|version history]] to apply the corresponding MR's after you have migrated to version 759).
Pandora FMS バージョン 6.0 からアップグレードする場合は **バージョン7.0NG 759** までしか移行できないことに注意してください。 そこから、後続のバージョンにアップグレードし続ける必要があります(バージョン 759 に移行した後、対応する MR を適用するには、[[:ja:documentation:08_technical_reference:10_versions|バージョン履歴]] を参照してください)。
===== Pandora FMS 6.0 から 7.0 への機能マイグレーション =====
このクイックガイドでは、新たなリリースで変更になった最も重要な機能および、マイグレーションで必要な操作について説明します。
==== ネットワークマップ ====
Pandora FMS 7.0 NG では従来のネットワークマップが改善されました。これは、これまでのネットワークマップはマイグレーションを行うと消えることを意味しており、マップはネットワークコンソールで再作成する必要があります。新しいバージョンでは、異なる監視対象デバイスインターフェイス間でリンクできます。
{{ wiki:mig1.JPG?800 }}
{{ wiki:mig2.JPG?800 }}
これらの接続はネットワーク自動検出で設定されますが、実行されていない場合は手動で接続を設定する必要があります。それには、次のようにします。
{{ wiki:mig3.JPG?800 }}
==== L2 自動検出タスク ====
標準の自動検出タスク(ネットワーク探索)は、これまで SNMP スクリプトである SNMP L2 Recon によって実行されていたオプションが追加されました。このスクリプトは、マイグレートした後の 7.0 NG でも機能します。異なるネットワークデバイス間のインターフェイスの接続を改善するネットワーク探索モードは、SNMP L2 Recon スクリプトには組み込まれていませんでいた。
{{ wiki:mig4.JPG?800 }}
==== エージェントの名前変更 ====
これはユーザから要望のあった機能です。以前のバージョンでは、この変更はコンソールと設定ファイルで実行する必要があったため、変更する要素の数に応じて面倒な作業になりました。
この問題を解決するために新たに別名の機能を追加しました。新しいバージョンでは、一つのエージェントラベルの中に、名前と別名の 2つの要素があります。
{{ wiki:mig5.JPG?800 }}
バージョン 6 から 7 へマイグレーションした環境では、この要素は同じです。
{{ wiki:mig6.JPG?800 }}
エージェントの表示名を変更したい場合は、別名を変更します。これにより、すべての表示でこの名前で利用されるようになります。
{{ wiki:mig7.JPG?800 }}
{{ wiki:mig8.JPG?800 }}
バージョン 7.0NG におけるエージェント名はランダムなデータから作成されます。これは、同じホスト名のマシンがあった場合に、Pandora FMS コンソール上では異なるエージェント名で同じ別名のエージェントが 2つ存在することを意味します。
この機能を利用したくない場合は(たとえば、エージェントソフトウェアの vmware プラグインが VM の Pandora 環境にインストールされていて、両方のソースのデータを同じ論理エージェントに入れたい場合など)、以前のバージョンと同様に動作するようにエージェントを設定できます。 同じエイリアスとエージェント名を持つエージェントを作成します。これを行うには、エージェントソフトウェアの設定ファイルで次の調整をします。
#agent_name 5fa9bdc9ad26a4d0e87d0f0d15ed786c3bd487441b2d5e8d7c42b90e8389797d
#agent_name_cmd __rand__
このようにすると、エージェントはいつもと同じ名前で、両方のソースから受け取った情報で作成されます。 必要に応じてコンソールから別名を変更することはできますが、情報は通常どおり表示されます。
エージェントまたはサテライトサーバを更新する場合は、使用している設定ファイルを保存しておく必要があります。そうしないと、上記の2つのパラメータが同じ設定で入力されている場合を除いて、それらは削除され、新しいランダムのラベル付きエージェントが生成され、保存された履歴データは失われます。
==== 新 Pandora FMS エージェント ====
エージェントが出力する既定の情報は、この新しいバージョンの Pandora FMS 7.0 NG で変更され、統一、統合されました。
情報を出力する新たなモジュールがあります。
Linux エージェント
{{ wiki:mig9.JPG?800 }}
Windows エージェント
{{ wiki:mig10.JPG?800 }}
エージェントは、新規エージェントでない限り、移行後に同じ構成のモジュールを維持します。 バージョン 7.0 に含まれるモジュールは自動的には追加されません。
上記の場合、追加する設定を以下に示します。
Linux エージェント
# Could change depending on linux distro and vmstat command version
module_begin
module_name CPU Load
module_type generic_data
module_interval 1
module_exec vmstat 1 2 | tail -1 | awk '{ print $13 }'
module_max 100
module_min 0
module_description User CPU Usage (%)
module_min_warning 70
module_max_warning 90
module_min_critical 91
module_max_critical 100
module_unit %
module_group System
module_end
# Could change depending on linux distro and vmstat command version
module_begin
module_name CPU IOWait
module_type generic_data
module_interval 1
module_exec vmstat 1 2 | tail -1 | awk '{ print $16 }'
module_min_warning 10
module_min_critical 16
module_unit %
module_description Too much IOwait means IO bottleneck and performance problems. Check also LoadAVG.
module_group System
module_end
# Get load average
module_begin
module_name Load Average
module_type generic_data
module_exec cat /proc/loadavg | cut -d -f1
module_description Average process in CPU (Last minute)
module_group System
module_end
# Basic info about TCP Connection
module_begin
module_name TCP_Connections
module_type generic_data
module_exec netstat -an | grep tcp | grep -v LIST | wc -l
module_description Total number of TCP connections active
module_group Networking
module_end
# This plugin detects all disk and report used space (%)
module_plugin pandora_df_used
# This plugin detects system free memory and used swap (in %)
module_plugin pandora_mem_used
# This plugin will get the network usage (bytes/sec)
module_plugin pandora_netusage
Windows エージェント
# CPU Load using WMI
module_begin
module_name CPU Load
module_type generic_data
module_wmiquery SELECT LoadPercentage FROM Win32_Processor
module_wmicolumn LoadPercentage
module_max 100
module_min 0
module_description User CPU Usage (%)
module_min_warning 70
module_max_warning 90
module_min_critical 91
module_max_critical 100
module_unit %
module_group System
module_end
# Basic info about TCP Connection
module_begin
module_name TCP_Connections
module_type generic_data
module_exec netstat -an | find /c /v "estab"
module_description Total number of TCP connections active
module_group Networking
module_end
# Example plugin to retrieve drive usage
module_plugin cscript.exe //B "%ProgramFiles%\Pandora_Agent\util\df_percent_used.vbs"
# Example plugin to retrieve memory usage
module_plugin cscript.exe //B "%ProgramFiles%\Pandora_Agent\util\mem_percent_used.vbs"
# Example plugin to retrieve network usage
module_plugin cscript.exe //B "%ProgramFiles%\Pandora_Agent\util\network.vbs"
==== アップデートマネージャ / ローリングリリース ====
Pandora FMS 7.0 NG では、段階的にリリースされる OUM パッチでデータベースの変更を行います。ネットワーク接続の状況に応じてアップデートマネージャのオンラインまたはオフラインのメニューへ行きます。
オフラインのアップデートは、Pandora FMS Enterprise版にのみあります。
=== オンラインアップデートマネージャ ===
アップデートマネージャ > オンラインアップデートマネージャ へ行きます。
{{ wiki:mig11.JPG }}
新規バージョンのインストールでは、次のようなメッセージが表示されます。
{{ wiki:mig12.JPG?700 }}
"最新バージョンに更新(Update to the latest version)" をクリックします。
{{ wiki:mig13.JPG?700 }}
アップデートが受け付けられると、次のパッチがダウロードされ適用されます。パッチにデータベースの変更も含んでいる場合は、変更を適用する前に、次のメッセージが表示されます。これは、パッチ適用でエラーが発生した場合にデータベースを元に戻せるように、データベースのバックアップを促すためです。
{{ wiki:mig14.JPG?700 }}
MR が適用され、データベースの変更が行われ、プロセスが終了すると更新されたバージョンが表示されます。
{{ wiki:mig15.JPG?700 }}
=== オフラインアップデートマネージャ ===
オフラインアップデートマネージャは、Pandora FMS Enterprise 版にのみあります。
アップデートマネージャ > オフラインアップデートマネージャ へ行きます。
{{ wiki:mig16.JPG }}
表示に従って、パッチをアップロードします。
{{ wiki:mig17.JPG?800 }}
パッチが適用されると、以下のメッセージが表示されます。
{{ wiki:mig18.JPG?800 }}
アップロードファイルにデータベースの変更も含まれる場合は、それも適用され次のメッセージが表示されます。
{{ wiki:mig19.JPG?800 }}
どのバージョンで動いているかを確認するには、コンソールのフッターを見ます。どの MR かと、データベースのバージョン、変更が適用されたかどうかが表示されています。
{{ wiki:mig20.JPG?600 }}
==== 新たなアラートテンプレート ====
このリリースには、新たなテンプレートが追加されています。
{{ wiki:mig21.JPG?800 }}
これらは Pandora FMS 7.0 NG の新規インストールで設定されますが、以前のバージョンからのマイグレーションでは既存の設定を優先するため反映されません。
==== インタフェース監視の命名規則 ====
監視の命名規則を変更しました。モジュールはインタフェースラベルを情報を用いてより簡単に設定できるようになりました。
以前のバージョンでは、以下の命名規則が使われていました。
{{ wiki:mig22.JPG?800 }}
以下が新しいフォーマットです。
{{ wiki:mig23.JPG?800 }}
Enterprise マップ、インタフェースグラフなど Pandora FMS 7.0 NG の新機能の利点を使うためには、以下の SQL クエリにてモジュール名を編集する必要があります。
UPDATE tagente_modulo SET nombre = CONCAT(REPLACE(nombre, 'ifOperStatus_', ), '_ifOperStatus') WHERE nombre LIKE('ifOperStatus_%');
UPDATE tagente_modulo SET nombre = CONCAT(REPLACE(nombre, 'ifInOctets_', ), '_ifInOctets') WHERE nombre LIKE('ifInOctets_%');
UPDATE tagente_modulo SET nombre = CONCAT(REPLACE(nombre, 'ifOutOctets_', ), '_ifOutOctets') WHERE nombre LIKE('ifOutOctets_%');
サテライトサーバモジュールの設定変更には、サテライトの設定ファイル内のモジュール名を変更する必要があります。
(注意: リモート設定が有効になっている場合は、サーバ上の設定および .md5 を更新する必要があります。もしくはサーバから削除し、サテライトサーバ上で名前を変更し、再送します。)
リモート設定が有効な場合は、サーバで以下を実行します。
sed -i -e 's/ifOperStatus_\(.*\)/\1_ifOperStatus/' /etc/pandora/conf/*.conf
sed -i -e 's/ifInOctets_\(.*\)/\1_ifInOctets/' /etc/pandora/conf/*.conf
sed -i -e 's/ifOutOctets_\(.*\)/\1_ifOutOctets/' /etc/pandora/conf/*.conf
sed -i -e 's/ifOperStatus_\(.*\)/\1_ifOperStatus/' /var/spool/pandora/data_in/conf/*.conf
sed -i -e 's/ifInOctets_\(.*\)/\1_ifInOctets/' /var/spool/pandora/data_in/conf/*.conf
sed -i -e 's/ifOutOctets_\(.*\)/\1_ifOutOctets/' /var/spool/pandora/data_in/conf/*.conf
その後、これらの変更をサテライトサーバの設定に適用する必要があります。そのためには、それぞれのエージェントの .md5 ファイルの内容を適当な値で更新します。
echo 1 >/var/spool/pandora/data_in/md5/*.md5