[postgis-commits] svn - r2921 - trunk/doc
postgis-commits at postgis.refractions.net
postgis-commits at postgis.refractions.net
Fri Aug 22 05:14:47 PDT 2008
Author: robe
Date: 2008-08-22 05:14:47 -0700 (Fri, 22 Aug 2008)
New Revision: 2921
Modified:
trunk/doc/installation.xml
Log:
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.
Modified: trunk/doc/installation.xml
===================================================================
--- trunk/doc/installation.xml 2008-08-21 11:27:54 UTC (rev 2920)
+++ trunk/doc/installation.xml 2008-08-22 12:14:47 UTC (rev 2921)
@@ -84,50 +84,54 @@
require recompiling your PostgreSQL from scratch, of course.</para>
</note>
</listitem>
+
+ <para><note>The steps that follow are for Linux users. They will not work on Windows without MingW and some other stuff</note></para>
+ <listitem>
+ <para>Check your settings to see which versions of things will be used</para>
+ <programlisting>
+ 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
+ </programlisting>
+ </listitem>
+
+ <listitem>
+ <para>If you are missing proj based on above or running a version below 4.5, then install by following these steps.</para>
+ <programlisting>
+ 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 ..
+ </programlisting>
+ </listitem>
- <listitem>
+ <listitem>
+ <para>If you are missing geos based on above or running a version below 3.0, then install by following these steps.</para>
+ <programlisting>
+ 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 ..
+ </programlisting>
+ </listitem>
+
+ <listitem>
<para>Retrieve the PostGIS source archive from <ulink
- url="http://postgis.refractions.net/postgis-&last_release_version;.tar.gz">http://postgis.refractions.net/postgis-&last_release_version;.tar.gz</ulink>.
- Uncompress and untar the archive.</para>
-
- <programlisting># gzip -d -c postgis-&last_release_version;.tar.gz | tar xvf -</programlisting>
- </listitem>
-
- <listitem>
- <para>Enter the postgis-&last_release_version; directory, and run:
- <programlisting># ./configure</programlisting></para>
-
- <itemizedlist>
- <listitem>
- <para>PostgreSQL provides a utility called <filename>pg_config</filename> to enable
- extensions like PostGIS to locate the PostgreSQL installation directory.
- If ./configure didn't find <filename>pg_config</filename>,
- try using the <code>--with-pgconfig=/path/to/pg_config</code> switch to specify a particular
- PostgreSQL installation.</para>
- </listitem>
-
- <listitem>
- <para>Proj4 is now required in order to build and use PostGIS.
- If ./configure didn't find the Proj4 library,
- try using the <code>--with-projdir=/path/to/projdir</code> switch to specify an alternative
- Proj4 installation directory.</para>
- </listitem>
-
- <listitem>
- <para>GEOS is now required in order to build and use PostGIS.
- If ./configure didn't find it, try using the
- <code>--with-geosconfig=/path/to/geos-config</code> switch to specify the full path
- to the <filename>geos-config</filename> program.</para>
- </listitem>
- </itemizedlist>
- </listitem>
-
- <listitem>
- <para>Run the compile and install commands.</para>
-
- <programlisting># make # make install</programlisting>
-
- <para>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</ulink>.
+ Uncompress and untar the archive. configure.</para>
+
+ <para>All files are installed using information provided by
<filename>pg_config</filename></para>
<itemizedlist>
@@ -147,40 +151,81 @@
<filename>[bindir]/</filename>.</para>
</listitem>
</itemizedlist>
- </listitem>
- <listitem>
- <para>PostGIS requires the PL/pgSQL procedural language extension.
- Before loading the <filename>lwpostgis.sql</filename> file, you must
- first enable PL/pgSQL. You should use the
- <filename>createlang</filename> command. The PostgreSQL Programmer's
- Guide has the details if you want to this manually for some
- reason.</para>
+ <programlisting>
+ 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
+ </programlisting>
+ </listitem>
+
+
+ <listitem>
+ <para>Make and Install</para>
+ <itemizedlist>
+ <listitem>
+ <para>PostgreSQL provides a utility called <filename>pg_config</filename> to enable
+ extensions like PostGIS to locate the PostgreSQL installation directory.
+ If ./configure didn't find <filename>pg_config</filename>,
+ try using the <code>--with-pgconfig=/path/to/pg_config</code> switch to specify a particular
+ PostgreSQL installation.</para>
+ </listitem>
- <programlisting># createlang plpgsql [yourdatabase]</programlisting>
- </listitem>
+ <listitem>
+ <para>Proj4 is now required in order to build and use PostGIS.
+ If ./configure didn't find the Proj4 library,
+ try using the <code>--with-projdir=/path/to/projdir</code> switch to specify an alternative
+ Proj4 installation directory.</para>
+ </listitem>
- <listitem>
- <para>Now load the PostGIS object and function definitions into your
- database by loading the <filename>lwpostgis.sql</filename> definitions
- file.</para>
+ <listitem>
+ <para>GEOS is now required in order to build and use PostGIS.
+ If ./configure didn't find it, try using the
+ <code>--with-geosconfig=/path/to/geos-config</code> switch to specify the full path
+ to the <filename>geos-config</filename> program.</para>
+ </listitem>
+ </itemizedlist>
+ <programlisting>
+ make clean && make
+ sudo make install
+ sudo ldconfig
+ </programlisting>
+ </listitem>
+
- <programlisting># psql -d [yourdatabase] -f lwpostgis.sql</programlisting>
+ <listitem>
+ <para>PostGIS requires the PL/pgSQL procedural language extension.
+ Before loading the <filename>lwpostgis.sql</filename> file, you must
+ first enable PL/pgSQL. You should use the
+ <filename>createlang</filename> command. The PostgreSQL Programmer's
+ Guide has the details if you want to this manually for some
+ reason.</para>
+
+ <programlisting># createlang plpgsql [yourdatabase]</programlisting>
+ </listitem>
+
+ <listitem>
+ <para>Now load the PostGIS object and function definitions into your
+ database by loading the <filename>lwpostgis.sql</filename> definitions
+ file.</para>
+
+ <programlisting># psql -d [yourdatabase] -f lwpostgis.sql</programlisting>
+
+ <para>The PostGIS server extensions are now loaded and ready to
+ use.</para>
+ </listitem>
+
+ <listitem>
+ <para>For a complete set of EPSG coordinate system definition
+ identifiers, you can also load the
+ <filename>spatial_ref_sys.sql</filename> definitions file and populate
+ the <varname>SPATIAL_REF_SYS</varname> table.</para>
+
+ <programlisting># psql -d [yourdatabase] -f spatial_ref_sys.sql</programlisting>
+ </listitem>
- <para>The PostGIS server extensions are now loaded and ready to
- use.</para>
- </listitem>
-
- <listitem>
- <para>For a complete set of EPSG coordinate system definition
- identifiers, you can also load the
- <filename>spatial_ref_sys.sql</filename> definitions file and populate
- the <varname>SPATIAL_REF_SYS</varname> table.</para>
-
- <programlisting># psql -d [yourdatabase] -f spatial_ref_sys.sql</programlisting>
- </listitem>
- </orderedlist>
-
<sect2 id="templatepostgis">
<title>Creating PostGIS spatially-enabled databases from an in-built
template</title>
@@ -339,6 +384,7 @@
</listitem>
</orderedlist>
</sect2>
+ </orderedlist>
</sect1>
<sect1>
More information about the postgis-commits
mailing list