mirror of
https://github.com/weewx/weewx.git
synced 2026-04-18 08:36:54 -04:00
170 lines
4.6 KiB
Markdown
170 lines
4.6 KiB
Markdown
# Installation on Redhat systems
|
|
|
|
This is a guide to installing WeeWX from an RPM package on systems based on
|
|
Redhat, including Fedora, CentOS, or Rocky.
|
|
|
|
WeeWX V5 requires Python 3.6 or greater, which is only available as a Redhat
|
|
package, with required modules, on Redhat 8 or later. For older systems,
|
|
install Python 3 then [install WeeWX using pip](pip.md).
|
|
|
|
|
|
## Configure `yum`
|
|
|
|
The first time you install WeeWX, you must configure `yum` so that it will
|
|
trust weewx.com, and know where to find the WeeWX releases.
|
|
|
|
1. Configure `yum` to use `epel-release`, since some of the Python modules
|
|
required by WeeWX are in that respository.
|
|
```{.shell .copy}
|
|
sudo dnf config-manager --set-enabled crb
|
|
sudo dnf -y install epel-release
|
|
```
|
|
|
|
2. Tell your system to trust weewx.com:
|
|
|
|
```{.shell .copy}
|
|
sudo rpm --import https://weewx.com/keys.html
|
|
```
|
|
|
|
3. Tell `yum` where to find the WeeWX repository.
|
|
|
|
```{.shell .copy}
|
|
curl -s https://weewx.com/yum/weewx.repo | \
|
|
sudo tee /etc/yum.repos.d/weewx.repo
|
|
```
|
|
|
|
!!! Note
|
|
If you are using Fedora, specify the repository that corresponds to your
|
|
Fedora release.
|
|
|
|
For example, Fedora 28 should use Redhat 8
|
|
```{.shell .copy}
|
|
curl -s https://weewx.com/yum/weewx-el8.repo | \
|
|
sudo tee /etc/yum.repos.d/weewx.repo
|
|
```
|
|
Fedora 34 should use Redhat 9
|
|
```{.shell .copy}
|
|
curl -s https://weewx.com/yum/weewx-el9.repo | \
|
|
sudo tee /etc/yum.repos.d/weewx.repo
|
|
```
|
|
|
|
## Install
|
|
|
|
Install WeeWX using `yum` or `dnf`. When you are done, WeeWX will be running
|
|
the `Simulator` in the background.
|
|
|
|
```{.shell .copy}
|
|
sudo yum install weewx
|
|
```
|
|
|
|
|
|
## Verify
|
|
|
|
After 5 minutes, copy the following and paste into a web browser. You should
|
|
see simulated data.
|
|
|
|
```{.copy}
|
|
/var/www/html/weewx/index.html
|
|
```
|
|
|
|
If things are not working as you think they should, check the status:
|
|
```{.shell .copy}
|
|
sudo systemctl status weewx
|
|
```
|
|
and check the [system log](../usersguide/monitoring.md#log-messages):
|
|
```{.shell .copy}
|
|
sudo journalctl -u weewx
|
|
```
|
|
See the [*Troubleshooting*](../usersguide/troubleshooting/what-to-do.md)
|
|
section of the [*User's guide*](../usersguide/introduction.md) for more help.
|
|
|
|
|
|
## 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
|
|
weectl station reconfigure
|
|
# Delete the old database
|
|
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`:
|
|
|
|
```{.shell .copy}
|
|
nano /etc/weewx/weewx.conf
|
|
```
|
|
|
|
The reference
|
|
[*Application options*](../reference/weewx-options/introduction.md)
|
|
contains an extensive list of the configuration options, with explanations for
|
|
what they do. For more advanced customization, see the [*Customization
|
|
Guide*](../custom/introduction.md), as well as the reference [*Skin
|
|
options*](../reference/skin-options/introduction.md).
|
|
|
|
To install new skins, drivers, or other extensions, use the [extension
|
|
utility](../utilities/weectl-extension.md).
|
|
|
|
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 yum update weewx
|
|
```
|
|
|
|
The upgrade process will only upgrade the WeeWX software; it does not modify
|
|
the configuration file, database, or any extensions you may have installed.
|
|
|
|
If modifications have been made to the configuration file or the skins that
|
|
come with WeeWX, 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, you will see 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 yum remove weewx
|
|
```
|
|
|
|
When you use `yum` 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 every trace of WeeWX:
|
|
|
|
```{.shell .copy}
|
|
sudo yum remove weewx
|
|
sudo rm -r /var/www/html/weewx
|
|
sudo rm -r /var/lib/weewx
|
|
sudo rm -r /etc/weewx
|
|
sudo rm /etc/default/weewx
|
|
sudo gpasswd -d $USER weewx
|
|
sudo userdel weewx
|
|
sudo groupdel weewx
|
|
```
|