Explain how to load data for testing
authorPaul Norman <penorman@mac.com>
Tue, 9 Sep 2014 00:12:10 +0000 (17:12 -0700)
committerPaul Norman <penorman@mac.com>
Tue, 9 Sep 2014 00:12:10 +0000 (17:12 -0700)
This is a fairly common query, and not too complicated where the data only needs to be loaded.

Loading data then editing it is more complex, and not covered here.

CONFIGURE.md

index 07f735cb2871e71c343529a699ad3cf859fbe1d4..36c5586d852216ae5058a6cf5204c0958f25f431 100644 (file)
@@ -6,7 +6,17 @@ After [installing](INSTALL.md) this software, you may need to carry out some of
 
 Your installation comes with no geographic data loaded. You can either create new data using one of the editors (Potlatch 2, iD, JOSM etc) or by loading an OSM extract.
 
-* Use this [yet-to-be-written script](https://github.com/openstreetmap/openstreetmap-website/issues/282)
+After installing but before creating any users or data, import an extract with [Osmosis](http://wiki.openstreetmap.org/wiki/Osmosis) and the [``--write-apidb``](http://wiki.openstreetmap.org/wiki/Osmosis/Detailed_Usage#--write-apidb_.28--wd.29) task.
+
+```
+osmosis --read-pbf greater-london-latest.osm.pbf \
+  --write-apidb host="localhost" database="openstreetmap" \
+  user="openstreetmap" password="" validateSchemaVersion="no"
+```
+
+Loading an apidb database with Osmosis is about **twenty** times slower than loading the equivalent data with osm2pgsql into a rendering database. [``--log-progress``](http://wiki.openstreetmap.org/wiki/Osmosis/Detailed_Usage#--log-progress_.28--lp.29) may be desirable for status updates.
+
+To be able to edit the data you have loaded, you will need to use this [yet-to-be-written script](https://github.com/openstreetmap/openstreetmap-website/issues/282).
 
 ## Managing Users