weewx: Quick Start Guide for Redhat Linux

This is a guide to install weewx from RPM package on systems such as Redhat, CentOS or Fedora. The installation will result in the following layout:

configuration file:	/etc/weewx/weewx.conf
skins and templates:	/etc/weewx/skins
sqlite databases:	/var/lib/weewx/
web pages and images:	/var/lib/weewx/html

Installation must be done with root privileges.

Download

Download the package weewx-X.Y.Z-R.rpm from Sourceforge.

Install

Install weewx by double-clicking the .rpm file, or via command line:

sudo rpm -i weewx-X.Y.Z-R.deb

Verify

After 5 minutes, open the station web page in a web browser. You should see the default weewx page with generic station information and data.

file:///usr/lib/weewx/html/index.html

Status

Look in the system log for messages from weewx.

sudo tail -f /var/log/messages

Configure

The default installation uses Simulator as the station_type. This should be changed to the actual weather station type.

Edit the configuration file /home/weewx/weewx.conf. Set at least the following:

location
latitude
longitude
altitude
station_type

Also set any parameters specific to the station, such as the port for stations connected via serial port.

weewx must be restarted for configuration file changes to take effect.

Start/Stop

The installer configures weewx to run when the computer starts up and starts weewx the first time. To start/stop weewx manually:

sudo /etc/init.d/weewx start
sudo /etc/init.d/weewx stop

Customize

To enable uploads such as Weather Underground or to customize reports, modify the configuration file /etc/weewx.conf. See the User Guide and Customization Guide for details.

weewx must be restarted for configuration file changes to take effect.

Uninstall

To uninstall weewx, removing configuration files but retaining data:

sudo rpm -r weewx