-
Notifications
You must be signed in to change notification settings - Fork 300
/
debian.htm
112 lines (95 loc) · 4.39 KB
/
debian.htm
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
<!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">
<head>
<meta content="en-us" http-equiv="Content-Language"/>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type"/>
<title>weewx: Installation on Debian systems</title>
<link href="css/weewx_docs.css" rel="stylesheet"/>
<link rel="icon" type="image/png" href="/docs/images/favicon.png">
</head>
<body>
<h1 class="title">weewx: Installation on Debian-based systems</h1>
<p class='os-icons'>
<img class='logo' src='images/logo-debian.png' alt=""/>
<img class='logo' src='images/logo-ubuntu.png' alt=""/>
<img class='logo' src='images/logo-mint.png' alt=""/>
</p>
<p>This is a guide to installing <span class='code'>weewx</span> from a DEB package on Debian-based systems, including Ubuntu, Mint, and Raspian.
</p>
<h2>Download</h2>
<p>Download the DEB package from <a href="http://weewx.com/downloads"><span class="code">weewx.com/downloads</span></a>. It will have a name similar to <span class='symcode'>weewx_X.Y.Z-R_all.deb</span>.
</p>
<h2>Install</h2>
<p>If you are running a graphical interface, you can install by double-clicking the .deb file. Alternatively, if you are running from a command line, use the command:</p>
<pre class='tty cmd'>sudo dpkg -i <span class="symcode">weewx_X.Y.Z-R_all.deb</span></pre>
<p>The installer will prompt for a location, latitude/longitude, altitude, station type, and parameters specific to your station hardware.
</p>
<p>If dpkg complains about dependency problems, use <span class="code">apt-get</span> to resolve the dependencies and complete the installation:
</p>
<pre class='tty cmd'>sudo apt-get update
sudo apt-get -f install</pre>
<p>When you are done, <span class="code">weewx</span> will be running in the background as a daemon.
</p>
<h2>Status</h2>
<p>To make sure things are running properly look in the system log for messages from <span class='code'>weewx</span>.
</p>
<pre class='tty cmd'>sudo tail -f /var/log/syslog</pre>
<h2>Verify</h2>
<p>After about 5 minutes, open the station web page in a web browser. You should see your station information and data.
</p>
<pre class='tty'><a href="file:///var/www/weewx/index.html">file:///var/www/weewx/index.html</a></pre>
<p>If your hardware supports hardware archiving, then how long you wait will depend on the <a href="usersguide.htm#archive_interval">archive interval</a> set in your hardware.
</p>
<h2>Customize</h2>
<p>To enable uploads such as Weather Underground or to customize reports, modify the configuration file <span class='code'>/etc/weewx/weewx.conf</span>. See the <a href="usersguide.htm">User Guide</a> and <a href="customizing.htm">Customization Guide</a> for details.
</p>
<p><span class='code'>weewx</span> must be restarted for configuration file changes to take effect.
</p>
<h2>Start/Stop</h2>
<p>To start/stop <span class='code'>weewx</span>:</p>
<pre class='tty cmd'>sudo /etc/init.d/weewx start
sudo /etc/init.d/weewx stop</pre>
<h2>Uninstall</h2>
<p>To uninstall <span class='code'>weewx</span> but retain configuration files and data:
</p>
<pre class='tty cmd'>sudo dpkg -r weewx</pre>
<p>To uninstall <span class='code'>weewx</span>, removing configuration files but retaining data:
</p>
<pre class='tty cmd'>sudo dpkg --purge weewx</pre>
<p>To remove data:</p>
<pre class='tty cmd'>sudo rm -r /var/lib/weewx
sudo rm -r /var/www/weewx</pre>
<h2>Layout</h2>
<p>If you followed the installation guide above, then it will result in the following layout:</p>
<table class='locations' style='width: 50%'>
<tr>
<td align='right'>executable:</td>
<td class='tty'>/usr/bin/weewxd</td>
</tr>
<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'>generated web pages and images:</td>
<td class='tty'>/var/www/weewx/</td>
</tr>
<tr>
<td align='right'>documentation:</td>
<td class='tty'>/usr/share/doc/weewx/</td>
</tr>
</table>
<p class='copyright'>
© <a href='copyright.htm'>Copyright</a> Tom Keffer
</p>
</body>
</html>