Commit e136a49c authored by Bruce Momjian's avatar Bruce Momjian

Remove FAQ items about IPC errors. We now report the help description

right in the failure.  We can always re-add it if required.
parent 93e17954
Frequently Asked Questions (FAQ) for PostgreSQL
Last updated: Sat Jan 29 22:51:43 EST 2005
Last updated: Sat Jan 29 22:59:12 EST 2005
Current maintainer: Bruce Momjian (pgman@candle.pha.pa.us)
......@@ -38,20 +38,14 @@
3.1) How do I install PostgreSQL somewhere other than
/usr/local/pgsql?
3.2) When I start postmaster, I get a Bad System Call or core dumped
message. Why?
3.3) When I try to start postmaster, I get IpcMemoryCreate errors.
Why?
3.4) When I try to start postmaster, I get IpcSemaphoreCreate errors.
Why?
3.5) How do I control connections from other hosts?
3.6) How do I tune the database engine for better performance?
3.7) What debugging features are available?
3.8) Why do I get "Sorry, too many clients" when trying to connect?
3.9) What is in the pgsql_tmp directory?
3.10) Why do I need to do a dump and restore to upgrade PostgreSQL
3.2) How do I control connections from other hosts?
3.3) How do I tune the database engine for better performance?
3.4) What debugging features are available?
3.5) Why do I get "Sorry, too many clients" when trying to connect?
3.6) What is in the pgsql_tmp directory?
3.7) Why do I need to do a dump and restore to upgrade PostgreSQL
releases?
3.11) What computer hardware should I use?
3.8) What computer hardware should I use?
Operational Questions
......@@ -419,43 +413,7 @@
Specify the --prefix option when running configure.
3.2) When I start postmaster, I get a Bad System Call or core dumped
message. Why?
It could be a variety of problems, but first check to see that you
have System V extensions installed in your kernel. PostgreSQL requires
kernel support for shared memory and semaphores.
3.3) When I try to start postmaster, I get IpcMemoryCreate errors. Why?
You either do not have shared memory configured properly in your
kernel or you need to enlarge the shared memory available in the
kernel. The exact amount you need depends on your architecture and how
many buffers and backend processes you configure for postmaster. For
most systems, with default numbers of buffers and processes, you need
a minimum of ~1 MB. See the PostgreSQL Administrator's Guide/Server
Run-time Environment/Managing Kernel Resources section for more
detailed information about shared memory and semaphores.
3.4) When I try to start postmaster, I get IpcSemaphoreCreate errors. Why?
If the error message is IpcSemaphoreCreate: semget failed (No space
left on device) then your kernel is not configured with enough
semaphores. Postgres needs one semaphore per potential backend
process. A temporary solution is to start postmaster with a smaller
limit on the number of backend processes. Use -N with a parameter less
than the default of 32. A more permanent solution is to increase your
kernel's SEMMNS and SEMMNI parameters.
Inoperative semaphores can also cause crashes during heavy database
access.
If the error message is something else, you might not have semaphore
support configured in your kernel at all. See the PostgreSQL
Administrator's Guide for more detailed information about shared
memory and semaphores.
3.5) How do I control connections from other hosts?
3.2) How do I control connections from other hosts?
By default, PostgreSQL only allows connections from the local machine
using Unix domain sockets or TCP/IP connections. Other machines will
......@@ -463,7 +421,7 @@
postgresql.conf and enable host-based authentication by modifying the
file $PGDATA/pg_hba.conf accordingly.
3.6) How do I tune the database engine for better performance?
3.3) How do I tune the database engine for better performance?
Certainly, indexes can speed up queries. The EXPLAIN ANALYZE command
allows you to see how PostgreSQL is interpreting your query, and which
......@@ -495,7 +453,7 @@
You can also use the CLUSTER command to group data in tables to match
an index. See the CLUSTER manual page for more details.
3.7) What debugging features are available?
3.4) What debugging features are available?
PostgreSQL has several features that report status information that
can be valuable for debugging purposes.
......@@ -550,7 +508,7 @@ log_*
in the client's current directory. Linux requires a compile with
-DLINUX_PROFILE for proper profiling.
3.8) Why do I get "Sorry, too many clients" when trying to connect?
3.5) Why do I get "Sorry, too many clients" when trying to connect?
You need to increase postmaster's limit on how many concurrent backend
processes it can start.
......@@ -570,7 +528,7 @@ log_*
that PostgreSQL has a limit on the number of allowed backend processes
is so your system won't run out of resources.
3.9) What is in the pgsql_tmp directory?
3.6) What is in the pgsql_tmp directory?
This directory contains temporary files generated by the query
executor. For example, if a sort needs to be done to satisfy an ORDER
......@@ -581,7 +539,7 @@ log_*
remain if a backend crashes during a sort. A stop and restart of the
postmaster will remove files from those directories.
3.10) Why do I need to do a dump and restore to upgrade between major
3.7) Why do I need to do a dump and restore to upgrade between major
PostgreSQL releases?
The PostgreSQL team makes only small changes between minor releases,
......@@ -596,7 +554,7 @@ log_*
script can be used to upgrade without a dump/restore. The release
notes mention whether pg_upgrade is available for the release.
3.11) What computer hardware should I use?
3.8) What computer hardware should I use?
Because PC hardware is mostly compatible, people tend to believe that
all PC hardware is of equal quality. It is not. ECC RAM, SCSI, and
......
......@@ -10,7 +10,7 @@
alink="#0000ff">
<H1>Frequently Asked Questions (FAQ) for PostgreSQL</H1>
<P>Last updated: Sat Jan 29 22:51:43 EST 2005</P>
<P>Last updated: Sat Jan 29 22:59:12 EST 2005</P>
<P>Current maintainer: Bruce Momjian (<A href=
"mailto:pgman@candle.pha.pa.us">pgman@candle.pha.pa.us</A>)<BR>
......@@ -56,24 +56,18 @@
<H2 align="center">Administrative Questions</H2>
<A href="#3.1">3.1</A>) How do I install PostgreSQL somewhere other
than <I>/usr/local/pgsql</I>?<BR>
<A href="#3.2">3.2</A>) When I start <I>postmaster</I>, I get a
<I>Bad System Call</I> or core dumped message. Why?<BR>
<A href="#3.3">3.3</A>) When I try to start <I>postmaster</I>, I
get <I>IpcMemoryCreate</I> errors. Why?<BR>
<A href="#3.4">3.4</A>) When I try to start <I>postmaster</I>, I
get <I>IpcSemaphoreCreate</I> errors. Why?<BR>
<A href="#3.5">3.5</A>) How do I control connections from other
<A href="#3.2">3.2</A>) How do I control connections from other
hosts?<BR>
<A href="#3.6">3.6</A>) How do I tune the database engine for
<A href="#3.3">3.3</A>) How do I tune the database engine for
better performance?<BR>
<A href="#3.7">3.7</A>) What debugging features are available?<BR>
<A href="#3.8">3.8</A>) Why do I get <I>"Sorry, too many
<A href="#3.4">3.4</A>) What debugging features are available?<BR>
<A href="#3.5">3.5</A>) Why do I get <I>"Sorry, too many
clients"</I> when trying to connect?<BR>
<A href="#3.9">3.9</A>) What is in the <I>pgsql_tmp</I>
<A href="#3.6">3.6</A>) What is in the <I>pgsql_tmp</I>
directory?<BR>
<A href="#3.10">3.10</A>) Why do I need to do a dump and restore
<A href="#3.7">3.7</A>) Why do I need to do a dump and restore
to upgrade PostgreSQL releases?<BR>
<A href="#3.11">3.11</A>) What computer hardware should I use?<BR>
<A href="#3.8">3.8</A>) What computer hardware should I use?<BR>
<H2 align="center">Operational Questions</H2>
......@@ -544,47 +538,7 @@
<P>Specify the <I>--prefix</I> option when running
<I>configure</I>.</P>
<H4><A name="3.2">3.2</A>) When I start <I>postmaster</I>, I get a
<I>Bad System Call</I> or core dumped message. Why?</H4>
<P>It could be a variety of problems, but first check to see that
you have System V extensions installed in your kernel. PostgreSQL
requires kernel support for shared memory and semaphores.</P>
<H4><A name="3.3">3.3</A>) When I try to start <I>postmaster</I>, I
get <I>IpcMemoryCreate</I> errors. Why?</H4>
<P>You either do not have shared memory configured properly in your
kernel or you need to enlarge the shared memory available in the
kernel. The exact amount you need depends on your architecture and
how many buffers and backend processes you configure for
<I>postmaster</I>. For most systems, with default numbers of
buffers and processes, you need a minimum of ~1 MB. See the <A
href="http://www.postgresql.org/docs/current/static/kernel-resources.html">PostgreSQL
Administrator's Guide/Server Run-time Environment/Managing Kernel Resources</A>
section for more detailed information about shared memory and semaphores.</P>
<H4><A name="3.4">3.4</A>) When I try to start <I>postmaster</I>, I
get <I>IpcSemaphoreCreate</I> errors. Why?</H4>
<P>If the error message is <I>IpcSemaphoreCreate: semget failed (No
space left on device)</I> then your kernel is not configured with
enough semaphores. Postgres needs one semaphore per potential
backend process. A temporary solution is to start <I>postmaster</I>
with a smaller limit on the number of backend processes. Use
<I>-N</I> with a parameter less than the default of 32. A more
permanent solution is to increase your kernel's
<SMALL>SEMMNS</SMALL> and <SMALL>SEMMNI</SMALL> parameters.</P>
<P>Inoperative semaphores can also cause crashes during heavy
database access.</P>
<P>If the error message is something else, you might not have
semaphore support configured in your kernel at all. See the
PostgreSQL Administrator's Guide for more detailed information
about shared memory and semaphores.</P>
<H4><A name="3.5">3.5</A>) How do I control connections from other
<H4><A name="3.2">3.2</A>) How do I control connections from other
hosts?</H4>
<P>By default, PostgreSQL only allows connections from the local
......@@ -594,7 +548,7 @@
host-based authentication by modifying the file
<I>$PGDATA/pg_hba.conf</I> accordingly.</P>
<H4><A name="3.6">3.6</A>) How do I tune the database engine for
<H4><A name="3.3">3.3</A>) How do I tune the database engine for
better performance?</H4>
<P>Certainly, indexes can speed up queries. The
......@@ -633,7 +587,7 @@
data in tables to match an index. See the <SMALL>CLUSTER</SMALL>
manual page for more details.</P>
<H4><A name="3.7">3.7</A>) What debugging features are
<H4><A name="3.4">3.4</A>) What debugging features are
available?</H4>
<P>PostgreSQL has several features that report status information
......@@ -691,7 +645,7 @@
file will be put in the client's current directory. Linux requires
a compile with <I>-DLINUX_PROFILE</I> for proper profiling.</P>
<H4><A name="3.8">3.8</A>) Why do I get <I>"Sorry, too many
<H4><A name="3.5">3.5</A>) Why do I get <I>"Sorry, too many
clients"</I> when trying to connect?</H4>
<P>You need to increase <I>postmaster</I>'s limit on how many
......@@ -716,7 +670,7 @@
the number of allowed backend processes is so your system won't run
out of resources.</P>
<H4><A name="3.9">3.9</A>) What is in the <I>pgsql_tmp</I> directory?</H4>
<H4><A name="3.6">3.6</A>) What is in the <I>pgsql_tmp</I> directory?</H4>
<P>This directory contains temporary files generated by the query
executor. For example, if a sort needs to be done to satisfy an
......@@ -728,7 +682,7 @@
remain if a backend crashes during a sort. A stop and restart of the
<I>postmaster</I> will remove files from those directories.</P>
<H4><A name="3.10">3.10</A>) Why do I need to do a dump and restore
<H4><A name="3.7">3.7</A>) Why do I need to do a dump and restore
to upgrade between major PostgreSQL releases?</H4>
<P>The PostgreSQL team makes only small changes between minor releases,
......@@ -744,7 +698,7 @@
The release notes mention whether <I>pg_upgrade</I> is available for the
release.</P>
<H4><A name="3.11">3.11</A>) What computer hardware should I use?</H4>
<H4><A name="3.8">3.8</A>) What computer hardware should I use?</H4>
<P>Because PC hardware is mostly compatible, people tend to believe that
all PC hardware is of equal quality. It is not. ECC RAM, SCSI, and
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment