Documentation Home
MySQL Connector/C++ Developer Guide
Related Documentation Download this Manual
PDF (US Ltr) - 0.6Mb
PDF (A4) - 0.6Mb
HTML Download (TGZ) - 433.4Kb
HTML Download (Zip) - 456.4Kb

MySQL Connector/C++ Developer Guide  /  Installing Connector/C++ from a Binary Distribution

Chapter 3 Installing Connector/C++ from a Binary Distribution

To obtain a Connector/C++ binary package, visit the Connector/C++ downloads page.


It is important that the tools you use to build your Connector/C++ applications are compatible with the tools used to build Connector/C++ itself. Ideally, build your applications with the same tools that were used to build the Connector/C++ binaries.

Connector/C++ distributions include a BUILDINFO.txt file in which you will find the configuration options used to build the binaries. If you experience build-related issues on a platform, it may help to check the settings that were used to build the binary on that platform. (Prior to Connector/C++ 1.1.11, check the README file instead.)

Developers using Microsoft Windows must satisfy the following requirements:

  • Microsoft Visual Studio 2013.

  • Your applications should use the same linker configuration as Connector/C++. For example, use one of /MD, /MDd, /MT, or /MTd.

To use a different compiler version, release configuration, or runtime library, compile Connector/C++ from source using your desired settings and build your applications using these same settings. To avoid issues, ensure that the three variables of compiler version, runtime library, and runtime linker configuration settings are the same for your applications and Connector/C++ itself.

Archive Package

Unpack the distribution archive into an appropriate directory. If you plan to use a dynamically linked version of Connector/C++, make sure that your system can reference the libmysqlclient MySQL client library (Connector/C++ is linked against and thus requires the MySQL client library). Consult your operating system documentation on how to modify and expand the search path for libraries. If you cannot modify the library search path, it may help to copy your application, the Connector/C++ library and the MySQL client library into the same directory. Most systems search for libraries in the current directory.

Installation on Windows


MySQL Connector/C++ Community requires the Visual C++ Redistributable for Visual Studio 2013 (available at the Microsoft Download Center) to work on Windows platforms; install it before installing MySQL Connector/C++ Community.

The simplest and recommended method for installing Connector/C++ on Windows platforms is to download MySQL Installer and let it install and configure all the MySQL products on your system. See MySQL Installer for Windows for details. Those who are not using the MySQL Installer can choose between two binary distributions:

  • Zip archive without installer (.zip file): To use a Zip archive, unpack it in the directory where you intend to install it using WinZip or another tool that can read .zip files. See more information in Archive Package above.

  • Windows MSI Installer (.msi file): To use the MSI Installer, launch it and follow the prompts in the screens it presents to install Connector/C++ in the location of your choosing.

The MSI Installer does not require any administrative permissions because it simply copies files. It begins by presenting a welcome screen.

Figure 3.1 MSI Installer Welcome Screen

Content is described in the surrounding text.

The MSI Installer overview screen enables you to select the type of installation to perform. The Typical installation consists of all required header files and the Release libraries. The Custom installation enables you to install additional Debug versions of the connector libraries. The Complete installation installs everything in the distribution.

Figure 3.2 MSI Installer Overview Screen

Content is described in the surrounding text.

If you select a Custom installation, the MSI Installer presents a Custom Setup screen that enables you to select which features to install and where to install them.

Figure 3.3 MSI Installer Custom Setup Screen

Content is described in the surrounding text.

User Comments
Sign Up Login You must be logged in to post a comment.