diff options
Diffstat (limited to 'os2/readme.os2')
| -rw-r--r-- | os2/readme.os2 | 190 |
1 files changed, 190 insertions, 0 deletions
diff --git a/os2/readme.os2 b/os2/readme.os2 new file mode 100644 index 00000000000..9936dd15369 --- /dev/null +++ b/os2/readme.os2 @@ -0,0 +1,190 @@ +MySQL 3.23.40 for OS/2 Warp build 1 +==================================================== + +Contents +-------- +Welcome to the latest port of MySQL for OS/2 and eComStation. + +Modules included in this build: + - protocol data compression + - transaction support + - perl BDB/BDI support (not in this package) + - Library and header files for C/CPP developers included + +This package has been built using IBM VAC++ 4.0 + +The MySQL server is distributed under the GPL license. Please refer to +the file COPYING for the license information. + +The MySQL client library is distributed under the LGPL license. +Please refer to the file COPYING for the license information. + +Most of the MySQL clients are distributed under the GPL license, but +some files may be in the public domain. + +The latest information about MySQL can be found at: http://www.mysql.com + +To get the latest information about this port please subscribe to our +newsgroup/mailinglist mysql2 at www.egroups.com. + +To see what MySQL can do, take a look at the features section in the +manual. For future plans see the TODO appendix in the manual. + +New features/bug fixes history is in the news appendix in the manual. + +For the currently known bugs/misfeatures (known errors) see the bugs +appendix in the manual. The OS/2 section contains notes that are +specific to the MySQL OS/2 and eComStation version. + +Please note that MySQL is a constantly moving target. New builds for +Linux are made available every week. This port may therefore be a few +minor versions after the latest Linux/Win32 builds but its generally +more stable than the "latest and greates" port. + +MySQL is brought to you by: TcX DataKonsult AB & MySQL Finland AB + +This port is brought to you by: + +Yuri Dario <mc6530@mclink.it>, development, porting +Timo Maier <tam@gmx.de>, documentation, testing +John M Alfredsson <jma@jmast.se>, documentation, testing + + +Installation +------------ +Prerequisite: + +- OS/2 Warp 3 with FP ?? or later, + OS/2 Warp 4 with FP ?? or later, + OS/2 Warp Server for e-Business, + eComStation 1.0 (prev 1/2 OK) +- TCPIP 4.x installed (requires 32-bit tcpip stack) +- WarpIN installer 0.9.12 (ftp://ftp.os2.org/xworkplace/warpin-0-9-12.zip) + +Note: probably some fixpak level is required on both Warp3&Warp4 to + support >2GB file sizes. + +Save the installation archives into a temporary folder and double click +on the main package; otherwise you can drop the mysql package in your +WarpIN object or type + + WARPIN MYSQL-3-23-??-B1.WPI + +from the command line. +The configuration file for MySQL is named my.cnf and it is placed into +your %ETC% directory. Usually it located into the boot driver under + + x:\MPTN\ETC + +If the installation detect an existing configuration file, this will be +renamed to my.cnf.bak; your current settings aren't migrated to current +installation. This file is not deleted by uninstall process. +Startup options for MySQL daemon could be added there. + +As default, client connections uses data compression: if you don't like it, +remove the following from your %ETC%\my.cnf + + [client] + compress + +The server switches automatically compression mode on client request. + +SMP systems: while my developement system is a SMP one, and here MySQL seems +to run fine with two processors enabled, keep in mind that both EMX runtime +and current thread model are not SMP safe. + +This release comes with DLL client library MYSQL.DLL: it is installed by +default into mysql\bin together with client applications. Copy it to your +x:\OS2\DLL or another directory in your LIBPATH to run command line +utilities from every place. + + +Documentation +------------- +Documentation is provided in separate files. You can use either +the PDF documentation (requires Adobe Acrobat Reader) or the +INF documentation (requires OS/2 view or NewView). + +The PDF documentation is found in MYSQL-3-23-28-PDF.WPI and +the INF documentation is found in MYSQL-3-23-28-INF.WPI + +The latest documentation can always be downloaded from +http://www.mysql.com. However this documentation may +no fully apply to this port. +The INF documentation could contain errors because of semi-automatic +translation from texi original. + +Support +------- +Since MySQL is a OpenSource freeware product there are no +formal support options available. + +Please subscribe to mysql2 at www.egroups.com to get in contact +with other users using this port. + +http://www.egroups.com/group/mysql2 + +This newsgroup/mailinglist is the official "home" of this port. + + +Know problems +------------- +alter_table.test and show_check are failing, reporting a different status +message: actually seems only a different text, no bugs in table checking. + + +Apache/2 + PHP +-------------- +To avoid problems with different socket when you use PHP and Apache +webserver, get the PHP4 module from the Apache Server for OS/2 homepage +http://silk.apana.org.au/apache/ + + +Developing MySQL +---------------- +If you want to help us develop MySQL for OS2/eComStation please join +the mysql2 mailinglist at www.egroups.com and ask for help to set up +your environment! + +All questions that are specific to the OS2/eComStation version should +be posted to this list! Please remember to include all relevant +information that may help solve your problem. + + +Building MySQL (EMX) +-------------------- +NOTE: these instructions are outdated + +db-3.2.x: before compiling MySQL, you need to setup Berkeley DB. Untar +the distribution, enter dist directory and run + +attrib -r * /s +sh -c s_config + +to create proper aclocal macros and configure headers. + +In the src directory you will find patches used to build this release +of MySQL. +You can run 'sh -c config.status' to create current makefiles without +running autoconf & configure. + +apply previous patches (if not already included) +sh -c autoconf (upgrade scripts) +sh -c configure.os2 (config system) +edit config.status: + s%@MYSQL_UNIX_ADDR@%\\socket\\MySQL%g + s%@LN_CP_F@%cp.exe%g + replace -O2 -m486 with -mpentiumpro +sh -c config.status (upgrade makefiles again) +edit libmysql\Makefile + remove all occurences of -Zexe + replace libmysqlclient with libmysql (case sensitive search) +edit client\Makefile + replace libmysqlclient with libmysql (case sensitive search) +make + +After config.status, you have to edit include\mysql_version.h and correct +the socket definition (\\socket\\MySQL is correct). +If you go with configure, you have to change LN_CP_F macro from 'ln -s' to +'cp' and correct all makefiles (sh -c config.status will do it). + |