Skip to content

Commit 9d90e05

Browse files
committed
Mention how to use psql environment variables in long install version and how to test extensions.
References #2214 for PostGIS 3.0 git-svn-id: http://svn.osgeo.org/postgis/trunk@16987 b70326c6-7e19-0410-871a-916f4a2858ee
1 parent 9969841 commit 9d90e05

File tree

1 file changed

+12
-31
lines changed

1 file changed

+12
-31
lines changed

doc/installation.xml

Lines changed: 12 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -310,13 +310,13 @@ tar -xvzf postgis-&last_release_version;.tar.gz</programlisting>
310310
svn
311311
</ulink>
312312
repository
313-
<ulink url="http://svn.osgeo.org/postgis/trunk/">
314-
http://svn.osgeo.org/postgis/trunk/
313+
<ulink url="https://svn.osgeo.org/postgis/trunk/">
314+
https://svn.osgeo.org/postgis/trunk/
315315
</ulink>
316316
.
317317
</para>
318318

319-
<programlisting>svn checkout http://svn.osgeo.org/postgis/trunk/ postgis-&last_release_version;</programlisting>
319+
<programlisting>svn checkout https://svn.osgeo.org/postgis/trunk/ postgis-&last_release_version;</programlisting>
320320

321321
<para>
322322
Change into the newly created
@@ -678,39 +678,20 @@ tar -xvzf postgis-&last_release_version;.tar.gz</programlisting>
678678
<command>make comments</command>
679679
</para>
680680
<para>Building the comments is not necessary if you are building from a release tar ball since these are packaged pre-built with the tar ball already.</para>
681-
<para>If you are building against PostgreSQL 9.1, the extensions should automatically build as part of the make install process. You can if needed build from the extensions
681+
<para>The extensions should automatically build as part of the make install process. You can if needed build from the extensions
682682
folders or copy files if you need them on a different server. </para>
683683
<programlisting>cd extensions
684684
cd postgis
685685
make clean
686686
make
687+
export PGUSER=postgres #overwrite psql variables
688+
make check #to test before install
687689
make install
688-
cd ..
689-
cd postgis_topology
690-
make clean
691-
make
692-
make install
693-
cd ..
694-
cd postgis_sfcgal
695-
make clean
696-
make
697-
make install
698-
699-
cd ..
700-
cd address_standardizer
701-
make clean
702-
make
703-
make install
704-
make installcheck
705-
706-
cd ..
707-
cd postgis_tiger_geocoder
708-
make clean
709-
make
710-
make install
711-
make installcheck
712-
</programlisting>
713-
<para>The extension files will always be the same for the same version of PostGIS regardless of OS, so it is fine to copy over the extension files from one OS to another as long as you
690+
# to test extensions
691+
make check RUNTESTFLAGS=--extension</programlisting>
692+
<note><para><code>make check</code> uses psql to run tests and as such can use psql environment variables.
693+
Common ones useful to override are <varname>PGUSER</varname>,<varname>PGPORT</varname>, and <varname>PGHOST</varname>. Refer to <ulink url="https://www.postgresql.org/docs/current/libpq-envars.html">psql environment variables</ulink> </para></note>
694+
<para>The extension files will always be the same for the same version of PostGIS and PostgreSQL regardless of OS, so it is fine to copy over the extension files from one OS to another as long as you
714695
have the PostGIS binaries already installed on your servers. </para>
715696
<para>If you want to install the extensions manually on a separate server different from your development,
716697
You need to copy the following files from the extensions folder into the <filename>PostgreSQL / share / extension</filename> folder
@@ -826,7 +807,7 @@ CREATE EXTENSION postgis_tiger_geocoder FROM unpackaged;
826807
<para>
827808
If you configured PostGIS using non-standard PostgreSQL, GEOS, or
828809
Proj4 locations, you may need to add their library locations to the
829-
LD_LIBRARY_PATH environment variable.
810+
<varname>LD_LIBRARY_PATH</varname> environment variable.
830811
</para>
831812
</note>
832813

0 commit comments

Comments
 (0)