Files
weewx/docs/redhat.htm
2018-12-06 13:59:13 -08:00

139 lines
4.6 KiB
HTML

<!DOCTYPE html>
<html lang="en">
<head>
<title>weewx: Installation on Redhat systems</title>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
<link rel="stylesheet" href="css/weewx_docs.css"/>
<link rel="icon" href="images/favicon.png" type="image/png"/>
</head>
<body>
<h1 class="title">WeeWX: Installation on Redhat-based systems
<span class='os-icons'>
<img class='logo' src='images/logo-redhat.png' alt=""/>
<img class='logo' src='images/logo-centos.png' alt=""/>
<img class='logo' src='images/logo-fedora.png' alt=""/>
</span>
</h1>
<p>
This is a guide to installing WeeWX from an RPM package on systems such as Redhat, CentOS or Fedora.
</p>
<h2>Download</h2>
<p>
Download the Redhat RPM package from <a href="http://weewx.com/downloads"><span class="code">weewx.com/downloads</span></a>. It will have a name similar to <span class='code'>weewx-X.Y.Z-R.rhel.noarch.rpm</span>.
</p>
<h2>Install</h2>
<p>
Install pre-requisites:
</p>
<pre class='tty cmd'>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</pre>
<p>
Install by double-clicking the .rpm file, or via command line:
</p>
<pre class='tty cmd'>sudo rpm -i weewx-X.Y.Z-R.rpm</pre>
<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>
<pre class='tty cmd'>sudo rpm --import http://weewx.com/keys.html</pre>
<p>or tell rpm to ignore the signature:</p>
<pre class='tty cmd'>sudo rpm -i --nosignature weewx-X.Y.Z-R.rpm</pre>
<h2>Status</h2>
<p>
Look in the system log for messages from WeeWX.
</p>
<pre class='tty cmd'>sudo tail -f /var/log/messages</pre>
<h2>Verify</h2>
<p>
After 5 minutes, open the station web page in a web browser. You should see generic station information and data.
If your hardware supports hardware archiving, then how long you wait will depend on the <a href="usersguide.htm#archive_interval">archive interval</a> set in your hardware.
</p>
<pre class='tty'><a href="file:///var/www/html/weewx/index.html">file:///var/www/html/weewx/index.html</a></pre>
<h2>Configure</h2>
<p>
The default installation uses Simulator as the <span class='code'>station_type</span>. To use real hardware, stop WeeWX, change to the actual station type and station parameters, delete the simulation data, then restart WeeWX:</p>
<pre class='tty cmd'>sudo /etc/init.d/weewx stop
sudo wee_config --reconfigure
sudo rm /var/lib/weewx/weewx.sdb
sudo /etc/init.d/weewx start</pre>
<h2>Start/Stop</h2>
<p>To start/stop WeeWX:</p>
<pre class='tty cmd'>sudo /etc/init.d/weewx start
sudo /etc/init.d/weewx stop</pre>
<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>
WeeWX must be restarted for configuration file changes to take effect.
</p>
<h2>Uninstall</h2>
<p>To uninstall WeeWX, removing configuration files but retaining data:</p>
<pre class='tty cmd'>sudo rpm -e weewx</pre>
<p>To remove data:</p>
<pre class='tty cmd'>sudo rm -r /var/lib/weewx
sudo rm -r /var/www/html/weewx</pre>
<h2>Layout</h2>
<p>The installation will result in the following layout:</p>
<table class='locations' style='width: auto;'>
<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>
<tr>
<td align='right'>examples:</td>
<td class='tty'>/usr/share/doc/weewx/examples/</td>
</tr>
<tr>
<td align='right'>utilities:</td>
<td class='tty'>/usr/bin/wee_*</td>
</tr>
</table>
<p class='copyright'>
&copy; <a href='copyright.htm'>Copyright</a> Tom Keffer
</p>
</body>
</html>