wview Quick Start Guide For FreeBSD >= 8.0
Feb. 16, 2011
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 packages should be installed. Become root or use sudo.
Libraries
-
gmake - GNU make
> pkg_add -r gmake
-
libgd2 - graphics drawing library
http://www.boutell.com/gd/
> pkg_add -r gd
-
readline - GNU library to edit command lines
> pkg_add -r readline
-
gawk - GNU awk
> pkg_add -r gawk
-
wget - ftp command line file fetcher
> pkg_add -r wget
-
libsqlite3 - SQLite3 database library
> pkg_add -r sqlite3
-
libcurl - "C" URL HTTP library - optional, required for Weather Underground -
http://curl.haxx.se/libcurl/
> pkg_add -r curl
-
radlib - rapid application development library - must be installed
with SQLite support (--enable-sqlite) -
http://www.radlib.teel.ws
Download version 2.10.1 or newer.
> wget http://downloads.sourceforge.net/radlib/radlib-2.10.1.tar.gz
> tar xzf radlib-X.Y.Z.tar.gz
> cd radlib-X.Y.Z
> ./configure --enable-sqlite
> sudo make install
Optional Web-Based Configuration
-
apache22 - HTTP Server
> pkg_add -r apache22
-
PHP5 and PHP5-Sqlite - Scripting language with Sqlite3 support
> cd /usr/ports/databases/php5-sqlite; make install clean
(enable building the Apache module)
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
-
php5 and php5-sqlite3 - optionally needed for browser-based
configuration (requires apache or similar)
-
Serial/Ethernet/USB port - an available interface port
is required to connect to the weather station
Weather Station
See wview User Manual
for a current list of supported stations and special instructions.
Procedure
- Get the latest wview tarball:wget http://downloads.sourceforge.net/wview/wview-x.y.z.tar.gz
- Extract the wview distribution: tar zxvf wview-x.y.z.tar.gz
- Configure the distribution:
cd wview-x.y.z
export CFLAGS="-I/usr/local/include"; export LDFLAGS="-L/usr/local/lib";
./configure
- Build wview: make
- Install wview: sudo make install
- See wview-User-Manual.html#StationConfig
for station setup.
- See wview-User-Manual.html#Configuration
for configuration instructions.
- See wview startup and run logs: tail -n 100 -f /var/log/messages