Skip to content

kothic/tirex

 
 

Repository files navigation

Tirex Tile Rendering System
===========================

Tirex is a bunch of tools that let you run a tile server. A tile server
is a web server that hands out pre-rendered map raster images to clients.

The web page for Tirex is at http://wiki.openstreetmap.org/wiki/Tirex .
See there for more information.

PREREQUISITES
-------------

You'll need the following Perl modules to run Tirex:

* IPC::ShareLite (Debian/Ubuntu: libipc-sharelite-perl)
* JSON           (Debian/Ubuntu: libjson-perl)
* GD             (Debian/Ubuntu: libgd-gd2-perl)
* LWP            (Debian/Ubuntu: libwww-perl)

You'll need a C++ compiler and build tools to compile the Mapnik backend.

BUILDING
--------

To build Tirex run

  make

in the main directory. This will compile the mapnik backend and create
the man pages for the Perl modules.

Call 'make clean' to cleanup after a 'make'.

INSTALLING
----------

To install Tirex call

  make install

as root user. This will install the main parts of Tirex including the
tirex-master, tirex-backend-manager and the Mapnik backend.

This will not install the example map, or the munin or nagios plugins.
To install those, call

  make install-example-map
  make install-munin
  make install-nagios

respectively. You can also install everything with

  make install-all

DEBIAN/UBUNTU
-------------

To create Debian/Ubuntu packages you need the package 'devscripts'
installed. Call

  make deb

to create the packages. The following packages will be created in the parent
directory:

  tirex-core
  tirex-backend-mapnik
  tirex-backend-wms
  tirex-backend-mapserver
  tirex-example-map
  tirex-munin-plugin
  tirex-nagios-plugin
  tirex-syncd

Call 'make deb-clean' to cleanup after a 'make deb'.

TESTS
-----

Call 'prove' in the main directory to run Perl unit tests. You need Test::More
(Debian/Ubuntu: libtest-simple-perl) and Test::Harness (Debian/Ubuntu:
libtest-harness-perl) installed.

There are some other tests in the 'test' directory. See the description at the
beginning of the scripts for information on how to use them.

Releases

No releases published

Packages

No packages published

Languages

  • Perl 61.6%
  • Python 30.3%
  • C++ 5.3%
  • JavaScript 1.6%
  • Other 1.2%