openstack/openstack-manuals
Code Issues Proposed changes

Updated MySQL server configuration to use UTF-8

Browse Source 
I updated the MySQL server configuration section to use the UTF-8
character set by default for table creation. I also modified the
structure to use a procedure which agrees with conventions.

Change-Id: I44fd8171ae27f21d44991f2942117fa42b8d3314
Closes-Bug: #1292934
This commit is contained in:
Matt Kassawara 2014-03-15 12:47:08 -06:00
parent 5a80decadb
commit 29f793a587
1 changed files with 30 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
doc/install-guide/ch_basics.xml
View File

@ -395,16 +395,37 @@ iface eth1 inet static
for the root password for the database. Choose a strong
password and remember it.</para>
</note>
<para>Edit <filename os="ubuntu;debian"
>/etc/mysql/my.cnf</filename><filename
os="opensuse;sles;rhel;fedora;centos"
>/etc/my.cnf</filename> and set the
<literal>bind-address</literal> to the internal IP address
of the controller, to enable access from outside the
controller node.</para>
<programlisting language="ini">[mysqld]
<para>The MySQL configuration requires some changes to work with
OpenStack.</para>
<procedure>
<step>
<para os="ubuntu;debian">Edit the
<filename>/etc/mysql/my.cnf</filename> file:</para>
<para os="opensuse;sles;rhel;fedora;centos">Edit the
<filename>/etc/my.cnf</filename> file:</para>
<substeps>
<step>
<para>Under the <literal>[mysqld]</literal> section, set the
<literal>bind-address</literal> key to the management IP
address of the controller node to enable access by other
nodes via the management network:</para>
<programlisting>[mysqld]
...
bind-address = 192.168.0.10</programlisting>
bind-address = 192.168.0.10</programlisting>
</step>
<step>
<para>Under the <literal>[mysqld]</literal> section, set the
following keys to enable the UTF-8 character set by
default:</para>
<programlisting>[mysqld]
...
collation-server = utf8_general_ci
init-connect = 'SET NAMES utf8'
character-set-server = utf8</programlisting>
</step>
</substeps>
</step>
</procedure>
<para os="ubuntu;debian">Restart the MySQL service to apply
the changes:</para>
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>service mysql restart</userinput></screen>