weeWX: Installation on SuSE-based systems

This is a guide to installing weeWX from an RPM package on systems such as SuSE or OpenSUSE.

Download

Download the SUSE RPM package from weewx.com/downloads. It will have a name similar to weewx-X.Y.Z-R.suse.noarch.rpm.

Install

Install pre-requisites:

sudo zypper install python-configobj
sudo zypper install python-cheetah
sudo zypper install python-imaging
sudo zypper install python-serial
sudo zypper install python-usb

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

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

If you see errors about untrusted signature, or MISSING KEYS, you can either install the weewx GPG keys:

sudo rpm --import http://weewx.com/keys.html

or tell rpm to ignore the signature:

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

Status

Look in the system log for messages from weeWX.

sudo tail -f /var/log/messages

Verify

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

file:///var/www/html/weewx/index.html

Configure

The default installation uses Simulator as the station_type. To use real hardware, stop weeWX, change to the actual station type and station parameters, delete the simulation data, then restart weeWX:

sudo /etc/init.d/weewx stop
sudo wee_config --reconfigure
sudo rm /var/lib/weewx/weewx.sdb
sudo /etc/init.d/weewx start

Start/Stop

To start/stop weeWX:

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/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 -e weewx

To remove data:

sudo rm -r /var/lib/weewx
sudo rm -r /var/www/html/weewx

Layout

The installation will result in the following layout:

executable: /usr/bin/weewxd
configuration file: /etc/weewx/weewx.conf
skins and templates: /etc/weewx/skins
sqlite databases: /var/lib/weewx/
generated web pages and images: /var/www/html/weewx/
documentation: /usr/share/doc/weewx-x.y.z/
examples: /usr/share/doc/weewx/examples/
utilities: /usr/bin/wee_*