This is for upgrading to Unnoc 1.0.10.1 2007-07-11 http://unnoc.org This file is for upgrading from 1.0.7 and higher NOTE: If you're upgrading from anything previous to 1.0.7 (that includes 1.0.0 through 1.0.6.2), then see UPGRADE.pre-1.0.7 Upgrading from 1.0.7 is fairly trivial, there are no config file changes (except a few additions, nothing has changed though), if you would like to chance Unnoc from running as root, you need to install one more perl module. After the upgrade is complete, you need to run one script to add CPU usage to each of the processes. See the README.root file for more information. Total upgrade time is anywhere from 5-10 minutes from start to finish. See the README.root file for changing from root to a non-priviledged user. Although not required, this is *highly* recommended. It takes about 4 minutes to do. ----------------------- - Upgrade Instructions ----------------------- See the README.root file for info on running as non privileged user. See the README.daemon file for running in daemon mode If you wish to install the daemon mode, copy the init.d/ script for your OS/distribution. If it does not exist, please consider contributing one. 1. Untar the tar.gz file (you've already done this) # tar xzf unnoc-1.0.10.1.tar.gz # cd unnoc-1.0.10.1 2. Check perl modules Check to make sure that you have all of the required perl modules, it's possible that new modules have been added, ore are required by the newest version. # ./perl-module-checker.pl Install any missing perl modules (note, some of the plugin modules might not apply to your installation, if you do not plan on using a missing module, then move to the next step). Note, in most cases, it is safe to ignore the warning if your system is missing Math::BigInt::FastCalc; this is experimental and used for SNMP 2c 3. Stop unnoc Either comment out the line in /etc/crontab, or stop the daemon. # /etc/init.d/unnocd stop 4. Upgrade your installation NOTE: this will overwrite any development changes that you've made!!! All files in the lib/, libexec/, plugins/ and bin/ directory will be overwritten (and in some cases, removed) completely. Run the upgrade.sh file located in the unnoc-1.0.10.1/ directory, this will update all of the files. Much has changed since 1.0.7, so the structure is quite a bit differet. If you've made any development changes to any of the files in lib/ or bin/ then back them up. Otherwise, you're fine to just run the upgrade script: # ./upgrade.sh /location/of/unnoc/ The script will also "intelligently" merge your existing graph_colors.conf with the new graph_colors.conf file. The old file will be renamed graph_colors.conf.previous 5. Mysql upgrade If you are upgrading from 1.0.9, simply upgrade the database (not necessary for upgrading minor versions, from 1.0.10): # mysql unnoc -p < upgrade/upgrade.1.0.9-1.0.10.sql If you are upgrading from any version other than 1.0.9, then you'll need to read in db changed from other versions first, then read in the 1.0.9-1.0.10 file # mysql unnoc -p < upgrade/upgrade.1.0.7-1.0.8.sql # mysql unnoc -p < upgrade/upgrade.1.0.8-1.0.9.sql # mysql unnoc -p < upgrade/upgrade.1.0.9-1.0.10.sql This will bring your SQL tables up to date 6. Proc update RRD files (ONLY FOR 1.0.7 and previous) If you're upgrading from ANY version including 1.0.7 and before, you must update the process RRD files. The reason is the rrd file structure changed in 1.0.8 (cpu/mem can now be monitored and graphed on a per process basis). The upgrade process is very easy, simply run the provided script in the upgrade directory and you are done. # upgrade/proc-rrd-fix.pl /var/www/unnoc > /tmp/output 2>&1 The script expects to find the 'find' command in /usr/bin/find and expects to find 'basename' in /usr/bin/basename also. Update these path names if they are not found here. The script can take anywhere from 30 seconds to 2 minutes, depending on how many RRD files you have and your processor speed. On a P4 3.2Ghz machine, it can get through 500 RRD files in about 1m15s minutes. The same operation took about 2m30s on a P3 1Ghz. So your times may vary. All of the output will be located in /tmp/output. 8. Start unnoc If you are using crontab method, uncomment unnoc. If you are using daemon mode, start the daemon back up. # /etc/init.d/unnocd start NOTE: if you click on your new index file or on a particular host and no graphs show up, wait for the cronjob to run. Most graphs and data relies on information stored in the database, so either run the scripts separately, run the unnoc-cron.pl, or just be patient for a couple of minutes and let everything get read in. If after 5 minutes you don't see any results, re-read the UPGRADE instructions, go over your unnoc.conf file make sure it looks good, and take a look at the doc/README.* files. That's pretty much it, take a look at the doc/README.* files for more information. vim:tw=72:wm=1