initial commit of tirex - a new tile rendering manager

Author: woodpeck

LICENSE

@@ -0,0 +1,45 @@
+build: Makefile.perl
+	cd tirex-renderd; $(MAKE) $(MFLAGS)
+	$(MAKE) -f Makefile.perl
+
+Makefile.perl: Makefile.PL
+	perl Makefile.PL PREFIX=/usr DESTDIR=$(DESTDIR) FIRST_MAKEFILE=Makefile.perl
+	rm -f Makefile.perl.old
+
+install: build
+	install -m 755 -g root -o root -d $(DESTDIR)/usr/bin/
+	install -m 755 -g root -o root -d $(DESTDIR)/usr/share/tirex
+	install -m 755 -g root -o root -d $(DESTDIR)/usr/share/munin/plugins
+	install -m 755 -g root -o root bin/tirex-batch           $(DESTDIR)/usr/bin/
+	install -m 755 -g root -o root bin/tirex-send            $(DESTDIR)/usr/bin/
+	install -m 755 -g root -o root bin/tirex-master          $(DESTDIR)/usr/bin/
+	install -m 755 -g root -o root bin/tirex-renderd-starter $(DESTDIR)/usr/bin/
+	install -m 755 -g root -o root bin/tirex-status          $(DESTDIR)/usr/bin/
+	install -m 755 -g root -o root bin/tirex-syncd           $(DESTDIR)/usr/bin/
+	install -m 755 -g root -o root bin/tirex-tiledir-check   $(DESTDIR)/usr/bin/
+	install -m 755 -g root -o root bin/tirex-tiledir-stat    $(DESTDIR)/usr/bin/
+	install -m 755 -g root -o root munin/*                   $(DESTDIR)/usr/share/munin/plugins
+
+	mkdir -p man-generated 
+	for i in bin/*; do if grep -q "=head" $$i; then pod2man $$i > man-generated/`basename $$i`.1; fi; done
+	pod2man --section=5 doc/tirex.conf.pod > man-generated/tirex.conf.5
+
+	install -m 755 -g root -o root -d                  $(DESTDIR)/etc/tirex
+	install -m 644 -g root -o root etc/tirex.conf.dist $(DESTDIR)/etc/tirex/tirex.conf
+	install -m 755 -g root -o root -d                  $(DESTDIR)/usr/share/man/man1/
+	install -m 644 -g root -o root man-generated/*.1   $(DESTDIR)/usr/share/man/man1/
+	install -m 755 -g root -o root -d                  $(DESTDIR)/usr/share/man/man5/
+	install -m 644 -g root -o root man-generated/*.5   $(DESTDIR)/usr/share/man/man5/
+
+	cd tirex-renderd; $(MAKE) DESTDIR=$(DESTDIR) install
+	$(MAKE) -f Makefile.perl install
+
+clean: Makefile.perl
+	$(MAKE) -f Makefile.perl clean
+	cd tirex-renderd; $(MAKE) DESTDIR=$(DESTDIR) clean
+	rm -f Makefile.perl
+	rm -f Makefile.perl.old
+	rm -f build-stamp
+	rm -f configure-stamp
+	rm -rf blib man-generated
+

Makefile

@@ -0,0 +1,21 @@
+use ExtUtils::MakeMaker;
+
+unless (eval { require Test::More; 1 }) {
+	print STDERR "*** Test::More is not installed, you will not be able to run the tests\n";
+}
+unless ($] >= 5.006001) {
+	print STDERR "*** This Perl version ($]) is not supported\n";
+}
+
+# See lib/ExtUtils/MakeMaker.pm for details of how to influence
+# the contents of the Makefile that is written.
+WriteMakefile(
+    'NAME'	       => 'Tirex',
+    'AUTHOR'       => 'Jochen Topf',
+    'LICENSE'      => 'GPL',
+    'INSTALLDIRS'  => 'vendor',
+    'VERSION_FROM' => 'lib/Tirex.pm', # finds $VERSION
+    'ABSTRACT'     => "Modules for the Tirex tile server",
+    'PREREQ_PM'    => { 'IPC::ShareLite' => 0, 'JSON' => 0 },
+    test           => { TESTS => join(' ', glob('t/*/*.t')) },
+);

Makefile.PL

@@ -0,0 +1,37 @@
+
+Tirex Tile Rendering System
+===========================
+
+
+
+PERL MODULES
+------------
+
+You'll need the following Perl modules:
+* IPC::ShareLite (Debian/Ubuntu/: libipc-sharelite-perl)
+* JSON (Debian/Ubuntu: libjson-perl)
+
+
+LOGGING
+-------
+
+Tirex-master has two logs:
+* General noticies, warnings, errors, debug messages and the like are
+  logged via syslog. You can configure the syslog facility that should
+  be used ('master_syslog_facility').
+* For each rendered metatile a line is written to a logfile. This can
+  be used for generating statistics. Failed renderings (when the
+  renderd didn't answer) are not logged here (but in the syslog). Use
+  the config variable 'master_logfile' to set the filename for this
+  log.
+
+
+TESTING
+-------
+
+Call 'prove' in the main directory to run Perl tests. You need Test::More
+(Debian/Ubuntu: libtest-simple-perl) and Test::Harness (Debian/Ubuntu:
+libtest-harness-perl) installed.
+
+Call 'perl t/tirex_queue_speed_test.pl' to run queue speed test.
+