Bug #69370 Misleading InnoDB Memcached Plugin installation instructions
Submitted: 31 May 2013 23:40 Modified: 10 Jun 2013 18:53
Reporter: Alex Gut Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Server: Documentation Severity:S2 (Serious)
Version:5.6.11 OS:Any
Assigned to: Bugs System CPU Architecture:Any

[31 May 2013 23:40] Alex Gut 
Description:
http://dev.mysql.com/doc/refman/5.6/en/innodb-memcached-setup.html

The "Building from Source" subsection states "When building the MySQL Server from source, once libevent is installed, build the MySQL server as usual. No special build steps are required" however if one follows the usual "2.9.2. Installing MySQL Using a Standard Source Distribution" installation guide, libmemcached.so and innodb_engine.so are not going to be built.

For InnoDB Memcached plugin to be built, the -DWITH_INNODB_MEMCACHED=ON option should be passed to cmake during the building process.

How to repeat:
See above.

Suggested fix:
Mention the -DWITH_INNODB_MEMCACHED=ON cmake option in the "Building from Source" subsection of the "14.2.9.3. Getting Started with InnoDB Memcached Plugin" MySQL-5.6 manual section.
[1 Jun 2013 0:02] MySQL Verification Team 
Thank you for the bug report.
[3 Jun 2013 20:11] Alex Gut 
I forgot to mention previously, there is a block in the source package mysql-5.6.11/CMakeLists.txt file defining the default InnoDB Memcached Plugin building options, lines 134-140 to be exact:

IF(UNIX)
  OPTION(WITH_INNODB_MEMCACHED "" OFF)
  OPTION(ENABLE_MEMCACHED_SASL "Enable SASL on InnoDB Memcached" OFF)
  OPTION(ENABLE_MEMCACHED_SASL_PWDB "Enable SASL on InnoDB Memcached" OFF)
ELSE()
  OPTION(WITH_INNODB_MEMCACHED "" OFF)
ENDIF()
 
As one can see, InnoDB Memcached Plugin option is disabled by default, hence the -DWITH_INNODB_MEMCACHED=ON is required to be defined explicitly during the building process for the plugin to be built.
[10 Jun 2013 18:53] Bugs System 
The referenced documentation page for InnoDB memcached setup has been updated to include instructions for setting "-DWITH_INNODB_MEMCACHED" to "ON" when building from source. 

This page has been updated for both the MySQL 5.6 and 5.7 reference manual.

Thank you for the bug report.