From: Regina Obe Date: Fri, 22 Aug 2008 12:14:47 +0000 (+0000) Subject: Updated the installations docs. I took some of Olivier Courtin instructions for insta... X-Git-Tag: 1.4.0b1~782 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=1c01c65ae5ecc565291ffc72d544cc5e27f41b50;p=postgis Updated the installations docs. I took some of Olivier Courtin instructions for install (http://postgis.refractions.net/pipermail/postgis-users/2008-August/020746.html) which seemed much easier to follow than the ones we currently have. Also corrected path settings we had to the install files. They are all in downloads not root of postgis as we suggested. git-svn-id: http://svn.osgeo.org/postgis/trunk@2921 b70326c6-7e19-0410-871a-916f4a2858ee --- diff --git a/doc/installation.xml b/doc/installation.xml index 152b6750c..fe7a50269 100644 --- a/doc/installation.xml +++ b/doc/installation.xml @@ -84,50 +84,54 @@ require recompiling your PostgreSQL from scratch, of course. - - + + The steps that follow are for Linux users. They will not work on Windows without MingW and some other stuff + + Check your settings to see which versions of things will be used + + which gcc + which make && which autoconf + which pg_config + sudo ldconfig -v | grep iconv + which flex && which bison + sudo ldconfig -v | grep /usr/local/lib + which geos-config + sudo ldconfig -v | grep proj + + + + + If you are missing proj based on above or running a version below 4.5, then install by following these steps. + + wget http://download.osgeo.org/proj/proj-4.6.0.tar.gz + tar xvzf proj4-4.6.0.tar.gz + cd proj4-4.6.0 + ./configure && make clean && make + sudo make install + sudo ldconfig + cd .. + + + + + If you are missing geos based on above or running a version below 3.0, then install by following these steps. + + wget http://geos.refractions.net/downloads/geos-3.0.0.tar.bz2 + tar xvjf geos-3.0.0.tar.bz2 + cd geos-3.0.0 + ./configure && make clean && make + sudo make install + sudo ldconfig + cd .. + + + + Retrieve the PostGIS source archive from http://postgis.refractions.net/postgis-&last_release_version;.tar.gz. - Uncompress and untar the archive. - - # gzip -d -c postgis-&last_release_version;.tar.gz | tar xvf - - - - - Enter the postgis-&last_release_version; directory, and run: - # ./configure - - - - PostgreSQL provides a utility called pg_config to enable - extensions like PostGIS to locate the PostgreSQL installation directory. - If ./configure didn't find pg_config, - try using the --with-pgconfig=/path/to/pg_config switch to specify a particular - PostgreSQL installation. - - - - Proj4 is now required in order to build and use PostGIS. - If ./configure didn't find the Proj4 library, - try using the --with-projdir=/path/to/projdir switch to specify an alternative - Proj4 installation directory. - - - - GEOS is now required in order to build and use PostGIS. - If ./configure didn't find it, try using the - --with-geosconfig=/path/to/geos-config switch to specify the full path - to the geos-config program. - - - - - - Run the compile and install commands. - - # make # make install - - All files are installed using information provided by + url="http://postgis.refractions.net/download/postgis-&last_release_version;.tar.gz">http://postgis.refractions.net/download/postgis-&last_release_version;.tar.gz. + Uncompress and untar the archive. configure. + + All files are installed using information provided by pg_config @@ -147,39 +151,80 @@ [bindir]/. - - - PostGIS requires the PL/pgSQL procedural language extension. - Before loading the lwpostgis.sql file, you must - first enable PL/pgSQL. You should use the - createlang command. The PostgreSQL Programmer's - Guide has the details if you want to this manually for some - reason. - - # createlang plpgsql [yourdatabase] - - - - Now load the PostGIS object and function definitions into your - database by loading the lwpostgis.sql definitions - file. - - # psql -d [yourdatabase] -f lwpostgis.sql - - The PostGIS server extensions are now loaded and ready to - use. - - - - For a complete set of EPSG coordinate system definition - identifiers, you can also load the - spatial_ref_sys.sql definitions file and populate - the SPATIAL_REF_SYS table. - - # psql -d [yourdatabase] -f spatial_ref_sys.sql - - + + wget http://postgis.refractions.net/download/postgis-&last_release_version;.tar.gz + gzip -d -c postgis-&last_release_version;.tar.gz | tar xvf - + cd postgis-&last_release_version;/ + sh autogen.sh + ./configure + + + + + + Make and Install + + + PostgreSQL provides a utility called pg_config to enable + extensions like PostGIS to locate the PostgreSQL installation directory. + If ./configure didn't find pg_config, + try using the --with-pgconfig=/path/to/pg_config switch to specify a particular + PostgreSQL installation. + + + + Proj4 is now required in order to build and use PostGIS. + If ./configure didn't find the Proj4 library, + try using the --with-projdir=/path/to/projdir switch to specify an alternative + Proj4 installation directory. + + + + GEOS is now required in order to build and use PostGIS. + If ./configure didn't find it, try using the + --with-geosconfig=/path/to/geos-config switch to specify the full path + to the geos-config program. + + + + make clean && make + sudo make install + sudo ldconfig + + + + + + PostGIS requires the PL/pgSQL procedural language extension. + Before loading the lwpostgis.sql file, you must + first enable PL/pgSQL. You should use the + createlang command. The PostgreSQL Programmer's + Guide has the details if you want to this manually for some + reason. + + # createlang plpgsql [yourdatabase] + + + + Now load the PostGIS object and function definitions into your + database by loading the lwpostgis.sql definitions + file. + + # psql -d [yourdatabase] -f lwpostgis.sql + + The PostGIS server extensions are now loaded and ready to + use. + + + + For a complete set of EPSG coordinate system definition + identifiers, you can also load the + spatial_ref_sys.sql definitions file and populate + the SPATIAL_REF_SYS table. + + # psql -d [yourdatabase] -f spatial_ref_sys.sql + Creating PostGIS spatially-enabled databases from an in-built @@ -339,6 +384,7 @@ newdb=> \i spatial_ref_sys.sql</programlisting> </listitem> </orderedlist> </sect2> + </orderedlist> </sect1> <sect1>