<!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>Requirements</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="ibm-db2.setup.html">Installing/Configuring</a></div>
<div class="next" style="text-align: right; float: right;"><a href="ibm-db2.installation.html">Installation</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.requirements" class="section">
<h2 class="title">Requirements</h2>
<p class="para">
To connect to IBM DB2 Universal Database for Linux, UNIX, and Windows, or
IBM Cloudscape, or Apache Derby, you must install an IBM DB2 Universal
Database client on the same computer on which you are running PHP. The
extension has been developed and tested with DB2 Version 8.2.
</p>
<p class="para">
To connect to IBM DB2 Universal Database for z/OS or iSeries, you also
require IBM DB2 Connect or the equivalent DRDA gateway software.
</p>
<div class="section" id="ibm-db2.requirements.unix">
<h2 class="title">Requirements on Linux or Unix</h2>
<p class="para">
The user invoking the PHP executable or SAPI must specify the DB2 instance
before accessing these functions. You can set the name of the DB2 instance
in <var class="filename">php.ini</var> using the <em>ibm_db2.instance_name</em>
configuration option, or you can source the DB2 instance profile before
invoking the PHP executable.
</p>
<p class="para">
If you created a DB2 instance named <em>db2inst1</em> in
<var class="filename">/home/db2inst1/</var>, for example, you can add the
following line to <var class="filename">php.ini</var>:
<div class="example-contents screen">
<div class="cdata"><pre>
ibm_db2.instance_name=db2inst1
</pre></div>
</div>
If you do not set this option in <var class="filename">php.ini</var>, you must issue the
following command to modify your environment variables to enable access to
DB2:
<div class="example-contents screen">
<div class="cdata"><pre>
bash$ source /home/db2inst1/sqllib/db2profile
</pre></div>
</div>
To enable your PHP-enabled Web server to access these functions, you must
either set the <em>ibm_db2.instance_name</em> configuration
option in <var class="filename">php.ini</var>, or source the DB2 instance environment in your Web
server start script (typically <var class="filename">/etc/init.d/httpd</var> or
<var class="filename">/etc/init.d/apache</var>).
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="ibm-db2.setup.html">Installing/Configuring</a></div>
<div class="next" style="text-align: right; float: right;"><a href="ibm-db2.installation.html">Installation</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>
