Files
weewx/docs/redhat.htm

142 lines
4.3 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" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:v="urn:schemas-microsoft-com:vml">
<!-- $Revision$ -->
<!-- $Author$ -->
<!-- $Date$ -->
<head>
<meta content="en-us" http-equiv="Content-Language" />
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
<title>weewx quick-start for redhat</title>
<!-- CSS -->
<link href="weewx_docs.css" rel="stylesheet" />
<!-- JavaScript -->
<style type="text/css">
tr {
vertical-align: middle;
}
.os-icons {
float: right;
margin-left: 100px;
}
img {
width: 60px;
}
.locations {
margin-left: 20px;
}
</style>
</head>
<body>
<h1 class="title">weewx: Quick Start Guide for Redhat Linux</h1>
<p class='os-icons'>
<img src='logo-redhat.png'/>
<img src='logo-centos.png'/>
<img src='logo-fedora.png'/>
</p>
<p>
This is a guide to install weewx from RPM package on systems such as Redhat, CentOS or Fedora. The installation will result in the following layout:
</p>
<table class='locations'>
<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'>web pages and images: </td>
<td class='tty'>/var/lib/weewx/html</td>
</tr>
</table>
<p>
Installation must be done with root privileges.
</p>
<p style='clear: both'></p>
<h3>Download</h3>
<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>
<h3>Install</h3>
<p>
Install weewx by double-clicking the .rpm file, or via command line:
</p>
<p class='tty'>
sudo rpm -i weewx-X.Y.Z-R.deb
</p>
<h3>Verify</h3>
<p>
After 5 minutes, open the station web page in a web browser. You should see the default weewx page with generic station information and data.
</p>
<p class='tty'>
file:///usr/lib/weewx/html/index.html
</p>
<h3>Status</h3>
<p>
Look in the system log for messages from weewx.
</p>
<p class='tty'>
sudo tail -f /var/log/messages
</p>
<h3>Configure</h3>
<p>
The default installation uses Simulator as the <span class='code'>station_type</span>. This should be changed to the actual weather station type.
</p>
<p>
Edit the configuration file <span class='code'>/home/weewx/weewx.conf</span>. Set at least the following:
<ul>
<li>location</li>
<li>latitude</li>
<li>longitude</li>
<li>altitude</li>
<li>station_type</li>
</ul>
Also set any parameters specific to the station, such as the <span class='code'>port</span> for stations connected via serial port.
</p>
<p>
weewx must be restarted for configuration file changes to take effect.
</p>
<h3>Start/Stop</h3>
<p>
The installer configures weewx to run when the computer starts up and starts weewx the first time. To start/stop weewx manually:
</p>
<p class='tty'>
sudo /etc/init.d/weewx start<br/>
sudo /etc/init.d/weewx stop<br/>
</p>
<h3>Customize</h3>
<p>
To enable uploads such as Weather Underground or to customize reports, modify the configuration file <span class='code'>/etc/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>
<h3>Uninstall</h3>
<p>
To uninstall weewx, removing configuration files but retaining data:
</p>
<p class='tty'>
sudo rpm -r weewx
</p>
<p class='copyright'>
&copy; <a href='copyright.htm'>Copyright</a> Tom Keffer
</p>
</body>
</html>