<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<section xml:id="ibm-db2.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.install;
 <para>
  To build the ibm_db2 extension, the DB2 application development header files
  and libraries must be installed on the system.
  DB2 does not install these by default, so it may be necessary to return to the
  DB2 installer and add this option.
  The DB2 Application Development Client includes the header files and is freely
  available for download from the IBM DB2 Universal Database
  <link xlink:href="&url.ibm.db2.client;">support site</link>.
 </para>
 <para>
  If the DB2 application development header files and libraries are added to a
  Linux or Unix operating system on which DB2 was already installed, the command
  <command>db2iupdt -e</command> must be issued to update the symbolic links to
  the header files and libraries in the DB2 instances.
 </para>
 <para>
  ibm_db2 is a &link.pecl; extension, so follow the instructions in
  <xref linkend='install.pecl' /> to install the ibm_db2 extension for PHP.
  Issue the <command>configure</command> command to point to the location of
  the DB2 header files and libraries as follows:
  <screen>
<![CDATA[
bash$ ./configure --with-IBM_DB2=/path/to/DB2
]]>
  </screen>
  The <command>configure</command> command defaults to
  <filename class="directory">/opt/IBM/db2/V8.1</filename>.
 </para>
 <para>
  <note>
   <title>Note for IIS users</title>
   <para>
    If the ibm_db2 driver is being used with Microsoft Internet Information
    Server (IIS), it may be necessary to do the following:
   </para>
   <para>
    <simplelist>
     <member>
      Install DB2 with extended operating system security.
     </member>
     <member>
      Add the PHP binary path to the <envar>PATH</envar> system environment variable (default C:\php\).
     </member>
     <member>
      Create another system environment variable equal to the path where the PHP.INI file is located (eg: PHPRC = C:\php\).
     </member>
     <member>
      Add the IUSR_COMPUTERNAME to the DB2USERS group.
     </member>
    </simplelist>
   </para>
  </note>
 </para>
</section>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
