From: Regina Obe Date: Fri, 22 Aug 2008 13:05:53 +0000 (+0000) Subject: More reordering X-Git-Tag: 1.4.0b1~779 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=30c0f9885cbb6332cad5b932c021c87c684c7c56;p=postgis More reordering git-svn-id: http://svn.osgeo.org/postgis/trunk@2924 b70326c6-7e19-0410-871a-916f4a2858ee --- diff --git a/doc/installation.xml b/doc/installation.xml index 7e7ba8ce3..3eb220863 100644 --- a/doc/installation.xml +++ b/doc/installation.xml @@ -68,164 +68,168 @@ not supported. - - Before you can compile the PostGIS server modules, you must - compile and install the PostgreSQL package. - - - If you plan to use GEOS functionality you might need to - explicitly link PostgreSQL against the standard C++ library: - - LDFLAGS=-lstdc++ ./configure [YOUR OPTIONS HERE] - - This is a workaround for bogus C++ exceptions interaction with - older development tools. If you experience weird problems (backend - unexpectedly closed or similar things) try this trick. This will - 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/download/postgis-&last_release_version;.tar.gz. - Uncompress and untar the archive. configure. + + Compiling and Installing from Source + + Before you can compile the PostGIS server modules, you must + compile and install the PostgreSQL package. + + + If you plan to use GEOS functionality you might need to + explicitly link PostgreSQL against the standard C++ library: + + LDFLAGS=-lstdc++ ./configure [YOUR OPTIONS HERE] + + This is a workaround for bogus C++ exceptions interaction with + older development tools. If you experience weird problems (backend + unexpectedly closed or similar things) try this trick. This will + 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 + + - All files are installed using information provided by - pg_config - - - - Libraries are installed - [pkglibdir]/lib/contrib. - - - - Important support files such as - lwpostgis.sql are installed in - [prefix]/share/contrib. - - - - Loader and dumper binaries are installed in - [bindir]/. - - - - - 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 - - + + 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 .. + + - - 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 + + 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 - - - - - - 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. + cd .. + + - # createlang plpgsql [yourdatabase] - - - - Now load the PostGIS object and function definitions into your - database by loading the lwpostgis.sql definitions - file. + + Retrieve the PostGIS source archive from 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 + + + + Libraries are installed + [pkglibdir]/lib/contrib. + + + + Important support files such as + lwpostgis.sql are installed in + [prefix]/share/contrib. + + + + Loader and dumper binaries are installed in + [bindir]/. + + + + + 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 + + - # 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. + + 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 + + - # psql -d [yourdatabase] -f spatial_ref_sys.sql - + + + 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