wview Quick Start Guide
February 5, 2006
Purpose
This guide will provide the basic procedure for a "standard" wview install.
Detailed description of the steps, advanced configuration of features and
troubleshooting tips are found in the
wview User Manual.
Prerequisites
The following package installations should be verified on your system. If a
package requires installation, you should use the package management utility
appropriate for your OS and distribution. Examples are:
FreeBSD /usr/ports
Fedora Core yum
SuSE yast (or apt4rpm)
Gentoo emerge
Debian apt
Note: Some of these libraries may be represented as "-devel" or similar in your
package management utility, i.e., "libcurl-devel". If they are, you should install
the devel version in order to get the development libraries that radlib/wview needs.
Libraries
-
libz - compression library - normally included in OS distribution
-
libpng - png image library - normally included in OS distribution
-
libgd2 - graphics drawing library - may require installation -
http://www.boutell.com/gd/
-
radlib - rapid application development library - must be installed -
http://www.radlib.teel.ws
-
libcurl - "C" URL HTTP library - optional, required for Weather Underground -
http://curl.haxx.se/libcurl/
System
-
ntp/xntp - Network Time Protocol - a configured and functional NTP
daemon should be enabled on the host system to keep system and weather
station time accurate
-
apache - in order to serve your weather site to the world,
an http server is required - other http servers will work too. If you are
going to export your site to another server or to your ISP account site,
then an http server is not required on the wview server
-
Serial/Ethernet/USB port - an available interface port
is required to connect to the weather station
Weather Station - one of the following:
-
Vantage Pro or Vantage Pro2 Weather Station with Console
-
--enable-station-vpro
-
WeatherLink for Vantage Pro or Pro2, Windows, Serial or USB -
the windows software is not required, but this is the only way to obtain the
serial or USB data logger
-
Vaisala WXT-510
-
Station Simulator (for demos and testing)
Procedure
- Extract the wview distribution: tar zxvf wview-x.y.z.tar.gz
- Configure the distribution: cd wview-x.y.z; ./configure --enable-station-[type]
- Build wview: make
- Install wview: sudo make install-env (requires root password)
- If new Vantage Pro, use the on-screen console configuration wizard
- If new Vantage Pro, configure the console: /usr/local/bin/vpinstall
- Configure wview: /usr/local/bin/wviewconfig
- Configure wview HTML Templates: /usr/local/bin/wviewhtmlconfig
- If new install, copy the run script: cp ./examples/[your_distro]/wview /etc/[your_distro_rc.d_dir]
- If new install, make the run script executable: chmod +x /etc/[your_distro_rc.d_dir]/wview
- Run wview: /etc/[your_distro_rc.d_dir]/wview start
- See wview startup and run logs: tail -n 100 -f /var/log/messages