Using the dev server
The OSMF provides a development server to help contributors try things out. It's a general-purpose development machine, in contrast to the dedicated service machines such as the main database server, tile server, etc - which only the sysadmins have access to. This page gives some details to help OSM developers get up and running with a dev server account.
You don't need an account on the development server (a “dev account”) in order to help develop OpenStreetMap — all the software that powers OSM can be downloaded and run on your own machine. Having a dev account doesn't give you any special abilities when doing development. But for some tasks where your own resources aren't sufficient, you can request an account.
The Dev/Tool Server is running Ubuntu 12.04 (Precise Pangolin). Major packages are updated from time to time. This will help ensure development packages remain compatible with recent software releases, and enable development against the newest and greatest software. On the other hand, expect packages to break!
Getting An Account
Using Your Account
The server is at dev.openstreetmap.org
Both PostgreSQL and MySQL are available - please contact the dev server administrator if you require access to either of these.
Postgres 8.3 and 9.1 are available, with 9.1 as the default. Command line tools such as psql can select which one to use with the "--cluster x.y/main" switch and network connections should use port 5432 for 8.3 and port 5433 for 9.1.
See pg_wrapper(1) for different ways to set your choice permanently. Also note that the contrib module isn't available for 8.3, so if you want e.g. hstore you'll need to use 9.1.
Apache User Directories
Every user on the dev server has web space at username.dev.openstreetmap.org
This is enabled by creating a directory named
public_html in your home directory and placing files within.
CGI scripts can only be executed from the
public_html/cgi-bin directory. Scripts will run with your own permissions, so there is no need to make files globally writeable (666).
If problems are experienced with CGI scripts, also try username.dev.openstreetmap.org/cgi-bin-d/script, to view debug output produced by the security wrapper script, which may prevent execution due to bad permissions or other security issues.
PHP scripts are currently executed from anywhere within the
public_html tree, but this may change in the future.
Rails applications can be run from your web space - the server is setup with passenger (aka mod_rails) and will detect correctly configured applications automatically. To run a rails application:
- Place the application in a subdirectory under your home directory (eg:
~/myrailsapp) and configure the database. You will need to set the port number in your database.yml configuration, while commenting out the host section to enable correct authentication with postgresql.
- Create a symbolic link under
public_htmlthat points to the public directory in the rails application (eg:
ln -s ~/myrailsapp/public public_html/myrailsapp).
pathis the location of the link relative to the
You should then be able to visit username.dev.openstreetmap.org/path and you see your application.
To restart the application just touch
tmp/restart.txt under the rails root directory.
Files in the
public_html/wsgi-bin directory will be run as WSGI applications.
For more details see http://apis.dev.openstreetmap.org/.