database/postgres
database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-04-20 00:42:27 +03:00
Code

doc: Update installation instructions for new shared libperl/libpython handling

Browse Source
This commit is contained in:
Peter Eisentraut 2015-05-05 14:41:39 -04:00
parent 3b6db1f445
commit 53f0965767
1 changed files with 19 additions and 42 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

61
doc/src/sgml/installation.sgml
View File

@ -169,32 +169,22 @@ su - postgres
also on most platforms. This appears to be the default in also on most platforms. This appears to be the default in
recent <productname>Perl</productname> versions, but it was not recent <productname>Perl</productname> versions, but it was not
in earlier versions, and in any case it is the choice of whomever in earlier versions, and in any case it is the choice of whomever
installed Perl at your site. installed Perl at your site. <filename>configure</filename> will fail
if building <application>PL/Perl</application> is selected but it cannot
find a shared <filename>libperl</filename>. In that case, you will have
to rebuild and install <productname>Perl</productname> manually to be
able to build <application>PL/Perl</application>. During the
configuration process for <productname>Perl</productname>, request a
shared library.
</para>
<para>
If you intend to make more than incidental use of If you intend to make more than incidental use of
<application>PL/Perl</application>, you should ensure that the <application>PL/Perl</application>, you should ensure that the
<productname>Perl</productname> installation was built with the <productname>Perl</productname> installation was built with the
<literal>usemultiplicity</> option enabled (<literal>perl -V</> <literal>usemultiplicity</> option enabled (<literal>perl -V</>
will show whether this is the case). will show whether this is the case).
</para> </para>
<para>
If you don't have the shared library but you need one, a message
like this will appear during the <productname>PostgreSQL</>
build to point out this fact:
<screen>
*** Cannot build PL/Perl because libperl is not a shared library.
*** You might have to rebuild your Perl installation. Refer to
*** the documentation for details.
</screen>
(If you don't follow the on-screen output you will merely notice
that the <application>PL/Perl</application> library object,
<filename>plperl.so</filename> or similar, will not be
installed.) If you see this, you will have to rebuild and
install <productname>Perl</productname> manually to be able to
build <application>PL/Perl</application>. During the
configuration process for <productname>Perl</productname>,
request a shared library.
</para>
</listitem> </listitem>
<listitem> <listitem>
@ -220,28 +210,15 @@ su - postgres
library, the <indexterm><primary>libpython</primary></indexterm> library, the <indexterm><primary>libpython</primary></indexterm>
<filename>libpython</filename> library must be a shared library <filename>libpython</filename> library must be a shared library
also on most platforms. This is not the case in a default also on most platforms. This is not the case in a default
<productname>Python</productname> installation. If after <productname>Python</productname> installation built from source, but a
building and installing <productname>PostgreSQL</> you have a file called shared library is available in many operating system
<filename>plpython.so</filename> (possibly a different distributions. <filename>configure</filename> will fail if
extension), then everything went well. Otherwise you should building <application>PL/Python</application> is selected but it cannot
have seen a notice like this flying by: find a shared <filename>libpython</filename>. That might mean that you
<screen> either have to install additional packages or rebuild (part of) your
*** Cannot build PL/Python because libpython is not a shared library. <productname>Python</productname> installation to provide this shared
*** You might have to rebuild your Python installation. Refer to library. When building from source, run <productname>Python</>'s
*** the documentation for details. configure with the <literal>--enable-shared</> flag.
</screen>
That means you have to rebuild (part of) your
<productname>Python</productname> installation to create this
shared library.
</para>
<para>
If you have problems, run <productname>Python</> 2.3 or later's
configure using the <literal>--enable-shared</> flag. On some
operating systems you don't have to build a shared library, but
you will have to convince the <productname>PostgreSQL</> build
system of this. Consult the <filename>Makefile</filename> in
the <filename>src/pl/plpython</filename> directory for details.
</para> </para>
</listitem> </listitem>