Ticket #17207: 17207-docs.patch

File 17207-docs.patch, 1.1 KB (added by John Paulett, 12 years ago)

Documentation patch to note issue & workaround

  • docs/ref/contrib/gis/install.txt 

    commit a8f52238084f4cdaa9794ed4d3c25c70a97c5930
Author: John Paulett <john@montagehealthcare.com>
Date:   Mon Mar 12 14:13:23 2012 -0700

    Document failure of create_template_postgis-*.sh when PG cluster uses SQL_ASCII encoding.
    
    Closes #17207

diff --git docs/ref/contrib/gis/install.txt docs/ref/contrib/gis/install.txt
index 06bee69..0b5dfcb 100644
    Similarly, on Red Hat and CentOS systems::  
    732732
    733733    $ sudo yum install binutils
    734734
     735
     736PostgreSQL's createdb fails
     737---------------------------
     738
     739When the PostgreSQL cluster uses a non-UTF8 encoding, the
     740:file:`create_template_postgis-*.sh` script will fail when executing
     741``createdb``::
     742
     743    createdb: database creation failed: ERROR:  new encoding (UTF8) is incompatible
     744      with the encoding of the template database (SQL_ASCII)
     745
     746The `current workaround`__ is to re-create the cluster using UTF8 (back up any
     747databases before dropping the cluster)
     748
     749__ http://jacobian.org/writing/pg-encoding-ubuntu/
     750
     751
    735752Platform-specific instructions
    736753==============================
    737754
Back to Top