<filename>libperl</filename> library must be a shared library
also on most platforms. This appears to be the default in
recent <productname>Perl</productname> versions, but it was not
- in earlier versions, and in general it is the choice of whomever
+ in earlier versions, and in any case it is the choice of whomever
installed Perl at your site.
</para>
<listitem>
<para>
- <application>Kerberos</>, <productname>OpenSSL</>, or <application>PAM</>,
- if you want to support authentication using these services.
+ <application>Kerberos</>, <productname>OpenSSL</>, or
+ <application>PAM</>, if you want to support authentication or
+ encryption using these services.
</para>
</listitem>
</itemizedlist>
old one then shut down the old server, at the latest before you
install the new files:
<screen>
-<userinput>kill -INT `cat /usr/local/pgsql/data/postmaster.pid | sed 1q`</>
+<userinput>pg_ctl stop</>
</screen>
- Versions prior to 7.0 do not have this
- <filename>postmaster.pid</> file. If you are using such a version
- you must find out the process ID of the server yourself, for
- example by typing <userinput>ps ax | grep postmaster</>, and
- supply it to the <command>kill</> command.
+ On systems that have <productname>PostgreSQL</> started at boot time,
+ there is probably a start-up file that will accomplish the same thing. For
+ example, on a <systemitem class="osname">Red Hat Linux</> system one
+ might find that
+<screen>
+<userinput>/etc/rc.d/init.d/postgresql stop</userinput>
+</screen>
+ works.
</para>
<para>
- On systems that have <productname>PostgreSQL</> started at boot time, there is
- probably a start-up file that will accomplish the same thing. For
- example, on a <systemitem class="osname">Red Hat Linux</> system one might find that
+ Very old versions might not have <application>pg_ctl</>. If you
+ can't find it or it doesn't work, find out the process ID of the
+ old server, for
+ example by typing <userinput>ps ax | grep postmaster</>, and
+ signal it to stop this way:
<screen>
-<userinput>/etc/rc.d/init.d/postgresql stop</userinput>
+<userinput>kill -INT <replaceable>processID</></userinput>
</screen>
- works. Another possibility is <userinput>pg_ctl stop</>.
</para>
</step>
</para>
<para>
- These topics are discussed at length in <![%standalone-include[the
- documentation,]]> <![%standalone-ignore[<xref
- linkend="migration">,]]> which you are encouraged to read in any
- case.
+ Further discussion appears in
+ <![%standalone-include[the documentation,]]>
+ <![%standalone-ignore[<xref linkend="migration">,]]>
+ which you are encouraged to read in any case.
</para>
</sect1>
Enables Native Language Support (<acronym>NLS</acronym>),
that is, the ability to display a program's messages in a
language other than English.
- <replaceable>LANGUAGES</replaceable> is a space separated
+ <replaceable>LANGUAGES</replaceable> is a space-separated
list of codes of the languages that you want supported, for
example <literal>--enable-nls='de fr'</>. (The intersection
between your list and the set of actually provided
<term><option>--without-readline</option></term>
<listitem>
<para>
- Prevents
the use of the <application>Readline</> library. This disables
+ Prevents use of the <application>Readline</> library. This disables
command-line editing and history in
<application>psql</application>, so it is not recommended.
</para>
<term><option>--with-rendezvous</option></term>
<listitem>
<para>
- Build with Rendezvous support.
+ Build with Rendezvous support. This requires Rendezvous support
+ in your operating system. Recommended on Mac OS X.
</para>
</listitem>
</varlistentry>
Make the client libraries thread-safe. This allows
concurrent threads in <application>libpq</application> and
<application>ECPG</application> programs to safely control
- their private connection handles.
+ their private connection handles. This option requires adequate
+ threading support in your operating system.
</para>
</listitem>
</varlistentry>
<term><option>--without-zlib</option></term>
<listitem>
<para>
- Prevents the use of the <application>Zlib</> library. This disables
- compression support in <application>pg_dump</application>.
+ <indexterm>
+ <primary>zlib</primary>
+ </indexterm>
+ Prevents use of the <application>Zlib</> library. This disables
+ support for compressed archives in <application>pg_dump</application>
+ and <application>pg_restore</application>.
This option is only intended for those rare systems where this
library is not available.
</para>
<para>
If you prefer a C compiler different from the one
- <filename>configure</filename> picks then you can set the
+ <filename>configure</filename> picks, you can set the
environment variable <envar>CC</> to the program of your choice.
By default, <filename>configure</filename> will pick
- <filename>gcc</filename> unless this is inappropriate for the
- platform. Similarly, you can override the default compiler flags
- with the <envar>CFLAGS</envar> variable.
+ <filename>gcc</filename> if available, else the platform's
+ default (usually <filename>cc</>). Similarly, you can override the
+ default compiler flags if needed with the <envar>CFLAGS</envar> variable.
</para>
<para>
<note>
<para>
If you are upgrading an existing system and are going to install
- the new files over the old ones, then you should have backed up
- your data and shut down the old server by now, as explained in
+ the new files over the old ones, be sure to back up
+ your data and shut down the old server before proceeding, as explained in
<xref linkend="install-upgrading"> above.
</para>
</note>
<para>
The standard installation provides all the header files needed for client
- application development as well as for any server-side program
- development (such as custom functions or data types written in C).
+ application development as well as for server-side program
+ development, such as custom functions or data types written in C.
+ (Prior to <productname>PostgreSQL</> 8.0, a separate <literal>gmake
+ install-all-headers</> command was needed for the latter, but this
+ step has been folded into the standard install.)
</para>
<formalpara>
projects / users / bernd / postgres.git / commitdiff