2006-09-16 02:30:20 +02:00
|
|
|
<!-- $PostgreSQL: pgsql/doc/src/sgml/install-win32.sgml,v 1.29 2006/09/16 00:30:14 momjian Exp $ -->
|
2003-09-29 20:18:35 +02:00
|
|
|
|
2000-12-21 23:30:39 +01:00
|
|
|
<chapter id="install-win32">
|
2004-12-24 20:20:18 +01:00
|
|
|
<title>Client-Only Installation on <productname>Windows</productname></title>
|
1999-01-07 03:59:45 +01:00
|
|
|
|
2001-05-13 00:51:36 +02:00
|
|
|
<indexterm>
|
|
|
|
<primary>installation</primary>
|
|
|
|
<secondary>on Windows</secondary>
|
|
|
|
</indexterm>
|
|
|
|
|
2000-12-21 23:30:39 +01:00
|
|
|
<para>
|
2004-12-27 00:06:56 +01:00
|
|
|
Although a complete <productname>PostgreSQL</productname> installation
|
|
|
|
for <productname>Windows</> can only be built using
|
|
|
|
<productname>MinGW</productname> or
|
2004-12-24 20:20:18 +01:00
|
|
|
<productname>Cygwin</productname>, the C client library
|
2000-12-21 23:30:39 +01:00
|
|
|
(<application>libpq</application>) and the interactive terminal
|
2004-09-27 21:43:17 +02:00
|
|
|
(<application>psql</application>) can be compiled using other Windows
|
|
|
|
tool sets. Makefiles are included in the source distribution for
|
|
|
|
<productname>Microsoft Visual C++</productname> and
|
|
|
|
<productname>Borland C++</productname>. It should be possible to
|
|
|
|
compile the libraries manually for other configurations.
|
2000-12-21 23:30:39 +01:00
|
|
|
</para>
|
1999-01-07 03:59:45 +01:00
|
|
|
|
2000-12-21 23:30:39 +01:00
|
|
|
<tip>
|
|
|
|
<para>
|
2004-12-27 00:06:56 +01:00
|
|
|
Using <productname>MinGW</productname> or
|
|
|
|
<productname>Cygwin</productname> is preferred. If using one of
|
|
|
|
those tool sets, see <xref linkend="installation">.
|
2000-12-21 23:30:39 +01:00
|
|
|
</para>
|
|
|
|
</tip>
|
1999-01-07 03:59:45 +01:00
|
|
|
|
2000-12-21 23:30:39 +01:00
|
|
|
<para>
|
2004-09-27 21:43:17 +02:00
|
|
|
To build everything that you can on <productname>Windows</productname>
|
|
|
|
using <productname>Microsoft Visual C++</productname>, change into the
|
2000-12-21 23:30:39 +01:00
|
|
|
<filename>src</filename> directory and type the command
|
|
|
|
<screen>
|
|
|
|
<userinput>nmake /f win32.mak</userinput>
|
|
|
|
</screen>
|
|
|
|
This assumes that you have <productname>Visual C++</productname> in
|
|
|
|
your path.
|
|
|
|
</para>
|
1999-01-07 03:59:45 +01:00
|
|
|
|
2004-09-27 21:43:17 +02:00
|
|
|
<para>
|
2004-12-27 21:13:48 +01:00
|
|
|
To build everything using <productname>Borland
|
2004-09-27 21:43:17 +02:00
|
|
|
C++</productname>, change into the <filename>src</filename> directory
|
|
|
|
and type the command
|
|
|
|
<screen>
|
2005-05-11 17:10:20 +02:00
|
|
|
<userinput>make -N -DCFG=Release /f bcc32.mak</userinput>
|
2004-09-27 21:43:17 +02:00
|
|
|
</screen>
|
|
|
|
</para>
|
|
|
|
|
2000-12-21 23:30:39 +01:00
|
|
|
<para>
|
|
|
|
The following files will be built:
|
1999-01-07 03:59:45 +01:00
|
|
|
|
2000-12-21 23:30:39 +01:00
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
|
|
<term><filename>interfaces\libpq\Release\libpq.dll</filename></term>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
The dynamically linkable frontend library
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term><filename>interfaces\libpq\Release\libpqdll.lib</filename></term>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
2003-03-24 15:32:51 +01:00
|
|
|
Import library to link your programs to <filename>libpq.dll</filename>
|
2000-12-21 23:30:39 +01:00
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
1999-01-07 03:59:45 +01:00
|
|
|
|
2000-12-21 23:30:39 +01:00
|
|
|
<varlistentry>
|
|
|
|
<term><filename>interfaces\libpq\Release\libpq.lib</filename></term>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
2004-12-27 21:13:48 +01:00
|
|
|
Static version of the frontend library
|
2000-12-21 23:30:39 +01:00
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
1999-01-07 03:59:45 +01:00
|
|
|
|
2000-12-21 23:30:39 +01:00
|
|
|
<varlistentry>
|
2006-02-12 07:11:51 +01:00
|
|
|
<term><filename>bin\pg_config\Release\pg_config.exe</filename></term>
|
2000-12-21 23:30:39 +01:00
|
|
|
<term><filename>bin\psql\Release\psql.exe</filename></term>
|
2006-02-12 07:11:51 +01:00
|
|
|
<term><filename>bin\pg_dump\Release\pg_dump.exe</filename></term>
|
|
|
|
<term><filename>bin\pg_dump\Release\pg_dumpall.exe</filename></term>
|
|
|
|
<term><filename>bin\pg_dump\Release\pg_restore.exe</filename></term>
|
|
|
|
<term><filename>bin\scripts\Release\clusterdb.exe</filename></term>
|
|
|
|
<term><filename>bin\scripts\Release\createdb.exe</filename></term>
|
|
|
|
<term><filename>bin\scripts\Release\createuser.exe</filename></term>
|
|
|
|
<term><filename>bin\scripts\Release\createlang.exe</filename></term>
|
|
|
|
<term><filename>bin\scripts\Release\dropdb.exe</filename></term>
|
|
|
|
<term><filename>bin\scripts\Release\dropuser.exe</filename></term>
|
|
|
|
<term><filename>bin\scripts\Release\droplang.exe</filename></term>
|
|
|
|
<term><filename>bin\scripts\Release\vacuumdb.exe</filename></term>
|
|
|
|
<term><filename>bin\scripts\Release\reindexdb.exe</filename></term>
|
2000-12-21 23:30:39 +01:00
|
|
|
<listitem>
|
|
|
|
<para>
|
2006-02-12 07:11:51 +01:00
|
|
|
The <productname>PostgreSQL</productname> client applications and utilities.
|
2000-12-21 23:30:39 +01:00
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
2006-02-12 07:11:51 +01:00
|
|
|
|
2000-12-21 23:30:39 +01:00
|
|
|
</variablelist>
|
|
|
|
</para>
|
1999-01-07 03:59:45 +01:00
|
|
|
|
2000-12-21 23:30:39 +01:00
|
|
|
<para>
|
|
|
|
The only file that really needs to be installed is the
|
|
|
|
<filename>libpq.dll</filename> library. This file should in most
|
|
|
|
cases be placed in the <filename>WINNT\SYSTEM32</filename> directory
|
|
|
|
(or in <filename>WINDOWS\SYSTEM</filename> on a Windows 95/98/ME
|
|
|
|
system). If this file is installed using a setup program, it should
|
|
|
|
be installed with version checking using the
|
|
|
|
<symbol>VERSIONINFO</symbol> resource included in the file, to
|
|
|
|
ensure that a newer version of the library is not overwritten.
|
|
|
|
</para>
|
1999-01-07 03:59:45 +01:00
|
|
|
|
2000-12-21 23:30:39 +01:00
|
|
|
<para>
|
2004-09-27 21:43:17 +02:00
|
|
|
If you plan to do development using <application>libpq</application>
|
|
|
|
on this machine, you will have to add the
|
|
|
|
<filename>src\include</filename> and
|
|
|
|
<filename>src\interfaces\libpq</filename> subdirectories of the source
|
2004-12-27 00:06:56 +01:00
|
|
|
tree to the include path in your compiler's settings.
|
2000-12-21 23:30:39 +01:00
|
|
|
</para>
|
1999-01-07 03:59:45 +01:00
|
|
|
|
2000-12-21 23:30:39 +01:00
|
|
|
<para>
|
2003-03-24 15:32:51 +01:00
|
|
|
To use the library, you must add the
|
2000-12-21 23:30:39 +01:00
|
|
|
<filename>libpqdll.lib</filename> file to your project. (In Visual
|
2001-11-28 21:49:10 +01:00
|
|
|
C++, just right-click on the project and choose to add it.)
|
2000-12-21 23:30:39 +01:00
|
|
|
</para>
|
1999-01-07 03:59:45 +01:00
|
|
|
|
2005-05-11 18:02:12 +02:00
|
|
|
<para>
|
|
|
|
Free development tools from <productname>Microsoft</productname>
|
|
|
|
can be downloaded from
|
|
|
|
<ulink url="http://msdn.microsoft.com/visualc/vctoolkit2003/"></>.
|
|
|
|
You will also need <filename>MSVCRT.lib</> from the platform SDK from
|
|
|
|
<ulink url="http://www.microsoft.com/msdownload/platformsdk/sdkupdate/"></>.
|
|
|
|
You can also download the <application>.NET</> framework from
|
|
|
|
<ulink url="http://msdn.microsoft.com/netframework/downloads/updates/default.aspx"></>.
|
|
|
|
Once installed, the toolkit binaries must be in your path, and you might
|
|
|
|
need to add a <literal>/lib:<libpath></> to point to <filename>MSVCRT.lib</>.
|
|
|
|
Free <productname>Borland C++</productname> compiler tools can be downloaded from
|
|
|
|
<ulink url="http://www.borland.com/products/downloads/download_cbuilder.html#"></>,
|
|
|
|
and require similar setup.
|
2005-05-13 17:21:59 +02:00
|
|
|
</para>
|
2000-12-21 23:30:39 +01:00
|
|
|
</chapter>
|