Repository navigation
Commit 2b2a3fd
committed
docs(5.2): explain the two listening ports of an Oracle-mode cluster
5.2.adoc is the page that first tells a reader to connect to port 1521, and
the tip there does not say what that port is. Two silent mistakes follow
from that:
- show port / show ivorysql.port print 5432 and 1521 on either port, so
they look like a way to check the compatibility mode;
- SET ivorysql.compatible_mode = 'oracle' from 5432 succeeds, and the next
connection is pg again, because the value is re-derived from the port.
And the obvious next step after "use 1521" -- making 1521 the main port --
stops the server from starting, with a message that points at the wrong
cause: "could not bind IPv4 address 127.0.0.1: Address already in use",
hinted as "Is another postmaster already running on port 1521?", while the
process holding the port is this cluster's own Oracle listener. The real
FATAL is "could not create any Oracle TCP/IP sockets".
Add a "Dual listening ports" section after that tip and before the data
type section, in both CN and EN:
- port (default 5432) routes to the PostgreSQL parser and ivorysql.port
(default 1521) to the Oracle-compatible parser; one postmaster owns
both sockets and both defaults are built in;
- the mode is decided when the connection is established, from the local
port on the server side, shown with the two psql invocations and their
output (oracle | 1521 | 5432 versus pg | 1521 | 5432);
- read current_setting('ivorysql.compatible_mode') to find out the mode of
the current session; show port / show ivorysql.port cannot tell;
- SET works within a session but does not survive reconnecting, while
ivorysql.database_mode is a cluster property written into pg_control;
- the two ports must differ; neither pg_ctl -o "-p 1521" (which overrides
port only) nor "port = 1521" in postgresql.conf can move the Oracle
port, with the four log lines that result;
- to change it, set ivorysql.port to another value and keep port = 5432;
afterwards the new port gives oracle and 5432 gives pg;
- the second listener exists only on Oracle-mode clusters
(DB_ORACLE == database_mode); a PostgreSQL-mode cluster listens on port
alone.
Insertion only: 2 files changed, 138 insertions(+), 69 lines per language,
no existing line modified. Verified with 4 Antora builds (CN/EN, base and
patched, all exit 0), zero warnings from 5.2.adoc, unchanged site-wide
warning set (CN 4->4, EN 8->8), identical rendered counters in both
languages (<tr> 2->7, <td> 4->17, <h3> 8->9), and the 11 pre-existing
section anchor ids untouched.
Closes #3781 parent 7c3f4a6 commit 2b2a3fd
2 files changed
Lines changed: 138 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
72 | 72 | | |
73 | 73 | | |
74 | 74 | | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
| 95 | + | |
| 96 | + | |
| 97 | + | |
| 98 | + | |
| 99 | + | |
| 100 | + | |
| 101 | + | |
| 102 | + | |
| 103 | + | |
| 104 | + | |
| 105 | + | |
| 106 | + | |
| 107 | + | |
| 108 | + | |
| 109 | + | |
| 110 | + | |
| 111 | + | |
| 112 | + | |
| 113 | + | |
| 114 | + | |
| 115 | + | |
| 116 | + | |
| 117 | + | |
| 118 | + | |
| 119 | + | |
| 120 | + | |
| 121 | + | |
| 122 | + | |
| 123 | + | |
| 124 | + | |
| 125 | + | |
| 126 | + | |
| 127 | + | |
| 128 | + | |
| 129 | + | |
| 130 | + | |
| 131 | + | |
| 132 | + | |
| 133 | + | |
| 134 | + | |
| 135 | + | |
| 136 | + | |
| 137 | + | |
| 138 | + | |
| 139 | + | |
| 140 | + | |
| 141 | + | |
| 142 | + | |
| 143 | + | |
75 | 144 | | |
76 | 145 | | |
77 | 146 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
74 | 74 | | |
75 | 75 | | |
76 | 76 | | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
| 95 | + | |
| 96 | + | |
| 97 | + | |
| 98 | + | |
| 99 | + | |
| 100 | + | |
| 101 | + | |
| 102 | + | |
| 103 | + | |
| 104 | + | |
| 105 | + | |
| 106 | + | |
| 107 | + | |
| 108 | + | |
| 109 | + | |
| 110 | + | |
| 111 | + | |
| 112 | + | |
| 113 | + | |
| 114 | + | |
| 115 | + | |
| 116 | + | |
| 117 | + | |
| 118 | + | |
| 119 | + | |
| 120 | + | |
| 121 | + | |
| 122 | + | |
| 123 | + | |
| 124 | + | |
| 125 | + | |
| 126 | + | |
| 127 | + | |
| 128 | + | |
| 129 | + | |
| 130 | + | |
| 131 | + | |
| 132 | + | |
| 133 | + | |
| 134 | + | |
| 135 | + | |
| 136 | + | |
| 137 | + | |
| 138 | + | |
| 139 | + | |
| 140 | + | |
| 141 | + | |
| 142 | + | |
| 143 | + | |
| 144 | + | |
| 145 | + | |
77 | 146 | | |
78 | 147 | | |
79 | 148 | | |
| |||
0 commit comments