amorfo77/sogo
1
0
Fork 0
mirror of https://github.com/inverse-inc/sogo.git synced 2026-04-03 04:18:51 +00:00
Code Issues Projects Releases Wiki Activity

(doc) Add caveat on using a database host alias

Browse Source
This commit is contained in:
Jens Erat
2016-04-01 11:45:45 +02:00
committed by Ludovic Marcotte
parent 35ed24511d
commit 2b13db1d0e
1 changed files with 20 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
Documentation/SOGoInstallationGuide.asciidoc
View File

@@ -1346,6 +1346,26 @@ supported, such as MySQL and Oracle.
First, make sure that your PostgreSQL server has TCP/IP connections
support enabled.
*Caveat: SOGo stores the database hostname together with table references
inside several database tables.* To prevent possible future issues when moving
the database to another host, it is best practice to add a local alias name to
your `/etc/hosts` file, and using this in `/etc/sogo/sogo.conf` instead of the
actual name of your server or localhost. When the database host name changes,
you can now simply change the hosts file instead of updating several table
columns replacing the old hostname. An example entry for `/etc/hosts` when
running the database on the same host, registering `127.0.0.1` not only for
`localhost`, but also the `db-alias` alias:
127.0.0.1 localhost db-alias
In the SOGo configuration, use the alias name instead of the real IP address or
host name, for example
----
SOGoProfileURL =
"postgresql://sogo:sogo@db-alias:5432/sogo/sogo_user_profile";
----
Create the database user and schema using the following commands:
----