<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Installation</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="ibm-db2.requirements.html">Requirements</a></div>
<div class="next" style="text-align: right; float: right;"><a href="ibm-db2.configuration.html">Runtime Configuration</a></div>
<div class="up"><a href="ibm-db2.setup.html">Installing/Configuring</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="ibm-db2.installation" class="section">
<h2 class="title">Installation</h2>
<p class="para">
To build the ibm_db2 extension, the DB2 application development header
files and libraries must be installed on your system. DB2 does not install
these by default, so you may have to return to your DB2 installer and add
this option. The header files are included with the DB2 Application
Development Client freely available for download from the IBM DB2 Universal
Database <a href="http://www-306.ibm.com/software/data/db2/udb/support/downloadv8.html" class="link external">» support site</a>.
</p>
<p class="para">
If you add the DB2 application development header files and libraries to
a Linux or Unix operating system on which DB2 was already installed, you
must issue the command <strong class="command">db2iupdt -e</strong> to update the symbolic
links to the header files and libraries in your DB2 instances.
</p>
<p class="para">
ibm_db2 is a <a href="http://pecl.php.net/" class="link external">» PECL</a> extension, so follow the
instructions in <a href="install.pecl.html" 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 your 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>
<p class="para">
<blockquote class="note"><p><strong class="note">Note</strong>:
<strong>Note for IIS users</strong><br />
<p class="para">
If you are using the ibm_db2 driver with Microsoft Internet Information Server (IIS)
you may have to do the following:
</p>
<p class="para">
<ul class="simplelist">
<li class="member">
Install DB2 with extended operating system security.
</li>
<li class="member">
Add the PHP binary path to the PATH system environment variable (default C:\php\).
</li>
<li class="member">
Create another system environment variable equal to the path where the PHP.INI file is located (eg: PHPRC = C:\php\).
</li>
<li class="member">
Add the IUSR_COMPUTERNAME to the DB2USERS group.
</li>
</ul>
</p>
</p></blockquote>
</p>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="ibm-db2.requirements.html">Requirements</a></div>
<div class="next" style="text-align: right; float: right;"><a href="ibm-db2.configuration.html">Runtime Configuration</a></div>
<div class="up"><a href="ibm-db2.setup.html">Installing/Configuring</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
