Author: paul
Date: 2007-03-07 19:59:03 +0100 (Wed, 07 Mar 2007)
New Revision: 5243
Log:
r17384@frost: paul | 2007-03-07 12:55:44 -0600
Revised binary (tar file) and source install instructions to better account
for file permissions needed depending on whether you run the commands as
root or mysql. (Bug#22835)
Modified:
trunk/refman-4.1/installing.xml
trunk/refman-5.0/installing-cs.xml
trunk/refman-5.1/installing.xml
Property changes on: trunk
___________________________________________________________________
Name: svk:merge
- 4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:21154
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:17383
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:14218
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:14593
+ 4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:21154
7d8d2c4e-af1d-0410-ab9f-b038ce55645b:/mysqldoc-local/mysqldoc:17384
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:14218
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:14593
Modified: trunk/refman-4.1/installing.xml
===================================================================
--- trunk/refman-4.1/installing.xml 2007-03-07 18:58:29 UTC (rev 5242)
+++ trunk/refman-4.1/installing.xml 2007-03-07 18:59:03 UTC (rev 5243)
Changed blocks: 9, Lines Added: 74, Lines Deleted: 50; 8666 bytes
@@ -6912,10 +6912,11 @@
shell> <userinput>gunzip <
<replaceable>/path/to/mysql-VERSION-OS</replaceable>.tar.gz | tar xvf
-</userinput>
shell> <userinput>ln -s
<replaceable>full-path-to-mysql-VERSION-OS</replaceable>
mysql</userinput>
shell> <userinput>cd mysql</userinput>
+shell> <userinput>chown -R mysql .</userinput>
+shell> <userinput>chgrp -R mysql .</userinput>
shell> <userinput>scripts/mysql_install_db --user=mysql</userinput>
-shell> <userinput>chown -R root .</userinput>
+shell> <userinput>chown -R root .</userinput>
shell> <userinput>chown -R mysql data</userinput>
-shell> <userinput>chgrp -R mysql .</userinput>
shell> <userinput>bin/mysqld_safe --user=mysql &</userinput>
</programlisting>
@@ -7076,8 +7077,32 @@
<listitem>
<para>
+ Ensure that the distribution contents are accessible to
+ <literal>mysql</literal>. If you unpacked the distribution as
+ <literal>mysql</literal>, no further action is required. If
+ you unpacked the distribution as <literal>root</literal>, its
+ contents will be owned by <literal>root</literal>. Change its
+ ownership to <literal>mysql</literal> by executing the
+ following commands as <literal>root</literal> in the
+ installation directory:
+ </para>
+
+<programlisting>
+shell> <userinput>chown -R mysql .</userinput>
+shell> <userinput>chgrp -R mysql .</userinput>
+</programlisting>
+
+ <para>
+ The first command changes the owner attribute of the files to
+ the <literal>mysql</literal> user. The second changes the
+ group attribute to the <literal>mysql</literal> group.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
If you have not installed MySQL before, you must create the
- MySQL grant tables:
+ MySQL data directory and initialize the grant tables:
</para>
<programlisting>
@@ -7085,11 +7110,9 @@
</programlisting>
<para>
- If you run the command as <literal>root</literal>, you must
- use the <option>--user</option> option as shown. The value of
- the option is the name of the login account that you created
- in the first step to use for running the server. If you run
- the command while logged in as that user, you can omit the
+ If you run the command as <literal>root</literal>, include the
+ <option>--user</option> option as shown. If you run the
+ command while logged in as that user, you can omit the
<option>--user</option> option.
</para>
@@ -7109,27 +7132,17 @@
<listitem>
<para>
- Change the ownership of program binaries to
- <literal>root</literal> and ownership of the data directory to
- the user that you run <command>mysqld</command> as. Assuming
- that you are located in the installation directory
- (<filename>/usr/local/mysql</filename>), the commands look
- like this:
+ Most of the MySQL installation can be owned by
+ <literal>root</literal> if you like. The exception is that the
+ data directory must be owned by <literal>mysql</literal>. To
+ accomplish this, run the following commands as
+ <literal>root</literal> in the installation directory:
</para>
<programlisting>
-shell> <userinput>chown -R root .</userinput>
+shell> <userinput>chown -R root .</userinput>
shell> <userinput>chown -R mysql data</userinput>
-shell> <userinput>chgrp -R mysql .</userinput>
</programlisting>
-
- <para>
- The first command changes the owner attribute of the files to
- the <literal>root</literal> user. The second changes the owner
- attribute of the data directory to the
- <literal>mysql</literal> user. The third changes the group
- attribute to the <literal>mysql</literal> group.
- </para>
</listitem>
<listitem>
@@ -7384,7 +7397,6 @@
<programlisting>
shell> <userinput>groupadd mysql</userinput>
shell> <userinput>useradd -g mysql mysql</userinput>
-shell> <replaceable>change user to mysql</replaceable>
shell> <userinput>gunzip <
mysql-<replaceable>VERSION</replaceable>.tar.gz | tar -xvf
-</userinput>
shell> <userinput>cd
mysql-<replaceable>VERSION</replaceable></userinput>
shell> <userinput>./configure --prefix=/usr/local/mysql</userinput>
@@ -7392,10 +7404,11 @@
shell> <userinput>make install</userinput>
shell> <userinput>cp support-files/my-medium.cnf
/etc/my.cnf</userinput>
shell> <userinput>cd /usr/local/mysql</userinput>
+shell> <userinput>chown -R mysql .</userinput>
+shell> <userinput>chgrp -R mysql .</userinput>
shell> <userinput>bin/mysql_install_db --user=mysql</userinput>
-shell> <userinput>chown -R root .</userinput>
+shell> <userinput>chown -R root .</userinput>
shell> <userinput>chown -R mysql var</userinput>
-shell> <userinput>chgrp -R mysql .</userinput>
shell> <userinput>bin/mysqld_safe --user=mysql &</userinput>
</programlisting>
@@ -7618,8 +7631,30 @@
<listitem>
<para>
+ If you ran the <command>make install</command> command as
+ <literal>root</literal>, the installed files will be owned
+ by <literal>root</literal>. Ensure that the installation is
+ accessible to <literal>mysql</literal> by executing the
+ following commands as <literal>root</literal> in the
+ installation directory:
+ </para>
+
+<programlisting>
+shell> <userinput>chown -R mysql .</userinput>
+shell> <userinput>chgrp -R mysql .</userinput>
+</programlisting>
+
+ <para>
+ The first command changes the owner attribute of the files
+ to the <literal>mysql</literal> user. The second changes the
+ group attribute to the <literal>mysql</literal> group.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
If you have not installed MySQL before, you must create the
- data directory and initialize the MySQL grant tables:
+ MySQL data directory and initialize the grant tables:
</para>
<programlisting>
@@ -7627,12 +7662,10 @@
</programlisting>
<para>
- If you run the command as <literal>root</literal>, you
- should use the <option>--user</option> option as shown. The
- value of the option is the name of the login account that
- you created in the first step to use for running the server.
- If you run the command while logged in as that user, you can
- omit the <option>--user</option> option.
+ If you run the command as <literal>root</literal>, include
+ the <option>--user</option> option as shown. If you run the
+ command while logged in as that user, you can omit the
+ <option>--user</option> option.
</para>
<para>
@@ -7651,27 +7684,18 @@
<listitem>
<para>
- Change the ownership of program binaries to
- <literal>root</literal> and ownership of the data directory
- to the user that you run <command>mysqld</command> as.
- Assuming that you are in the installation directory
- (<filename>/usr/local/mysql</filename>), the commands look
- like this:
+ Most of the MySQL installation can be owned by
+ <literal>root</literal> if you like. The exception is that
+ the data directory must be owned by
+ <literal>mysql</literal>. To accomplish this, run the
+ following commands as <literal>root</literal> in the
+ installation directory:
</para>
<programlisting>
-shell> <userinput>chown -R root .</userinput>
+shell> <userinput>chown -R root .</userinput>
shell> <userinput>chown -R mysql var</userinput>
-shell> <userinput>chgrp -R mysql .</userinput>
</programlisting>
-
- <para>
- The first command changes the owner attribute of the files
- to the <literal>root</literal> user. The second changes the
- owner attribute of the data directory to the
- <literal>mysql</literal> user. The third changes the group
- attribute to the <literal>mysql</literal> group.
- </para>
</listitem>
<listitem>
Modified: trunk/refman-5.0/installing-cs.xml
===================================================================
--- trunk/refman-5.0/installing-cs.xml 2007-03-07 18:58:29 UTC (rev 5242)
+++ trunk/refman-5.0/installing-cs.xml 2007-03-07 18:59:03 UTC (rev 5243)
Changed blocks: 9, Lines Added: 74, Lines Deleted: 50; 8683 bytes
@@ -6059,10 +6059,11 @@
shell> <userinput>gunzip <
<replaceable>/path/to/mysql-VERSION-OS</replaceable>.tar.gz | tar xvf
-</userinput>
shell> <userinput>ln -s
<replaceable>full-path-to-mysql-VERSION-OS</replaceable>
mysql</userinput>
shell> <userinput>cd mysql</userinput>
+shell> <userinput>chown -R mysql .</userinput>
+shell> <userinput>chgrp -R mysql .</userinput>
shell> <userinput>scripts/mysql_install_db --user=mysql</userinput>
-shell> <userinput>chown -R root .</userinput>
+shell> <userinput>chown -R root .</userinput>
shell> <userinput>chown -R mysql data</userinput>
-shell> <userinput>chgrp -R mysql .</userinput>
shell> <userinput>bin/mysqld_safe --user=mysql &</userinput>
</programlisting>
@@ -6217,8 +6218,32 @@
<listitem>
<para>
+ Ensure that the distribution contents are accessible to
+ <literal>mysql</literal>. If you unpacked the distribution as
+ <literal>mysql</literal>, no further action is required. If
+ you unpacked the distribution as <literal>root</literal>, its
+ contents will be owned by <literal>root</literal>. Change its
+ ownership to <literal>mysql</literal> by executing the
+ following commands as <literal>root</literal> in the
+ installation directory:
+ </para>
+
+<programlisting>
+shell> <userinput>chown -R mysql .</userinput>
+shell> <userinput>chgrp -R mysql .</userinput>
+</programlisting>
+
+ <para>
+ The first command changes the owner attribute of the files to
+ the <literal>mysql</literal> user. The second changes the
+ group attribute to the <literal>mysql</literal> group.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
If you have not installed MySQL before, you must create the
- MySQL grant tables:
+ MySQL data directory and initialize the grant tables:
</para>
<programlisting>
@@ -6226,11 +6251,9 @@
</programlisting>
<para>
- If you run the command as <literal>root</literal>, you must
- use the <option>--user</option> option as shown. The value of
- the option is the name of the login account that you created
- in the first step to use for running the server. If you run
- the command while logged in as that user, you can omit the
+ If you run the command as <literal>root</literal>, include the
+ <option>--user</option> option as shown. If you run the
+ command while logged in as that user, you can omit the
<option>--user</option> option.
</para>
@@ -6247,27 +6270,17 @@
<listitem>
<para>
- Change the ownership of program binaries to
- <literal>root</literal> and ownership of the data directory to
- the user that you run <command>mysqld</command> as. Assuming
- that you are located in the installation directory
- (<filename>/usr/local/mysql</filename>), the commands look
- like this:
+ Most of the MySQL installation can be owned by
+ <literal>root</literal> if you like. The exception is that the
+ data directory must be owned by <literal>mysql</literal>. To
+ accomplish this, run the following commands as
+ <literal>root</literal> in the installation directory:
</para>
<programlisting>
-shell> <userinput>chown -R root .</userinput>
+shell> <userinput>chown -R root .</userinput>
shell> <userinput>chown -R mysql data</userinput>
-shell> <userinput>chgrp -R mysql .</userinput>
</programlisting>
-
- <para>
- The first command changes the owner attribute of the files to
- the <literal>root</literal> user. The second changes the owner
- attribute of the data directory to the
- <literal>mysql</literal> user. The third changes the group
- attribute to the <literal>mysql</literal> group.
- </para>
</listitem>
<listitem>
@@ -6515,7 +6528,6 @@
<programlisting>
shell> <userinput>groupadd mysql</userinput>
shell> <userinput>useradd -g mysql mysql</userinput>
-shell> <replaceable>change user to mysql</replaceable>
shell> <userinput>gunzip <
mysql-<replaceable>VERSION</replaceable>.tar.gz | tar -xvf
-</userinput>
shell> <userinput>cd
mysql-<replaceable>VERSION</replaceable></userinput>
shell> <userinput>./configure --prefix=/usr/local/mysql</userinput>
@@ -6523,10 +6535,11 @@
shell> <userinput>make install</userinput>
shell> <userinput>cp support-files/my-medium.cnf
/etc/my.cnf</userinput>
shell> <userinput>cd /usr/local/mysql</userinput>
+shell> <userinput>chown -R mysql .</userinput>
+shell> <userinput>chgrp -R mysql .</userinput>
shell> <userinput>bin/mysql_install_db --user=mysql</userinput>
-shell> <userinput>chown -R root .</userinput>
+shell> <userinput>chown -R root .</userinput>
shell> <userinput>chown -R mysql var</userinput>
-shell> <userinput>chgrp -R mysql .</userinput>
shell> <userinput>bin/mysqld_safe --user=mysql &</userinput>
</programlisting>
@@ -6743,8 +6756,30 @@
<listitem>
<para>
+ If you ran the <command>make install</command> command as
+ <literal>root</literal>, the installed files will be owned
+ by <literal>root</literal>. Ensure that the installation is
+ accessible to <literal>mysql</literal> by executing the
+ following commands as <literal>root</literal> in the
+ installation directory:
+ </para>
+
+<programlisting>
+shell> <userinput>chown -R mysql .</userinput>
+shell> <userinput>chgrp -R mysql .</userinput>
+</programlisting>
+
+ <para>
+ The first command changes the owner attribute of the files
+ to the <literal>mysql</literal> user. The second changes the
+ group attribute to the <literal>mysql</literal> group.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
If you have not installed MySQL before, you must create the
- data directory and initialize the MySQL grant tables:
+ MySQL data directory and initialize the grant tables:
</para>
<programlisting>
@@ -6752,12 +6787,10 @@
</programlisting>
<para>
- If you run the command as <literal>root</literal>, you
- should use the <option>--user</option> option as shown. The
- value of the option is the name of the login account that
- you created in the first step to use for running the server.
- If you run the command while logged in as that user, you can
- omit the <option>--user</option> option.
+ If you run the command as <literal>root</literal>, include
+ the <option>--user</option> option as shown. If you run the
+ command while logged in as that user, you can omit the
+ <option>--user</option> option.
</para>
<para>
@@ -6775,27 +6808,18 @@
<listitem>
<para>
- Change the ownership of program binaries to
- <literal>root</literal> and ownership of the data directory
- to the user that you run <command>mysqld</command> as.
- Assuming that you are located in the installation directory
- (<filename>/usr/local/mysql</filename>), the commands look
- like this:
+ Most of the MySQL installation can be owned by
+ <literal>root</literal> if you like. The exception is that
+ the data directory must be owned by
+ <literal>mysql</literal>. To accomplish this, run the
+ following commands as <literal>root</literal> in the
+ installation directory:
</para>
<programlisting>
-shell> <userinput>chown -R root .</userinput>
+shell> <userinput>chown -R root .</userinput>
shell> <userinput>chown -R mysql var</userinput>
-shell> <userinput>chgrp -R mysql .</userinput>
</programlisting>
-
- <para>
- The first command changes the owner attribute of the files
- to the <literal>root</literal> user. The second changes the
- owner attribute of the data directory to the
- <literal>mysql</literal> user. The third changes the group
- attribute to the <literal>mysql</literal> group.
- </para>
</listitem>
<listitem>
Modified: trunk/refman-5.1/installing.xml
===================================================================
--- trunk/refman-5.1/installing.xml 2007-03-07 18:58:29 UTC (rev 5242)
+++ trunk/refman-5.1/installing.xml 2007-03-07 18:59:03 UTC (rev 5243)
Changed blocks: 9, Lines Added: 74, Lines Deleted: 50; 8674 bytes
@@ -6802,10 +6802,11 @@
shell> <userinput>gunzip <
<replaceable>/path/to/mysql-VERSION-OS</replaceable>.tar.gz | tar xvf
-</userinput>
shell> <userinput>ln -s
<replaceable>full-path-to-mysql-VERSION-OS</replaceable>
mysql</userinput>
shell> <userinput>cd mysql</userinput>
+shell> <userinput>chown -R mysql .</userinput>
+shell> <userinput>chgrp -R mysql .</userinput>
shell> <userinput>scripts/mysql_install_db --user=mysql</userinput>
-shell> <userinput>chown -R root .</userinput>
+shell> <userinput>chown -R root .</userinput>
shell> <userinput>chown -R mysql data</userinput>
-shell> <userinput>chgrp -R mysql .</userinput>
shell> <userinput>bin/mysqld_safe --user=mysql &</userinput>
</programlisting>
@@ -6960,8 +6961,32 @@
<listitem>
<para>
+ Ensure that the distribution contents are accessible to
+ <literal>mysql</literal>. If you unpacked the distribution as
+ <literal>mysql</literal>, no further action is required. If
+ you unpacked the distribution as <literal>root</literal>, its
+ contents will be owned by <literal>root</literal>. Change its
+ ownership to <literal>mysql</literal> by executing the
+ following commands as <literal>root</literal> in the
+ installation directory:
+ </para>
+
+<programlisting>
+shell> <userinput>chown -R mysql .</userinput>
+shell> <userinput>chgrp -R mysql .</userinput>
+</programlisting>
+
+ <para>
+ The first command changes the owner attribute of the files to
+ the <literal>mysql</literal> user. The second changes the
+ group attribute to the <literal>mysql</literal> group.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
If you have not installed MySQL before, you must create the
- MySQL grant tables:
+ MySQL data directory and initialize the grant tables:
</para>
<programlisting>
@@ -6969,11 +6994,9 @@
</programlisting>
<para>
- If you run the command as <literal>root</literal>, you must
- use the <option>--user</option> option as shown. The value of
- the option is the name of the login account that you created
- in the first step to use for running the server. If you run
- the command while logged in as that user, you can omit the
+ If you run the command as <literal>root</literal>, include the
+ <option>--user</option> option as shown. If you run the
+ command while logged in as that user, you can omit the
<option>--user</option> option.
</para>
@@ -6990,27 +7013,17 @@
<listitem>
<para>
- Change the ownership of program binaries to
- <literal>root</literal> and ownership of the data directory to
- the user that you run <command>mysqld</command> as. Assuming
- that you are located in the installation directory
- (<filename>/usr/local/mysql</filename>), the commands look
- like this:
+ Most of the MySQL installation can be owned by
+ <literal>root</literal> if you like. The exception is that the
+ data directory must be owned by <literal>mysql</literal>. To
+ accomplish this, run the following commands as
+ <literal>root</literal> in the installation directory:
</para>
<programlisting>
-shell> <userinput>chown -R root .</userinput>
+shell> <userinput>chown -R root .</userinput>
shell> <userinput>chown -R mysql data</userinput>
-shell> <userinput>chgrp -R mysql .</userinput>
</programlisting>
-
- <para>
- The first command changes the owner attribute of the files to
- the <literal>root</literal> user. The second changes the owner
- attribute of the data directory to the
- <literal>mysql</literal> user. The third changes the group
- attribute to the <literal>mysql</literal> group.
- </para>
</listitem>
<listitem>
@@ -7258,7 +7271,6 @@
<programlisting>
shell> <userinput>groupadd mysql</userinput>
shell> <userinput>useradd -g mysql mysql</userinput>
-shell> <replaceable>change user to mysql</replaceable>
shell> <userinput>gunzip <
mysql-<replaceable>VERSION</replaceable>.tar.gz | tar -xvf
-</userinput>
shell> <userinput>cd
mysql-<replaceable>VERSION</replaceable></userinput>
shell> <userinput>./configure --prefix=/usr/local/mysql</userinput>
@@ -7266,10 +7278,11 @@
shell> <userinput>make install</userinput>
shell> <userinput>cp support-files/my-medium.cnf
/etc/my.cnf</userinput>
shell> <userinput>cd /usr/local/mysql</userinput>
+shell> <userinput>chown -R mysql .</userinput>
+shell> <userinput>chgrp -R mysql .</userinput>
shell> <userinput>bin/mysql_install_db --user=mysql</userinput>
-shell> <userinput>chown -R root .</userinput>
+shell> <userinput>chown -R root .</userinput>
shell> <userinput>chown -R mysql var</userinput>
-shell> <userinput>chgrp -R mysql .</userinput>
shell> <userinput>bin/mysqld_safe --user=mysql &</userinput>
</programlisting>
@@ -7486,8 +7499,30 @@
<listitem>
<para>
+ If you ran the <command>make install</command> command as
+ <literal>root</literal>, the installed files will be owned
+ by <literal>root</literal>. Ensure that the installation is
+ accessible to <literal>mysql</literal> by executing the
+ following commands as <literal>root</literal> in the
+ installation directory:
+ </para>
+
+<programlisting>
+shell> <userinput>chown -R mysql .</userinput>
+shell> <userinput>chgrp -R mysql .</userinput>
+</programlisting>
+
+ <para>
+ The first command changes the owner attribute of the files
+ to the <literal>mysql</literal> user. The second changes the
+ group attribute to the <literal>mysql</literal> group.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
If you have not installed MySQL before, you must create the
- data directory and initialize the MySQL grant tables:
+ MySQL data directory and initialize the grant tables:
</para>
<programlisting>
@@ -7495,12 +7530,10 @@
</programlisting>
<para>
- If you run the command as <literal>root</literal>, you
- should use the <option>--user</option> option as shown. The
- value of the option is the name of the login account that
- you created in the first step to use for running the server.
- If you run the command while logged in as that user, you can
- omit the <option>--user</option> option.
+ If you run the command as <literal>root</literal>, include
+ the <option>--user</option> option as shown. If you run the
+ command while logged in as that user, you can omit the
+ <option>--user</option> option.
</para>
<para>
@@ -7518,27 +7551,18 @@
<listitem>
<para>
- Change the ownership of program binaries to
- <literal>root</literal> and ownership of the data directory
- to the user that you run <command>mysqld</command> as.
- Assuming that you are located in the installation directory
- (<filename>/usr/local/mysql</filename>), the commands look
- like this:
+ Most of the MySQL installation can be owned by
+ <literal>root</literal> if you like. The exception is that
+ the data directory must be owned by
+ <literal>mysql</literal>. To accomplish this, run the
+ following commands as <literal>root</literal> in the
+ installation directory:
</para>
<programlisting>
-shell> <userinput>chown -R root .</userinput>
+shell> <userinput>chown -R root .</userinput>
shell> <userinput>chown -R mysql var</userinput>
-shell> <userinput>chgrp -R mysql .</userinput>
</programlisting>
-
- <para>
- The first command changes the owner attribute of the files
- to the <literal>root</literal> user. The second changes the
- owner attribute of the data directory to the
- <literal>mysql</literal> user. The third changes the group
- attribute to the <literal>mysql</literal> group.
- </para>
</listitem>
<listitem>
| Thread |
|---|
| • svn commit - mysqldoc@docsrva: r5243 - in trunk: . refman-4.1 refman-5.0 refman-5.1 | paul | 7 Mar |