- Update the unit tests to be more independent
- Add support for the Ingres BOOLEAN type
- Add ingres_fetch_assoc()
- Allow for a 0 offset in all ingres field functions
- Update build scripts for OpenVMS CSWS PHP 2.0
- Fix bug 17556 – Handle errors for non-result returning statements
- Fix bug 16960 – SEGV when fetching the results from a row producing procedure
- Fix bug 16990 – SEGV when executing a database procedure
- Fix bug 17510 – Fix php_ii_set_connect_options so they work as documented
- Fix bug 17302 – _close_statement is unable to free active statements
- Fix bug 17207 – Under certain conditions the driver can SEGV when doing cleaning up
- Fix bug 17198 – Unable to close non-result statements
- Fix bug 17092 – SIGBUS when fetching data on 64-bit Solaris
- IIapi_getDescriptor() should only be called for SELECT statements
- Fix bug 16752 – Send all string values as IIAPI_VCH_TYPE

You can download the source code from http://pecl.php.net/get/ingres or install directly from the command line using the command:

sudo pecl install ingres-2.2.2

Pre-built Windows binaries are available from ESD for PHP 5.1.6, 5.2.13 and 5.3.2. An OpenVMS binary for CSWS PHP 2.0 will be updated today. You can raise questions/problems via the Ingres Community Forums, the project home page or via Service Desk.

Related Posts

• PHP Ingres 2.2.1 released
• PHP Ingres 2.2.0 released
• PHP Ingres 2.1.0 released

Getting web applications to connect to Ingres via Apache on UNIX/Linux can be quite fiddly. Here is a simple guide on the setup steps needed to allow the Ingres PHP, Python and Ruby drivers to work with Apache on RedHat Enterprise Linux, CentOS and Fedora Linux. I’ve also published articles on doing the same for Debian/Ubunutu and Novell SLES/OpenSUSE in the Ingres Community Wiki.

Pre-requisites

It is assumed that you have the following installed:

• Ingres 2006 or newer ( Ingres >= 9.0.4 )
• RedHat Enterprise Linux 5.4, CentOS 5.4 and Fedora Linux 11
  • These steps might apply to earlier releases as well
• Apache 2.2.8
  • The steps here apply to other releases of Apache from 1.3 onwards
  • mod_env – An Apache module which modifies the environment which is passed to CGI scripts and SSI pages

Disabling SELinux

As of writing this Ingres and SELinux do not interact very well. To use Ingres on an SELinux enabled system, SELinux needs to be placed in permissive or disabled modes. To determine the current state of SELinux run the following:

sestatus

sample output:

$ sudo /usr/sbin/sestatus
SELinux status:                 disabled

If the status is enforcing then SELinux must be disabled using the command:

setenforce 0
# or to disable SELinux but log exceptions to policy to /var/log/secure
setenforce Permissive

This will only disable SELinux until the next reboot of the server. To make the change permanent edit /etc/sysconfig/selinux, changing SELINUX to disabled or permissive.

Enabling Ingres for Apache

Any user that connects to Ingres must be a known (defined) user. Specifically a user account must be created within Ingres using CREATE USER .... In the case of web applications served by Apache, Tomcat or whatever, the server process owner is the user that Ingres will initially see. To determine the process owner for Apache execute the following:

ps -fe | grep httpd | grep -v grep

On my system I get the following:

[grant@uksl-grant-rhel64 ~]$ ps -fe | grep httpd | grep -v grep
root      3331     1  0 Apr08 ?        00:00:02 /usr/sbin/httpd
apache   23356  3331  0 Apr11 ?        00:00:00 /usr/sbin/httpd
apache   23357  3331  0 Apr11 ?        00:00:00 /usr/sbin/httpd
apache   23358  3331  0 Apr11 ?        00:00:00 /usr/sbin/httpd
apache   23359  3331  0 Apr11 ?        00:00:00 /usr/sbin/httpd
apache   23360  3331  0 Apr11 ?        00:00:00 /usr/sbin/httpd
apache   23361  3331  0 Apr11 ?        00:00:00 /usr/sbin/httpd
apache   23362  3331  0 Apr11 ?        00:00:00 /usr/sbin/httpd
apache   23363  3331  0 Apr11 ?        00:00:00 /usr/sbin/httpd

Which shows two user accounts for Apache. The root account can be ignored since it is a monitor/control process that starts up and shuts down servers as required. The processes run under the apache account will be used to connect to Ingres.

To add apache to Ingres run the following, as the ingres administrator:

sql iidbdb <<EOSQL
create user apache\g
commit\g
\q
EOSQL

You should see something similar to:

