PrimeBase XT (PBXT) Pluggable Storage Engine for MySQL 5.1/5.2
==============================================================

This is the binary distribution of the PrimeBase XT Storage Engine for MySQL.

This package contains plug-ins for a number of versions of MySQL. The installer
will automatically install the plug-in that matches your platform.


HOW TO INSTALL:
---------------

1. Start your MySQL server.

2. On the command line enter: ./install

NOTE: If MySQL was installed under /usr/local then you will have to run the
installer as root. This can be done as follows: sudo ./install


WHAT THE INSTALLER DOES:
------------------------

1. Copy libpbxt.so to the MySQL server plug-ins directory.

2. Send the SQL command "INSTALL PLUGIN pbxt SONAME 'libpbxt.so';" to the
   server.
  
3. MySQL 5.1.14 & 5.2.0: Make a backup copy (mysqld-bak) of mysqld and then
   replace it with a patched version of mysqld (see below for details).


HOW TO UNINSTALL:
-----------------

The installer generates a shell script called uninstall.

Run this script from the command line to remove the plug-in.

The original version of the server will also be restored.


WHY DOES THE INSTALLER PATCH mysqld?
------------------------------------

MySQL 5.1.14 and 5.2.0 have a bug which causes the server to crash when you
restart after installing a plug-in storage engine.

For more details see: http://bugs.mysql.com/bug.php?id=22694

If you are using one of these versions, the installer renames your current
version of mysqld to mysqld-bak before it is replaced with the version in
this directory.


WHAT IF THE PLUG-IN DOES NOT LOAD?
----------------------------------

If the plug-in does not load, this is probably due to the fact that your
version of MySQL was built with different compile flags.

The plug-ins in this package have been build to be compatible with the
MySQL binary distribution.

If you have built MySQL yourself, then make sure that you have not used
the '--with-debug' option. Linux versions must be built with the
'--with-fast-mutexes' option.


NEED HELP?
----------

If you have questions, comments of bug reports, let me know.

It helps if you place PBXT or XT somewhere in the subject of your e-mail
to avoid landing on the junk mail pile. :)

Thanks for using PrimeBase XT!


Paul McCullagh
paul.mccullagh@primebase.com
www.primebase.com/xt
sourceforge.net/projects/pbxt
pbxt.blogspot.com