Changes between Version 66 and Version 67 of GeoDjangoInstall

Timestamp:

Aug 27, 2008, 7:24:21 PM (16 years ago)

Author:

springmeyer

Comment:

Cleaned up GEOS lib details for GeoDjango install notes

GeoDjangoInstall

@@ -71 +71 @@
 }}}
 
-'''Troubleshooting:''' The libgeos is a dependency of both GeoDjango directly and PostGIS. If you get errors like 'Could not find the GEOS library (tried "geos_c")' during `syncdb` or when loading the postgis functions into your database (see below), then the library is either not installed or properly linked.
- * The path to the GEOS library may be manually specified by setting `GEOS_LIBRARY_PATH` in your settings with the full path to the GEOS library (e.g., `/path/to/libgeos_c.so` for linux or `/path/to/libgeos_c.dylib` file for mac).
- * You should also confirm at this time (if running linux) that the GEOS lib dir, likely `/usr/local/lib` is within `/etc/ld.so.conf`, then run:
+'''Troubleshooting:''' The libgeos is a dependency of both GeoDjango directly and PostGIS. If you get errors like `Could not find the GEOS library (tried "geos_c")` during `syncdb` or when loading the postgis functions into your database (see below), then the library is either not installed or properly linked.
+ * You should first make sure that the directory which the GEOS C library was installed in is properly linked.
+  * This location is usually `usr/local/lib` on unix systems and can be linked on linux by confirming that `/usr/local/lib` is within `/etc/ld.so.conf` and then running:
 {{{
 $ ldconfig
 }}}
- * Then make sure to log out and back in (and if the error occured during postgis function insert then restart the PostgreSQL server)
+  * It can also be set as an env variable on Linux by placing `export LD_LIBRARY_PATH=/usr/local/lib` in your bash_profile.
+  * It can be set as an env variable on Mac by placing `export DYLD_LIBRARY_PATH=/usr/local/lib` in your bash_profile.
+ * As a backup option, the path to the GEOS library may be manually specified by setting `GEOS_LIBRARY_PATH` in your settings.py with the full path to the GEOS library (e.g., `/path/to/libgeos_c.so` for linux or `/path/to/libgeos_c.dylib` file for mac).
+ * '''Note''': If the error occured during postgis function insert then restart the PostgreSQL server after making these changes.
 
 === PROJ.4 ===
@@ -180 +183 @@
 }}}
 
- * '''Troubleshooting''': if you experience errors about not finding libraries, you should confirm that libgeos.so (.dylib on mac) has been properly installed prior to configuring PostGIS. Otherwise you will need to rebuild PostGIS. If it was built and installed properly you may need to adjust your `LD_LIBRARY_PATH`, or DYLD_LIBRARY_PATH (on mac). (This environment can also be configured system-wide on linux by editing `/etc/ld.so.conf` and running `ldconfig`)
-  * Hint: Most of the times the libraries you are looking for are in '/usr/local/lib', but geos in particular will output its install location during the `make install` step.
+ * '''Troubleshooting''': if you experience errors about not finding libraries, you should confirm that libgeos.so (.dylib on mac) has been '''properly installed and linked''' prior to configuring PostGIS. Otherwise you will need to rebuild PostGIS. If it was built and installed properly you may need to adjust your `LD_LIBRARY_PATH`, or DYLD_LIBRARY_PATH (on mac). (This environment can also be configured system-wide on linux by editing `/etc/ld.so.conf` and running `ldconfig`)
+  * Hint: Most of the time the libraries you are looking for are in '/usr/local/lib', but geos in particular will output its install location during the `make install` step.
   * Sometimes the errors are too many and not descriptive (i.e. operation aborted), in that cases use the '-s' switch on psql to debug step by step. On Solaris platforms use the `crle` utility to configure the runtime linking environment.