Tirex/Quick Start

From OpenStreetMap Wiki
Jump to: navigation, search
Available languages — Tirex/Quick Start
Afrikaans Alemannisch aragonés asturianu azərbaycanca Bahasa Indonesia Bahasa Melayu Bân-lâm-gú Basa Jawa Baso Minangkabau bosanski brezhoneg català čeština dansk Deutsch eesti English español Esperanto estremeñu euskara français Frysk Gaeilge Gàidhlig galego Hausa hrvatski Igbo interlingua Interlingue isiXhosa isiZulu íslenska italiano Kiswahili Kreyòl ayisyen kréyòl gwadloupéyen kurdî latviešu Lëtzebuergesch lietuvių magyar Malagasy Malti Nederlands Nedersaksies norsk norsk nynorsk occitan Oromoo oʻzbekcha/ўзбекча Plattdüütsch polski português português do Brasil română shqip slovenčina slovenščina Soomaaliga suomi svenska Tiếng Việt Türkçe Vahcuengh vèneto Wolof Yorùbá Zazaki српски / srpski беларуская български қазақша македонски монгол русский тоҷикӣ українська Ελληνικά Հայերեն ქართული नेपाली मराठी हिन्दी অসমীয়া বাংলা ਪੰਜਾਬੀ ગુજરાતી ଓଡ଼ିଆ தமிழ் తెలుగు ಕನ್ನಡ മലയാളം සිංහල ไทย မြန်မာဘာသာ ລາວ ភាសាខ្មែរ ⵜⴰⵎⴰⵣⵉⵖⵜ አማርኛ 한국어 日本語 中文(简体)‎ 吴语 粵語 中文(繁體)‎ ייִדיש עברית اردو العربية پښتو سنڌي فارسی ދިވެހިބަސް

To quickly get Tirex running follow these steps:

  • Build Debian packages for Tirex according to this.
  • Install the tirex-core package.
  • The tirex-master and tirex-backend-manager should be running.
  • Check by running tirex-status --once --extended, this should show you the config and current status of the master.
  • Find the log files, probably /var/log/messages, with the startup messages from the master and backend-manager. You'll probably need those logfiles later.
  • The default configuration comes with a test map. Render your first metatile with tirex-batch --prio=1 map=test z=0 x=0 y=0. This should create a file called /var/lib/tirex/tiles/test/0/0/0/0/0/0.meta.
  • Configure mod_tile using at least these options:
   ModTileRenderdSocketName /var/lib/tirex/modtile.sock
   ModTileTileDir           /var/lib/tirex/tiles
   AddTileConfig            /tiles/test/ test

Create a symbolic link from /var/lib/mod_tile to /var/lib/tirex/tiles:

 ln -s /var/lib/tirex/tiles /var/lib/mod_tile

(The link is needed because there currently is a bug in mod_tile that makes it only work with /var/lib/mod_tile as tile directory, see here).

This gives you access to the test tiles under http://hostname/tiles/test, configure your OpenLayers map accordingly. The test tiles show a checkerboard pattern with red borders around metatiles.

Once the test backend works, you can go on with installing Mapnik and the mapnik backend:

  • Install the tirex-backend-mapnik and tirex-example-map packages.
  • In addition to the test map you now have a map called example that uses Mapnik to create a simple map showing the continents. Add AddTileConfig /tiles/example/ example to your Apache/mod_tile config and add it to OpenLayers. You should be able to see the map.