From 8c13cd804b546ddad4fc29bbad471567d4ee146f Mon Sep 17 00:00:00 2001 From: Mark Cave-Ayland Date: Sat, 2 Aug 2008 08:24:21 +0000 Subject: [PATCH] A long overdue documentation update - update the installation section to reflect the many changes in the new SVN trunk build system. git-svn-id: http://svn.osgeo.org/postgis/trunk@2909 b70326c6-7e19-0410-871a-916f4a2858ee --- doc/installation.xml | 93 ++++++++++++++++++++++---------------------- 1 file changed, 46 insertions(+), 47 deletions(-) diff --git a/doc/installation.xml b/doc/installation.xml index abd413366..64a54ee35 100644 --- a/doc/installation.xml +++ b/doc/installation.xml @@ -13,7 +13,7 @@ A complete installation of PostgreSQL (including server headers). PostgreSQL is available from http://www.postgresql.org. - Version 7.2 or higher is required. + Version 8.1 or higher is required. @@ -32,19 +32,25 @@ - (Recommended) Proj4 reprojection library. The Proj4 library is + Proj4 reprojection library. The Proj4 library is used to provide coordinate reprojection support within PostGIS. Proj4 is available for download from http://www.remotesensing.org/proj. - (Recommended) GEOS geometry library. The GEOS library is used to + GEOS geometry library. The GEOS library is used to provide geometry tests (ST_Touches(), ST_Contains(), ST_Intersects()) and operations (ST_Buffer(), ST_Union(), ST_Difference()) within PostGIS. GEOS is available for download from http://geos.refractions.net. + + + (Recommended) Apache Ant (ant). Required for + building any of the drivers under the java directory. + + @@ -58,7 +64,7 @@ url="http://www.postgresql.org">http://www.postgresql.org. PostGIS &last_release_version; can be built against PostgreSQL - versions 7.2.0 or higher. Earlier versions of PostgreSQL are + versions 8.1.0 or higher. Earlier versions of PostgreSQL are not supported. @@ -93,17 +99,25 @@ - If you want support for coordinate reprojection, you must - have the Proj4 library installed. If ./configure didn't find it, - try using --with-proj=PATH switch specify a specific + 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 specify a specific + 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 specify a specific Proj4 installation directory. - If you want to use GEOS functionality, you must have the - GEOS library installed. If ./configure didn't find it, try using - --with-geos=PATH to specify the full path to the - geos-config program full path. + 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. @@ -293,23 +307,12 @@ newdb=> \i spatial_ref_sys.sql - It is easiest if you untar the PostGIS distribution into the - contrib directory under the PostgreSQL source tree. However, if this - is not possible for some reason, you can set the - PGSQL_SRC environment variable to the path to the - PostgreSQL source directory. This will allow you to compile PostGIS, - but the make install may not work, so be prepared - to copy the PostGIS library and executable files to the appropriate - locations yourself. - - - - Check that you you have installed PostgreSQL 7.2 or newer, and + Check that you you have installed PostgreSQL 8.1 or newer, and that you are compiling against the same version of the PostgreSQL source as the version of PostgreSQL that is running. Mix-ups can occur when your (Linux) distribution has already installed PostgreSQL, or you have otherwise installed PostgreSQL before and - forgotten about it. PostGIS will only work with PostgreSQL 7.2 or + forgotten about it. PostGIS will only work with PostgreSQL 8.1 or newer, and strange, unexpected error messages will result if you use an older version. To check the version of PostgreSQL which is running, connect to the database using psql and run this @@ -324,23 +327,15 @@ newdb=> \i spatial_ref_sys.sql - Also check that you have made any necessary changes to the top of - the Makefile.config. This includes: + Also check that configure has correctly detected the location and + version of PostgreSQL, the Proj4 library and the GEOS library. - If you want to be able to do coordinate reprojections, you - must install the Proj4 library on your system, set the - USE_PROJ variable to 1 and the - PROJ_DIR to your installation prefix in the - Makefile.config. - - - - If you want to be able to use GEOS functions you must install - the GEOS library on your system, and set the - USE_GEOS to 1 and the GEOS_DIR - to your installation prefix in the Makefile.config + The output from configure is used to generate the + postgis_config.h file. Check that the + POSTGIS_PGSQL_VERSION, POSTGIS_PROJ_VERSION + and POSTGIS_GEOS_VERSION variables have been set correctly. @@ -356,22 +351,26 @@ newdb=> \i spatial_ref_sys.sql - Enter the jdbc sub-directory of the PostGIS + Enter the java/jdbc sub-directory of the PostGIS distribution. - Edit the Makefile to provide the correct - paths of your java compiler (JAVAC) and interpreter - (JAVA). - - - - Run the make command. Copy the + Run the ant command. Copy the postgis.jar file to wherever you keep your java libraries. + + The JDBC extensions require a PostgreSQL JDBC driver to be present in + the current CLASSPATH during the build process. If the PostgreSQL JDBC driver + is located elsewhere, you may pass the location of the JDBC driver JAR separately + using the -D parameter like this: + + # ant -Dclasspath=/path/to/postgresql-jdbc.jar + + PostgreSQL JDBC drivers be downloaded from + http://jdbc.postgresql.org. @@ -390,4 +389,4 @@ newdb=> \i spatial_ref_sys.sql tables (or queries) into ESRI Shape files. For more verbose documentation, see the online help, and the manual pages. - \ No newline at end of file + -- 2.50.1