mysql / mysql-configurator

MySQL Configurator

MySQL Configurator

MySQL Configurator is a standalone application designed to ease the complexity of configuring a MySQL server to run MySQL on Microsoft Windows. It is bundled with the MySQL server, in both the MSI and standalone Zip archive. It performs the initial configuration, a reconfiguration, and also functions as part of the uninstallation process.

Licensing

Please refer to the license files, available in this repository, and Legal Notices in documentation for further details.

Download and build

MySQL Configurator is distributed as part of the MySQL Server and can be found in the bin folder located in the folder where MySQL Server was extracted to or installed.

No installation is required as the tool is distributed as a stand-alone exe which can be executed at any given moment.

Building from sources

Prerequisites

• Visual Studio 2022
• .NET Framework 4.8
• MS Build Community Tasks 1.5.0+

Building

Using Visual Studio

1. Open the mysql_configurator.sln solution file in Visual Studio 2022 with admin privileges.
2. Select the build configuration type (Debug/Release).
3. Build the solution.

Using MSBuild

1. Open a Command Prompt app (Run as administrator).
2. Navigate to the folder containing the mysql_configurator.sln solution file.
3. Run the following command (replace [CONFIGURATION_TYPE] with the corresponding value (Debug/Release):

"C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Current\Bin\msbuild.exe" mysql_configurator.sln /p:Configuration=[CONFIGURATION_TYPE] /p:Platform="Any CPU"

Finally, you will find the mysql_configurator.exe file in the corresponding Configurator/bin/[CONFIGURATION_TYPE] folder.

Debugging

Before debugging, update the path to the server installation directory in the installationDirectory key of the app.config file. The path set as the installation directory must be the root directory of the server installation. This directory is expected to contain the bin, share, etc and other server directories.

For MSI installations this path is usually "C:\Program Files\MySQL\MySQL Server 8.1" or the custom path set during installation. For ZIP installations this path is whichever location where the server files were extracted to.

mysql-configurator's Issues

Inconsistencies is data directory case, cause failures on case sensitive file system.

On ServerConfigSecurityPage.cs, code has been added to update the data directory using "Data" as the data directory. This causes an install on a case sesnitive file system to fail.
Historically, it has been impossible to get MySQL to operate reliably on Windows without setting lowercase_table_names to 1 or 2. However, it operates well on a Windows system with lowercase_table_names=0 if installed in a folder with case sensitivity enabled:
fsutil file setCaseSensitiveInfo enable
this requires susbsyetm for Linux, but not an avctual linux kernel or linux version of MySQL.
Unforunately, this code change breaks that installer.