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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
|
<!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" xml:lang="en" lang="en">
<!-- This page was created with the build-github-pages.sh script found at
https://github.com/mattrude/mattrude.github.com for
http://gh.mattrude.com -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>gh.mattrude.com / </title>
<link rel="stylesheet" type="text/css" href="./style.css" />
<link rel="icon" href="http://github.com/favicon.ico" type="image/x-icon" />
</head>
<body>
<div id="content"><div id="primary" class="main">
<!-- Finished Header Section -->
<p>This is my timeservers web site's source repository. This repository doesn't contain the code for NTP, but instead the code to run my actual time server website.</p>
<div id="title"><h1> <i> — </i> gh.mattrude.com</h1></div><div id="breadcrums"><p><a href="/">gh.mattrude.com</a> / <strong></strong></p></div>
<p>This site uses rrdtools to build and display usage graphs. rrdtools is required to be installed on the host server before the graphs may be created.</p>
<p>The below informaion is tailored for <a href="http://fedoraproject.org/">Fedora</a> servers, but should be generic enough for most unix/linux systems.</p>
<p>The source for this project may always be found on my github repository: <a href="https://github.com/mattrude/time.mattrude.com">https://github.com/mattrude/time.mattrude.com</a></p>
<div id="title"><h1> <i> — </i> gh.mattrude.com</h1></div><div id="breadcrums"><p><a href="/">gh.mattrude.com</a> / <strong></strong></p></div>
<p>You may download this project directly from <a href="https://github.com/mattrude/time.mattrude.com">github</a> the current truck may be downloaded as a <a href="https://github.com/mattrude/time.mattrude.com/tarball/master">tar.gz</a> file, or a <a href="https://github.com/mattrude/time.mattrude.com/zipball/master">zip</a> file.</p>
<ul>
<li>Version 1.0 <a href="https://github.com/mattrude/time.mattrude.com/tarball/1.0">tar.gz</a> - <a href="https://github.com/mattrude/time.mattrude.com/zipball/1.0">zip</a></li>
</ul>
<p>or you can always just download the full <a href="http://git-scm.com">git</a> repository:</p>
<pre><code>git clone git://github.com/mattrude/time.mattrude.com.git
</code></pre>
<div id="title"><h1> <i> — </i> gh.mattrude.com</h1></div><div id="breadcrums"><p><a href="/">gh.mattrude.com</a> / <strong></strong></p></div>
<p>The requirements for running this project on your own site are pretty simple.</p>
<ul>
<li><a href="http://www.apache.org/">Apache</a> 2.2+</li>
<li><a href="http://oss.oetiker.ch/rrdtool/doc/index.en.html">RRDtools</a> 1.4.4+</li>
<li><a href="http://daringfireball.net/projects/markdown/">Markdown</a> 2.0+</li>
</ul>
<p>So on a Fedora system, you may run:</p>
<pre><code>yum -y install rrdtools python-markdown
</code></pre>
<div id="title"><h1> <i> — </i> gh.mattrude.com</h1></div><div id="breadcrums"><p><a href="/">gh.mattrude.com</a> / <strong></strong></p></div>
<p>The install proccess for this project at this time is a bit cumbersome. Currently it assumes all files are stored in <code>/var/www/time.mattrude.com</code>. This will change in the future, but for now, it will be just easiest to create that director on your system.</p>
<p>To install, first you need to add a cron entry for the RRD graphs.</p>
<pre><code>*/5 * * * * <path-to-source>/scripts/do-xntp > /dev/null 2&>1
</code></pre>
<p>After adding the cron job, you may add your NTP Servers. To add your NTP servers, start by going into the <strong>scripts/</strong> directory. Once in the scripts directory, run the <code>do-newntpstat</code> followed by the name of the computer, similar to below.</p>
<pre><code>./do-newntpstat time.example.com
</code></pre>
<p>Lastly, if you wish to also count the current number of clients per server, run the below to lines.</p>
<pre><code>echo "/usr/bin/perl -w <path-to-source>/scripts/ntpclientsd \
-dump /var/log/ntpstats/ntp_stats.dump >> /var/log/ntpstats/ntp_stats.log 2>&1 &" >> /etc/rc.local
/usr/bin/perl -w <path-to-source>/scripts/ntpclientsd \
-dump /var/log/ntpstats/ntp_stats.dump >> /var/log/ntpstats/ntp_stats.log 2>&1 &
</code></pre>
<div id="title"><h1> <i> — </i> gh.mattrude.com</h1></div><div id="breadcrums"><p><a href="/">gh.mattrude.com</a> / <strong></strong></p></div>
<pre><code>yum -y install httpd perl-CGI
</code></pre>
<p>The Apache configuration for virtual hosts is pretty simple. The only trick is setting the cgi directory.</p>
<pre><code><VirtualHost *:80>
ServerName time.example.com
DocumentRoot /var/www/time.example.com
CustomLog logs/time.example.com.access_log combined
ErrorLog logs/time.example.com.error_log
<Location /bin>
Options Indexes FollowSymLinks
Options +ExecCGI
Order allow,deny
Allow from all
AddHandler cgi-script .cgi
</Location>
</VirtualHost>
</code></pre>
<div id="title"><h1> <i> — </i> gh.mattrude.com</h1></div><div id="breadcrums"><p><a href="/">gh.mattrude.com</a> / <strong></strong></p></div>
<p>Installing <a href="http://www.lighttpd.net/">Lighttpd</a> on a Fedora system is pretty simple.</p>
<pre><code>yum -y install lighttpd lighttpd-fastcgi
</code></pre>
<p>After Lighttpd is installed, you need to configure it.</p>
<pre><code>server.document-root = "/var/www/time.example.com/"
server.port = 80
server.username = "www"
server.groupname = "www"
mimetype.assign = (
".html" => "text/html",
".txt" => "text/plain",
".jpg" => "image/jpeg",
".png" => "image/png"
)
static-file.exclude-extensions = ( ".fcgi", ".php", ".rb", "~", ".inc" )
index-file.names = ( "index.html" )
</code></pre>
<div id="title"><h1> <i> — </i> gh.mattrude.com</h1></div><div id="breadcrums"><p><a href="/">gh.mattrude.com</a> / <strong></strong></p></div>
<p>To rebuild the css file after modification, download and install the <a href="https://github.com/yui/yuicompressor">YUI Compressor</a>, then run:</p>
<pre><code>java -jar /yuicompressor-2.4.8pre.jar style.css > style.min.css && gzip style.min.css && mv style.min.css.gz style.css.gz
</code></pre>
<p><em>Yes, it requires <a href="http://java.com">Java</a>, but you may always just copy the style.dev.css to style.css and be done</em></p>
<div id="title"><h1> <i> — </i> gh.mattrude.com</h1></div><div id="breadcrums"><p><a href="/">gh.mattrude.com</a> / <strong></strong></p></div>
<pre><code>This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
</code></pre>
<!-- Starting Comments Section -->
<script type='text/javascript'>
var idcomments_acct = '4f5b5827534ac8f56be532bc26aab3bf';
var idcomments_post_id;
var idcomments_post_url;
</script>
<span id="IDCommentsPostTitle" style="display:none"></span>
<script type='text/javascript' src='http://www.intensedebate.com/js/genericCommentWrapperV2.js'></script>
<!-- Finished Comments Section -->
<!-- Starting Footer Section -->
<div id="footer">
<div class="footer-left">
<p><a href='/'>Home</a> | <a href='http://github.com/mattrude/'>Github Project List</a> | <a href='https://github.com/mattrude/time.mattrude.com'>Source</a> | <a href='https://github.com/mattrude/time.mattrude.com/issues'>Issues</a></p>
</div>
<div class="footer-right">
<p>Copyright © 2009 — 2012 by <a href='http://mattrude.com'>Matt Rude</a></p>
</div>
</div>
</div>
</div>
</body>
</html>
|
