begriffs open source - ai-pg/blob - full-docs/html/installation-platform-notes.html

   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.7. Platform-Specific Notes</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="supported-platforms.html" title="17.6. Supported Platforms" /><link rel="next" href="runtime.html" title="Chapter 18. Server Setup and Operation" /></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.7. Platform-Specific Notes</th></tr><tr><td width="10%" align="left"><a accesskey="p" href="supported-platforms.html" title="17.6. Supported Platforms">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 18.0 Documentation">Home</a></td><td width="10%" align="right"> <a accesskey="n" href="runtime.html" title="Chapter 18. Server Setup and Operation">Next</a></td></tr></table><hr /></div><div class="sect1" id="INSTALLATION-PLATFORM-NOTES"><div class="titlepage"><div><div><h2 class="title" style="clear: both">17.7. Platform-Specific Notes <a href="#INSTALLATION-PLATFORM-NOTES" class="id_link">#</a></h2></div></div></div><div class="toc"><dl class="toc"><dt><span class="sect2"><a href="installation-platform-notes.html#INSTALLATION-NOTES-CYGWIN">17.7.1. Cygwin</a></span></dt><dt><span class="sect2"><a href="installation-platform-notes.html#INSTALLATION-NOTES-MACOS">17.7.2. macOS</a></span></dt><dt><span class="sect2"><a href="installation-platform-notes.html#INSTALLATION-NOTES-MINGW">17.7.3. MinGW</a></span></dt><dt><span class="sect2"><a href="installation-platform-notes.html#INSTALLATION-NOTES-SOLARIS">17.7.4. Solaris</a></span></dt><dt><span class="sect2"><a href="installation-platform-notes.html#INSTALLATION-NOTES-VISUAL-STUDIO">17.7.5. Visual Studio</a></span></dt></dl></div><p>
   3    This section documents additional platform-specific issues
   4    regarding the installation and setup of PostgreSQL.  Be sure to
   5    read the installation instructions, and in
   6    particular <a class="xref" href="install-requirements.html" title="17.1. Requirements">Section 17.1</a> as well.  Also,
   7    check <a class="xref" href="regress.html" title="Chapter 31. Regression Tests">Chapter 31</a> regarding the
   8    interpretation of regression test results.
   9   </p><p>
  10    Platforms that are not covered here have no known platform-specific
  11    installation issues.
  12   </p><div class="sect2" id="INSTALLATION-NOTES-CYGWIN"><div class="titlepage"><div><div><h3 class="title">17.7.1. Cygwin <a href="#INSTALLATION-NOTES-CYGWIN" class="id_link">#</a></h3></div></div></div><a id="id-1.6.4.10.4.2" class="indexterm"></a><p>
  13     PostgreSQL can be built using Cygwin, a Linux-like environment for
  14     Windows, but that method is inferior to the native Windows build
  15     and running a server under Cygwin is no longer recommended.
  16    </p><p>
  17     When building from source, proceed according to the Unix-style
  18     installation procedure (i.e., <code class="literal">./configure;
  19     make</code>; etc.), noting the following Cygwin-specific
  20     differences:
  21
  22     </p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
  23        Set your path to use the Cygwin bin directory before the
  24        Windows utilities.  This will help prevent problems with
  25        compilation.
  26       </p></li><li class="listitem"><p>
  27        The <code class="command">adduser</code> command is not supported; use
  28        the appropriate user management application on Windows.
  29        Otherwise, skip this step.
  30       </p></li><li class="listitem"><p>
  31        The <code class="command">su</code> command is not supported; use ssh to
  32        simulate su on Windows. Otherwise, skip this step.
  33       </p></li><li class="listitem"><p>
  34        <span class="productname">OpenSSL</span> is not supported.
  35       </p></li><li class="listitem"><p>
  36        Start <code class="command">cygserver</code> for shared memory support.
  37        To do this, enter the command <code class="literal">/usr/sbin/cygserver
  38        &amp;</code>.  This program needs to be running anytime you
  39        start the PostgreSQL server or initialize a database cluster
  40        (<code class="command">initdb</code>).  The
  41        default <code class="command">cygserver</code> configuration may need to
  42        be changed (e.g., increase <code class="symbol">SEMMNS</code>) to prevent
  43        PostgreSQL from failing due to a lack of system resources.
  44       </p></li><li class="listitem"><p>
  45         Building might fail on some systems where a locale other than
  46         C is in use. To fix this, set the locale to C by doing
  47         <code class="command">export LANG=C.utf8</code> before building, and then
  48         setting it back to the previous setting after you have installed
  49         PostgreSQL.
  50       </p></li><li class="listitem"><p>
  51        The parallel regression tests (<code class="literal">make check</code>)
  52        can generate spurious regression test failures due to
  53        overflowing the <code class="function">listen()</code> backlog queue
  54        which causes connection refused errors or hangs.  You can limit
  55        the number of connections using the make
  56        variable <code class="varname">MAX_CONNECTIONS</code> thus:
  57 </p><pre class="programlisting">
  58 make MAX_CONNECTIONS=5 check
  59 </pre><p>
  60        (On some systems you can have up to about 10 simultaneous
  61        connections.)
  62       </p></li></ul></div><p>
  63    </p><p>
  64     It is possible to install <code class="command">cygserver</code> and the
  65     PostgreSQL server as Windows NT services.  For information on how
  66     to do this, please refer to the <code class="filename">README</code>
  67     document included with the PostgreSQL binary package on Cygwin.
  68     It is installed in the
  69     directory <code class="filename">/usr/share/doc/Cygwin</code>.
  70    </p></div><div class="sect2" id="INSTALLATION-NOTES-MACOS"><div class="titlepage"><div><div><h3 class="title">17.7.2. macOS <a href="#INSTALLATION-NOTES-MACOS" class="id_link">#</a></h3></div></div></div><a id="id-1.6.4.10.5.2" class="indexterm"></a><p>
  71     To build <span class="productname">PostgreSQL</span> from source
  72     on <span class="productname">macOS</span>, you will need to install Apple's
  73     command line developer tools, which can be done by issuing
  74 </p><pre class="programlisting">
  75 xcode-select --install
  76 </pre><p>
  77     (note that this will pop up a GUI dialog window for confirmation).
  78     You may or may not wish to also install Xcode.
  79    </p><p>
  80     On recent <span class="productname">macOS</span> releases, it's necessary to
  81     embed the <span class="quote">“<span class="quote">sysroot</span>”</span> path in the include switches used to
  82     find some system header files.  This results in the outputs of
  83     the <span class="application">configure</span> script varying depending on
  84     which SDK version was used during <span class="application">configure</span>.
  85     That shouldn't pose any problem in simple scenarios, but if you are
  86     trying to do something like building an extension on a different machine
  87     than the server code was built on, you may need to force use of a
  88     different sysroot path.  To do that, set <code class="varname">PG_SYSROOT</code>,
  89     for example
  90 </p><pre class="programlisting">
  91 make PG_SYSROOT=<em class="replaceable"><code>/desired/path</code></em> all
  92 </pre><p>
  93     To find out the appropriate path on your machine, run
  94 </p><pre class="programlisting">
  95 xcrun --show-sdk-path
  96 </pre><p>
  97     Note that building an extension using a different sysroot version than
  98     was used to build the core server is not really recommended; in the
  99     worst case it could result in hard-to-debug ABI inconsistencies.
 100    </p><p>
 101     You can also select a non-default sysroot path when configuring, by
 102     specifying <code class="varname">PG_SYSROOT</code>
 103     to <span class="application">configure</span>:
 104 </p><pre class="programlisting">
 105 ./configure ... PG_SYSROOT=<em class="replaceable"><code>/desired/path</code></em>
 106 </pre><p>
 107     This would primarily be useful to cross-compile for some other
 108     macOS version.  There is no guarantee that the resulting executables
 109     will run on the current host.
 110    </p><p>
 111     To suppress the <code class="option">-isysroot</code> options altogether, use
 112 </p><pre class="programlisting">
 113 ./configure ... PG_SYSROOT=none
 114 </pre><p>
 115     (any nonexistent pathname will work).  This might be useful if you wish
 116     to build with a non-Apple compiler, but beware that that case is not
 117     tested or supported by the PostgreSQL developers.
 118    </p><p>
 119     <span class="productname">macOS</span>'s <span class="quote">“<span class="quote">System Integrity
 120     Protection</span>”</span> (SIP) feature breaks <code class="literal">make check</code>,
 121     because it prevents passing the needed setting
 122     of <code class="literal">DYLD_LIBRARY_PATH</code> down to the executables being
 123     tested.  You can work around that by doing <code class="literal">make
 124     install</code> before <code class="literal">make check</code>.
 125     Most PostgreSQL developers just turn off SIP, though.
 126    </p></div><div class="sect2" id="INSTALLATION-NOTES-MINGW"><div class="titlepage"><div><div><h3 class="title">17.7.3. MinGW <a href="#INSTALLATION-NOTES-MINGW" class="id_link">#</a></h3></div></div></div><a id="id-1.6.4.10.6.2" class="indexterm"></a><p>
 127     PostgreSQL for Windows can be built using MinGW, a Unix-like build
 128     environment for Windows.  It is recommended to use the <a class="ulink" href="https://www.msys2.org/" target="_top">MSYS2</a> environment for this and also
 129     to install any prerequisite packages.
 130    </p><div class="sect3" id="MINGW-CRASH-DUMPS"><div class="titlepage"><div><div><h4 class="title">17.7.3.1. Collecting Crash Dumps <a href="#MINGW-CRASH-DUMPS" class="id_link">#</a></h4></div></div></div><p>
 131      If PostgreSQL on Windows crashes, it has the ability to generate
 132      <span class="productname">minidumps</span> that can be used to track down the cause
 133      for the crash, similar to core dumps on Unix. These dumps can be
 134      read using the <span class="productname">Windows Debugger Tools</span> or using
 135      <span class="productname">Visual Studio</span>. To enable the generation of dumps
 136      on Windows, create a subdirectory named <code class="filename">crashdumps</code>
 137      inside the cluster data directory. The dumps will then be written
 138      into this directory with a unique name based on the identifier of
 139      the crashing process and the current time of the crash.
 140     </p></div></div><div class="sect2" id="INSTALLATION-NOTES-SOLARIS"><div class="titlepage"><div><div><h3 class="title">17.7.4. Solaris <a href="#INSTALLATION-NOTES-SOLARIS" class="id_link">#</a></h3></div></div></div><a id="id-1.6.4.10.7.2" class="indexterm"></a><p>
 141     PostgreSQL is well-supported on Solaris.  The more up to date your
 142     operating system, the fewer issues you will experience.
 143    </p><div class="sect3" id="INSTALLATION-NOTES-SOLARIS-REQ-TOOLS"><div class="titlepage"><div><div><h4 class="title">17.7.4.1. Required Tools <a href="#INSTALLATION-NOTES-SOLARIS-REQ-TOOLS" class="id_link">#</a></h4></div></div></div><p>
 144      You can build with either GCC or Sun's compiler suite.  For
 145      better code optimization, Sun's compiler is strongly recommended
 146      on the SPARC architecture.  If
 147      you are using Sun's compiler, be careful not to select
 148      <code class="filename">/usr/ucb/cc</code>;
 149      use <code class="filename">/opt/SUNWspro/bin/cc</code>.
 150     </p><p>
 151      You can download Sun Studio
 152      from <a class="ulink" href="https://www.oracle.com/technetwork/server-storage/solarisstudio/downloads/" target="_top">https://www.oracle.com/technetwork/server-storage/solarisstudio/downloads/</a>.
 153      Many GNU tools are integrated into Solaris 10, or they are
 154      present on the Solaris companion CD.  If you need packages for
 155      older versions of Solaris, you can find these tools
 156      at <a class="ulink" href="http://www.sunfreeware.com" target="_top">http://www.sunfreeware.com</a>.
 157      If you prefer
 158      sources, look
 159      at <a class="ulink" href="https://www.gnu.org/prep/ftp" target="_top">https://www.gnu.org/prep/ftp</a>.
 160     </p></div><div class="sect3" id="INSTALLATION-NOTES-SOLARIS-CONFIGURE-COMPLAINS"><div class="titlepage"><div><div><h4 class="title">17.7.4.2. configure Complains About a Failed Test Program <a href="#INSTALLATION-NOTES-SOLARIS-CONFIGURE-COMPLAINS" class="id_link">#</a></h4></div></div></div><p>
 161      If <code class="command">configure</code> complains about a failed test
 162      program, this is probably a case of the run-time linker being
 163      unable to find some library, probably libz, libreadline or some
 164      other non-standard library such as libssl.  To point it to the
 165      right location, set the <code class="envar">LDFLAGS</code> environment
 166      variable on the <code class="command">configure</code> command line, e.g.,
 167 </p><pre class="programlisting">
 168 configure ... LDFLAGS="-R /usr/sfw/lib:/opt/sfw/lib:/usr/local/lib"
 169 </pre><p>
 170      See
 171      the <span class="citerefentry"><span class="refentrytitle">ld</span></span>
 172      man page for more information.
 173     </p></div><div class="sect3" id="INSTALLATION-NOTES-SOLARIS-COMP-OPT-PERF"><div class="titlepage"><div><div><h4 class="title">17.7.4.3. Compiling for Optimal Performance <a href="#INSTALLATION-NOTES-SOLARIS-COMP-OPT-PERF" class="id_link">#</a></h4></div></div></div><p>
 174      On the SPARC architecture, Sun Studio is strongly recommended for
 175      compilation.  Try using the <code class="option">-xO5</code> optimization
 176      flag to generate significantly faster binaries.  Do not use any
 177      flags that modify behavior of floating-point operations
 178      and <code class="varname">errno</code> processing (e.g.,
 179      <code class="option">-fast</code>).
 180     </p><p>
 181      If you do not have a reason to use 64-bit binaries on SPARC,
 182      prefer the 32-bit version.  The 64-bit operations are slower and
 183      64-bit binaries are slower than the 32-bit variants.  On the
 184      other hand, 32-bit code on the AMD64 CPU family is not native,
 185      so 32-bit code is significantly slower on that CPU family.
 186     </p></div><div class="sect3" id="INSTALLATION-NOTES-SOLARIS-USING-DTRACE"><div class="titlepage"><div><div><h4 class="title">17.7.4.4. Using DTrace for Tracing PostgreSQL <a href="#INSTALLATION-NOTES-SOLARIS-USING-DTRACE" class="id_link">#</a></h4></div></div></div><p>
 187      Yes, using DTrace is possible.  See <a class="xref" href="dynamic-trace.html" title="27.5. Dynamic Tracing">Section 27.5</a> for
 188      further information.
 189     </p><p>
 190      If you see the linking of the <code class="command">postgres</code> executable abort with an
 191      error message like:
 192 </p><pre class="screen">
 193 Undefined                       first referenced
 194  symbol                             in file
 195 AbortTransaction                    utils/probes.o
 196 CommitTransaction                   utils/probes.o
 197 ld: fatal: Symbol referencing errors. No output written to postgres
 198 collect2: ld returned 1 exit status
 199 make: *** [postgres] Error 1
 200 </pre><p>
 201      your DTrace installation is too old to handle probes in static
 202      functions.  You need Solaris 10u4 or newer to use DTrace.
 203     </p></div></div><div class="sect2" id="INSTALLATION-NOTES-VISUAL-STUDIO"><div class="titlepage"><div><div><h3 class="title">17.7.5. Visual Studio <a href="#INSTALLATION-NOTES-VISUAL-STUDIO" class="id_link">#</a></h3></div></div></div><a id="id-1.6.4.10.8.2" class="indexterm"></a><p>
 204     It is recommended that most users download the binary distribution for
 205     Windows, available as a graphical installer package from the
 206     <span class="productname">PostgreSQL</span> website at
 207     <a class="ulink" href="https://www.postgresql.org/download/" target="_top">https://www.postgresql.org/download/</a>. Building from
 208     source is only intended for people developing
 209     <span class="productname">PostgreSQL</span> or extensions.
 210    </p><p>
 211     PostgreSQL for Windows with Visual Studio can be built using Meson, as
 212     described in <a class="xref" href="install-meson.html" title="17.4. Building and Installation with Meson">Section 17.4</a>.
 213     The native Windows port requires a 32 or 64-bit version of Windows
 214     10 or later.
 215    </p><p>
 216     Native builds of <span class="application">psql</span> don't support command
 217     line editing. The <span class="productname">Cygwin</span> build does support
 218     command line editing, so it should be used where psql is needed for
 219     interactive use on <span class="productname">Windows</span>.
 220    </p><p>
 221     PostgreSQL can be built using the Visual C++ compiler suite from Microsoft.
 222     These compilers can be either from <span class="productname">Visual Studio</span>,
 223     <span class="productname">Visual Studio Express</span> or some versions of the
 224     <span class="productname">Microsoft Windows SDK</span>. If you do not already have a
 225     <span class="productname">Visual Studio</span> environment set up, the easiest
 226     ways are to use the compilers from
 227     <span class="productname">Visual Studio 2022</span> or those in the
 228     <span class="productname">Windows SDK 10</span>, which are both free downloads
 229     from Microsoft.
 230    </p><p>
 231     Both 32-bit and 64-bit builds are possible with the Microsoft Compiler suite.
 232     32-bit PostgreSQL builds are possible with
 233     <span class="productname">Visual Studio 2015</span> to
 234     <span class="productname">Visual Studio 2022</span>,
 235     as well as standalone Windows SDK releases 10 and above.
 236     64-bit PostgreSQL builds are supported with
 237     <span class="productname">Microsoft Windows SDK</span> version 10 and above or
 238     <span class="productname">Visual Studio 2015</span> and above.
 239
 240    </p><p>
 241     If your build environment doesn't ship with a supported version of the
 242     <span class="productname">Microsoft Windows SDK</span> it is recommended
 243     that you upgrade to the latest version (currently version 10), available
 244     for download from <a class="ulink" href="https://www.microsoft.com/download" target="_top">https://www.microsoft.com/download</a>.
 245    </p><p>
 246     You must always include the
 247     <span class="application">Windows Headers and Libraries</span> part of the SDK.
 248     If you install a <span class="productname">Windows SDK</span>
 249     including the <span class="application">Visual C++ Compilers</span>,
 250     you don't need <span class="productname">Visual Studio</span> to build.
 251     Note that as of Version 8.0a the Windows SDK no longer ships with a
 252     complete command-line build environment.
 253    </p><div class="sect3" id="WINDOWS-REQUIREMENTS"><div class="titlepage"><div><div><h4 class="title">17.7.5.1. Requirements <a href="#WINDOWS-REQUIREMENTS" class="id_link">#</a></h4></div></div></div><p>
 254      The following additional products are required to build
 255      <span class="productname">PostgreSQL</span> on Windows.
 256
 257      </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span class="productname">Strawberry Perl</span></span></dt><dd><p>
 258         Strawberry Perl is required to run the build generation scripts. MinGW
 259         or Cygwin Perl will not work. It must also be present in the PATH.
 260         Binaries can be downloaded from
 261         <a class="ulink" href="https://strawberryperl.com" target="_top">https://strawberryperl.com</a>.
 262        </p></dd><dt><span class="term"><span class="productname">Bison</span> and
 263         <span class="productname">Flex</span></span></dt><dd><p>
 264         Binaries for <span class="productname">Bison</span> and
 265         <span class="productname">Flex</span> can be downloaded from <a class="ulink" href="https://github.com/lexxmark/winflexbison" target="_top">https://github.com/lexxmark/winflexbison</a>.
 266        </p></dd></dl></div><p>
 267     </p><p>
 268      The following additional products are not required to get started,
 269      but are required to build the complete package.
 270
 271      </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span class="productname">Magicsplat Tcl</span></span></dt><dd><p>
 272         Required for building <span class="application">PL/Tcl</span>.
 273         Binaries can be downloaded from
 274         <a class="ulink" href="https://www.magicsplat.com/tcl-installer/index.html" target="_top">https://www.magicsplat.com/tcl-installer/index.html</a>.
 275        </p></dd><dt><span class="term"><span class="productname">Diff</span></span></dt><dd><p>
 276         Diff is required to run the regression tests, and can be downloaded
 277         from <a class="ulink" href="http://gnuwin32.sourceforge.net" target="_top">http://gnuwin32.sourceforge.net</a>.
 278        </p></dd><dt><span class="term"><span class="productname">Gettext</span></span></dt><dd><p>
 279         Gettext is required to build with NLS support, and can be downloaded
 280         from <a class="ulink" href="http://gnuwin32.sourceforge.net" target="_top">http://gnuwin32.sourceforge.net</a>. Note that binaries,
 281         dependencies and developer files are all needed.
 282        </p></dd><dt><span class="term"><span class="productname">MIT Kerberos</span></span></dt><dd><p>
 283         Required for GSSAPI authentication support. MIT Kerberos can be
 284         downloaded from
 285         <a class="ulink" href="https://web.mit.edu/Kerberos/dist/index.html" target="_top">https://web.mit.edu/Kerberos/dist/index.html</a>.
 286        </p></dd><dt><span class="term"><span class="productname">libxml2</span> and
 287         <span class="productname">libxslt</span></span></dt><dd><p>
 288         Required for XML support. Binaries can be downloaded from
 289         <a class="ulink" href="https://zlatkovic.com/pub/libxml" target="_top">https://zlatkovic.com/pub/libxml</a> or source from
 290         <a class="ulink" href="http://xmlsoft.org" target="_top">http://xmlsoft.org</a>. Note that libxml2 requires iconv,
 291         which is available from the same download location.
 292        </p></dd><dt><span class="term"><span class="productname">LZ4</span></span></dt><dd><p>
 293         Required for supporting <span class="productname">LZ4</span> compression.
 294         Binaries and source can be downloaded from
 295         <a class="ulink" href="https://github.com/lz4/lz4/releases" target="_top">https://github.com/lz4/lz4/releases</a>.
 296        </p></dd><dt><span class="term"><span class="productname">Zstandard</span></span></dt><dd><p>
 297         Required for supporting <span class="productname">Zstandard</span> compression.
 298         Binaries and source can be downloaded from
 299         <a class="ulink" href="https://github.com/facebook/zstd/releases" target="_top">https://github.com/facebook/zstd/releases</a>.
 300        </p></dd><dt><span class="term"><span class="productname">OpenSSL</span></span></dt><dd><p>
 301         Required for SSL support. Binaries can be downloaded from
 302         <a class="ulink" href="https://slproweb.com/products/Win32OpenSSL.html" target="_top">https://slproweb.com/products/Win32OpenSSL.html</a>
 303         or source from <a class="ulink" href="https://www.openssl.org" target="_top">https://www.openssl.org</a>.
 304        </p></dd><dt><span class="term"><span class="productname">ossp-uuid</span></span></dt><dd><p>
 305         Required for UUID-OSSP support (contrib only). Source can be
 306         downloaded from
 307         <a class="ulink" href="http://www.ossp.org/pkg/lib/uuid/" target="_top">http://www.ossp.org/pkg/lib/uuid/</a>.
 308        </p></dd><dt><span class="term"><span class="productname">Python</span></span></dt><dd><p>
 309         Required for building <span class="application">PL/Python</span>. Binaries can
 310         be downloaded from <a class="ulink" href="https://www.python.org" target="_top">https://www.python.org</a>.
 311        </p></dd><dt><span class="term"><span class="productname">zlib</span></span></dt><dd><p>
 312         Required for compression support in <span class="application">pg_dump</span>
 313         and <span class="application">pg_restore</span>. Binaries can be downloaded
 314         from <a class="ulink" href="https://www.zlib.net" target="_top">https://www.zlib.net</a>.
 315        </p></dd></dl></div><p>
 316     </p></div><div class="sect3" id="INSTALL-WINDOWS-FULL-64-BIT"><div class="titlepage"><div><div><h4 class="title">17.7.5.2. Special Considerations for 64-Bit Windows <a href="#INSTALL-WINDOWS-FULL-64-BIT" class="id_link">#</a></h4></div></div></div><p>
 317      PostgreSQL will only build for the x64 architecture on 64-bit Windows.
 318     </p><p>
 319      Mixing 32- and 64-bit versions in the same build tree is not supported.
 320      The build system will automatically detect if it's running in a 32- or
 321      64-bit environment, and build PostgreSQL accordingly. For this reason, it
 322      is important to start the correct command prompt before building.
 323     </p><p>
 324      To use a server-side third party library such as <span class="productname">Python</span> or
 325      <span class="productname">OpenSSL</span>, this library <span class="emphasis"><em>must</em></span> also be
 326      64-bit. There is no support for loading a 32-bit library in a 64-bit
 327      server. Several of the third party libraries that PostgreSQL supports may
 328      only be available in 32-bit versions, in which case they cannot be used with
 329      64-bit PostgreSQL.
 330     </p></div><div class="sect3" id="WINDOWS-CRASH-DUMPS"><div class="titlepage"><div><div><h4 class="title">17.7.5.3. Collecting Crash Dumps <a href="#WINDOWS-CRASH-DUMPS" class="id_link">#</a></h4></div></div></div><p>
 331      If PostgreSQL on Windows crashes, it has the ability to generate
 332      <span class="productname">minidumps</span> that can be used to track down the cause
 333      for the crash, similar to core dumps on Unix. These dumps can be
 334      read using the <span class="productname">Windows Debugger Tools</span> or using
 335      <span class="productname">Visual Studio</span>. To enable the generation of dumps
 336      on Windows, create a subdirectory named <code class="filename">crashdumps</code>
 337      inside the cluster data directory. The dumps will then be written
 338      into this directory with a unique name based on the identifier of
 339      the crashing process and the current time of the crash.
 340     </p></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="supported-platforms.html" title="17.6. Supported Platforms">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="runtime.html" title="Chapter 18. Server Setup and Operation">Next</a></td></tr><tr><td width="40%" align="left" valign="top">17.6. Supported Platforms </td><td width="20%" align="center"><a accesskey="h" href="index.html" title="PostgreSQL 18.0 Documentation">Home</a></td><td width="40%" align="right" valign="top"> Chapter 18. Server Setup and Operation</td></tr></table></div></body></html>