Files
weewx/docs/debian.htm

138 lines
4.1 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 debian</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 Debian Linux</h1>
<p class='os-icons'>
<img src='logo-debian.png'/>
<img src='logo-ubuntu.png'/>
<img src='logo-mint.png'/>
</p>
<p>
This is a guide to install weewx from DEB package on systems such as Debian, Ubuntu or Mint. 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.deb</span> from <a href="http://sourceforge.net/projects/weewx/files">Sourceforge</a>.
</p>
<h3>Install</h3>
<p>
Install weewx by double-clicking the .deb file, or via command line:
</p>
<p class='tty'>
sudo dpkg -i weewx-X.Y.Z-R.deb
</p>
<p>
If dpkg complains about dependency problems, use apt-get to resolve the dependencies and complete the installation:
</p>
<p class='tty'>
sudo apt-get -f install<br/>
</p>
<p>
The installer will prompt for a location, latitude/longitude, altitude, station type, and parameters specific to the station.
</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 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>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>Uninstall</h3>
<p>
To uninstall weewx but retain configuration files and data:
</p>
<p class='tty'>
sudo dpkg -r weewx
</p>
<p>
To uninstall weewx, removing configuration files but retaining data:
</p>
<p class='tty'>
sudo dpkg --purge weewx
</p>
<p class='copyright'>
&copy; <a href='copyright.htm'>Copyright</a> Tom Keffer
</p>
</body>
</html>