Se puede instalar MySQL en Mac OS X 10.2.x (“Jaguar”) y posteriores utilizando un paquete binario de Mac OS X en formato PKG en lugar de la distribución binaria tarball. Debe tenerse en cuenta que las versiones anteriores de Mac OS X (por ejemplo, 10.1.x) no no están soportadas por este paquete.

El paquete se encuentra dentro de un fichero de imagen de disco (.dmg) que deberá montarse haciendo doble click sobre su ícono en Finder. Una vez montado debería verse su contenido en la pantalla.

Para obtener MySQL, consulte Sección 2.1.3, “Cómo obtener MySQL”.

Nota: Antes de proceder con la instalación, deben haberse finalizado todas las instancias del servidor MySQL en ejecución, ya sea usando la Aplicación MySQL Manager (en Mac OS X Server) o a través de mysqladmin shutdown en la línea de comandos.

Para instalar el fichero PKG de MySQL, debe hacerse doble click en el ícono del paquete. Esto iniciará el Instalador de Paquetes de Mac OS X, el cual guiará el resto de la instalación.

Debido a un error en el instalador de paquetes de Mac OS X, puede llegar a verse este error en el cuadro de diálogo de selección de disco destino:

You cannot install this software on this disk. (null)

Si ocurre este error, simplemente debe hacerse click en el botón Go Back una vez para volver a la pantalla anterior. Luego hacer click en Continue para avanzar nuevamente a la selección de disco destinto, y entonces debería poderse elegir sin problemas la unidad de instalación. MySQL AB ha informado de este error a Apple, quien se encuentra investigando el problema.

El PKG para Mac OS X de MySQL se instala en /usr/local/mysql-VERSION y también instala un vínculo simbólico, /usr/local/mysql, apuntando a la nueva ubicación. Si existe un directorio llamado /usr/local/mysql, será renombrado a /usr/local/mysql.bak primero. Adicionalmente, el instalador creará las tablas de permisos en la base de datos mysql a través de la ejecución de mysql_install_db después de la instalación.

La disposición de la instalación es similar a la de la distribución binaria en fichero tar, todos los ficheros binarios de MySQL están ubicados en el directorio /usr/local/mysql/bin. El fichero de socket MySQL se crea por defecto en /tmp/mysql.sock. Consulte Sección 2.1.5, “Conformación de la instalación”.

La instalación de MySQL requiere una cuenta de usuario Mac OS X llamada mysql. En Mac OS X 10.2 y posteriores, debería existir por defecto una cuenta con este nombre.

Si se está ejecutando Mac OS X Server, entonces se tiene una versión de MySQL instalada. Las versiones de MySQL que acompañan a cada versión de Mac OS X Server se muestran en la siguiente tabla:

Esta sección del manual abarca solamente la instalación del PKG oficial para Mac OS X de MySQL. Se debe leer la ayuda de Apple relativa a la instalación de MySQL: Ejecutando la aplicación “Help View”, seleccionando la ayuda de “Mac OS X Server”, haciendo una búsqueda por “MySQL”, y leyendo el tema titulado “Installing MySQL.”

En versiones de MySQL preinstaladas en Mac OS X Server, hay que tener en cuenta especialmente que se debería dar inicio a mysqld con el comando safe_mysqld en lugar de mysqld_safe si MySQL es anterior a la versión 4.0.

Si anteriormente se estuvieron utilizando los paquetes para Mac OS X de Marc Liyanage, descargados de http://www.entropy.ch, es suficiente con seguir las instrucciones para actualizar paquetes que usan la disposición de la instalación binaria, como se ha presentado en estas páginas.

Si se está actualizando hacia el PKG MySQL oficial desde alguna de las versiones 3.23.xx de Marc, o desde la versión de MySQL que acompaña al Mac OS X Server, se pueden convertir al formato actual las tablas de privilegios MySQL existentes, ya que se añadieron algunos nuevos privilegios de seguridad. Consulte Sección 2.10.2, “Aumentar la versión de las tablas de privilegios”.

Si se desea iniciar automáticamente el servidor MySQL junto con el arranque del sistema, será necesario instalar también el Componente MySQL Startup (Inicio de MySQL). En el caso de MySQL 5.0, viene como un paquete separado dentro de las imágenes de disco de instalación. Siplemente hay que hacer doble click en el ícono MySQLStartupItem.pkg y seguir las instrucciones para instalarlo.

