Install Guide: Switch from MySQL-python to PyMySQL

As discussed in the Liberty Design Summit "Moving apps to Python 3"
cross-project workshop, the way forward in the near future is to
switch to the pure-python PyMySQL library as a default.

https://etherpad.openstack.org/p/liberty-cross-project-python3

This change only updates the Install Guide.

Change-Id: I71ff1841af54f5db870e836bc1c62499096a712e

doc/install-guide/source/basics-packages.rst

@@ -238,19 +238,19 @@ services also support other SQL databases including
 
       .. code-block:: console
 
-         # apt-get install mariadb-server python-mysqldb
+         # apt-get install mariadb-server python-pymysql
 
    .. only:: debian
 
       .. code-block:: console
 
-         # apt-get install mysql-server python-mysqldb
+         # apt-get install mysql-server python-pymysql
 
    .. only:: rdo
 
       .. code-block:: console
 
-         # yum install mariadb mariadb-server MySQL-python
+         # yum install mariadb mariadb-server PyMySQL
 
    .. only:: obs
 

doc/install-guide/source/cinder-controller-node.rst

@@ -211,7 +211,7 @@ To install and configure Block Storage controller components
 
          [database]
          ...
-         connection = mysql://cinder:CINDER_DBPASS@controller/cinder
+         connection = mysql+pymysql://cinder:CINDER_DBPASS@controller/cinder
 
       Replace ``CINDER_DBPASS`` with the password you chose for the
       Block Storage database.

doc/install-guide/source/cinder-storage-node.rst

@@ -191,7 +191,7 @@ Install and configure Block Storage volume components
       .. code-block:: console
 
          # yum install openstack-cinder targetcli python-oslo-db \
-           python-oslo-log MySQL-python
+           python-oslo-log PyMySQL
 
       .. Temporary workaround for bug:
          https://bugzilla.redhat.com/show_bug.cgi?id=1212899
@@ -213,7 +213,7 @@ Install and configure Block Storage volume components
 
          [database]
          ...
-         connection = mysql://cinder:CINDER_DBPASS@controller/cinder
+         connection = mysql+pymysql://cinder:CINDER_DBPASS@controller/cinder
 
       Replace ``CINDER_DBPASS`` with the password you chose for
       the Block Storage database.

doc/install-guide/source/debconf/debconf-dbconfig-common.rst

@@ -11,7 +11,7 @@ directive as follows:
 .. code-block:: ini
 
    [database]
-   connection = mysql://keystone:0dec658e3f14a7d@localhost/keystonedb
+   connection = mysql+pymysql://keystone:0dec658e3f14a7d@localhost/keystonedb
 
 This ``connection`` directive will be handled by the ``dbconfig-common``
 package, which provides a standard Debian interface. It enables you to
@@ -80,7 +80,7 @@ corresponding DNS will then be:
 .. code-block:: ini
 
    [database]
-   connection = mysql://keystone:PASSWORD@localhost/keystonedb
+   connection = mysql+pymysql://keystone:PASSWORD@localhost/keystonedb
 
 The ``dbconfig-common`` package will configure MySQL for these access
 rights, and create the database for you. Since OpenStack 2014.1.1, all

doc/install-guide/source/glance-install.rst

@@ -180,7 +180,7 @@ To install and configure the Image service components
 
             [database]
             ...
-            connection = mysql://glance:GLANCE_DBPASS@controller/glance
+            connection = mysql+pymysql://glance:GLANCE_DBPASS@controller/glance
 
          Replace ``GLANCE_DBPASS`` with the password you chose for the
          Image service database.
@@ -259,7 +259,7 @@ To install and configure the Image service components
 
             [database]
             ...
-            connection = mysql://glance:GLANCE_DBPASS@controller/glance
+            connection = mysql+pymysql://glance:GLANCE_DBPASS@controller/glance
 
          Replace ``GLANCE_DBPASS`` with the password you chose for the
          Image service database.

doc/install-guide/source/heat-install.rst

@@ -248,7 +248,7 @@ To install and configure the Orchestration components
 
            [database]
            ...
-           connection = mysql://heat:HEAT_DBPASS@controller/heat
+           connection = mysql+pymysql://heat:HEAT_DBPASS@controller/heat
 
         Replace ``HEAT_DBPASS`` with the password you chose for the
         Orchestration database.

doc/install-guide/source/keystone-install.rst

@@ -138,7 +138,7 @@ database and an administration token.
 
             [database]
             ...
-            connection = mysql://keystone:KEYSTONE_DBPASS@controller/keystone
+            connection = mysql+pymysql://keystone:KEYSTONE_DBPASS@controller/keystone
 
          Replace ``KEYSTONE_DBPASS`` with the password you chose for the database.
 
@@ -212,7 +212,7 @@ database and an administration token.
 
          [database]
          ...
-         connection = mysql://keystone:KEYSTONE_DBPASS@controller/keystone
+         connection = mysql+pymysql://keystone:KEYSTONE_DBPASS@controller/keystone
 
       If you decide to not use ``dbconfig-common``, then you will have to
       create the database and manage its access rights yourself, and run the

doc/install-guide/source/neutron-controller-node.rst

@@ -187,7 +187,7 @@ must create a database, service credentials, and API endpoint.
 
          [database]
          ...
-         connection = mysql://neutron:NEUTRON_DBPASS@controller/neutron
+         connection = mysql+pymysql://neutron:NEUTRON_DBPASS@controller/neutron
 
          Replace ``NEUTRON_DBPASS`` with the password you chose for the
          database.

doc/install-guide/source/nova-controller-install.rst

@@ -167,7 +167,7 @@ To install and configure Compute controller components
 
         [database]
         ...
-        connection = mysql://nova:NOVA_DBPASS@controller/nova
+        connection = mysql+pymysql://nova:NOVA_DBPASS@controller/nova
 
      Replace ``NOVA_DBPASS`` with the password you chose for
      the Compute database.