If You are updating form a version before 0.9.6 please note, there are two more perl modules required now, JSON::XS and LWP::UserAgent, see section "Requirements" in INSTALL If You want to update from version 0.9.0 or 0.9.1, there are two different ways: 1. keep the old path and URL settings (not recommended) 2. use the new path and URL setting If You are updating from version 0.9.2 or later, please see section "Updating from version 0.9.2 or later" below. Keep the old path and URL settings ---------------------------------- If You choose this way, You will keep path (/usr/local/nagios-ext) and URL (http://yourhost.example.com/nagios-ext/...) as they were in previous versions. This has the advantage, that You do not need to change any links. Do the following steps: Save the files of Your nagios-ext/etc directory. Change to the directory directly above nagios-ext, by default /usr/local cd /usr/local Delete nagios-ext rm -f nagios-ext If You did create a separate session directory, e. g. /var/www/nagios_bp.sessions You can remove this directory too: cd /var/www rm -Rf nagios_bp.sessions Install this version as described in INSTALL and README. As options for configure You should use something like ./configure --with-cgiurl=/nagios-ext/cgi-bin --with-htmurl=/nagios-ext --prefix=/usr/local/nagios-ext --with-cron-d-dir=/usr/local/nagios-ext/etc/cron.d --with-httpd-conf=/usr/local/nagios-ext/etc/apache-conf.d Restore the files in nagios-ext/etc One change in configuration You have to do: The file which was named ndo_db_readonly.cfg before is now ndo.cfg and has more settings. The best solution would be to copy ndo.cfg-sample to ndo.cfg cd etc cp ndo.cfg-sample ndo.cfg Afterwards You take over the values You did define in ndo_db_readonly.cfg into ndo.cfg. If You are updating from version 0.9.0 and Your NDO database is running on another host than Nagios Business Process View, You might want to completely reconfigure Your values in the new ndo.cfg, because it's more easy now to configure a different host and port for the database. Now You can delete the old ndo_db_readonly.cfg. If You did map Your Business Processes to Nagios service, please note, that You also have to change the service templates and the command You did define in some nagios config file: The command check_bp_status must get two parameters now, see README. The files *-sample in nagios-ext/etc can be removed. The symlinks You added to Your system's perl INC path pointing to *.pm files in /usr/local/nagios-ext/sbin/ should be removed. They are not needed any longer (Nagios Business Process AddOns use local libs now only). If You are unsure, which directories are in the INC path, type perl -e 'print join("\n", @INC) . "\n"' That's it. Now it should work. If You have problems, see section Help in README. Use the new path and URL setting -------------------------------- If You choose this way, You will install into the new default path (/usr/local/nagiosbp) and URL (http://yourhost.example.com/nagiosbp/...) This has the advantage, that You are closer to the standard of 0.9.2 and further versions. Do the following steps: Save the files of Your nagios-ext/etc directory. Change to the directory directly above nagios-ext, by default /usr/local cd /usr/local Delete nagios-ext rm -f nagios-ext If You did create a separate session directory, e. g. /var/www/nagios_bp.sessions You can remove this directory too: cd /var/www rm -Rf nagios_bp.sessions If You did create a cronjob, for cleaning up old session information, You can remove this one now. You probably have some line like */10 * * * * /usr/local/nagios-ext/bin/nagios_bp_session_timeout 2>&1 | logger -t nagios_bp_session_timeout in the crontab of the user Your webserver is running under. Remove it. On install of Your previous version, You did add some lines in Your httpd.conf (one ScriptAlias, one Alias and two directory directives - search for the string nagios-ext). Remove them. You will get a separate config file in apache's conf.d directory afterwards, when installing the new version. Now Your installation is as clean as we need it for the installation of the new version. (the only things we left over are Links in Nagios's side.html and some host and service templates and commands You did define in some Nagios config file - You will change them later) Now it's time to install this new version as described in INSTALL and README. When You are at the point to add two links to Nagios' side.html remember to just change the links there instead of inserting them. If You come to the section Business Process representation as Nagios services and You did map Your Business Processes to Nagios service before, please note, that You also have to change the service templates and the command You did define in some nagios config file: The command check_bp_status must get two parameters now, see README. Now You can restore the files in nagios-ext/etc One change in configuration You have to do: The file which was named ndo_db_readonly.cfg before is now ndo.cfg and has more settings. The best solution would be to copy ndo.cfg-sample to ndo.cfg cd etc cp ndo.cfg-sample ndo.cfg Afterwards You take over the values You did define in ndo_db_readonly.cfg into ndo.cfg. If You are updating from version 0.9.0 and Your NDO database is running on another host than Nagios Business Process View, You might want to completely reconfigure Your values in the new ndo.cfg, because it's more easy now to configure a different host and port for the database. Now You can delete the old ndo_db_readonly.cfg. The files *-sample in nagios-ext/etc can be removed. The symlinks You added to Your system's perl INC path pointing to *.pm files in /usr/local/nagios-ext/sbin/ should be removed. They are not needed any longer (Nagios Business Process AddOns use local libs now only). If You are unsure, which directories are in the INC path, type perl -e 'print join("\n", @INC) . "\n"' That's it. Now it should work. If You have problems, see section Help in README. Updating from version 0.9.2 or later ------------------------------------ Save the files of Your nagiosbp/etc/ directory and share/stylesheets/user.css (just to be sure). Now You do an normal installation, see INSTALL. As parameters for the configure script You should use the same parameters You did use when installing the previous version! The section about editing side.html: You do not have to do this again! Also You did already create the read-only user for the database last time. One change in configuration You have to do: The file which was named ndo_db_readonly.cfg before in 0.9.2 is now ndo.cfg and has more settings. The best solution would be to copy ndo.cfg-sample to ndo.cfg cd etc cp ndo.cfg-sample ndo.cfg Afterwards You take over the values You did define in ndo_db_readonly.cfg into ndo.cfg. The other settings in ndo.cfg You do not need to change. Now You can delete the old ndo_db_readonly.cfg and all *-sample config files. That's it. Now You should be on the new version and everything should be working. If You have problems, see section Help in README.