Depuis MySQL 4.0.11, vous pouvez installer MySQL sur Mac OS X 10.2 ("Jaguar") avec le paquet binaire Mac OS X PKG au lieu d'utiliser la distribution binaire compressée. Notez que les anciennes versions de Mac OS X (i.e. 10.1.x) ne sont pas supportées par ce paquet.

Le paquet est situé dans une image disque (.dmg), que vous devez monter en double-cliquant son icône sur le Finder. Le disque devrait alors se monter, et afficher son contenu.

Pour télécharger MySQL, voyez Section 2.1.3, « Comment obtenir MySQL ? ».

Note : avant de lancer l'installation, assurez vous qu'il n'y a pas de serveur MySQL en fonctionnement! Arrêtez tous les serveurs MySQL avant de continuer, soit en utilisant l'application manager (pour les serveurs Mac OS X) ou via mysqladmin shutdown en ligne de commande.

Pour installer le paquet MySQL, double-cliquez sur l'icône. Cela va lancer l'installeur de paquet MacOSX, qui vous guidera durant l'installation.

A cause d'un bug dans l'installeur de paquets MySQL, vous pourriez rencontrer le message d'erreur

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

dans le dialogue de sélection du disque de destination. Si cette erreur survient, cliquez sur le bouton de retour (Go Back) pour retourner à l'écran précédent. Puis, cliquez sur le bouton d'avance (Continue) pour passer à nouveau à la page de sélection des disques. Nous avons indiqué ce bug à Apple, qui travaille sur le sujet.

Le paquet Mac OS X de MySQL va s'installer lui-même dans le dossier /usr/local/mysql-VERSION et va aussi ajouter un lien symbolique /usr/local/mysql, qui pointe sur le nouveau dossier. Si un dossier appelé /usr/local/mysql existe déjà, il sera renommé en /usr/local/mysql.bak. De plus, il va installer les tables de droits MySQL en exécutant le script mysql_install_db après l'installation.

Le schéma d'installation est semblable à celui de la distribution binaire, tous les programmes MySQL sont situés dans le dossier /usr/local/mysql/bin. Les sockets MySQL sont installées dans le fichier /etc/mysql.sock par défaut. See Section 2.1.5, « Dispositions d'installation ».

L'installation requiert un compte nommé mysql (qui existe par défaut en Mac OS X 10.2 et plus récent).

Si vous utilisez Mac OS X Server, vous devez avoir déjà une version de MySQL installée :

Cette section du manuel couvre l'installation du paquet binaire MySQL pour Mac OS X uniquement. Assurez vous de bien lire l'aide d'Apple concernant l'installation de MySQL (Lancer le visualiseur d'aide, sélectionnez la rubrique "Serveur Mac OS X", et faites une recherche sur "MySQL", puis lisez l'entrée appelée "Installing MySQL").

Notez bien que la version pre-installée de MySQL sur Mac OS X Server peut être lancée avec la commande safe_mysqld au lieu de mysqld_safe!

Si vous avez utilisé auparavant les paquets MySQL de Marc Liyanage pour Mac OS X, depuis le site de http://www.entropy.ch, vous pouvez simplement suivre le processus de mise à jour, en utilisant les conseils de ses pages.

Si vous faites une mise à jour depuis les versions de Marc, ou depuis une ancienne version de MySQL pour Mac OS X Server, avec le nouveau paquet officiel, vous devrez convertir les tables de droits. See Section 2.6.3, « Passer de la version 3.23 à la version 4.0 ».

Si vous voulez lancer automatiquement MySQL au démarrage du système, vous devez aussi installer le MySQL Startup Item. Depuis MySQL 4.0.15, il fait partie du disque d'installation MySQL pour Mac OS X dans un paquet séparé. Il suffit de double-cliquer sur l'icône MySQLStartupItem.pkg et de suivre les instructions pour l'installer.

Notez que le MySQL Startup Item ne doit être installé qu'une seule fois. Il n'y a pas besoin de me mettre à jour avec les versions de MySQL.

Le MySQL Startup Item est installé dans le dossier /Library/StartupItems/MySQLCOM. (Avant MySQL 4.1.2, le dossier était /Library/StartupItems/MySQL, mais cela créait un conflit avec le MySQL Startup Item du serveur Mac OS X Server.) Il ajoute la variable MYSQLCOM=-YES- au fichier de configuration /etc/hostconfig. Si vous voulez désactiver le démarrage automatique de MySQL, modifiez simplement la variable avec MYSQLCOM=-NO-.

Sur Mac OS X Server, l'installation par défaut de MySQL utilise la variable MYSQL dans /etc/hostconfig. Le MySQL Startup Item désactive cette variable en lui donnant la valeur de MYSQL=-NO-. Cela évite que des conflit de démarrage surviennent, si la variable MYSQLCOM est utilisée par MySQL Startup Item. Cependant, cela n'éteint pas un serveur MySQL en fonctionnement.

Après cette installation, vous pouvez lancer le serveur MySQL avec ces commandes, exécutées dans terminal. Notez bien que vous devez avoir des droits d'administrateur pour cela!

Si vous avez installé le MySQL Startup Item :

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

Si vous n'avez pas installé le MySQL Startup Item :

shell> cd /usr/local/mysql
shell> sudo ./bin/mysqld_safe
(Enter your password)
(Press CTRL+Z)
shell> bg
(Press CTRL+D to exit the shell)

Vous devez alors être capable de vous connecter au serveur MySQL, notamment en exécutant la commande /usr/local/mysql/bin/mysql.

Note : cette procédure ne configure aucun mot de passe pour les comptes MySQL. Après avoir suivi cette procédure, lisez la section Section 2.5, « Procédure de post-installation », pour les instructions de post-installation et les tests.

Vous pouvez faire cela avec les commandes suivantes :

/usr/local/mysql/bin/mysqladmin -u root password <password>
/usr/local/mysql/bin/mysqladmin -u root -h `hostname` password <password>

Vous pouvez aussi ajouter des alias à votre fichier de ressource Shell, pour accéder à mysql et mysqladmin depuis la ligne de commande :

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

Alternativement, vous pouvez simplement ajouter /usr/local/mysql/bin à votre variable d'environnement PATH, par exemple, en ajoutant la ligne suivante dans votre fichier $HOME/.tcshrc :

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

Si aucun fichier .tcshrc n'existe dans votre dossier d'utilisateur, créez le avec un éditeur texte.

Notez que l'installation d'un nouveau paquet MySQL ne supprimer pas le dossier d'une vieille installation : l'installeur de Mac OS X n'offre pas encore les fonctionnalités nécessaires pour mettre à jour proprement une vieille version.

Après avoir copié les fichiers de bases depuis votre ancien dossier vers le nouveau, et que vous avez réussi à redémarrer MySQL avec la nouvelle version, vous devriez pensez à supprimer les vieilles versions des fichiers, situées dans /Library/Receipts/mysql-<version>.pkg.