Z MySQL DA


  This is the Z MySQL database adapter product for the 
  Z Object Publishing Environment.

  ***** IMPORTANT *****

  This product is distributed as a NON-BINARY release!

  This product requires compiled Python extensions that are
  NOT included as binaries with this release. You must build
  or install the required extensions using the instructions 
  below before the product will work properly!

  Installation

    The Z MySQL database adapter product requires that the Python
    MySQLmodule extension be installed. 

    **Note** that this is a different extension than the older 
    "mySQLmodule" extension - the older "mySQLmodule" extension will 
    NOT WORK with this product!

    The source files and associated files required to build the 
    required MySQLmodule are included in this product distribution.
    Follow the steps below to build the extension on UNIX platforms.
    Note that the included files do not support building on win32 
    platforms at this time.

      o Ensure that you have Python 1.5 or greater installed.

      o Ensure that you have MySQL installed on your machine,
        INCLUDING THE FILES AND LIBRARIES NECESSARY TO DEVELOP
        MySQL APPLICATIONS. This is generally only an issue if
        you used an RPM installation of MySQL, which may not have
        installed the various include files and libraries required
        to compile the MySQL extension. If you do not have the developer 
        files installed, you will need to download them from the
        MySQL web site at http://www.tcx.se. Please contact the
        MySQL maintainers with all questions pertaining to the
        use or installation of development files.

      o If you have a previously-installed version of ZmySQLDA, MOVE
        OR REMOVE THE OLD lib/python/Products/ZmySQLDA DIRECTORY. This
        new version will allow you to continue to use existing database
        connection objects created with the old version of ZmySQLDA.

      o Ensure that you have extracted the ZMySQLDA product distribution
        in your top-level Zope directory. This should have created a 
        subdirectory named lib/python/Products/ZMySQLDA containing the 
        product files as well as this README file.

      o Build the extension.

        Change to the /src directory of your ZSolidDA product directory
	and issue the following commands::
    
  	  make -f Makefile.pre.in boot
	  make

        Note that if the Python interpreter that will be used to run
        Zope is not run with the command 'python', then you must
        supply the command used to run Python as an option on the
        first make command.  For example, if you run Python with the
        command 'python1.5.1', then use::

  	  make -f Makefile.pre.in boot PYTHON=python1.5.1
    
	This should create the file MySQLmodule.so in your src directory.
        This file is a dynamically-linked library.  Some versions of
        Unix (e.g. HP/UX) use a different suffix for dynamically-linked 
        libraries. If errors occur when trying to build the extension, you 
        may need to modify the Setup file to ensure that the correct MySQL 
        include and lib directory options are being passed to the compiler.

        Next, start Python and type "import MySQL", to make sure you can
        import the module without problems. If Python is unable to import
        the module, you may need to try rebuilding the module, changing the
        the switch "-lm" to "-lgcc" in the Setup file.

        Finally, copy the output file MySQLmodule.so up one directory into
        your ZMySQLDA product directory and restart your Zope installation 
        to complete the product installation.




