mirror of
https://github.com/weewx/weewx.git
synced 2026-04-18 00:26:57 -04:00
296 lines
9.7 KiB
HTML
296 lines
9.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" 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 linux</title>
|
|
<link href="weewx_docs.css" rel="stylesheet" />
|
|
<style type="text/css">
|
|
.cmdtbl {
|
|
border: none;
|
|
width: 100%;
|
|
}
|
|
.cmdcell {
|
|
width: 50%;
|
|
border: none;
|
|
}
|
|
.cmdhdr {
|
|
font-weight: bold;
|
|
font-size: 80%;
|
|
border: none;
|
|
}
|
|
.os-icons {
|
|
float: right;
|
|
}
|
|
img {
|
|
width: 60px;
|
|
}
|
|
.locations {
|
|
margin-left: 20px;
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<h1 class="title">weewx: Quick Start Guide for Linux</h1>
|
|
<p class='os-icons'>
|
|
<img src='logo-linux.png'/>
|
|
<img src='logo-debian.png'/>
|
|
<img src='logo-ubuntu.png'/>
|
|
<img src='logo-mint.png'/><br/>
|
|
<img src='logo-redhat.png'/>
|
|
<img src='logo-centos.png'/>
|
|
<img src='logo-fedora.png'/>
|
|
</p>
|
|
<p>
|
|
This is a guide to install weewx on Linux systems. The installation will
|
|
place weewx in the /home/weewx directory with the following:
|
|
<table class='locations'>
|
|
<tr>
|
|
<td align='right'>configuration file: </td>
|
|
<td class='tty'>/home/weewx/weewx.conf</td>
|
|
</tr>
|
|
<tr>
|
|
<td align='right'>skins and templates: </td>
|
|
<td class='tty'>/home/weewx/skins/</td>
|
|
</tr>
|
|
<tr>
|
|
<td align='right'>sqlite databases: </td>
|
|
<td class='tty'>/home/weewx/archive/</td>
|
|
</tr>
|
|
<tr>
|
|
<td align='right'>web pages and images: </td>
|
|
<td class='tty'>/home/weewx/public_html/</td>
|
|
</tr>
|
|
</table>
|
|
</p>
|
|
|
|
<p style='clear: both'></p>
|
|
|
|
<h3>Install Prerequisites</h3>
|
|
<table class='cmdtbl'>
|
|
<tr valign='top'>
|
|
<td class='cmdhdr'>Debian, Ubuntu, Mint</td>
|
|
<td class='cmdhdr'>Redhat, CentOS, Fedora</td>
|
|
</tr>
|
|
<tr valign='top'>
|
|
<td class='cmdcell'>
|
|
<p class='tty' style='margin:0'>
|
|
# required packages:<br/>
|
|
sudo apt-get install python-configobj<br/>
|
|
sudo apt-get install python-cheetah<br/>
|
|
sudo apt-get install python-imaging<br/>
|
|
<br/>
|
|
# if using MySQL:<br/>
|
|
sudo apt-get install python-mysqldb<br/>
|
|
sudo apt-get install python-mysql-client<br/>
|
|
<br/>
|
|
# serial or USB, depending on hardware:<br/>
|
|
sudo apt-get install python-serial<br/>
|
|
sudo apt-get install python-usb<br/>
|
|
<br/>
|
|
# for extended almanac information:<br/>
|
|
sudo apt-get install python-dev<br/>
|
|
sudo apt-get install python-pip<br/>
|
|
sudo pip install pyephem<br/>
|
|
</p>
|
|
</td>
|
|
<td class='cmdcell'>
|
|
<p class='tty' style='margin:0'>
|
|
# required packages:<br/>
|
|
sudo yum install python-configobj<br/>
|
|
sudo yum install python-cheetah<br/>
|
|
sudo yum install python-imaging<br/>
|
|
<br/>
|
|
# if using MySQL:<br/>
|
|
sudo yum install python-mysqldb<br/>
|
|
sudo yum install python-mysql-client<br/>
|
|
<br/>
|
|
# serial or USB, depending on hardware:<br/>
|
|
sudo yum install pyserial<br/>
|
|
sudo yum install pyusb<br/>
|
|
<br/>
|
|
# for extended almanac information:<br/>
|
|
sudo yum install pyephem<br/>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
<tr valign='top'>
|
|
<td class='cmdhdr'>SuSE</td>
|
|
<td class='cmdhdr'>Python Setup Tool (<a href="http://pypi.python.org/pypi/pip">pip</a>)</td>
|
|
</tr>
|
|
<tr valign='top'>
|
|
<td class='cmdcell'>
|
|
<p class='tty' style='margin:0'>
|
|
sudo yast -i gcc<br/>
|
|
sudo yast -i python-configobj<br/>
|
|
sudo yast -i python-imaging<br/>
|
|
sudo yast -i python-devel<br/>
|
|
sudo yast -i setuptools<br/>
|
|
<br/>
|
|
# install pip<br/>
|
|
sudo pip install Cheetah<br/>
|
|
<br/>
|
|
# serial or USB, depending on hardware:<br/>
|
|
sudo yast -i pyserial<br/>
|
|
sudo yast -i pyusb<br/>
|
|
<br/>
|
|
# for extended almanac information:<br/>
|
|
sudo pip install pyephem<br/>
|
|
</p>
|
|
</td>
|
|
<td class='cmdcell'>
|
|
<p class='tty' style='margin:0'>
|
|
# required packages:<br/>
|
|
sudo pip install configobj<br/>
|
|
sudo pip install Cheetah<br/>
|
|
sudo pip install pil<br/>
|
|
<br/>
|
|
# serial or USB, depending on hardware:<br/>
|
|
sudo pip install pyserial<br/>
|
|
sudo pip install pyusb<br/>
|
|
<br/>
|
|
# for extended almanac information:<br/>
|
|
sudo pip install pyephem<br/>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<h3>Download</h3>
|
|
<p>
|
|
Download the source archive <span class='code'>weewx-X.Y.Z.tar.gz</span> from <a href="http://sourceforge.net/projects/weewx/files">Sourceforge</a>
|
|
</p>
|
|
|
|
<h3>Install</h3>
|
|
<p>
|
|
Expand the source archive:
|
|
</p>
|
|
<p class="tty">
|
|
tar xvf weewx-X.Y.Z.tar.gz
|
|
</p>
|
|
<p>
|
|
Change directory:
|
|
</p>
|
|
<p class="tty">
|
|
cd weewx-X.Y.Z
|
|
</p>
|
|
<p>
|
|
Then build and install:
|
|
</p>
|
|
<p class="tty">
|
|
./setup.py build<br/>
|
|
sudo ./setup.py install
|
|
</p>
|
|
<p>
|
|
The install will place weewx in <span class='code'>/home/weewx</span>, so sudo is probably required.
|
|
</p>
|
|
|
|
<h3>Configure</h3>
|
|
<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>
|
|
If you have a weather station from the Davis Vantage series, many of the configuration data will be downloaded from your hardware, including altitude, archive interval, and the start of your rain year. If you have not set these, you can either do so by following the instructions in the manual that came with your weather station, or by using the configuration utility config_vp.py, which is included with weewx. To see how to run config_vp.py:
|
|
</p>
|
|
<p class='tty'>
|
|
# This works only for Davis Vantage weather stations!<br/>
|
|
cd /home/weewx<br/>
|
|
./bin/config_vp.py weewx.conf --help<br/>
|
|
</p>
|
|
|
|
<h3>Run</h3>
|
|
<p>
|
|
Run the main program from the command line:
|
|
</p>
|
|
<p class="tty">
|
|
cd /home/weewx<br/>
|
|
./bin/weewxd.py weewx.conf<br/>
|
|
</p>
|
|
<p>
|
|
Or as a daemon automatically when the computer starts:
|
|
</p>
|
|
<table class='cmdtbl'>
|
|
<tr valign='top'>
|
|
<td class='cmdhdr'>Debian, Ubuntu, Mint</td>
|
|
<td class='cmdhdr'>Redhat, CentOS, Fedora</td>
|
|
</tr>
|
|
<tr valign='top'>
|
|
<td class='cmdcell'>
|
|
<p class="tty" style='margin:0'>
|
|
sudo cp util/init.d/weewx.debian /etc/init.d/weewx<br/>
|
|
sudo chmod +x /etc/init.d/weewx<br/>
|
|
sudo update-rc.d weewx defaults 98<br/>
|
|
sudo /etc/init.d/weewx start<br/>
|
|
</p>
|
|
</td>
|
|
<td class='cmdcell'>
|
|
<p class="tty" style='margin:0'>
|
|
sudo cp util/init.d/weewx.redhat /etc/init.d/weewx<br/>
|
|
sudo chmod +x /etc/init.d/weewx<br/>
|
|
sudo chkconfig weewx on<br/>
|
|
sudo /etc/init.d/weewx start<br/>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
<tr valign='top'>
|
|
<td class='cmdhdr'>SuSE</td>
|
|
</tr>
|
|
<tr valign='top'>
|
|
<td class='cmdcell'>
|
|
<p class="tty" style='margin:0'>
|
|
sudo cp util/init.d/weewx.suse /etc/init.d/weewx<br/>
|
|
sudo chmod +x /etc/init.d/weewx<br/>
|
|
sudo chkconfig weewx on<br/>
|
|
sudo /etc/init.d/weewx start<br/>
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<h3>Verify</h3>
|
|
<p>
|
|
After 5 minutes, open the station web page in a web browser. You should see the default weewx page with your 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>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, simply delete the directory <span class='code'>/home/weewx</span>. This will delete weewx, configuration files, and data.
|
|
</p>
|
|
<p class='tty'>
|
|
sudo rm -r /home/weewx
|
|
sudo rm /etc/init.d/weewx
|
|
</p>
|
|
<p> </p>
|
|
</body>
|
|
</html>
|