<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ibm-db2.setup.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'en',
  ),
  'this' => 
  array (
    0 => 'ibm-db2.installation.php',
    1 => 'Installation',
    2 => 'Installation',
  ),
  'up' => 
  array (
    0 => 'ibm-db2.setup.php',
    1 => 'Installing/Configuring',
  ),
  'prev' => 
  array (
    0 => 'ibm-db2.requirements.php',
    1 => 'Requirements',
  ),
  'next' => 
  array (
    0 => 'ibm-db2.configuration.php',
    1 => 'Runtime Configuration',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    'path' => 'reference/ibm_db2/configure.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="ibm-db2.installation" class="section">
 <h2 class="title">Installation</h2>
 <p class="simpara">
  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
  <a href="https://www.ibm.com/developerworks/downloads/im/db2express/index.html" class="link external">&raquo;&nbsp;support site</a>.
 </p>
 <p class="simpara">
  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
  <strong class="command">db2iupdt -e</strong> must be issued to update the symbolic links to
  the header files and libraries in the DB2 instances.
 </p>
 <p class="para">
  ibm_db2 is a <a href="https://pecl.php.net/" class="link external">&raquo;&nbsp;PECL</a> extension, so follow the instructions in
  <a href="install.pecl.php" class="xref">Installation of PECL extensions</a> to install the ibm_db2 extension for PHP.
  Issue the <strong class="command">configure</strong> command to point to the location of
  the DB2 header files and libraries as follows:
  <div class="example-contents screen">
<div class="cdata"><pre>
bash$ ./configure --with-IBM_DB2=/path/to/DB2
</pre></div>
  </div>
  The <strong class="command">configure</strong> command defaults to
  <var class="filename">/opt/IBM/db2/V8.1</var>.
 </p>
 <blockquote class="note"><p><strong class="note">Note</strong>: 
  <strong>Note for IIS users</strong><br />
  <span class="simpara">
   If the ibm_db2 driver is being used with Microsoft Internet Information
   Server (IIS), it may be necessary to do the following:
  </span>
  <ul class="simplelist">
   <li>
    Install DB2 with extended operating system security.
   </li>
   <li>
    Add the PHP binary path to the <var class="envar">PATH</var> system environment variable (default C:\php\).
   </li>
   <li>
    Create another system environment variable equal to the path where the PHP.INI file is located (eg: PHPRC = C:\php\).
   </li>
   <li>
    Add the IUSR_COMPUTERNAME to the DB2USERS group.
   </li>
  </ul>
 </p></blockquote>
</div><?php manual_footer($setup); ?>