El Componente de Inicio de MySQL sólo necesita ser instalado una vez: no hay necesidad de instalarlo cada vez que se hace una actualización de MySQL

El Componente de Inicio de MySQL se instala en /Library/StartupItems/MySQLCOM. (Antes de MySQL 4.1.2, la ubicación era /Library/StartupItems/MySQL, pero entraba en conflicto con el Componente de Inicio de MySQL instalado por Mac OS X Server). La instalación del Componente de Inicio agrega una variable MYSQLCOM=-YES- al fichero de configuración del sistema /etc/hostconfig. Si se deseara deshabilitar el inicio automático de MySQL, simplemente hay que cambiar esta variable a MYSQLCOM=-NO-.

En Mac OS X Server, la instalación por defecto de MySQL utiliza la variable MYSQL en el fichero /etc/hostconfig. El instalador del Componente de Inicio de MySQL provisto por MySQL AB deshabilita esta variable estableciéndola en MYSQL=-NO-. Esto evita conflictos al momento del arranque del sistema con la variable MYSQLCOM utilizada por el Componente de Inicio de MySQL AB. Sin embargo, ello no finaliza un server MySQL en ejecución. Eso debería ser hecho expresamente por el usuario.

Luego de la instalación, se puede iniciar MySQL ejecutando los siguientes comandos en una ventana de terminal. Se deben tener privilegios de administrador para llevar a cabo esta tarea.

Si se ha instalado el Componente de Inicio:

shell> sudo /Library/StartupItems/MySQLCOM/MySQLCOM start
(Enter your password, if necessary)
(Press Control-D or enter "exit" to exit the shell)

Si no se ha instalado el Componente de Inicio, debe ingresarse la siguiente secuencia de comandos:

shell> cd /usr/local/mysql
shell> sudo ./bin/mysqld_safe
(Enter your password, if necessary)
(Press Control-Z)
shell> bg
(Press Control-D or enter "exit" to exit the shell)

Se debería estar en condiciones de conectar con el servidor MySQL, por ejemplo, ejecutando /usr/local/mysql/bin/mysql.

Nota: Las cuentas que se hallan en las tablas de permisos de MySQL, en principio no están protegidas con contraseñas. Después de iniciar el servidor se deben establecer contraseñas para esas cuentas siguiendo las instrucciones en Sección 2.9, “Puesta en marcha y comprobación después de la instalación”.

Se podría desear agregar alias al fichero de recursos del shell para facilitar el acceso a los programas más utilizados, como mysql y mysqladmin, desde la línea de comandos. La sintaxis para tcsh es:

alias mysql /usr/local/mysql/bin/mysql
alias mysqladmin /usr/local/mysql/bin/mysqladmin

Para bash, debe usarse:

alias mysql=/usr/local/mysql/bin/mysql
alias mysqladmin=/usr/local/mysql/bin/mysqladmin

Aún mejor, es agregar /usr/local/mysql/bin a la variable de entorno PATH. Por ejemplo, si se emplea el shell tcsh, agregando la siguiente línea al fichero $HOME/.tcshrc:

setenv PATH ${PATH}:/usr/local/mysql/bin

Si en el directorio home no existe el fichero .tcshrc, se lo deberá crear con un editor de textos.

Si se está actualizando una instalación existente, hay que notar que instalar un nuevo PKG MySQL no borra el directorio de la instalación anterior. Desafortunadamente, el instalador de Mac OS X aún no ofrece la funcionalidad necesaria para actualizar apropiadamente los paquetes instalados con anterioridad.

Para utilizar en la nueva instalación las bases de datos existentes, habrá que copiar el contenido del directorio de datos antiguo dentro del nuevo. Hay que asegurarse que ni el antiguo servidor ni el nuevo estén en funcionamiento cuando se haga esto. Luego de que se hayan copiado las bases de datos desde la antigua instalación hacia la nueva, y se haya iniciado exitosamente el nuevo servidor, debe considerarse la eliminación de la instalación anterior a fin de recuperar espacio en disco. Quizá también se desee borrar versiones antiguas de los directorios Receipt localizados en /Library/Receipts/mysql-VERSION.pkg.