Skip to content

Commit d63790d

Browse files
committed
Clarify user of "postmaster" vs. "server" in FAQs.
Brendan Jurd
1 parent 9f3bd29 commit d63790d

File tree

6 files changed

+28
-28
lines changed

6 files changed

+28
-28
lines changed

doc/FAQ

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -423,10 +423,10 @@
423423

424424
3.5) Why do I get "Sorry, too many clients" when trying to connect?
425425

426-
You have reached the default limit is 100 database sessions. You need
427-
to increase the postmaster's limit on how many concurrent backend
426+
You have reached the default limit of 100 database sessions. You need
427+
to increase the server's limit on how many concurrent backend
428428
processes it can start by changing the max_connections value in
429-
postgresql.conf and restarting the postmaster.
429+
postgresql.conf and restarting the server.
430430

431431
3.6) What is the upgrade process for PostgreSQL?
432432

@@ -753,7 +753,7 @@
753753

754754
You probably have run out of virtual memory on your system, or your
755755
kernel has a low limit for certain resources. Try this before starting
756-
postmaster:
756+
the server:
757757
ulimit -d 262144
758758
limit datasize 256m
759759

doc/FAQ_AIX

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Frequently Asked Questions (FAQ) for PostgreSQL
33
AIX Specific
44
TO BE READ IN CONJUNCTION WITH THE NORMAL FAQ
55
=======================================================
6-
Last updated: $Date: 2006/12/06 15:45:30 $
6+
Last updated: $Date: 2007/10/09 01:28:24 $
77

88
Topics
99

@@ -16,7 +16,7 @@ Topics
1616
-----
1717

1818
From: Zeugswetter Andreas <ZeugswetterA@spardat.at>
19-
$Date: 2006/12/06 15:45:30 $
19+
$Date: 2007/10/09 01:28:24 $
2020

2121
On AIX 4.3.2 PostgreSQL compiled with the native IBM compiler xlc
2222
(vac.C 5.0.1) passes all regression tests. Other versions of OS and
@@ -301,7 +301,7 @@ The cause of these problems
301301
----------------------------
302302

303303
The overall cause of all these problems is the default bittedness and
304-
memory model used by the postmaster process.
304+
memory model used by the server process.
305305

306306
By default, all binaries built on AIX are 32-bit. This does not
307307
depend upon hardware type or kernel in use. These 32-bit processes
@@ -327,10 +327,10 @@ but that's not always practical. Systems with 32-bit processors can
327327
build, but not run, 64-bit binaries.
328328

329329
If a 32-bit binary is desired, set LDR_CNTRL to "MAXDATA=0xn0000000",
330-
where 1 <= n <= 8, before starting the postmaster and try different
330+
where 1 <= n <= 8, before starting the postgres server and try different
331331
values and postgresql.conf settings to find a configuration that works
332332
satisfactorily. This use of LDR_CNTRL tells AIX that you want the
333-
postmaster to have $MAXDATA bytes set aside for the heap, allocated in
333+
server to have $MAXDATA bytes set aside for the heap, allocated in
334334
256MB segments.
335335

336336
When you find a workable configuration, ldedit can be used to modify

doc/FAQ_CYGWIN

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
Installing PostgreSQL on Windows Using Cygwin FAQ
22
=================================================
33

4-
$Date: 2004/10/15 16:18:35 $
4+
$Date: 2007/10/09 01:28:24 $
55

66
PostgreSQL requires the appropriate subset of Cygwin DLLs to be
77
installed in order that it functions under Windows.
@@ -30,8 +30,8 @@ adjust these instructions accordingly.
3030

3131
3a. Start cygserver for shared memory support. To do this,
3232
enter the command "/usr/sbin/cygserver &". This program
33-
needs to be running anytime you start the PostgreSQL server
34-
(postmaster) or initialize a database (initdb).
33+
needs to be running anytime you start the Postgres server
34+
or initialize a database (initdb).
3535

3636
3b. Use the initdb command to create a new database cluster. An
3737
example command would be:
@@ -42,18 +42,18 @@ adjust these instructions accordingly.
4242
directory, will prompt for a superuser password and will
4343
set the default database encoding to LATIN1.
4444

45-
3c. Start up the postmaster. Use a command similar to the
45+
3c. Start up the Postgres server. Use a command similar to the
4646
following:
4747

48-
postmaster -D /usr/local/pgsql/data
48+
postgres -D /usr/local/pgsql/data
4949

50-
This will start the postmaster, and if successful you will
50+
This will start the server, and if successful you will
5151
see some initial log entries, and an entry "LOG: database
5252
system is ready".
5353

5454
4. You are now running a PostgreSQL server on your Windows machine.
5555

56-
5. It is possible to install cygserver and the postmaster as
56+
5. It is possible to install cygserver and the Postgres server as
5757
Windows NT services. For information on how to do this, please
5858
refer to the README document included with Cygwin PostgreSQL. It
5959
is installed in the /usr/share/doc/Cygwin directory.