ingres@esva-suse:~> sql iidbdb <<EOSQL
> create user apache\g
> commit\g
> \q
> EOSQL
INGRES TERMINAL MONITOR Copyright 2008 Ingres Corporation
Ingres Linux Version II 9.2.0 (a64.lnx/143)NPTL login
Tue Apr 13 23:33:18 2010
continue
* Executing . . .
continue
* Executing . . .
continue
* Ingres Version II 9.2.0 (a64.lnx/143)NPTL logout
Tue Apr 13 23:33:18 2010

Now the Ingres DBMS is setup for the Apache web server.

Enabling Apache for Ingres

1. Edit, (as root), /etc/sysconfig/httpd to include the following:

    II_SYSTEM=/opt/Ingres/IngresII
    LD_LIBRARY_PATH=/opt/Ingres/IngresII/ingres/lib:/opt/Ingres/IngresII/ingres/lib/lp32
    ODBCSYSINI=/opt/Ingres/IngresII/ingres/files
    export II_SYSTEM LD_LIBRARY_PATH ODBCSYSINI

   Note – ODBCSYSINI is only needed for the Python driver or applications based on ODBC

2. Create a new config file (as root), /etc/httpd/conf.d/ingres.conf, adding the following:

PassEnv II_SYSTEM LD_LIBRARY_PATH ODBCSYSINI

3. Restart apache (as root):

   service httpd restart

Verifying the setup

To see that the environment variables are visible the following code snippets can be executed through Apache through PHP and mod_python.

PHP

• Code:

  < ?php
    echo "II_SYSTEM is :" .$_SERVER["II_SYSTEM"] . "<br/>\n";
    echo "LD_LIBRARY_PATH is :" .$_SERVER["LD_LIBRARY_PATH"] . "<br />\n";
  ?>

• Sample Output:

  II_SYSTEM is :/opt/Ingres/IngresII
  LD_LIBRARY_PATH is :/opt/Ingres/IngresII/ingres/lib:/opt/Ingres/IngresII/ingres/lib/lp32
  

Python

• Code, save as python_env.py:

from mod_python import apache
def environment(req):
    req.content_type = "text/html"
    req.add_common_vars()
    env_vars = req.subprocess_env.copy()
    req.write('< !DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">')
    req.write('<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">')
    req.write('<head><title>mod_python.publisher</title></head>')
    req.write('<body>')
    req.write('<h2>Environment Variables</h2>')
    req.write('<table border="1">')
    req.write('<tr><td>%s</td><td>%s</td></tr>' % ("II_SYSTEM", env_vars['II_SYSTEM']))
    req.write('<tr><td>%s</td><td>%s</td></tr>' % ("LD_LIBRARY_PATH", env_vars['LD_LIBRARY_PATH']))
    req.write('</table>')
    req.write('</body>')
    req.write('</html>')

• Ouput from http://localhost/env.py/environment:

   Environment Variables
   II_SYSTEM	/opt/Ingres/II
   LD_LIBRARY_PATH	/lib:/usr/lib:/usr/local/lib:/opt/Ingres/II/ingres/lib:/opt/Ingres/II/ingres/lib/lp32
  

If you have any comments feel free to post them below.

Updated Apr 14, 2010 9:50 to include SELinux information

Related Posts

• Using IMA to get a list of inbound/outbound connections in GCC
• Ingres Ruby driver updated – version 1.4.1
• Improving the Improved – docs.ingres.com

Related Posts

• PECL ingres-2.2.2 released
• PHP Ingres 2.2.1 released
• PHP 5.3.0 released

Related Posts

• PHP Ingres 2.2.0 released
• PHP Ingres 2.1.0 released
• PHP driver 2.0.2 released

Related Posts

• PHP Ingres 2.2.1 released
• PHP Ingres 2.2.0 released
• PHP Ingres 2.1.0 released

This update is implements several bits of new functionality as can seen from the CHANGELOG

• Add ingres.fetch_buffer_size to configure to the number of rows ingres_query() will fetch.
• Add ingres_charset() to fetch the installation II_CHARSETxx value
• Add ingres.describe ini setting to allow disabling of DESCRIBE INPUT if desired
• Add support for DESCRIBE INPUT
• Add ingres_escape_string()
• Add ingres_result_seek() to support row positioning

Some Links:

• Package home – http://pecl.php.net/package/ingres
• Changelog – http://pecl.php.net/package-changelog.php?package=ingres
• Source Download – http://pecl.php.net/get/ingres-2.1.0.tgz
• W32 Download – http://esd.ingres.com/product/drivers/PHP/Windows_32-Bit

Related Posts

• PHP Ingres 2.2.1 released
• PHP Ingres 2.2.0 released
• PHP driver 2.0.2 released

2.0.2 is minor release fixing a couple of memory leaks and a SEGV. For your enjoyment, here is the complete CHANGELOG:

- Fix corrupt Ingres MONEY to PHP DOUBLE conversions
- Eliminate memory leak when ingres_free_result() is not called
- Fix ingres_field_name() so it returns the correct column name
- Fix SEGV in php_ii_convert_data() when converting DATE to STRING
- Enable the extension to build on Mac OS X and HP-UX
- Reduce the number of emalloc calls in php_ii_fetch()
- Clean up proto entries in ingres.c
- Make ingres_conn_*() and ingres_stmt_* aliases for their ingres_err*() counterparts

And now for some links:

• README.html – http://cvs.php.net/viewvc.cgi/pecl/ingres/README.html?view=co&pathrev=RELEASE_2_0_2
• Source code – http://pecl.ingres.net/get/ingres
• Windows DLLs – Since http://pecl4win.php.net is no longer being updated, I have made available DLLs for PHP 5.1.6, 5.2.6 and 5.2.8 for Ingres 2.6/0305, 9.0.4, 9.1.1, 9.2.0 and 9.3.0 at http://esd.ingres.com/product/drivers/PHP/Windows_32-Bit/PHP_Driver

As always if you experience any problems with the driver you can email me via grant @ php dot net, or raise and issue via Servicedesk.

Related Posts

• PHP Ingres 2.2.1 released
• PHP Ingres 2.2.0 released
• PHP Ingres 2.1.0 released

2.0.1 is major/minor release in as much as it is just a bunch of bug fixes but includes some important changes. From the CHANGELOG here are what I believe are the two most notable updates:

1. Improved performance by batch fetching rows – the ingres_fetch_*() functions will now retrieve upto 100 rows from the server, reducing the network traffic required to fetch those same 100 rows, one at a time. Whether the DBMS engine provides 100 rows is another matter as this is dependant upon the width of the row and the ability to make good use of the GCA packet. Performance improvements of between 2 and 30 times have been observed. YMMV…
2. Improved interoperability when working with older Ingres releases – some time in the past interoperability between versions of Ingres broke when using the PHP driver. Driver functionality is based on the Ingres release against which it is built. For example Ingres 9.2.0 introduced bi-directional scrollable cursor support. When the driver was build against 9.2.0 but connected to an earlier release of Ingres it did not know that the DBMS engine could not provide that feature. The driver is now “aware” of the capabilities of the server to which it is connected and will only use features supported in that engine.

And now for some links:

• README.html – http://cvs.php.net/viewvc.cgi/pecl/ingres/README.html?view=co&pathrev=RELEASE_2_0_1
• Source code – http://pecl.ingres.net/get/ingres
• Windows DLLs – Since http://pecl4win.php.net is no longer being updated, I have made available DLLs for PHP 5.1.6, 5.2.6 and 5.2.8 for Ingres 2.6/0305, 9.0.4, 9.1.1, 9.2.0 and 9.3.0 at http://esd.ingres.com/product/drivers/PHP/Windows_32-Bit/PHP_Driver

As always if you experience any problems with the driver you can email me via grant @ php dot net, or raise and issue via Servicedesk.

Feliz Navidad a todos

grant

Related Posts

• PHP Ingres 2.2.1 released
• PHP Ingres 2.2.0 released
• PHP Ingres 2.1.0 released

• To attend the session at 6am PDT (14:00 UK, 15:00 CEDT, 00:00 AEDT Weds) here
• To attend the session at 5pm PDT (01:00 UK Weds, 02:00 CEDT Weds, 10:00 AEDT Weds) register here

The following week, 16th April, I will presenting a session on working on the driver code and how to submit changes in to the driver.

• To attend the session at 6am PDT (14:00 UK, 15:00 CEDT, 00:00 AEDT Weds) here
• To attend the session at 5pm PDT (01:00 UK Weds, 02:00 CEDT Weds, 10:00 AEDT Weds) register here

Hope to see you there.

Some random posts

• Added support for multiple concurrent result-sets
• Added automatic coercion between UTF-8 and UTF-16
• Added support for Bi-directional scrolling cursors
• Added ingres_free_results() – free the memory associated with a given result set
• Added ingres_autocommit_state() – return the current auto-commit state
• Added ingres_next_error() – fetch additional errors if any

If you are feeling brave you can grab the code from cvs.php.net:

cvs co -d somedir pecl/ingres

If you want to run it along side an existing pecl ingres install I would recommend you use the following (ahem, undocumented) configure flag:

./configure --enable-ingres2

Documentation will follow, first with an overhaul of the README(.html) as well as the information on http://php.net/ingres.

Technorati Tags: ingres, pecl, php, update

Some random posts