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
libgd - 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
- --enable-station-wxt510
Station Simulator (for demos and testing)
- --enable-station-sim

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
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