mirror of
https://github.com/weewx/weewx.git
synced 2026-05-24 09:46:19 -04:00
122 lines
2.8 KiB
Markdown
122 lines
2.8 KiB
Markdown
# 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, either use WeeWX V4, or install Python 3.7 then
|
|
[install WeeWX V5 using pip](../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.
|
|
|
|
1. Tell your system to trust weewx.com:
|
|
|
|
```{.shell .copy}
|
|
sudo rpm --import https://weewx.com/keys.html
|
|
```
|
|
|
|
2. Tell `zypper` where to find the WeeWX repository.
|
|
|
|
```{.shell .copy}
|
|
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 as a daemon.
|
|
|
|
```
|
|
sudo zypper install weewx
|
|
```
|
|
|
|
|
|
## Verify
|
|
|
|
After 5 minutes, copy the following and paste into a web browser:
|
|
|
|
/var/www/html/weewx/index.html
|
|
|
|
You should see simulated data.
|
|
|
|
Check the system log `/var/log/messages` for problems.
|
|
|
|
|
|
## Configure
|
|
|
|
To switch from the `Simulator` to real hardware, reconfigure the driver.
|
|
|
|
```{.shell .copy}
|
|
# 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 customize reports, modify the configuration file.
|
|
See the [*Customization Guide*](../../custom/introduction) for instructions,
|
|
and the [application](../../reference/weewx-options/introduction) and
|
|
[skin](../../reference/skin-options/introduction) references for all of
|
|
the options.
|
|
|
|
Use any text editor, such as `nano`:
|
|
```shell
|
|
sudo nano /etc/weewx/weewx.conf
|
|
```
|
|
|
|
WeeWX must be restarted for the changes to take effect.
|
|
```{.shell .copy}
|
|
sudo systemctl restart weewx
|
|
```
|
|
|
|
|
|
## Upgrade
|
|
|
|
Upgrade to the latest version like this:
|
|
```{.shell .copy}
|
|
sudo zypper update weewx
|
|
```
|
|
|
|
The upgrade process will not modify the WeeWX databases.
|
|
|
|
Unmodified files will be upgraded. If modifications have been made to the
|
|
configuration, `rpm` will display a message about any differences between the
|
|
changes and the new configuration. 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, `rpm` 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:
|
|
|
|
```{.shell .copy}
|
|
sudo zypper remove weewx
|
|
```
|
|
To delete data:
|
|
|
|
```{.shell .copy}
|
|
sudo rm -r /var/lib/weewx
|
|
sudo rm -r /var/www/html/weewx
|
|
```
|