Gisgraphy installation guide

Before install and launch Gisgraphy, you must setup java (you needs JVM >= 1.5), postgres, and postgis. it is not, properly speaking, the installation of Gisgraphy, and if you already havn't Postgres, Postgis and java installed, you must install it first. a tutorial is provided here for linux and here for windows

Download a Gisgraphy distribution


Initialize The database

Here are the command to run to and init the Gisgraphy tables
#create tables;
psql -UYOURUSER -d gisgraphy -h YOURIP -f /path/to/file/create_tables.sql
 
Where YOURUSER is a postgresql user with admin rights, YOURIP is the ip adress of your server(127.0.0.1 in most case)

Then insert users (...for the admin interface,... you don't have to log to use gisgraphy webservices) in the database. A script called insert-users.sql is provided with two default users: one with admin rights and one with simple rights.
psql -UYOURPOSTGRESQLUSER -d gisgraphy -h YOURIP -f /path/to/file/insert_users.sql

It is HIGHLY recommended to modify them for security : once gisgraphy is installed :

Edit database and Gisgraphy settings

Go into the directory you've extract the gisgraphy distribution, Then edit the database settings in the jdbc.properties file in the directory 'webapps/ROOT/WEB-INF/classes' of the Gisgraphy distribution to setup postgres password you've defined in the 'Environment setup' step.


You can edit the configuration (import, and so on) in the env.properties file in directory 'webapps/ROOT/WEB-INF/classes' of the Gisgraphy distribution (for more information see options documentation).

Good to know : if you want to use Google maas features (see street, etc), you must set the googleMapAPIKey in the env.properties

that's all, you can now start gisgraphy

Start Gisgraphy


Important : You must type the command line in the directory where you've extract the Gisgraphy files.

The directory where you type the command to start your servlet container (e.g : java -jar start.jar for Jetty or startup.sh/startup.bat for Tomcat) determines the directory Where The full text data will be stored : the data will be stored in the $Current_Working_directory/solr Directory. In other words : This is the same thing for Tomcat or any servlet Container (Resin, ...) due to solr. More...

To avoid OutOfMemoryError : you must launch Gisgraphy with a minimum memory of 512M. To do this : set your CATALINA_OPTS to -Xms512M -Xmx512M (e.g : add this CATALINA_OPTS=-Xms512M -Xmx512M to the .bashrc file in your home directory)


See if it works

Open a browser and go to http://localhost:8080/mainMenu.html. you should see the admin page and then go to http://localhost:8080/ you should see a Gisgraphy page

And now...

Now, You can :