INSTALL-WIN-SOURCE:

  Initial cleanup edits.
parent 75b8cb20
...@@ -3,36 +3,39 @@ ...@@ -3,36 +3,39 @@
# HOWTO : INSTALL MySQL FROM SOURCE # # HOWTO : INSTALL MySQL FROM SOURCE #
# WINDOWS PORT # # WINDOWS PORT #
# # # #
# COpyright (C) MySQL AB 1995-2003 # # Copyright (C) MySQL AB 1995-2003 #
######################################################### #########################################################
This is a simple 'HOWTO' document describing howto build This is a simple 'HOWTO' document describing how to
MySQL 4.1 and above version binaries for Windows from build MySQL binaries for versions 4.1 and above on
'BitKeeper' tree as well as from normal source archive. Windows. Instructions are provided for building binaries
from a standard source distribution or from the BitKeeper
tree that contains the latest developer source.
--------------------------------------------------------- ---------------------------------------------------------
NOTE NOTE
--------------------------------------------------------- ---------------------------------------------------------
This is strictly for users who wants to test the MySQL from Normally, it is best to use precompiled binary distributions
the latest source from BitKeeper branch on Windows and for of MySQL that are built specifically for optimal performance
internal MySQL developers. on Windows by MySQL AB. Binary distributions are available
from:
Other wise better always strict to MySQL binary distributions
which is built specifically for optmistic performance,
available from:
http://www.mysql.com/downloads/ http://www.mysql.com/downloads/
The instructions in this document are strictly for users
who want to test MySQL on Windows from the latest source or
from the BitKeeper tree, and for internal MySQL developers.
-------------------------------------------------------- --------------------------------------------------------
TABLE OF CONTENTS TABLE OF CONTENTS
-------------------------------------------------------- --------------------------------------------------------
1. REQUIREMENTS 1. REQUIREMENTS
2. OBTAINING THE WINDOWS SOURCE ARCHIVE 2. OBTAINING A WINDOWS SOURCE DISTRIBUTION
3. CREATING SOURCE PACKAGE FROM 'BitKeeper' TREE. 3. CREATING A SOURCE PACKAGE FROM THE 'BitKeeper' TREE
4. BUILDING 'mysql server and clients' FROM VC++ WORKSPACE 4. BUILDING 'mysql server and clients' FROM VC++ WORKSPACE
5. BUILDING FROM 'nmake' MAKEFILES 5. BUILDING FROM 'nmake' MAKEFILES
6. STARTING AND CONFIGURING THE SERVER FOR FISRT TIME 6. STARTING THE MYSQL SERVER FOR THE FIRST TIME
7. TESTING THE CONNECTION 7. TESTING THE CONNECTION
8. SPECIAL NOTES AND CONSIDERATIONS 8. SPECIAL NOTES AND CONSIDERATIONS
...@@ -40,79 +43,100 @@ TABLE OF CONTENTS ...@@ -40,79 +43,100 @@ TABLE OF CONTENTS
1. REQUIREMENTS 1. REQUIREMENTS
------------------------------------------------------- -------------------------------------------------------
To build MySQL on Windows from its bitkeeper source, you need To build MySQL on Windows from source, you need the
the following compilers and/or tools installed on your Windows following compiler and resources available on your Windows
system: system:
- Microsoft Visual C++ 6.0 and above - Microsoft Visual C++ 6.0 and above
- MySQL Source package
(http://www.mysql.com/downloads)
- ~45 MB disk space - ~45 MB disk space
- 64 MB RAM - 64 MB RAM
In case from BitKeeper tree: You'll also need a MySQL source distribution. You can
get the source for released versions of MySQL from:
http://www.mysql.com/downloads/
Alternatively, you can package a source distribution
yourself from the latest BitKeeper developer source
tree. If you plan to do this, you must create the
package on a Unix system and then transfer it to your
Windows system. (The reason for this is that the initial
configuration scripts and some of the build steps work
only on Unix.) The BitKeeper approach thus requires:
- BitKeeper 3.0 (http://www.bitkeeper.com) - A system running Unix, or a Unix-like system such as Linux
- Any working and fully built *UNIX* BK tree - BitKeeper 3.0 installed on that system (you can obtain
BitKeeper from http://www.bitkeeper.com)
------------------------------------------------------- -------------------------------------------------------
2. OBTAINING WINDOWS SOURCE ARCHIVE 2. OBTAINING A WINDOWS SOURCE DISTRIBUTION
------------------------------------------------------- -------------------------------------------------------
There are two ways you can get the Windows source package for There are two ways you can get a Windows source distribution for
MySQL 4.1 and above versions: MySQL version 4.1 and above:
I. MySQL distributed source package for the perticular version, I. Obtain a MySQL AB-distributed source distribution for the
which can be obtainied from: particular version of MySQL in which you are interested.
http://www.mysql.com/downloads Prepackaged source distributions are available for released
versions of MySQL and can be obtained from:
http://www.mysql.com/downloads/
II. Source package archive From the latest Development II. Create a source package yourself from the latest development
'BitKeeper' tree. 'BitKeeper' source tree.
If you are using the first option, you can skip the next
section and go directly to 'BUILDING FROM VC++ WORKSPACE'.
In case if you are using the OPTION 'I', then you can skip the
next section and go directly to 'BUILDING FROM VC++ WORKSPACE'.
------------------------------------------------------- -------------------------------------------------------
3. CREATING SOURCE PACKAGE FROM 'BitKeeper' TREE 3. CREATING A SOURCE PACKAGE FROM THE 'BitKeeper' TREE
------------------------------------------------------- -------------------------------------------------------
To build the latest Windows source package, Please follow the To build the latest Windows source package, Please follow the
following instructions from any of your '*UNIX*' operating following instructions from any of your '*UNIX*' operating
systems (preferably Linux): systems (preferably Linux):
- Get the latest BK clone of MySQL 4.1 (or above, as desired) - Clone the BitKeeper source tree for MySQL (version 4.1
and build the source. For more information how to do this, or above, as desired). For more information how to clone
follow the instructions from: the BitKeeper source tree, follow the instructions at:
http://www.mysql.com/doc/en/Installing_source_tree.html http://www.mysql.com/doc/en/Installing_source_tree.html
- Make sure the build process went through. - Build the distribution so that you have a server binary to
work with. One way to do this is to run the following
command in the top-level directory of your source tree:
- Now run the following script from the mysql installed ./BUILD/compile-pentium-max
root directory, which creates the windows source package:
- After making sure that build process completed successfully,
run the following utility script from top-level directory
of your source tree:
./scripts/make_win_src_distribution ./scripts/make_win_src_distribution
You can even supply different options to this script based This script creates the Windows source package. You can
on your needs. It takes: supply different options to the script based on your needs.
It accepts: the following options:
./scripts/make_win_src_distribution --help
MySQL utility script to create a Windows src package, and it takes
the following arguments:
--debug Debug, without creating the package --debug Debug, without creating the package
--tmp Specify the temporary location --tmp Specify the temporary location
--suffix Suffix name for the package
--dirname Directory name to copy files (intermediate)
--silent Do not list verbosely files processed --silent Do not list verbosely files processed
--tar Create tar.gz package instead of .zip --tar Create tar.gz package instead of .zip
--help Show this help message --help Show this help message
By default it creates the zipped archive with the name: By default, make_win_src_distribution creates a zipped
mysql-$version-win-src.zip archive with the name mysql-$version-win-src.zip, where
$version is the version of the MySQL source tree you
cloned.
- Copy or upload this created windows source package to - Copy or upload to your Windows machine the Windows source
your windows directory. package that you have just created, and compile it using
the instructions in the next section.
--------------------------------------------------------- ---------------------------------------------------------
4. BUILDING 'mysql server & clients' from VC++ WORKSPACE 4. BUILDING 'mysql server & clients' FROM VC++ WORKSPACE
--------------------------------------------------------- ---------------------------------------------------------
NOTE: MySQL 4.1 and above VC++ workspace files are compatible NOTE: MySQL 4.1 and above VC++ workspace files are compatible
...@@ -121,72 +145,67 @@ NOTE: MySQL 4.1 and above VC++ workspace files are compatible ...@@ -121,72 +145,67 @@ NOTE: MySQL 4.1 and above VC++ workspace files are compatible
release. release.
Unpack the Windows source zipped archive to a folder and open Unpack the Windows source zipped archive to a folder and open
mysql.dsw from your top level directory. mysql.dsw from your top-level directory.
If you want to build both release and debug versions, then If you want to build both release and debug versions, then
select 'build' -> 'buildall' option or in case to build only select 'build' -> 'buildall' option. To build only 'release'
'release' or 'debug' versions, then select all appropriate or 'debug' versions, then select all appropriate workspaces
workspaces from 'custom build' option. from the 'build' -> 'batch build' option.
The simplest solution to build basic clients and core server The simplest solution to build basic clients and core
is to set your current active workspace as 'mysqld' release server is to set your current active workspace as 'mysqld'
or debug version, and just hit 'build' or 'F7', which creates release or debug version, and just hit 'build' or 'F7', which
necessary client binaries in 'client_release' or 'client_debug' creates necessary client binaries in the 'client_release' or
and the libraries are placed in 'lib_release' and 'lib_debug' 'client_debug' directories. The libraries are placed in the
for release and debug versions respectively. 'lib_release' and 'lib_debug' directories for release and
debug versions, respectively.
Now, you are all up with the things. If you get any compiler
Now you have built the distribution. If you get any compiler
errors, please cross check and send the compiler output to errors, please cross check and send the compiler output to
win32@lists.mysql.com for further assistance. win32@lists.mysql.com for further assistance.
--------------------------------------------------------- ---------------------------------------------------------
5. BUILDING FROM 'nmake' MAKEFILESS 5. BUILDING FROM 'nmake' MAKEFILES
--------------------------------------------------------- ---------------------------------------------------------
TODO from MySQL PIEFU team. TODO from MySQL PIEFU team.
--------------------------------------------------------- ---------------------------------------------------------
6. STARTING THE MYSQL SERVER FIRST TIME 6. STARTING THE MYSQL SERVER FOR THE FIRST TIME
--------------------------------------------------------- ---------------------------------------------------------
First ensure to set or copy my.ini or my.cnf file to your First ensure to set or copy my.ini or my.cnf file to your
'data' directory that exists in the top-level directory or 'data' directory that exists in the top-level directory or
point to existing 'data' directory. point to existing 'data' directory.
Now, start your server from 'client_release' or 'client_debug' Now, start your server from the 'client_release' or
sub-directories by following the instructions from: 'client_debug' directory (depending on which server you
want to use), by following the instructions from:
http://www.mysql.com/doc/en/Windows_installation.html http://www.mysql.com/doc/en/Windows_installation.html
Thats all !!! See, its as simple as building 'mysql' on any That's all!!! See, it's as simple to build MySQL on Windows
other platforms !!! as on any other platform!!!
--------------------------------------------------------- ---------------------------------------------------------
7. TESTING THE CONNECTION 7. TESTING THE CONNECTION
--------------------------------------------------------- ---------------------------------------------------------
Once the server is running in standalone or as a service Once the server is running in standalone fashion or as a
based on your configuration, try to connect to it from service based on your configuration, try to connect to it
'mysql' command line SQL interactive utility that exists from the 'mysql' command line SQL interactive utility that
from your 'client_release' or 'client_debug' directory. exists in your 'client_release' or 'client_debug' directory.
--------------------------------------------------------- ---------------------------------------------------------
8. SPECIAL NOTES AND CONSIDERATIONS 8. SPECIAL NOTES AND CONSIDERATIONS
--------------------------------------------------------- ---------------------------------------------------------
- MySQL doesnot advice to use 'mysql' server built by - For production use, MySQL AB does not advise using a MySQL
yourself from sources, instead stick to binaries shipped server built by yourself from source. Instead, stick to
by MySQL on the production environment. binaries shipped by MySQL AB.
- If you find something is not working as expected, or - If you find something not working as expected, or you have
some improvements to the current one can be made, then suggestions about ways to improve the current build process
please send a mail to 'win32@lists.mysql.com'. on Windows, please email to 'win32@lists.mysql.com'.
Thanks Thanks
MySQL Team MySQL Team
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment