Files
weewx/docs/debian.htm
2012-01-07 18:05:39 +00:00

107 lines
3.2 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>The Weewx weather system</title>
<!-- CSS -->
<link href="weewx_docs.css" rel="stylesheet" />
<!-- JavaScript -->
<style type="text/css">
</style>
</head>
<body>
<h1 class="title">Quick start guide for Debian (Ubuntu) systems</h1>
<p>
This guide is to get you quickly started using <span class="code">weewx</span> on Debian systems,
particularly Ubuntu. It assumes you have already downloaded the <span class="code">weewx</span> tarball.
</p>
<h3>Prerequisites</h3>
<p>
Install the required libraries:
</p>
<p class="tty">
sudo apt-get install sqlite3
<br />
sudo apt-get install python-pysqlite2
<br />
sudo apt-get install python-configobj
<br />
sudo apt-get install python-serial
<br />
sudo apt-get install python-cheetah
<br />
sudo apt-get install python-imaging
<br />
sudo apt-get install python-dev
<br />
sudo apt-get install python-pip
</p>
<p>
The last two allow the optional package <span class="code">pyephem</span> to
be installed:
</p>
<p class="tty">
sudo pip install pyephem
</p>
<h3>Installing</h3>
<p>
Unpack the tar ball (substitute your version for X.Y.Z) into any
convenient directory where you have write permission
</p>
<p class="tty">
tar xvf weewx-X.Y.Z
</p>
<p>
Then change directory into it:
</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>
This will install <span class="code">weewx</span> into its default directory <span class="code">/home/weewx</span>.
</p>
<h3>Configure</h3>
<p>
Edit the configuration file <span class="code">/home/weewx/weewx.conf</span>.
Pay particular attention to which serial port your weather station uses (option <span class="code">port</span>), the archive interval (option <span class="code"> archive_interval</span>), and the altitude of your station (option <span class="code">altitude</span>).
</p>
<p>
Then run the configuration program to configure your hardware:
</p>
<p class="tty">
/home/weewx/bin/configure.py /home/weewx/weewx.conf --configure
</p>
<h3>Running</h3>
<p>
Now you can either run the main program from the command line:
</p>
<p class="tty">
/home/weewx/bin/weewxd.py /home/weewx/weewx.conf
</p>
<p>
Or, if you prefer to run as a daemon, then do the following:
</p>
<p class="tty">
sudo cp /home/weewx/start_scripts/Debian/weewx /etc/init.d
<br />
sudo chmod +x /etc/init.d/weewx
<br />
sudo update-rc.d weewx defaults 98
<br />
sudo /etc/init.d/weewx start
</p>
</body>
</html>