From 9822121cd7b5cad9743eda5ffdd6902065a15cb6 Mon Sep 17 00:00:00 2001 From: Matt Rude Date: Sun, 12 Aug 2012 19:37:10 -0500 Subject: Webstie Update --- index.html | 133 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 132 insertions(+), 1 deletion(-) (limited to 'index.html') diff --git a/index.html b/index.html index 8a061b8..e91d0dc 100644 --- a/index.html +++ b/index.html @@ -6,14 +6,145 @@ http://gh.mattrude.com --> - gh.mattrude.com / WordPres Plugin MDR Network + gh.mattrude.com /
+

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.

+

— gh.mattrude.com

+ +

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.

+ +

The below informaion is tailored for Fedora servers, but should be generic enough for most unix/linux systems.

+ +

The source for this project may always be found on my github repository: https://github.com/mattrude/time.mattrude.com

+ +

— gh.mattrude.com

+ +

You may download this project directly from github the current truck may be downloaded as a tar.gz file, or a zip file.

+ + + +

or you can always just download the full git repository:

+ +
git clone git://github.com/mattrude/time.mattrude.com.git
+
+ +

— gh.mattrude.com

+ +

The requirements for running this project on your own site are pretty simple.

+ + + +

So on a Fedora system, you may run:

+ +
yum -y install rrdtools python-markdown
+
+ +

— gh.mattrude.com

+ +

The install proccess for this project at this time is a bit cumbersome. Currently it assumes all files are stored in /var/www/time.mattrude.com. This will change in the future, but for now, it will be just easiest to create that director on your system.

+ +

To install, first you need to add a cron entry for the RRD graphs.

+ +
*/5 * * * * <path-to-source>/scripts/do-xntp > /dev/null 2&>1
+
+ +

After adding the cron job, you may add your NTP Servers. To add your NTP servers, start by going into the scripts/ directory. Once in the scripts directory, run the do-newntpstat followed by the name of the computer, similar to below.

+ +
./do-newntpstat time.example.com
+
+ +

Lastly, if you wish to also count the current number of clients per server, run the below to lines.

+ +
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 &
+
+ +

— gh.mattrude.com

+ +
yum -y install httpd perl-CGI
+
+ +

The Apache configuration for virtual hosts is pretty simple. The only trick is setting the cgi directory.

+ +
<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>
+
+ +

— gh.mattrude.com

+ +

Installing Lighttpd on a Fedora system is pretty simple.

+ +
yum -y install lighttpd lighttpd-fastcgi
+
+ +

After Lighttpd is installed, you need to configure it.

+ +
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" )
+
+ +

— gh.mattrude.com

+ +

To rebuild the css file after modification, download and install the YUI Compressor, then run:

+ +
java -jar /yuicompressor-2.4.8pre.jar style.css > style.min.css && gzip style.min.css && mv style.min.css.gz style.css.gz
+
+ +

Yes, it requires Java, but you may always just copy the style.dev.css to style.css and be done

+ +

— gh.mattrude.com

+ +
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/>.
+