WHAT IT IS

  Reimplementation of libmysqlclient library, using Carob to benefit from
  clustering. So, native mysql client programs can use the Sequoia clustering
  solution without changing any line of code in the application.

  Project home page is at http://carob.continuent.org
  
HOW TO USE IT

  Install the debian or rpm package and you are ready with the first step. Now
  you can try one of the following steps:
  * If libmysqlclient is linked dinamically:
    LD_PRELOAD=/path/to/libmysequoia.so ./your_program
  * If this will not work then you must recompile the sources of the application.
    It's easy just replace every ocurence of "mysql_config" with "mysequoia_config"
    after that:
    ./configure && make && make install
  
  In the CVS there are patch files for recompiling PHP, Python and Perl for Redhat.

SEQUOIA CONFIGURATION

  In the "config" directory you can find some sample configuration file for Sequoia.
  This files must be copied to $SEQUOIA_HOME/config directory.
  The JDBC driver must be downloaded from http://dev.mysql.com/downloads/connector/j/3.1.html
  and the JAR file copied to $SEQUOIA_HOME/drivers directory.
  Note for developers: before the "make check" you must start the Sequoia controller using
  the configuration files from the "config" directory.
  
APT-GET AND YUM REPOSITORIES

  Include the following lines in your /etc/apt/sources.list file for apt-get:
  
  deb http://carob.continuent.org/repo/debian/ binary/
  deb-src http://carob.continuent.org/repo/debian/ source/
 
  Include the following lines in your /etc/yum.repos.d/Continuent.repo for yum:
  
  [continuent]
  name=Continuent
  baseurl=http://carob.continuent.org/repo/rhel4
  gpgcheck=0
 
  The packages are compiled with the MySQL 5.0 header files. If you want to use
  with MySQL 4.1 then you need to recompile the packages.
  
DEPENDENCIES

  * carob - http://carob.continuent.org/
  * log4cxx (0.9.7) - http://logging.apache.org/log4cxx/
  * iconv - http://www.gnu.org/software/libiconv/

  iconv is included in glibc. So all Linux systems for instance
  already have it.

  For developers 4 more dependencies (the last 3 are optional):

  * mysqlclient development - http://dev.mysql.com/doc/refman/5.0/en/c.html
  * cppunit - http://cppunit.sourceforge.net/cppunit-wiki
  * lcov - http://ltp.sourceforge.net/coverage/lcov.php
  * doxygen - http://www.stack.nl/~dimitri/doxygen/
  
CURRENT LIMITATIONS

  The following MySQL API C functions are not implemented (in fact they are dummy
  functions)
  * mysql_ping
  * mysql_debug
  * mysql_shutdown
  * mysql_list_processes
  * mysql_stat
  * mysql_thread_id
  * mysql_kill
  
  Also, please note that Sequoia does not implement the whole MySQL SQL dialect. If
  some queries are not working try to rewrite using standard SQL dialect.
