citusdata / citusdata/citus_docs

Common error message for psql

Open
#845 0 comments 0 reactions 0 assignees View on GitHub
SE
Dominant language
CSS
Stars
58
Forks
60
PR merge metrics
No merged PRs in 30d

Description

## Communication goals (e.g. detailed howto vs orientation)

People get confused by this error:

```
psql: could not translate host name "example.com" to address: nodename nor servname provided, or not known
```

It just means that the DNS doesn't resolve to an IP address. Provide a suggestion to verify:

```
dig example.com A +short
```

Note that resolving host with a closed port gives a different error:

```
psql: could not connect to server: Operation timed out
Is the server running on host "example.com" (192.0.2.0) and accepting
TCP/IP connections on port 9999?
```

Add this information to our common error messages section.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.