wview Upgrade Directions ------------------------ 1) Extract new wview source tree to standard location (the name includes the version number for uniqueness - your old source tree will not be copied over or disturbed) 2) Read ChangeLog for any new configuration or environment requirements 3) Stop any running wview daemons (/etc/init.d/wview stop) 4) Copy any user-specific source (such as .../htmlgenerator/images-user.c) into the new source tree 5) cd to the wview-X.Y.Z root source directory 6) ./configure (see the User Manual for configuration options) 7) make && make install (install requires root priveleges) 8) Find the version you are upgrading from in the list below and proceed from there through all versions to the end 9) Execute wviewconfig - should always be run after upgrades 10) Start wview daemons (/etc/init.d/wview start) 11) Check /var/log/messages (tail -n 100 -f /var/log/messages) for proper operation (htmls generated, wview daemon downloading archive pages, history timer adding samples every archive interval minutes, etc.) 12) If all is good, store the distro tarball in a safe place, delete the old source tree, you're done! Version Specific Directions --------------------------- 0.8.1 or Older: (backup your /usr/local/wview directory first): --------------- (Mandatory) a) mv /usr/local/wview/html /etc/wview/html b) mv /usr/local/wview/*.conf /etc/wview c) mv /usr/local/wview/archive /var/wview/archive d) mv /usr/local/wview/img /var/wview/img e) mv /usr/local/wview/noaa.dat /var/wview/noaa/noaa.dat f) Edit your start script (/etc/init.d/wview or /etc/rc.d/wview) and change the path to the binaries from /usr/local/wview to /usr/local/bin, change run path from /usr/local/wview to /var/wview then change the executable name for ftpd to wviewftpd (see the new wview start scripts in examples/* for examples of these changes). 0.9.1 or Older: --------------- (Optional) - If you want to utilize the new combo-charts for temp/dewpoint and heat index/wind chill, do the following: a) Using examples/conf/images.conf as a guide, edit your site-specific /etc/wview/images.conf to add Temp/Dew Point and Heat Index/Wind Chill multi-plot charts. Don't forget to comment out the old single chart entries for TempDay, DewDay, HeatDay, ChillDay, TempMonth, DewMonth, HeatMonth and ChillMonth (see examples/conf/images.conf). b) Using the files Current_Vantage_Pro.htx, Daily_Vantage_Pro.htx and Monthly_Vantage_Pro.htx in the bin/html directory as a guide, modify your site-specific versions of these files in /etc/wview/html. Look for references to the filenames you commented out in images.conf - a bit of rearranging is necessary but is illustrated in the distro examples in bin/html. According to your site, you may be able to just copy and paste the image blocks from the examples. 2.0.0 or Older: --------------- (Optional) - From version 3.0.0 forward, the HTML template files with references to "Vantage Pro" have changed as have the references to them in the home page templates. New navigation buttons were also added at the top of each template. If you want to stay up to date on template files, you should upgrade your template files based on the distro examples then upgrade your html-templates.conf to the newest format using the new file names and update your home page template(s) to refer to these new file names. Current_Vantage_Pro.htx => Current.htx Current_Vantage_Pro_Plus.htx => Current_Plus.htx Daily_Vantage_Pro.htx => Daily.htx Daily_Vantage_Pro_Plus.htx => Daily_Plus.htx Monthly_Vantage_Pro.htx => Monthly.htx Monthly_Vantage_Pro_Plus.htx => Monthly_Plus.htx Yearly_Vantage_Pro.htx => Yearly.htx Yearly_Vantage_Pro_Plus.htx => Yearly_Plus.htx (Optional) - Udgrade your almanac.htx file from the distro examples so you will have the new solar rise/set times, the new Storm Start Date entry, etc. If you have extended sensors, add the new almanac_Plus.htx to your template directory. 3.1.4 or Older: --------------- (Optional) - Udgrade all of your *.htx template files from the distro examples so you will have the new Weekly page and references to it on the other pages. Upgrade your images(-metric(-mm)).conf file to generate the new weekly chart images. Upgrade your html-templates.conf to include the new Weekly.htx page. As always, refer to the examples in the distro for changes/usage. 3.2.0 or Older: --------------- (Optional) - Udgrade your index.htx template file (or index-day.htx and index-night.htx if doing day/night themes) from the distro examples so you may take advantage of the new radar and forecast HTML tags. Be sure to always run wviewconfig after an upgrade. As always, refer to the examples in the distro for changes/usage. 3.2.1 or Older: --------------- If you have user-defined images in ../htmlgenerator/images-user.c which include a date and time stamp, (i.e. all non-dial images), add an extra parameter, img->mgrWork->dateFormat as the final parameter to the function call which produces the image. See the version of images-user.c from the distro for an example. 3.3.0 or Older: --------------- (Mandatory) - (re)copy the wview start script for your OS distribution from the examples directory of the distribution so the process monitor will be started. (Mandatory) - copy the new wvpmond config file: > sudo cp examples/conf/processes.conf /etc/wview It shouldn't require editing. (Mandatory) - if you were generating data to wunderground, the new configure option to enable it is "--enable-http" - the renamed http daemon can submit data to wunderground and/or weatherforyou. The config file for the http daemon is http.conf and replaces wvwunderd.conf. (wviewconfig will create the new http.conf config file for you) (Optional) - copy the new html templates from examples/html/classic to your /etc/wview/html directory to take advantage of the new template macro inclusion capability. Customize the include templates and html templates for your site. (Optional) - Submit your site template to the wview google group so it can be included in future wview releases as "examples/html/". 3.4.1 or Older: --------------- (Mandatory) - If you use wviewftpd to transfer files to a remote web server you will need to copy the new example wviewftp.conf-no-ftp to /etc/wview/wviewftp.conf. If you need to modify the FTP binary used or the arguments passed to it you can now do so in the new config file. (Mandatory) - You should now start using the new html template configuration script "wviewhtmlconfig" to setup your HTML templates. Run it immediately after "make install-env"/"wviewconfig" then customize as you wish. 3.5.0 or Older: --------------- (Mandatory) - The location of generated NOAA and ARC files has been changed to "img/NOAA" and "img/Archive" respectively. The new "install-env" make target creates these directories but if you have existing NOAA and ARC files in the img directory (both on your wview server and your web site), you will want to create these new subdirectories and move the files. The new index*.htx files have been updated to support these locations (but your old ones will not). 3.6.0 or Older: --------------- (Mandatory) - The location of the wview configuration and data trees has moved as of version 3.7.0. To allow installation and execution from a chroot jail and/or allow package management systems to specify an install/run root prefix, the configure script "--prefix" argument now controls not only where binaries are installed but also where "/etc/wview" and "/var/wview" are located. The default for configure if no "--prefix" argument is given is "--prefix=/usr/local". So the new default locations are: "/usr/local/etc/wview" and "/usr/local/var/wview". Executing "sudo make install-env" for 3.7.0 will create these directories for you, then you will need to move anything pertinent from the old "/etc/wview" and "/var/wview" locations to the new "prefix" locations. Obvious choices are: "/var/wview/archive" "/var/wview/alarms" - if applicable "/etc/wview/alarms" - if applicable "/etc/wview/*.conf " - not advisable to move directly "/etc/wview/html customizations" Alternatively, if you just refuse to be compliant ;) and *must* keep your config and data trees on the root prefix, you can specify "--prefix=/ --exec-prefix=/usr/local". But this means you must remember this every time you upgrade wview and I am not going to keep reminding you... The really good news in all this is that the example start scripts are now configured for paths based on the "--prefix" argument too (during the build step), so there should be much less customization of those required in the future. 3.7.3 or Older: --------------- (Optional) - Support for a new config file "calibrate.conf" has been added. If you want to calibrate basic sensor readings, copy the example version .../wview-x.y.z/examples/conf/calibrate.conf to $prefix/etc/wview and edit for your calibration requirements. See the example config file or the User Manual for calibration details.