source: content/databases/mysql/mysql-config.xml@ 65df9fca

<sect2>
<title>Configuring <application>My<acronym>SQL</acronym></application></title>

<sect3>
<title>Config files</title>

<para><filename>/etc/my.cnf</filename>, <filename>~/.my.cnf</filename></para>

</sect3>

<sect3>
<title>Configuration Information</title>

<para>There are several default configuration files available in
<filename class="directory">/usr/share/mysql</filename> which you can
use.  Create <filename>/etc/my.cnf</filename> using the following
command:</para>

<screen><userinput><command>cp /usr/share/mysql/my-medium.cnf /etc/my.cnf</command></userinput></screen>

<para>You can now install a database and change the ownership to the
unprivileged user and group.</para>

<screen><userinput><command>mysql_install_db &amp;&amp;
chown -R mysql:mysql /var/lib/mysql</command></userinput></screen>

<para>Further configuration requires that the mysql server be running:</para>

<screen><userinput><command>mysqld_safe --user=mysql 2&gt;&amp;1 &gt;/dev/null &amp;</command></userinput></screen>

<para>A default installation does not setup a password for the
administrator, so use the following command to set one. Replace <replaceable>[new-password]</replaceable>
with your own.</para>

<!--
<screen><userinput><command>mysql -uroot mysql</command></userinput>
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 2 to server version: 3.23.51-log

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

<prompt>mysql&gt;</prompt> <userinput><command>UPDATE user SET password=password('<replaceable>new-password</replaceable>') WHERE user='root';</command></userinput>
Query OK, 2 rows affected (0.00 sec)
Rows matched: 2  Changed: 2  Warnings: 0

<prompt>mysql&gt;</prompt> <userinput><command>FLUSH PRIVILEGES;</command></userinput>
Query OK, 0 rows affected (0.00 sec)

<prompt>mysql&gt;</prompt> <userinput><command>EXIT;</command></userinput>
bye
</screen>
-->

<screen><userinput><command>mysqladmin -u root password <replaceable>[new-password]</replaceable></command></userinput></screen>

<para>Configuration of the server is now finished. Shut the server down
using the following command:</para>

<screen><userinput><command>mysqladmin -p shutdown</command></userinput></screen>

<para>Install the <filename>/etc/rc.d/init.d/mysql</filename>
init script included in the <xref linkend="intro-important-bootscripts"/> package.</para>
                                                                                                                
<screen><userinput><command>make install-mysql</command></userinput></screen>

</sect3>

</sect2>