Xymon 4.3.Xへのアップデートについて



●4.2.3から4.3.2へのアップデート

 ソースからインストールすることを前提に説明します。
 Xymonの最新版(4.3.2)をSourceForgeから/usr/local/srcにダウロードします。ダウンロードしたファイルを展開し、インストールします。
# cd /usr/local/src
# tar xvzf xymon-4.3.2.tar.gz
# cd xymon-4.3.2
# ./configure
 configure時に質問がされますが、自分の環境に基づいて対応してください。バージョン4.2.3のconfigure時はXymon(旧Hobbit)サーバのインストールのようにしていました。
 インストール方法はInstalling Xymonを参照してください。
 make完了時に下記のような警告が表示されました。
Build complete.
#####################################################################
IMPORTANT: If upgrading from 4.2.x, see the docs/upgrade-to-430.txt
           file for instructions. You must run build/upgrade430.sh
           before installing the new version.
#####################################################################
Now run 'make install' as root
 docs/upgrade-to-430.txtに目を通すと、
1) Make sure you have a backup. It is not necessary to backup
   the data in the hist/, histlogs/, hostdata/ and rrd/ 
   directories (if you use the default directory layout, then
   that means the entire data/ directory need not be backed up).
2) Configure Xymon 4.3.0 using a directory layout that is
   identical to your previous version. Make sure you keep the
   directory names exactly as they were in the version you are
   currently running, even though that may include "hobbit" in
   the directory name.
3) Build Xymon 4.3.0 (run "make")
4) Stop Hobbit (the current version).
5) Using the "bbcmd" utility from your current version, run
   then "./build/upgrade430.sh" script. I.e. run a command
   like
       ~hobbit/server/bin/bbcmd ./build/upgrade430.sh
   This will perform almost all of the file renaming and 
   configuration file updates that are needed when going
   to version 4.3. A few updates cannot be done automatically,
   you will be notified what else is needed after the script
   completes.
6) Install Xymon 4.3.0 (run "make install").
Your installation should now be upgraded to version 4.3.0.
Run your normal startup-script to launch Xymon, or the
        ~hobbit/server/xymon.sh start
の記載がありましたので、指示にしたがって4.3.Xにバージョンアップします。
# service xymon stop
# ~hobbit/server/bin/bbcmd ./build/upgrade430.sh
2011-06-18 10:48:17 Using default environment file /home/xymon/server/etc/xymonserver.cfg
mv: `bb' と `xymon' は同じファイルです
ln: creating symbolic link `bb': ファイルが存在します
mv: `bbcmd' と `xymoncmd' は同じファイルです
ln: creating symbolic link `bbcmd': ファイルが存在します
mv: `bbhostgrep' と `xymongrep' は同じファイルです
ln: creating symbolic link `bbhostgrep': ファイルが存在します
mv: `bbhostshow' と `xymoncfg' は同じファイルです
ln: creating symbolic link `bbhostshow': ファイルが存在します

Things you must do
==================

* Run 'make install' now to install Xymon 4.3.0.

* If you have modified web templates files, then these have
NOT been updated with the new default templates. You must
manually install the new templates from the xymond/webfiles
directory, and copy over any changes you have made locally.
All of the template files were updated to include a link
to the new xymon.sourceforge.net website, the DOCTYPE header
was updated from '4.0 Transitional' to '4.0', the Java
menu-code in the footer-files was replaced with &XYMONBODYFOOTER
the menu stylesheet was changed to &XYMONBODYMENUCSS, and a line
with &XYMONBODYHEADER was added just after the BODY tag in all
header-files.
The following files had further changes from 4.2.3 to 4.3.0:
- event_form
- hostgraphs_form
- notify_form
If you modified these three files, it is probably best to
copy the new standard files from xymond/webfiles/ to your
/home/xymon/server/web/ and re-add your local changes.

* If you have modified the menu-entries in the Xymon menu, then
these changes have not been ported over to the new setup. You
must add these changes to the new /home/xymon/server/etc/xymonmenu.cfg file.

* In your Apache (webserver) configuration, add
FollowSymLinks to the Options line for the
/home/xymon/cgi-bin and /home/xymon/cgi-secure directories.

* Also in your Apache (webserver) configuration, add
Rewrite-rules so the old URL's for CGI-scripts and webpages
still work. See the xymond/etcfiles/xymon-apache.conf example file.
# make install
 下記のように表示されれば、インストール完了です。
Installation complete.
You must configure your webserver for the Xymon webpages and CGI-scripts.
A sample Apache configuration is in /home/xymon/server/etc/xymon-apache.conf
If you have your Administration CGI scripts in a separate directory,
then you must also setup the password-file with the htpasswd command.
To start Xymon, as the xymon user run '/home/xymon/server/bin/xymon.sh start'
To view the Xymon webpages, go to http://******.bigbang.dyndns.org/xymon
 xymonを起動します。
# service xymon start
 10分ほど経過すれば、旧バージョンで設定していた値等が読み込まれ正常に表示されるようになります。

●旧バージョンとの表示項目の違い

 バージョン4.3.Xの監視画面を見ていると見慣れない項目が表示されていることに気づきました。調べてみるとバージョンアップによって名前が変わったようです。

●バージョンアップによるファイル等の名前変更

 バージョンアップによって相当数のファイルの名前が変更となっていますので、注意してください。
 Renaming-430.txt

●設定ファイル

 詳細はConfiguring Xymon Monitoringを参照してください。
 Renaming-430.txtにも記載されているとおり下記のように変わっています。
bb-hosts			→	hosts.cfg
bbcombotest.cfg			→	combo.cfg
hobbit-alerts.cfg		→	alerts.cfg
hobbitcgi.cfg			→	cgioptions.cfg
hobbit-nkview.cfg		→	critical.cfg
hobbit-rrddefinitions.cfg	→	rrddefinitions.cfg
hobbitgraph.cfg			→	graphs.cfg
hobbit-holidays.cfg		→	holidays.cfg
hobbit-clients.cfg		→	analysis.cfg
hobbit-snmpmibs.cfg		→	snmpmibs.cfg
hobbitlaunch.cfg		→	tasks.cfg
hobbitserver.cfg		→	xymonserver.cfg
hobbitclient.cfg		→	xymonclient.cfg
bb-services			→	protocols.cfg

●ヘルプ一覧

 ヘルプページ一覧は下記をクリックしてください。
 Xymon4.3.Xのヘルプページはこちらです。
 マニュアルページは下記をクリックしてください。
 Xymon4.3.Xのマニュアルページはこちらです。

●Xymon(旧Hobbit)で追加したサービスを取り消すには

 bb-hostsで監視対象サービスをテストで色々設定してしまい、Web画面上から取り除く場合、以下の方法により解決しました。
 下記は、ホスト名www.abc.co.jpから「bbd」を取り除く場合の方法です。
 まず、installdir/server/etc/bb-hostsで「bbd」を削除します。
 次に「bb」コマンドを実行します。
# installdir/server/bin/bb 127.0.0.1 "drop www.abc.co.jp bbd"
 これでも取り除くことができない場合は、下記を実行します。
# service xymon restart
# service httpd reload