======= README ======= RRDWeather Released under the GNU General Public License http://www.wains.be/projects/rrdweather/ What is RRDWeather ? RRDWeather is a set of scripts working with RRDtool and weather.com. It collects weather info from the web on a regular basis and puts it in RRDtool graphs. Installation See INSTALL Contributors - Lionel Porcheron - Gregory Bittan - Gregory Guthrie - Heikki Hokkanen - "fugitif67" - Angela Kahealani Changelog Version 0.43 kahealani - 2011-07-19 04:29:13+00:00 This particular distribution has been hacked by Angela Kahealani This was created by taking the package: rrdweather_0.42-0ubuntu1_all.deb and overlaying it with the version 0.43 code and manually hacking in the changes suggested in the documentation on the source website. I also changed weather.cgi to hyperlink to weather.com It is essential to get your user ID and user KEY from weather.com and place those in the config file to get any valid data to chart. You can either rsync this all to / or use the installer from the cannonical or official releases. Version 0.43 - July 2009 : - db_update.sh * fixed broken link to data feed. Thanks to fugitif67 * fixed null values when the connection is down. Thanks to fugitif67 Version 0.42 - October 2007 : - weather.cgi * header titles now link to their section. Patch by Heikki Hokkanen * click on graphs to go to the next section (click on daily graphs to reach weekly graphs and so on) * no longer necessary to have several weather.cgi files to display different cities, zip passed as argument. Idea by Gregory Guthrie * city name fetched from the XML source * made XHTML 1.1 and CSS 2.1 compliant (again) Version 0.41 - October 2007 : - applied the patches made available by Lionel Porcheron in Ubuntu Universe repository * configuration file in /etc instead of editing script files * remove interactions and read informations from configuration file * change database location in cgi script * db_builder.sh and db_update.sh scripts now go in /usr/share/rrdweather and no more in /usr/lib/rrdweather * call rrdweather_cron.sh which creates rrd database if necessary (no need to run db_builder.sh first) - lower and upper limit variables for pressure graphs in cgi script - speed variable for wind graphs in cgi script - reduced size of graphs and changed general layout of graph page - removed the average label for pressure, which was kind of pointless, and due to the smaller graphs, the labels for pressure were too large, so I needed to get rid of one - new install script Version 0.40 - December 2006 : - Gregory Bittan reported an issue when the web connection is down. The script would still feed the RRD databases with a value of 0, messing up the average figures. - The update script can now handle the monitoring of several cities - Lionel Porcheron made RRDweather available to the Ubuntu Community trough the Universe repository - To achieve the goal of monitoring several cities from a single script, RRDWeather had to use a new directory structure in order to store database files - Better indenting - Improved bash code - Improved debugging mode - ... Version 0.36 - January 2006: - Lionel Porcheron made weather.cgi fully w3c XHTML 1.1 et CSS 2.1 compliant ======= INSTALL ======= RRDWeather Released under the GNU General Public License http://www.wains.be/projects/rrdweather/ What do I need ? - a linux or unix machine running 24/7 - awk, sed, curl and wget - apache webserver allowing ExecCGI (or any other webserver) - rrdtool >= 1.2.0 - the following perl libraries : * RRDs * POSIX * perl::XML::Simple * perl::XML::Parser Installation steps - if you want to monitor cities outside of the USA, find the international city code by searching on weather.com By searching for "Mons, Belgium" I'm pointed to this URL : http://www.weather.com/weather/local/BEXX0014?from=search_city The international city code is BEXX0014. - "untar-gz" the files to a temporary directory - edit files/rrdweather.conf to fit the locations you want to monitor, your needs and configuration edit files/rrdweather_cron and change the user that must run the script (by default www-data under Debian, apache under RedHat) - execute install.sh as root, this will copy the config file, cron file and scripts to default locations As soon as the files have been copied, the cron will start doing its job and the RRD databases will start being populated - copy "weather.cgi" to a cgi-bin folder of your webserver. - after a few minutes, you should see graphs at http://yourdomain.tld/cgi-bin/weather.cgi?zip=BEXX0014 Troubleshooting Q : I get a blank page when trying to reach weather.cgi in my web browser OR I get something like this in the error logs of Apache Can't locate RRDs.pm in @INC (@INC contains: /etc/perl /usr/local/lib/perl/5.8.8 /usr/local/share/perl/5.8.8 /usr/lib/perl5 /usr/share/perl5 /usr/lib/perl/5.8 /usr/share/perl/5.8 /usr/local/lib/site_perl .) at /usr/lib/cgi-bin/weather.cgi line 7. A : You will probably need to install the missing perl library Under Debian systems : # apt-get install librrds-perl Under RedHat systems : You will need to install the package "perl-rrdtool" provided by several 3rd party repositories. Search for "perl-rrdtool RPM" in Google. Or build from sources. Q : I can reach weather.cgi but no graph is displayed ! A : check the permissions on : - the database directory : directory reachable by your web server ? - the database files must be owned by the web server user/group and writable by the web server. - the temporary directory and its files. These should be owned by the web server user/group. ======= TODO ======= Todo : - tabs for daily/weekly/... graphs instead of everything on 1 page ======= COPYRIGHT ======= This package was debianized by Lionel Porcheron on Wed, 1 Mar 2006 00:35:18 +0100. It was downloaded from http://www.wains.be/projects/rrdweather/ Upstream author: Sébastien Wains Copyright (C) 2006 Sébastien Wains License: This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. On Debian GNU/Linux systems, the complete text of the GNU General Public License can be found in `/usr/share/common-licenses/GPL'. This particular distribution has been hacked by Angela Kahealani Mon Sep 20 21:25:00 HST 2010 2010-09-21 07:25:00+00:00 This was created by taking the package: rrdweather_0.42-0ubuntu1_all.deb and overlaying it with the version 0.43 code and manually hacking in the changes suggested in the documentation on the source website. ======= CHANGELOG.Debian.gz ======= rrdweather (0.42-0ubuntu1) jaunty; urgency=low * New upstream release * Drop all patches: all are now integrated upstream (Thanks Sébastien!) * Drop debian/rrdweather.conf and debian/rrdweather_cron.sh: integrated upstream * update debian/rules: no more dpatch and upstream files are now in a files directory * Bump standard to 3.8.0 (no changes needed) * Move Homepage to it's own field -- Lionel Porcheron Sun, 07 Dec 2008 22:52:44 +0100 rrdweather (0.40-0ubuntu1) feisty; urgency=low * New upstream release * debian/patches/01_set_configuration_file.dpatch: set a configuration file in /etc instead of editing script files * debian/patches/02_db_builder_remove_interactions.dpatch: remove interactions and read informations from configuration file * debian/patches/03_weather.cgi_modif.dpatch: change database location in cgi-bin script * debian/patches/04_weather_xhtml.dpatch: removed, it is now upstream * former debian/patches/01_db_builder.dpatch, debian/patches/02_db_update.dpatch, debian/patches/02_db_update.dpatch debian/patches/03_weather.dpatch are now obsolete due to upstream code change * updating configuration file template (now rrdweather can graph several cities) * db_builder.sh and db_update.sh scripts now go in /usr/share/rrdweather and no more in /usr/lib/rrdweather * debian/control: Minor cleanup * rrdweather.conf: remove city name (fetch by rrdweather now) and change ZIP parameter to ZIPS (as rrdweather monitors now several cities) * debian/cron.d: now call rrdweather_cron.sh which creates rrd database if necessary (no need to run db_builder.sh first) * debian/postinst: migrate rrdweather < 0.40 rrd database to new location * debian/dirs: removed useless usr/share/doc/rrdweather -- Lionel Porcheron Wed, 07 Feb 2007 17:59:46 +0100 rrdweather (0.36-0ubuntu1) edgy; urgency=low * Initial release * debian/patches/01_db_builder.dpatch : adjust user rights on the database * debian/patches/02_db_update.dpatch : relocate the configuration and database * debian/patches/03_weather.dpatch : relocate the configuration and database * debian/patches/04_weather_xhtml.dpatch : HTML is made XHTML 1.1 compliant -- Lionel Porcheron Wed, 1 Mar 2006 00:35:18 +0100