doc/FAQ_DEV

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -428,7 +428,7 @@ General Questions
428428
4. A README.rpm-dist document that tries to adequately document both
429429
the differences between the RPM build and the WHY of the
430430
differences, as well as useful RPM environment operations (like,
431-
using syslog, upgrading, getting postmaster to start at OS boot,
431+
using syslog, upgrading, getting the server to start at OS boot,
432432
etc);
433433
5. The spec file that throws it all together. This is not a trivial
434434
undertaking in a package of this size.
@@ -755,8 +755,8 @@ typedef struct nameData
755755
(gdb) call print(any_pointer)
756756
(gdb) call pprint(any_pointer)
757757

758-
The output appears in the postmaster log file, or on your screen if
759-
you are running a backend directly without a postmaster.
758+
The output appears in the server log file, or on your screen if
759+
you are running a backend directly.
760760

761761
2.4) I just added a field to a structure. What else should I do?
762762

@@ -782,7 +782,7 @@ typedef struct nameData
782782
ereport() is used to send messages to the front-end, and optionally
783783
terminate the current query being processed. The first parameter is an
784784
ereport level of DEBUG (levels 1-5), LOG, INFO, NOTICE, ERROR, FATAL,
785-
or PANIC. NOTICE prints on the user's terminal and the postmaster
785+
or PANIC. NOTICE prints on the user's terminal and to the server
786786
logs. INFO prints only to the user's terminal and LOG prints only to
787787
the server logs. (These can be changed from postgresql.conf.) ERROR
788788
prints in both places, and terminates the current query, never
@@ -811,7 +811,7 @@ typedef struct nameData
811811
assert()s monitor the progress of the backend and halt the program
812812
when something unexpected occurs.
813813

814-
The postmaster has a -d option that allows even more detailed
814+
The postgres server has a -d option that allows even more detailed
815815
information to be reported. The -d option takes a number that
816816
specifies the debug level. Be warned that high debug level values
817817
generate large log files.

doc/src/FAQ/FAQ.html

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -577,11 +577,11 @@ <H3 id="item3.4">3.4) What debugging features are
577577
<H3 id="item3.5">3.5) Why do I get <I>"Sorry, too many
578578
clients"</I> when trying to connect?</H3>
579579

580-
<P>You have reached the default limit is 100 database sessions. You
581-
need to increase the <I>postmaster</I>'s limit on how many
580+
<P>You have reached the default limit of 100 database sessions. You
581+
need to increase the server's limit on how many
582582
concurrent backend processes it can start by changing the
583583
<I>max_connections</I> value in <I>postgresql.conf</I> and
584-
restarting the <I>postmaster</I>.</P>
584+
restarting the server.</P>
585585

586586
<H3 id="item3.6">3.6) What is the upgrade process for PostgreSQL?</H3>
587587

@@ -991,7 +991,7 @@ <H3 id="item4.13">4.13) Why do I get the error <I>"ERROR:
991991

992992
<P>You probably have run out of virtual memory on your system,
993993
or your kernel has a low limit for certain resources. Try this
994-
before starting <I>postmaster</I>:</P>
994+
before starting the server:</P>
995995
<PRE>
996996
ulimit -d 262144
997997
limit datasize 256m

doc/src/FAQ/FAQ_DEV.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -939,7 +939,7 @@ <H3 id="item2.3">2.3) Why do we use <I>Node</I> and
939939
(gdb) call pprint(any_pointer)
940940
</CODE>
941941
</PRE>
942-
The output appears in the postmaster log file, or on your screen if
942+
The output appears in the server log file, or on your screen if
943943
you are running a backend directly without a postmaster.
944944

945945
<H3 id="item2.4">2.4) I just added a field to a structure.
@@ -972,7 +972,7 @@ <H3 id="item2.6">2.6) What is ereport()?</H3>
972972
parameter is an ereport level of <I>DEBUG</I> (levels 1-5),
973973
<I>LOG,</I> <I>INFO,</I> <I>NOTICE,</I> <I>ERROR,</I> <I>FATAL,</I>
974974
or <I>PANIC.</I> <I>NOTICE</I> prints on the user's terminal and
975-
the postmaster logs. <I>INFO</I> prints only to the user's terminal
975+
to the server logs. <I>INFO</I> prints only to the user's terminal
976976
and <I>LOG</I> prints only to the server logs. (These can be
977977
changed from <I>postgresql.conf.</I>) <I>ERROR</I> prints in both
978978
places, and terminates the current query, never returning from the
@@ -1004,7 +1004,7 @@ <H3 id="item2.8">2.8) What debugging features are available?</H3>
10041004
option, many <I>assert()</I>s monitor the progress of the
10051005
backend and halt the program when something unexpected occurs.</P>
10061006

1007-
<P>The <I>postmaster</I> has a <I>-d</I> option that allows
1007+
<P>The postgres server has a <I>-d</I> option that allows
10081008
even more detailed information to be reported. The <I>-d</I>
10091009
option takes a number that specifies the debug level. Be warned
10101010
that high debug level values generate large log files.</P>

0 commit comments

Comments
 (0)