NOTE: This document is essentially that of DBD::Oracle's README. Most of the points from that still apply. Original document: (c)Tim Bunce Amendments: (c)Alligator Descartes ---------8<-------------------8<-------------------- DBD::mSQL -- an mSQL 1.x interface for Perl 5. Copyright (c) 1994,1995 Tim Bunce, Alligator Descartes You may distribute under the terms of either the GNU General Public License or the Artistic License, as specified in the Perl README file. WARNING: THIS IS ALPHA SOFTWARE. IT IS POSSIBLY UNRELIABLE! BEFORE BUILDING, TESTING AND INSTALLING this you will need to: Build, test and install Perl 5. It is very important to test it and install it! Build, test and install the DBI module. It is very important to test it and install it! BUILDING If Perl5 is installed do: perl Makefile.PL If Perl5 is NOT installed do: perl Makefile.PL PERL_SRC=/path/to/perl/source/dir Then do: make make test make test TEST_VERBOSE=1 (if any tests fail) Do NOT hand edit the generated Makefile unless you are completely sure you understand the implications! Always try to make changes via the Makefile.PL command line and/or editing the Makefile.PL. You should never need to make any changes. If you do *please* let me know so that I can try to make it automatic in a later release. Testing: The test program auto-searches your local mSQL databases for a suitable one to use for testing. If you do *NOT* want this to happen please edit 'test.pl' and follow the instructions at the top. The test software does not discriminate between working databases and development ones! Also note! The methods to create and drop table are no exercised in the main test.pl script. Look in the extratests directory for those test scripts. If the message at the end of testing: ** Testing of DBD::mSQL complete! You appear to be normal! *** appears, then you can complete the driver installation by typing: make install IF YOU HAVE PROBLEMS: Please read the DBI WWW pages at: http://www.hermetica.com/technologia/DBI for any pertinent outstanding build issues for your platform. Also, please post details to dbi-users@fugue.com and CC them to me at descarte@hermetica.com. Please include: 1. A complete log of a complete build, e.g.: perl Makefile.PL (do a make realclean first) make make test make test TEST_VERBOSE=1 (if any tests fail) 2. Full details of which version of mSQL and Perl you're using. 3. The output of: perl -e 'use Config; print Config::myconfig()' 4. If you get a core dump, try to include a stack trace from it. If the stack trace mentions XS_DynaLoader_dl_load_file then rerun make test after setting the environment variable PERL_DL_DEBUG to 2. 5. Please don't post problems to comp.lang.perl.misc or perl5-porters. 6. If you are not currently subscribed to the mailing list please also send a subscription request to dbi-users-request@fugue.com. Also, you can subscribe to the DBI Mailing Lists at: http://www.fugue.com/dbi Regards, Tim & Al.