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.

All Connector/C++ distributions include a README file that contains platform-specific notes. At the end of the README file, 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.

Developers using Microsoft Windows must satisfy the following requirements:

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.

Windows users can choose between two binary packaging formats:


Connector/C++ requires the Visual C++ Redistributable for Visual Studio 2013 to work on Windows platforms; install it before installing Connector/C++.

Windows MSI Installer

Using the MSI Installer may be the easiest solution. The MSI Installer does not require any administrative permissions because it simply copies files.

The MSI Installer begins by presenting a welcome screen.

Figure 3.1 MSI Installer Welcome Screen

MSI Installer Welcome Screen

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

MSI Installer Overview Screen

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

MSI Installer Custom Setup Screen