mirror of
https://github.com/weewx/weewx.git
synced 2026-04-19 00:56:54 -04:00
138 lines
4.7 KiB
HTML
138 lines
4.7 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<!-- $Id$ -->
|
|
<head>
|
|
<meta content="en-us" http-equiv="Content-Language" />
|
|
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
|
|
<title>Installation on Redhat systems</title>
|
|
<link href="css/weewx_docs.css" rel="stylesheet" />
|
|
<style type="text/css">
|
|
.os-icons {
|
|
float: right;
|
|
margin-left: 100px;
|
|
}
|
|
.logo {
|
|
width: 60px;
|
|
}
|
|
.tty {
|
|
white-space: pre-line;
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<h1 class="title">weewx: Installation on Redhat-based systems</h1>
|
|
<p class='os-icons'>
|
|
<img class='logo' src='images/logo-redhat.png'/>
|
|
<img class='logo' src='images/logo-centos.png'/>
|
|
<img class='logo' src='images/logo-fedora.png'/>
|
|
</p>
|
|
<p>
|
|
This is a guide to installing <span class='code'>weewx</span>
|
|
from an RPM package on systems such as Redhat, CentOS or Fedora.</p>
|
|
|
|
<h2>Download</h2>
|
|
<p>
|
|
Download the package <span class='code'>weewx-X.Y.Z-R.rpm</span> from <a href="http://sourceforge.net/projects/weewx/files">Sourceforge</a>.
|
|
</p>
|
|
|
|
<h2>Install</h2>
|
|
<p>
|
|
Install pre-requisites:
|
|
</p>
|
|
<p class='tty'>sudo yum install python-configobj
|
|
sudo yum install python-cheetah
|
|
sudo yum install python-imaging
|
|
sudo yum install python-setuptools
|
|
sudo easy_install pyserial
|
|
sudo easy_install pyusb
|
|
</p>
|
|
<p>
|
|
Install by double-clicking the .rpm file, or via command line:
|
|
</p>
|
|
<p class='tty'>sudo rpm -i weewx-X.Y.Z-R.rpm</p>
|
|
<p>
|
|
If you see errors about untrusted signature, or MISSING KEYS, you can
|
|
either install the <a href="http://weewx.com/keys.html">weewx GPG keys</a>:
|
|
</p>
|
|
<p class='tty'>sudo rpm --import http://weewx.com/keys.html</p>
|
|
<p>or tell rpm to ignore the signature:</p>
|
|
<p class='tty'>sudo rpm -i --nosignature weewx-X.Y.Z-R.rpm</p>
|
|
|
|
<h2>Status</h2>
|
|
<p>
|
|
Look in the system log for messages from <span class='code'>weewx</span>.
|
|
</p>
|
|
<p class='tty'>sudo tail -f /var/log/messages</p>
|
|
|
|
<h2>Verify</h2>
|
|
<p>
|
|
After 5 minutes, open the station web page in a web browser. You should see generic station information and data.
|
|
</p>
|
|
<p class='tty'><a href="file:///var/www/html/weewx/index.html">file:///var/www/html/weewx/index.html</a></p>
|
|
|
|
<h2>Configure</h2>
|
|
<p>
|
|
The default installation uses Simulator as the <span class='code'>station_type</span>. To use real hardware, stop <span class='code'>weewx</span>, change to the actual station type and station parameters, delete the simulation data, then restart <span class='code'>weewx</span>:</p>
|
|
<p class='tty'>sudo /etc/init.d/weewx stop
|
|
sudo wee_setup configure
|
|
sudo rm /var/lib/weewx/weewx.sdb
|
|
sudo /etc/init.d/weewx start</p>
|
|
|
|
<h2>Start/Stop</h2>
|
|
<p>To start/stop <span class='code'>weewx</span>:</p>
|
|
<p class='tty'>sudo /etc/init.d/weewx start
|
|
sudo /etc/init.d/weewx stop
|
|
</p>
|
|
|
|
<h2>Customize</h2>
|
|
<p>
|
|
To enable uploads such as Weather Underground or to customize reports, modify the configuration file <span class='code'>/etc/weewx/weewx.conf</span>. See the <a href="usersguide.htm">User Guide</a> and <a href="customizing.htm">Customization Guide</a> for details.
|
|
</p>
|
|
<p>
|
|
<span class='code'>weewx</span> must be restarted for configuration file
|
|
changes to take effect.
|
|
</p>
|
|
|
|
<h2>Uninstall</h2>
|
|
<p>To uninstall <span class='code'>weewx</span>, removing configuration files but retaining data:</p>
|
|
<p class='tty'>sudo rpm -e weewx</p>
|
|
<p>To remove data:</p>
|
|
<p class='tty'>sudo rm -r /var/lib/weewx
|
|
sudo rm -r /var/www/html/weewx</p>
|
|
|
|
<h2>Layout</h2>
|
|
<p>The installation will result in the following layout:</p>
|
|
<table class='locations' style="width:40%; font-size: 90%">
|
|
<tr>
|
|
<td align='right'>executable: </td>
|
|
<td class='tty'>/usr/bin/weewxd</td>
|
|
</tr>
|
|
<tr>
|
|
<td align='right'>configuration file: </td>
|
|
<td class='tty'>/etc/weewx/weewx.conf</td>
|
|
</tr>
|
|
<tr>
|
|
<td align='right'>skins and templates: </td>
|
|
<td class='tty'>/etc/weewx/skins</td>
|
|
</tr>
|
|
<tr>
|
|
<td align='right'>sqlite databases: </td>
|
|
<td class='tty'>/var/lib/weewx/</td>
|
|
</tr>
|
|
<tr>
|
|
<td align='right'>generated web pages and images: </td>
|
|
<td class='tty'>/var/www/html/weewx/</td>
|
|
</tr>
|
|
<tr>
|
|
<td align='right'>documentation: </td>
|
|
<td class='tty'>/usr/share/doc/weewx-x.y.z/</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p class='copyright'>
|
|
© <a href='copyright.htm'>Copyright</a> Tom Keffer
|
|
</p>
|
|
|
|
</body>
|
|
</html>
|