[openrailwaymap] OpenRailwayMap on your own server

[Rolf Eike Beer]

[No German version, I'm too lazy.]

You may know it or not, I have been quite busy in the last month hacking on 
OpenRailwayMap code. I have introduced automated testcases to spot syntax 
errors and dangling icon references and much stuff like this. In fact, also the 
automation to build the new JavaScript stylesheets from the MapCSS ones was 
done by me.

I've also done a lot of things to improve the stylesheets, as well as the 
underlying software that drives them. Which usually resulted in me begging 
Alexander to put that stuff on the server so I can actually see if it works. 
Testing on a live system isn't a good idea anyway, and given the fact that 
every update has to go through another person doesn't make this solution scale 
anywhere.

So once I sat down and tried to set up a local server, but not a full-featured 
database one. I have only the frontend rendering code on my machines, happily 
using the vector tiles of the "real" server. This resulted in me fixing even 
more stuff. Since the important parts of that are already merged I'll now write 
down how to get there so you can hack on your own stuff.

My machines use openSUSE, so I will stick to those package names. And I don't 
list the dependencies explicitely here to keep things short. So, let's start 
installing:

zypper in git-core apache2-mod_php5 php5-ctype php5-gettext python-ply python-
rsvg python-cairo libxml2-tools zip

Now get the actual code

git clone https://github.com/rurseekatze/OpenRailwayMap.git
cd OpenRailwayMap
git submodule init renderer

Now build the JavaScript stylesheets

cd styles
make

That's pretty much it. Now tell your webserver where your OpenRailwayMap 
directory is and that it should be served, or put the whole directory in your 
~/public_html. Put "php5" and maybe also "userdir" (if you use ~/public_html) 
in your /etc/sysconfig/apache2 in the APACHE_MODULES line, (re)start apache:

 systemctl start apache2.service

You may want to make canvas.php the directory index, otherwise you always have 
to type it. The bitmap layer is of course also taken from the "real" instance, 
so you can't change how that looks.

And you should basically be done. Now you can e.g. hack on styles/*.mapcss to 
get different styling, just "make -C styles" afterwards and reload the page.

I hope some cool new pull requests will come in now, e.g. for signalling 
systems outside of central Europe. In case I have forgotten some thing just 
ask either on this list or in #OpenRailwayMap on irc.oftc.net.

Greetings,

Eike

P.S.: want to have a proof that this works? http://orm-dev.der-dakon.net, this 
usually runs a combination of most of my own branches that are waiting for 
upstream integration. I may or may not pick other peoples branches there, too, 
this is more or less random if I have an interest in them.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 198 bytes
Desc: This is a digitally signed message part.
URL: <http://lists.openrailwaymap.org/archives/openrailwaymap/attachments/20151107/6acad31c/attachment.sig>