Changes between Version 109 and Version 110 of WKTRaster/Documentation01

Timestamp:

04/20/11 10:39:22 (2 years ago)

Author:

jorgearevalo

Comment:

Compile and install instructions updated.

WKTRaster/Documentation01

@@ -132 +132 @@
 
 
-Windows and Linux binaries are available in the [wiki:WKTRaster PostGIS Raster Home Page].
+Windows and Linux binaries are available in the [wiki:WKTRaster PostGIS Raster Home Page]. A Windows how-to can be found [http://gis4free.wordpress.com/2011/03/10/how-to-install-and-configure-postgis-raster-on-windows/ here]
 
 == '''2.3 - Compiling and Installing from Sources''' ==
@@ -138 +138 @@
 
 '''2.3.1 - Compiling on Linux'''[[BR]][[BR]]
- 1. Follow the [http://postgis.refractions.net/documentation/manual-1.3/ch02.html instructions to compile PostGIS].
-
- 2. Get the PostGIS Raster source code. You have two options:
-
-  * Download the latest development snapshot from http://postgis.refractions.net/download/
-
-  * Using a SVN client, retrieve the very last PostGIS Raster source from http://svn.osgeo.org/postgis/spike/wktraster. In this case you will have to generate the "configure" script with autogen:
-
-{{{
->./autogen.sh
-}}}
-
- 3. From the wktraster directory, run: 
-
-{{{
->./configure --with-postgis-sources=/thesrc/postgis-version
-}}}
-
- 
- 4. Run the compile and install commands:
-
-
-{{{
->make & make 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.
-
-
-'''2.3.2 - Compiling on Windows using MSYS/MinGW'''
-
- 1. Compile PostGIS [wiki:UsersWikiWinCompile using these instructions].
-
- 2. Get GDAL 1.7.1 sources from [http://trac.osgeo.org/gdal/wiki/DownloadSource] and extract (you need this for advanced features like ST_DumpAsPolygons).
-
- 3. Configure the GDAL build without libtool. (Refer to [http://trac.osgeo.org/gdal/ticket/3465].)
-    
-{{{
->cd /c/projects/GDAL/gdal-1.7.1
->./configure --without-libtool --with-libtiff=internal --with-libz=/c/gtk/include
-}}}
- 
- 4. Edit /c/thesrc/gdal/gdal-1.7.1/GNUMakefile so that GDAL_OBJ, at the beginning of the file, is assigned like this:
-
-{{{
- GDAL_OBJ = ./frmts/o/*.o \
-            ./gcore/*.o \
-            ./port/*.o \
-            ./alg/*.o
-}}}
-
- 5. Build and install GDAL.
-
-{{{
->make clean && make
->make install
-}}}
-
- libgdal.dll should now exist in /usr/local/lib
-
- 6. You can remove the debug information from libgdal.dll:
-
-{{{
->strip /usr/local/lib/libgdal.dll
-}}}
-
-
- 7. Get the PostGIS Raster source code. You have two options:
-
-  * Download the latest development snapshot from http://postgis.refractions.net/download/
-
-  * Using a SVN client, retrieve the very last PostGIS Raster source from http://svn.osgeo.org/postgis/spike/wktraster. In this case you will have to generate the "configure" script with autogen:
-
-{{{
->./autogen.sh
-}}}
-
- 8. CD to the wktraster folder and configure (if you don't want to build with GDAL leave out the --enable-development line).
-
-{{{
->cd /c/thesrc/wktraster-svn
->./configure \
-      --prefix=/c/postgres --with-postgis-sources=/c/thesrc/postgis-version --with-pgconfig=/c/postgres/bin/pg_config
-}}}
-
- 9. Run the compile and install commands:
-
-{{{
->make & make install
-}}}
-
- '''Troubleshouting'''
-
- * If make tries to compile using "cc" and can't find it (you get "cc: Command not found"). Try copying gcc to cc in MinGW/bin.
- * If you get an error like this: ''ERROR: could not load library "c:/postgres/lib/rtpostgis.dll": The specified module could not be found'', simply add the /c/postgres/lib directory to PATH enviroment variable: export PATH=/c/postgres/lib/:$PATH
-
-'''2.3.3 - Compiling on Windows using Visual Studio'''
-
+
+As [http://gis4free.wordpress.com/2010/10/01/wkt-raster-is-now-postgis-raster/ PostGIS Raster is official part of PostGIS], you only need to compile PostGIS using special flag '--with-raster' in configure time. So, you'll first have to get the last PostGIS development snapshot from [http://postgis.refractions.net/download/postgis-2.0.0SVN.tar.gz here]. Or using a SVN client, checkout from [http://svn.osgeo.org/postgis/trunk here]
+
+Example with console SVN client:
+
+{{{
+>. svn checkout http://svn.osgeo.org/postgis/trunk postgis-svn
+}}}
+
+Now, in case you checked out the code with a SVN client, you'll need to generate the configure script with:
+
+{{{
+>/autogen.sh
+}}}
+
+In case you got the last development snapshot, the configure script is packed with the code. The next steps are:
+
+{{{
+>./configure --with-raster
+> make
+> sudo make install
+}}}
+
+Now, you have PostGIS 2.0 with PostGIS Raster extension installed in your system.
+
+
+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.
+
+
+'''2.3.2 - Compiling on Windows'''
+
+Instructions are [wiki:UsersWikiWinCompile here]. Simply add '--with-raster' when invoking configure scripts.
 
 
 '''2.3.4 - Final Installation'''
 
- 1. Load the PostGIS Raster object and function definitions into your database by loading the rtpostgis.sql definitions file.
-
-{{{
->psql -d [yourdatabase] -f rtpostgis.sql
-}}}
-
- You can also do this directly in a pgAdmin III query dialog box if you administer your database using this software.
- 
- The PostGIS Raster extension should now be loaded and ready to use.
-
- All files are installed using information provided by pg_config:
+To create a new database and activate it with PostGIS and PostGIS Raster extensions, execute these steps from a console:
+
+{{{
+> createdb <your_database>
+}}}
+
+{{{
+> createlang plpgsql <your_database>
+}}}
+
+{{{
+> psql -U <your_user> -f postgis/postgis.sql -d <your_database>
+}}}
+
+{{{
+> psql -U <your user> -f spatial_ref_sys.sql -d <your_database>
+}}}
+
+{{{
+> psql -U <your user> -f raster/rt_pg/rtpostgis.sql -d <your_database>
+}}}
+
+You can also do this directly in a pgAdmin III query dialog box if you administer your database using this software.
+
+The PostGIS Raster extension should now be loaded and ready to use. All files are installed using information provided by pg_config:
 
    * Core functionality (rtpostgis shared library) is installed in [pkglibdir]/lib/
@@ -257 +204 @@
    * SQL function file (rtpostgis.sql) is installed in [prefix]/share/contrib/
 
-   * Loader (gdal2wktraster.py) is installed in [bindir]/
+   * Loader (raster2pgsql.py) is installed in [bindir]/
+
+
+Further information [http://gis4free.wordpress.com/2010/10/01/wkt-raster-is-now-postgis-raster/ here].