\fBMYSQL.SERVER\fR

Section: MySQL Database System (1)
Updated: 11/15/2007
Index Return to Main Contents

NAME

mysql.server - MySQL server startup script

SYNOPSIS

mysql {start|stop}

DESCRIPTION

MySQL distributions on Unix include a script named mysql.server. It can be used on systems such as Linux and Solaris that use System V-style run directories to start and stop system services. It is also used by the Mac OS X Startup Item for MySQL.

mysql.server can be found in the support-files directory under your MySQL installation directory or in a MySQL source distribution.

If you use the Linux server RPM package (MySQL-server-VERSION.rpm), the mysql.server script will be installed in the /etc/init.d directory with the name mysql. You need not install it manually. See Section 4.9, lqInstalling MySQL from RPM Packages on Linuxrq, for more information on the Linux RPM packages.

Some vendors provide RPM packages that install a startup script under a different name such as mysqld.

If you install MySQL from a source distribution or using a binary distribution format that does not install mysql.server automatically, you can install it manually. Instructions are provided in Section 4.16.2.2, lqStarting and Stopping MySQL Automaticallyrq.

mysql.server reads options from the [mysql.server] and [mysqld] sections of option files. For backward compatibility, it also reads [mysql_server] sections, although you should rename such sections to [mysql.server] when using MySQL 5.0.

mysql.server understands the following options:

*: --basedir=path
The path to the MySQL installation directory.
*: --datadir=path
The path to the MySQL data directory.
*: --pid-file=file_name
The pathname of the file in which the server should write its process ID.
*: --service-startup-timeout=file_name
How long in seconds to wait for confirmation of server startup. If the server does not start within this time, mysql.server exits with an error. The default value is 900. A value of 0 means not to wait at all for startup. Negative values mean to wait forever (no timeout). This option was added in MySQL 5.0.40. Before that, a value of 900 is always used.
*: --use-mysqld_safe
Use mysqld_safe to start the server. This is the default. This option was added in MySQL 5.0.4.
*: --use-manager
Use Instance Manager to start the server. This option was added in MySQL 5.0.4.
*: --user=user_name
The login username to use for running mysqld. This option was added in MySQL 5.0.4.

COPYRIGHT

This documentation is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License.

This documentation is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with the program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA or see http://www.gnu.org/licenses/.

Please email <docs@mysql.com> for more information or if you are interested in doing a translation.