e706ea2a61
Change the title of the section on application options back to "The configuration file weewx.conf" (which is what it was in V4). No one knows what "application options" are.
3.8 KiB
Installation on SUSE systems
This is a guide to installing WeeWX from an RPM package systems based on SUSE, such as openSUSE Leap.
WeeWX V5 requires Python 3.7 or greater, which is only available on SUSE-15 or later. For older systems, install Python 3.7 then install WeeWX using pip.
Configure zypper
The first time you install WeeWX, you must configure zypper so that it will
trust weewx.com, and know where to find the WeeWX releases.
-
Tell your system to trust weewx.com:
sudo rpm --import https://weewx.com/keys.html -
Tell
zypperwhere to find the WeeWX repository.curl -s https://weewx.com/suse/weewx-suse15.repo | \ sudo tee /etc/zypp/repos.d/weewx.repo
Install
Install WeeWX using zypper. When you are done, WeeWX will be running the
Simulator in the background.
sudo zypper install weewx
Verify
After 5 minutes, copy the following and paste into a web browser. You should see simulated data.
/var/www/html/weewx/index.html
If things are not working as you think they should, check the status:
sudo systemctl status weewx
and check the log file:
tail -50 /var/log/weewx/weewxd.log
See the Troubleshooting section of the User's guide for more help.
Configure
To switch from the Simulator to real hardware, reconfigure the driver.
# Stop the daemon
sudo systemctl stop weewx
# Reconfigure to use your hardware
sudo weectl station reconfigure
# Delete the old database
sudo rm /var/lib/weewx/weewx.sdb
# Start the daemon
sudo systemctl start weewx
Customize
To enable uploads, or to enable other reports, modify the configuration file
/etc/weewx/weewx.conf using any text editor such as nano:
sudo nano /etc/weewx/weewx.conf
See the User's Guide and the reference The configuration file weewx.conf for instructions.
For more advanced customization, see the Customization Guide, as well as the reference for skin options.
To install new skins, drivers, or other extensions, use the utility weectl extension.
WeeWX must be restarted for the changes to take effect.
sudo systemctl restart weewx
Upgrade
The upgrade process will only upgrade the WeeWX software; it does not modify the database, configuration file, extensions, or skins.
Upgrade to the latest version like this:
sudo zypper update weewx
Unmodified files will be upgraded. If modifications have been made to any
files, you will see a message about any differences between the modified
files and the new files. Any new changes from the upgrade will be noted as
files with a .rpmnew extension and the modified files will be left untouched.
For example, if /etc/weewx/weewx.conf was modified, zypper will present a
message something like this:
warning: /etc/weewx/weewx.conf created as /etc/weewx/weewx.conf.rpmnew
Uninstall
To uninstall WeeWX, deleting configuration files but retaining data:
sudo zypper remove weewx
When you use zypper to uninstall WeeWX, it does not touch WeeWX data, logs,
or any changes you might have made to the WeeWX configuration. It also leaves
the weewx user, since data and configuration files were owned by that user.
To remove the remaining WeeWX bits:
sudo zypper remove weewx
sudo rm -r /var/www/html/weewx
sudo rm -r /var/lib/weewx
sudo rm -r /var/log/weewx
sudo rm -r /etc/weewx
sudo userdel weewx