codekingpro/portable-devtools

1<?xml version="1.0" encoding="UTF-8" standalone="no"?>2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>17.5. Post-Installation Setup</title><link rel="stylesheet" type="text/css" href="stylesheet.css" /><link rev="made" href="pgsql-docs@lists.postgresql.org" /><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /><link rel="prev" href="install-meson.html" title="17.4. Building and Installation with Meson" /><link rel="next" href="supported-platforms.html" title="17.6. Supported Platforms" /></head><body id="docContent" class="container-fluid col-10"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="5" align="center">17.5. Post-Installation Setup</th></tr><tr><td width="10%" align="left"><a accesskey="p" href="install-meson.html" title="17.4. Building and Installation with Meson">Prev</a> </td><td width="10%" align="left"><a accesskey="u" href="installation.html" title="Chapter 17. Installation from Source Code">Up</a></td><th width="60%" align="center">Chapter 17. Installation from Source Code</th><td width="10%" align="right"><a accesskey="h" href="index.html" title="PostgreSQL 16.3 Documentation">Home</a></td><td width="10%" align="right"> <a accesskey="n" href="supported-platforms.html" title="17.6. Supported Platforms">Next</a></td></tr></table><hr /></div><div class="sect1" id="INSTALL-POST"><div class="titlepage"><div><div><h2 class="title" style="clear: both">17.5. Post-Installation Setup <a href="#INSTALL-POST" class="id_link">#</a></h2></div></div></div><div class="toc"><dl class="toc"><dt><span class="sect2"><a href="install-post.html#INSTALL-POST-SHLIBS">17.5.1. Shared Libraries</a></span></dt><dt><span class="sect2"><a href="install-post.html#INSTALL-POST-ENV-VARS">17.5.2. Environment Variables</a></span></dt></dl></div><div class="sect2" id="INSTALL-POST-SHLIBS"><div class="titlepage"><div><div><h3 class="title">17.5.1. Shared Libraries <a href="#INSTALL-POST-SHLIBS" class="id_link">#</a></h3></div></div></div><a id="id-1.6.4.9.2.2" class="indexterm"></a><p>3    On some systems with shared libraries4    you need to tell the system how to find the newly installed5    shared libraries.  The systems on which this is6    <span class="emphasis"><em>not</em></span> necessary include7    <span class="systemitem">FreeBSD</span>,8    <span class="systemitem">Linux</span>,9    <span class="systemitem">NetBSD</span>, <span class="systemitem">OpenBSD</span>, and10    <span class="systemitem">Solaris</span>.11   </p><p>12    The method to set the shared library search path varies between13    platforms, but the most widely-used method is to set the14    environment variable <code class="envar">LD_LIBRARY_PATH</code> like so: In Bourne15    shells (<code class="command">sh</code>, <code class="command">ksh</code>, <code class="command">bash</code>, <code class="command">zsh</code>):16</p><pre class="programlisting">17LD_LIBRARY_PATH=/usr/local/pgsql/lib18export LD_LIBRARY_PATH19</pre><p>20    or in <code class="command">csh</code> or <code class="command">tcsh</code>:21</p><pre class="programlisting">22setenv LD_LIBRARY_PATH /usr/local/pgsql/lib23</pre><p>24    Replace <code class="literal">/usr/local/pgsql/lib</code> with whatever you set25    <code class="option"><code class="literal">--libdir</code></code> to in <a class="xref" href="install-make.html#CONFIGURE" title="Configuration">Step 1</a>.26    You should put these commands into a shell start-up file such as27    <code class="filename">/etc/profile</code> or <code class="filename">~/.bash_profile</code>.  Some28    good information about the caveats associated with this method can29    be found at <a class="ulink" href="http://xahlee.info/UnixResource_dir/_/ldpath.html" target="_top">http://xahlee.info/UnixResource_dir/_/ldpath.html</a>.30   </p><p>31    On some systems it might be preferable to set the environment32    variable <code class="envar">LD_RUN_PATH</code> <span class="emphasis"><em>before</em></span>33    building.34   </p><p>35    On <span class="systemitem">Cygwin</span>, put the library36    directory in the <code class="envar">PATH</code> or move the37    <code class="filename">.dll</code> files into the <code class="filename">bin</code>38    directory.39   </p><p>40    If in doubt, refer to the manual pages of your system (perhaps41    <code class="command">ld.so</code> or <code class="command">rld</code>). If you later42    get a message like:43</p><pre class="screen">44psql: error in loading shared libraries45libpq.so.2.1: cannot open shared object file: No such file or directory46</pre><p>47    then this step was necessary.  Simply take care of it then.48   </p><p>49    <a id="id-1.6.4.9.2.8.1" class="indexterm"></a>50    If you are on <span class="systemitem">Linux</span> and you have root51    access, you can run:52</p><pre class="programlisting">53/sbin/ldconfig /usr/local/pgsql/lib54</pre><p>55    (or equivalent directory) after installation to enable the56    run-time linker to find the shared libraries faster.  Refer to the57    manual page of <code class="command">ldconfig</code> for more information.  On58    <span class="systemitem">FreeBSD</span>, <span class="systemitem">NetBSD</span>, and <span class="systemitem">OpenBSD</span> the command is:59</p><pre class="programlisting">60/sbin/ldconfig -m /usr/local/pgsql/lib61</pre><p>62    instead.  Other systems are not known to have an equivalent63    command.64   </p></div><div class="sect2" id="INSTALL-POST-ENV-VARS"><div class="titlepage"><div><div><h3 class="title">17.5.2. Environment Variables <a href="#INSTALL-POST-ENV-VARS" class="id_link">#</a></h3></div></div></div><a id="id-1.6.4.9.3.2" class="indexterm"></a><p>65    If you installed into <code class="filename">/usr/local/pgsql</code> or some other66    location that is not searched for programs by default, you should67    add <code class="filename">/usr/local/pgsql/bin</code> (or whatever you set68    <code class="option"><code class="literal">--bindir</code></code> to in <a class="xref" href="install-make.html#CONFIGURE" title="Configuration">Step 1</a>)69    into your <code class="envar">PATH</code>.  Strictly speaking, this is not70    necessary, but it will make the use of <span class="productname">PostgreSQL</span>71    much more convenient.72   </p><p>73    To do this, add the following to your shell start-up file, such as74    <code class="filename">~/.bash_profile</code> (or <code class="filename">/etc/profile</code>, if you75    want it to affect all users):76</p><pre class="programlisting">77PATH=/usr/local/pgsql/bin:$PATH78export PATH79</pre><p>80    If you are using <code class="command">csh</code> or <code class="command">tcsh</code>, then use this command:81</p><pre class="programlisting">82set path = ( /usr/local/pgsql/bin $path )83</pre><p>84   </p><p>85    <a id="id-1.6.4.9.3.5.1" class="indexterm"></a>86    To enable your system to find the <span class="application">man</span>87    documentation, you need to add lines like the following to a88    shell start-up file unless you installed into a location that is89    searched by default:90</p><pre class="programlisting">91MANPATH=/usr/local/pgsql/share/man:$MANPATH92export MANPATH93</pre><p>94   </p><p>95    The environment variables <code class="envar">PGHOST</code> and <code class="envar">PGPORT</code>96    specify to client applications the host and port of the database97    server, overriding the compiled-in defaults. If you are going to98    run client applications remotely then it is convenient if every99    user that plans to use the database sets <code class="envar">PGHOST</code>.  This100    is not required, however; the settings can be communicated via command101    line options to most client programs.102   </p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="install-meson.html" title="17.4. Building and Installation with Meson">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="installation.html" title="Chapter 17. Installation from Source Code">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="supported-platforms.html" title="17.6. Supported Platforms">Next</a></td></tr><tr><td width="40%" align="left" valign="top">17.4. Building and Installation with Meson </td><td width="20%" align="center"><a accesskey="h" href="index.html" title="PostgreSQL 16.3 Documentation">Home</a></td><td width="40%" align="right" valign="top"> 17.6. Supported Platforms</td></tr></table></div></body></html>