<!-- $Header: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v 1.69 2001/12/08 03:24:22 thomas Exp $ -->

<!-- $Header: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v 1.70 2001/12/19 18:49:56 petere Exp $ -->

<chapter id="installation">

<title><![%standalone-include[<productname>PostgreSQL</>]]>

<screen>

<userinput>gmake --version</userinput>

</screen>

If at all possible you should use version 3.76.1 or later.

It is recommended to use version 3.76.1 or later.

</para>

</listitem>

into private directories under

<varname>includedir</varname>.

See the <citetitle>Programmer's Guide</citetitle> for

information how to get at the header files for each interface.

informationabouthow to get at the header files for each interface.

Finally, a private subdirectory will also be created, if appropriate,

under <varname>libdir</varname> for dynamically loadable modules.

</para>

to display a program's message in a language other than

English. <replaceable>LANGUAGES</replaceable> is a space

separated list of codes of the languages that you want

supported. (The intersection between your list and the set

supported, for example <literal>--enable-nls='de fr'</>.

(The intersection between your list and the set

of actually provided translations will be computed

automatically.) If you do not specify it, then all available

translations are installed.

<para>

Build the ODBC driver. By default, the driver will be independent

of a driver manager. To work better with a driver manager already

installed on your system, use one of the following options. More

information can be found in the <citetitle>Programmer's Guide</citetitle>.

installed on your system, use one of the following options in addition

to this one. More information can be found in the

<citetitle>Programmer's Guide</citetitle>.

</para>

</listitem>

</varlistentry>

</varlistentry>

<varlistentry>

<term><option>--with-krb4=<replaceable>DIRECTORY</></option></term>

<term><option>--with-krb5=<replaceable>DIRECTORY</></option></term>

<term><option>--with-krb4<optional>=<replaceable>DIRECTORY</></></option></term>

<term><option>--with-krb5<optional>=<replaceable>DIRECTORY</></></option></term>

<listitem>

<para>

Build with support for Kerberos authentication. You can use

<seealso>SSL</seealso>

</indexterm>

<term><option>--with-openssl=<replaceable>DIRECTORY</></option></term>

<term><option>--with-openssl<optional>=<replaceable>DIRECTORY</></></option></term>

<listitem>

<para>

Build with support for <acronym>SSL</> (encrypted) connections.

</para>

<para>

The standardinstall installs only the header files needed for client

The standardinstallation contains only the header files needed for client

application development. If you plan to do any server-side program

development (such as custom functions or data types written in C),

then you may want to install the entire <productname>PostgreSQL</>

</para>

<formalpara>

<title>Client-only installation</title>

<title>Client-only installation:</title>

<para>

If you want to install only the client applications and

interface libraries, then you can use these commands:

<option><literal>--libdir</></> to in <xref linkend="configure">.

You should put these commands into a shell start-up file such as

<filename>/etc/profile</> or <filename>~/.bash_profile</>. Some

good information about the caveats associated withthe method can

good information about the caveats associated withthis method can

be found at <ulink

url="http://www.visi.com/~barr/ldpath.html"></ulink>.

</para>

<itemizedlist>

<listitem>

<para>

The <citetitle>Tutorial</> should be your first reading if you

are completely new to <acronym>SQL</> databases. It should have

been installed at

<filename>/usr/local/pgsql/doc/html/tutorial.html</> unless you

The <productname>PostgreSQL</> distribution contains a

comprehensive documentation set, which you should read sometime.

After installation, the documentation can be accessed by

pointing your browser to

<filename>/usr/local/pgsql/doc/html/index.html</>, unless you

changed the installation directories.

</para>

</listitem>

<listitem>

<para>

The <citetitle>Tutorial</> should be your first reading if you

are completely new to <acronym>SQL</> databases.

If you are familiar with database concepts then you want to

proceed with the <citetitle>Administrator's Guide</citetitle>,

which contains information about how to set up the database

server, database users, and authentication. It can be found at

<filename>/usr/local/pgsql/doc/html/admin.html</>.

server, database users, and authentication.

</para>

</listitem>

<entry>OBSD-3.0</entry>

</row>

<row>

<entry><systemitem class="osname">OpenUnix</></entry>

<entry><systemitem class="osname">OpenUNIX</></entry>

<entry><systemitem>x86</></entry>

<entry>7.2</entry>

<entry>2001-11-28,

<entry>2001-05-24,

Bernd Tegge (<email>tegge@repas-aeg.de</email>)

</entry>

<entry>7.2 w/patches on QNX 6;see also <filename>doc/FAQ_QNX4</filename></entry>

<entry>see also <filename>doc/FAQ_QNX4</filename></entry>

</row>

<row>

<entry><systemitem class="osname">Solaris</></entry>

Martin Renters (<email>martin@datafax.com</email>)</entry>

<entry>2.8; see also <filename>doc/FAQ_Solaris</filename></entry>

</row>

<!--

No longer compiles without error, but not really needing to be listed

as unsupported either since it is superceded by Solaris. - thomas 2001-12-03

<row>

<entry><systemitem class="osname">SunOS</></entry>

<entry><systemitem>Sparc</></entry>

<entry>7.1</entry>

<entry>2001-03-23,

Tatsuo Ishii (<email>t-ishii@sra.co.jp</email>)</entry>

<entry>4.1.4</entry>

</row>

-->

<row>

<entry><systemitem class="osname">Tru64</></entry>

<entry><systemitem class="osname">Tru64 UNIX</></entry>

<entry><systemitem>Alpha</></entry>

<entry>7.2</entry>

<entry>2001-11-26,

</informaltable>

<formalpara>

<title>Unsupported Platforms</title>

<title>Unsupported Platforms:</title>

<para>

The following platformshave not been verified to work. Platforms

listed for version 6.3.xandlater should also work with

&version;, but we did not receive explicit confirmation of such at

the time this list was compiled. We include these here to let you

The following platformsare either known not to work, or they used

to work in a previous releaseandwe did not receive explicit

confirmation of a successful test with version &majorversion; at

the time this list was compiled.We include these here to let you

know that these platforms <emphasis>could</> be supported if given

some attention.

</para>

<entry><systemitem>m88k</></entry>

<entry>6.3</entry>

<entry>1998-03-01, Brian E Gallew (<email>geek+@cmu.edu</email>)</entry>

<entry>6.4 probably OK</entry>

<entry>no recent reports</entry>

</row>

<!--

Obsolete platform? This distro was merged into PPC afaik. - thomas 2001-12-07

<entry>1998-03-01, David Wetzel (<email>dave@turbocat.de</email>)</entry>

<entry>bit rot suspected</entry>

</row>

<row>

<entry><systemitem class="osname">QNX 6</></entry>

<entry><systemitem>x86</></entry>

<entry>7.2</entry>

<entry>2001-11-20, Igor Kovalenko (<email>Igor.Kovalenko@motorola.com</email>)</entry>

<entry>patches available, but too late for 7.2</entry>

</row>

<row>

<entry><systemitem class="osname">SCO OpenServer 5</></entry>

<entry><systemitem>x86</></entry>

<entry>6.5</entry>

<entry>1999-05-25, Andrew Merrill (<email>andrew@compclass.com</>)</entry>

<entry>7.1 should work, but no reports; see also <filename>doc/FAQ_SCO</filename></entry>

<entry>7.2 should work, but no reports; see also <filename>doc/FAQ_SCO</filename></entry>

</row>

<row>

<entry><systemitem class="osname">SunOS</></entry>

<entry><systemitem>Sparc</></entry>

<entry>7.2</entry>

<entry>2001-12-04, Tatsuo Ishii (<email>t-ishii@sra.co.jp</email>)</entry>

<entry><function>memcmp()</> does not work correctly, so probably not reliable</entry>

</row>

<row>

<entry><systemitem class="osname">System V R4</></entry>

<entry><systemitem>MIPS</></entry>

<entry>6.4</entry>

<entry>1998-10-28, Frank Ridderbusch (<email>ridderbusch.pad@sni.de</email>)</entry>

<entry>no64-bit integer</entry>

<entry>norecent reports</entry>

</row>

<row>

<entry><systemitem class="osname">Ultrix</></entry>

<entry><systemitem>VAX</></entry>

<entry>6.x</entry>

<entry>1998-03-01</entry>

<entry>No recent reports</entry>

<entry>no recent reports</entry>

</row>

<row>

<entry><systemitem class="osname">Windows 9x, ME, NT, 2000</> (native)</entry>

<entry>2001-03-26, Magnus Hagander (<email>mha@sollentuna.net</email>)</entry>

<entry>

client-side libraries (<application>libpq</> and <application>psql</>) or ODBC or JDBC, no server-side;

<![%standalone-include[see Administrator's Guide]]>

<![%standalone-include[see<citetitle>Administrator's Guide</>]]>

<![%standalone-ignore[see <xref linkend="install-win32">]]>

for instructions

</entry>