Files
weewx/docs/debian.htm

103 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>weewx quick-start for debian</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 Linux</h1>
<p>
This is a guide to install weewx from DEB package on systems such as Debian, Ubuntu or Mint.
</p>
<p>
Installing from package will result in the following:
<table>
<tr>
<td align='right'>configuration files, skins, and templates: </td>
<td class='tty'>/etc/weewx</td>
</tr>
<tr>
<td align='right'>data will be saved to sqlite database: </td>
<td class='tty'>/var/lib/weewex</td>
</tr>
<tr>
<td align='right'>web pages and images: </td>
<td class='tty'>/var/lib/weewx/html</td>
</tr>
</table>
</p>
<p>
Installation must be done with root privileges.
</p>
<h3>Download</h3>
<p>
Download the package weewx-X.Y.Z-R.deb from <a href="http://sourceforge.net/projects/weewx"> 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>
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 <span class='code'>file:///usr/lib/weewx/html/index.html</span> in a web browser. You should see the default weewx page with your station information and data.
</p>
<h3>Status</h3>
<p>
Look in the system log <span class='code'>/var/log/messages</span> for messages from weewx.
</p>
<p class='tty'>
sudo tail /var/log/messages
</p>
<h3>Customize</h3>
<p>
To enable uploads such as Weather Underground or to customize reports, modify the configuration file /etc/weewx.conf. See the User Guide and Customization Guide 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>
</body>
</html>