From 725128289398ba4bce60a4093d9d69bbcea01d92 Mon Sep 17 00:00:00 2001 From: John Paulett Date: Wed, 3 Oct 2012 20:06:05 +0200 Subject: [PATCH] Fixed #17207 -- Added a troubleshooting note about failing createdb --- docs/ref/contrib/gis/install.txt | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/ref/contrib/gis/install.txt b/docs/ref/contrib/gis/install.txt index 0ce8253210..355fb55a47 100644 --- a/docs/ref/contrib/gis/install.txt +++ b/docs/ref/contrib/gis/install.txt @@ -757,6 +757,21 @@ Similarly, on Red Hat and CentOS systems:: $ sudo yum install binutils +PostgreSQL's createdb fails +--------------------------- + +When the PostgreSQL cluster uses a non-UTF8 encoding, the +:file:`create_template_postgis-*.sh` script will fail when executing +``createdb``:: + + createdb: database creation failed: ERROR: new encoding (UTF8) is incompatible + with the encoding of the template database (SQL_ASCII) + +The `current workaround`__ is to re-create the cluster using UTF8 (back up any +databases before dropping the cluster). + +__ http://jacobian.org/writing/pg-encoding-ubuntu/ + Platform-specific instructions ==============================