diff --git a/source/installguide/management-server/_database.rst b/source/installguide/management-server/_database.rst index 46a9f1320b..c860ca008f 100644 --- a/source/installguide/management-server/_database.rst +++ b/source/installguide/management-server/_database.rst @@ -37,8 +37,14 @@ MySQL. See :ref:`install-database-on-separate-node`. #. Install MySQL from the package repository of your distribution: + CentOS 7 and later no longer provides the MySQL binaries, add a repository first: + .. parsed-literal:: + wget http://repo.mysql.com/mysql-community-release-el7-5.noarch.rpm + rpm -ivh mysql-community-release-el7-5.noarch.rpm + yum -y update + .. parsed-literal:: yum install mysql-server .. parsed-literal:: @@ -216,7 +222,55 @@ MySQL. See :ref:`install-database-on-separate-node`. Defaults:cloud !requiretty #. Now that the database is set up, you can finish configuring the OS - for the Management Server. This command will set up iptables, + for the Management Server. + + First, install the MySQL connectors for Python and Java. + + Install Python MySQL connector using the official MySQL packages repository. + Create the file ``/etc/yum.repos.d/mysql.repo`` with the following content: + + .. parsed-literal:: + + [mysql-connectors-community] + name=MySQL Community connectors + baseurl=http://repo.mysql.com/yum/mysql-connectors-community/el/$releasever/$basearch/ + enabled=1 + gpgcheck=1 + exclude: "mysql-connector-java*" + + Import GPG public key from MySQL: + + .. parsed-literal:: + + rpm --import http://repo.mysql.com/RPM-GPG-KEY-mysql + + Install mysql-connector + + .. parsed-literal:: + + yum install mysql-connector-python + + + Install python-dns + + .. parsed-literal:: + + yum -y install epel-release + yum -y install python-dns + + .. note:: + + There are issues with using mysql-connector-java-8.0.19-1.el7. To + workaround, exclude it from the repository configuration with the 'exclude' flag + in the repository definition above. + This will install the earlier mysql-connector-java-5.* package from the OS + base repository instead: + + .. parsed-literal:: + + yum -y install mysql-connector-java + + Then start the cloustack-setup-management installer. This command will set up iptables, sudoers, and start the Management Server. .. parsed-literal:: @@ -249,8 +303,14 @@ same node for MySQL. See `“Install the Database on the Management Server Node #. Install MySQL from the package repository from your distribution: + CentOS 7 and later no longer provides the MySQL binaries, add a repository first: + .. parsed-literal:: + wget http://repo.mysql.com/mysql-community-release-el7-5.noarch.rpm + rpm -ivh mysql-community-release-el7-5.noarch.rpm + yum -y update + .. parsed-literal:: yum install mysql-server .. parsed-literal:: @@ -377,7 +437,56 @@ same node for MySQL. See `“Install the Database on the Management Server Node “Successfully initialized the database.” #. Now that the database is set up, you can finish configuring the OS - for the Management Server. This command will set up iptables, + for the Management Server. + + First, install the MySQL connectors for Python and Java. + + Install Python MySQL connector using the official MySQL packages repository. + Create the file ``/etc/yum.repos.d/mysql.repo`` with the following content: + + .. parsed-literal:: + + [mysql-connectors-community] + name=MySQL Community connectors + baseurl=http://repo.mysql.com/yum/mysql-connectors-community/el/$releasever/$basearch/ + enabled=1 + gpgcheck=1 + exclude: "mysql-connector-java*" + + Import GPG public key from MySQL: + + .. parsed-literal:: + + rpm --import http://repo.mysql.com/RPM-GPG-KEY-mysql + + Install mysql-connector + + .. parsed-literal:: + + yum install mysql-connector-python + + + Install python-dns + + .. parsed-literal:: + + yum -y install epel-release + yum -y install python-dns + + .. note:: + + There are issues with using mysql-connector-java-8.0.19-1.el7. To + workaround, exclude it from the repository configuration with the 'exclude' flag + in the repository definition above. + This will install the earlier mysql-connector-java-5.* package from the OS + base repository instead: + + .. parsed-literal:: + + yum -y install mysql-connector-java + + + Then start the cloustack-setup-management installer. This command will set up iptables, sudoers, and start the Management Server. .. parsed-literal::