remove indexes before renaming tables (some dbs have database-level index namespaces...

[rails.git] / db / README

diff --git a/db/README b/db/README
index 466a16cc475586a8287b97627c4cf9cb7a6a5b40..f0002933938d842abfa0edf4aa09ac48551d6e03 100644 (file)
--- a/db/README
+++ b/db/README
@@ -1,36 +1,75 @@
 Creating database
 Creating database

-=====================
+===================

 
 

-OSM server use databse with follow name :
+OSM server uses a database with the following name:

 
 openstreetmap
 
 
 openstreetmap
 

-You may create it with your prefrable client or run next (linux) command :
+You may create it with your preferable client or run next (linux) command:

 
 

-$ mysqladmin -u <uid> -p create openstreetmap
+$ mysql -u <uid> -p
+
+(change <uid> with appropriate username of administrative user eg. root )

 
 

-(change <uid> with appropriate username of administrativ user eg. root )
+> create database openstreetmap default character set utf8;
+> exit

 
 

-Creating user, password, and access rightts
-=============================================
+Creating user, password, and access rights
+============================================

 
 $ mysql -u <uid> -p
 
 
 $ mysql -u <uid> -p
 

-(change <uid> with appropriate username of administrativ user eg. root )
+(change <uid> with appropriate username of administrative user eg. root )

 
 > grant all privileges on openstreetmap.* to 'openstreetmap'@'localhost' identified by 'openstreetmap';
 > flush privileges;
 > exit
 
 
 > grant all privileges on openstreetmap.* to 'openstreetmap'@'localhost' identified by 'openstreetmap';
 > flush privileges;
 > exit
 

-Creating database skeleton tables
-===================================
+Creating functions For MySQL
+==============================
+
+Run this command in the db/functions directory:
+
+$ make libmyosm.so
+
+Make sure the db/functions directory is on the MySQL server's library
+path and restart the MySQL server. 
+
+On Linux the easiest way to do this is to create /etc/ld.so.conf.d/osm.conf, and place the path to the db/functions directory in it and then run the ldconfig command as root.
+
+On OS X: sudo ln -s /path_to_your_osm_install/sites/rails_port/db/functions/libmyosm.so /usr/local/lib/libmyosm.so
+
+Now create the functions as follows:

 
 

-$ mysql openstreetmap -u openstreetmap -p < db/create_database.sql
+$ mysql -u <uid> -p openstreetmap

 
 

-New server patch (RAILS)
-==========================
+(change <uid> with appropriate username of administrative user eg. root )
+
+> create function tile_for_point returns integer soname 'libmyosm.so';
+> create function maptile_for_point returns integer soname 'libmyosm.so';
+> exit
+
+Creating functions for PgSQL
+==============================
+
+Run this command in the db/functions directory:
+
+$ make libmyosm.so
+
+Now create the function as follows:
+
+$ psql openstreetmap
+(This may need authentication or a -u <dbowneruid>)
+
+> CREATE FUNCTION maptile_for_point(int8, int8, int4) RETURNS int4 
+  AS '/path/to/rails-port/db/functions/libpgosm', 'maptile_for_point'
+  LANGUAGE C STRICT;
+
+Creating database skeleton tables
+===================================

 
 

-Run follow command to prepare tables to be OSM REILS distribution compatible :
+Run this command from the root of your rails directory:

 
 

-$ mysql openstreetmap -u openstreetmap -p < db/migrate.sql
+$ rake db:migrate

 
 

+This will create the db for you