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 · Basa Sunda · Baso Minangkabau · bosanski · brezhoneg · català · čeština · corsu · 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 bokmål · norsk nynorsk · occitan · Oromoo · oʻzbekcha/ўзбекча · Plattdüütsch · polski · português · română · shqip · slovenčina · slovenščina · Soomaaliga · suomi · svenska · Tagalog · 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 soft 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.