mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Doc: update example connection-failure messages in the documentation.

Browse Source 
Now that the dust has more or less settled on 52a10224e and follow-ons,
make sure the examples in the documentation are up-to-date.
This commit is contained in:
Tom Lane 2021-01-23 15:50:51 -05:00
parent 68d1c33941
commit 183bbd1b6d
2 changed files with 18 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
doc/src/sgml/runtime.sgml
View File

@ -629,9 +629,8 @@ DETAIL: Failed system call was semget(5440126, 17, 03600).
<para> <para>
<screen> <screen>
psql: could not connect to server: Connection refused psql: error: connection to server at "server.joe.com" (123.123.123.123), port 5432 failed: Connection refused
Is the server running on host "server.joe.com" and accepting Is the server running on that host and accepting TCP/IP connections?
TCP/IP connections on port 5432?
</screen> </screen>
This is the generic <quote>I couldn't find a server to talk This is the generic <quote>I couldn't find a server to talk
to</quote> failure. It looks like the above when TCP/IP to</quote> failure. It looks like the above when TCP/IP
@ -640,19 +639,22 @@ psql: could not connect to server: Connection refused
</para> </para>
<para> <para>
Alternatively, you'll get this when attempting Unix-domain socket Alternatively, you might get this when attempting Unix-domain socket
communication to a local server: communication to a local server:
<screen> <screen>
psql: could not connect to server: No such file or directory psql: error: connection to server on socket "/tmp/.s.PGSQL.5432" failed: No such file or directory
Is the server running locally and accepting Is the server running locally and accepting connections on that socket?
connections on Unix domain socket "/tmp/.s.PGSQL.5432"?
</screen> </screen>
If the server is indeed running, check that the client's idea of the
socket path (here <literal>/tmp</literal>) agrees with the server's
<xref linkend="guc-unix-socket-directories"/> setting.
</para> </para>
<para> <para>
The last line is useful in verifying that the client is trying to A connection failure message always shows the server address or socket
path name, which is useful in verifying that the client is trying to
connect to the right place. If there is in fact no server connect to the right place. If there is in fact no server
running there, the kernel error message will typically be either listening there, the kernel error message will typically be either
<computeroutput>Connection refused</computeroutput> or <computeroutput>Connection refused</computeroutput> or
<computeroutput>No such file or directory</computeroutput>, as <computeroutput>No such file or directory</computeroutput>, as
illustrated. (It is important to realize that illustrated. (It is important to realize that
@ -663,7 +665,7 @@ psql: could not connect to server: No such file or directory
linkend="client-authentication-problems"/>.) Other error messages linkend="client-authentication-problems"/>.) Other error messages
such as <computeroutput>Connection timed out</computeroutput> might such as <computeroutput>Connection timed out</computeroutput> might
indicate more fundamental problems, like lack of network indicate more fundamental problems, like lack of network
connectivity. connectivity, or a firewall blocking the connection.
</para> </para>
</sect2> </sect2>
</sect1> </sect1>

13
doc/src/sgml/start.sgml
View File

@ -176,19 +176,18 @@ createdb: command not found
<para> <para>
Another response could be this: Another response could be this:
<screen> <screen>
createdb: could not connect to database postgres: could not connect to server: No such file or directory createdb: error: connection to server on socket "/tmp/.s.PGSQL.5432" failed: No such file or directory
Is the server running locally and accepting Is the server running locally and accepting connections on that socket?
connections on Unix domain socket "/tmp/.s.PGSQL.5432"?
</screen> </screen>
This means that the server was not started, or it was not started This means that the server was not started, or it is not listening
where <command>createdb</command> expected it. Again, check the where <command>createdb</command> expects to contact it. Again, check the
installation instructions or consult the administrator. installation instructions or consult the administrator.
</para> </para>
<para> <para>
Another response could be this: Another response could be this:
<screen> <screen>
createdb: could not connect to database postgres: FATAL: role "joe" does not exist createdb: error: connection to server on socket "/tmp/.s.PGSQL.5432" failed: FATAL: role "joe" does not exist
</screen> </screen>
where your own login name is mentioned. This will happen if the where your own login name is mentioned. This will happen if the
administrator has not created a <productname>PostgreSQL</productname> user account administrator has not created a <productname>PostgreSQL</productname> user account
@ -208,7 +207,7 @@ createdb: could not connect to database postgres: FATAL: role "joe" does not ex
If you have a user account but it does not have the privileges required to If you have a user account but it does not have the privileges required to
create a database, you will see the following: create a database, you will see the following:
<screen> <screen>
createdb: database creation failed: ERROR: permission denied to create database createdb: error: database creation failed: ERROR: permission denied to create database
</screen> </screen>
Not every user has authorization to create new databases. If Not every user has authorization to create new databases. If
<productname>PostgreSQL</productname> refuses to create databases <productname>PostgreSQL</productname> refuses to create databases