Author: paul
Date: 2007-02-12 22:49:25 +0100 (Mon, 12 Feb 2007)
New Revision: 4916
Log:
r16159@frost: paul | 2007-02-12 15:47:56 -0600
Additional information re: Compiling MySQL from source on Windows.
Modified:
trunk/refman-5.1/installing.xml
Property changes on: trunk
___________________________________________________________________
Name: svk:merge
- 4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:19666
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:16158
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:14218
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:13520
+ 4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:19666
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:16159
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:14218
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:13520
Modified: trunk/refman-5.1/installing.xml
===================================================================
--- trunk/refman-5.1/installing.xml 2007-02-12 21:49:09 UTC (rev 4915)
+++ trunk/refman-5.1/installing.xml 2007-02-12 21:49:25 UTC (rev 4916)
Changed blocks: 7, Lines Added: 77, Lines Deleted: 15; 6974 bytes
@@ -9446,9 +9446,8 @@
<listitem>
<para>
CMake, which can be downloaded from
- <ulink url="http://www.cmake.org">http://www.cmake.org</ulink>.
- After installing, modify your path to include the cmake
- binary.
+ <ulink url="http://www.cmake.org"/>. After installing,
+ modify your path to include the cmake binary.
</para>
</listitem>
@@ -9465,7 +9464,7 @@
also install an appropriate Platform SDK. More information
and links to downloads for various Windows platforms is
available from
- <ulink url="http://msdn.microsoft.com/platformsdk/">http://msdn.microsoft.com/platformsdk/</ulink>.
+ <ulink url="http://msdn.microsoft.com/platformsdk/"/>.
</para>
</listitem>
@@ -9474,7 +9473,7 @@
If you are compiling from from a BitKeeper tree or making
changes to the parser, you need <literal>bison</literal> for
Windows, which can be downloaded from
- <ulink url="http://gnuwin32.sourceforge.net/packages/bison.htm">http://gnuwin32.sourceforge.net/packages/bison.htm</ulink>.
+ <ulink url="http://gnuwin32.sourceforge.net/packages/bison.htm"/>.
Download the package labeled <quote>Complete package,
excluding sources</quote>. After installing the package,
modify your path to include the <command>bison</command>
@@ -9485,6 +9484,16 @@
<listitem>
<para>
+ Cygwin might be necessary if you want to run the test script
+ or package the compiled binaries and support files into a
+ Zip archive. (Cygwin is needed only to test or package the
+ distribution, not to build it.) Cygwin is available from
+ <ulink url="http://cygwin.com"/>.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
3GB to 5GB of disk space.
</para>
</listitem>
@@ -9550,8 +9559,8 @@
<listitem>
<para>
- If you are installing from a BitKeeper tree, consider the
- root directory of that tree to be the work directory in the
+ If you are installing from a BitKeeper tree, the root
+ directory of that tree is the work directory in the
following instructions.
</para>
</listitem>
@@ -9659,18 +9668,42 @@
From the work directory, execute the
<filename>win\build-vs8.bat</filename> or
<filename>win\build-vs71.bat</filename> file, depending on
- the version of Visual Studio you have installed.
+ the version of Visual Studio you have installed. The script
+ invokes CMake, which generates the
+ <filename>mysql.sln</filename> solution file.
</para>
</listitem>
<listitem>
<para>
- From the work directory, execute the generated
- <filename>mysql.sln</filename> file. Visual Studio will load
- the solution and you can then click
+ From the work directory, open the generated
+ <filename>mysql.sln</filename> file with Visual Studio and
+ select the proper configuration using the
+ <guimenu>Configuration</guimenu> > menu. The menu provides
+ <guimenuitem>Debug</guimenuitem>,
+ <guimenuitem>Release</guimenuitem>,
+ <guimenuitem>RelwithDebInfo</guimenuitem>,
+ <guimenuitem>MinRelInfo</guimenuitem> options. Then select
<guimenu>Solution</guimenu> >
<guimenuitem>Build</guimenuitem> to build the solution.
</para>
+
+ <para>
+ Alternatively, configure and build by executing a command
+ like this from the command line in the work directory
+ (substituting a different configuration for
+ <literal>/debug</literal> as necessary):
+ </para>
+
+<programlisting>
+C:\workdir><userinput>devenv mysql.sln /debug</userinput>
+</programlisting>
+
+ <para>
+ Remember the configuration that you use in this step. It is
+ important later when you run the test script because the
+ script needs to know which configuration you used.
+ </para>
</listitem>
<listitem>
@@ -9689,25 +9722,54 @@
existing data directory elsewhere that you want to use, you
can specify its pathname instead.
</para>
- </listitem>
- <listitem>
<para>
When the server is running in standalone fashion or as a
service based on your configuration, try to connect to it
from the <command>mysql</command> interactive command-line
utility.
</para>
+
+ <para>
+ You can also run the standard test script,
+ <command>mysql-test-run.pl</command>. This script is written
+ in Perl, so you'll need either Cygwin or ActiveState Perl to
+ run it. You may also need to install the modules required by
+ the script. To run the test script, change location into the
+ <filename>mysql-test</filename> directory, set the
+ <literal>MTR_VS_CONFIG</literal> environment variable to the
+ configuration you selected earlier, and invoke
+ <command>mysql-test-run.pl</command>. For example (using
+ Cygwin and the <command>bash</command> shell):
+ </para>
+
+<programlisting>
+shell> <literal>cd mysql-test</literal>
+shell> <literal>export MTS_VS_CONFIG=debug</literal>
+shell> <literal>./mysqltest-run.pl --force --timer</literal>
+shell> <literal>./mysqltest-run.pl --force --timer --ps-protocol</literal>
+</programlisting>
</listitem>
</orderedlist>
<para>
When you are satisfied that the programs you have built are
- working correctly, stop the server. Then install MySQL as
- follows:
+ working correctly, stop the server. Now you can install the
+ distribution. One way to do this is to use the
+ <command>make_win_bin_dist</command> script in the
+ <filename>scripts</filename> directory of the MySQL source
+ distribution. This is a shell script, so you must have Cygwin
+ installed if you want to use it. It creates a Zip archive of the
+ built executables and support files that you can unpack in the
+ location at which you want to install MySQL.
</para>
+ <para>
+ It is also possible to installl MySQL in a more manual fashion
+ using the following procedure:
+ </para>
+
<orderedlist>
<listitem>
| Thread |
|---|
| • svn commit - mysqldoc@docsrva: r4916 - in trunk: . refman-5.1 | paul | 12 Feb |
