DBIx/HA version 1.00 ==================== DBIx::HA is a High Availability module for DBI. It is implemented by overloading the DBI connect, prepare and execute methods and can be seamlessly used without code modification except for initialization. DBIx::HA also works seamlessly with Apache::DBI when available, and ensures that cached database handles in the Apache::DBI module are properly released when failing over. Features of DBIx::HA are: - multiple failovers Should a datasource become unavailable, queries are automatically sent to the next available datasource in a user-configured datasource stack. All subsequent queries continue to hit the failover server until reinitialized. This ensures that a failed datasource can be properly brought back online before it is put back in service. - timeouts Database calls are wrapped in user-configurable timeouts. Connect and execute timeouts are handled independently. - configurable retries Queries can be retried n times before a datasource is considered failed. - callback function A user-defined callback function can be called upon abnormal failure and disconnection from a datasource in order to clean locally cached handles and perform other housekeeping tasks. - inter-process automatic failover under mod_perl Failover can be triggered for a single process or a set of processes at the application level. Specifically designed for Apache's multi-process model, if one mod_perl process triggers a failover, it is propagated to all other mod_perl processes using the same database handle. DBIx::HA was designed primarily for reliability and speed. Functionality that would compromise speed was not considered. This module has been tested extensively at very high loads in the Apache/mod_perl/Sybase environment. INSTALLATION To install this module type the following: perl Makefile.PL make make install DEPENDENCIES This modules requires Perl >= 5.6.0. It also requires DBI >= 1.49 Apache::DBI is recommended when using mod_perl (v1 only). If using Apache::DBI, version 0.89 or above is required. WEBSITE AND SVN REPOSITORY The DBIx::HA sourcecode is hosted on Google Code: http://code.google.com/p/perl-dbix-ha/ Please submit bug reports or feature improvements in at the site above. The SVN repository can likewise be accessed at: http://perl-dbix-ha.googlecode.com/svn/ COPYRIGHT AND LICENCE Copyright (C) 2003-2006 Henri Asseily <henri@asseily.com>. All rights reserved. This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.