Environnement Mac

Ce mode opératoire permet l'installation d'une application QALITEL / Epistolaire sous environnement Mac. Cette installation sera réalisée à l'aide de 'MAMP, c'est à dire avec un serveur Web Apache et la base de données MySQL.

1.  Installation de MAMP

L'application MAMP est un projet gratuit vous permettant d'installer un environnement complet Apache - MySQL et PHP. Dans la version 10.6 de MAMP, les modules suivants sont installés :

• Apache 2.0.63
• MySQL 5.1.44
• PHP 5.3.2 (ou PHP 5.2.13)

Assurez-vous de la compatibilité des modules installés par MAMP avec les préconisations fournies pour les installations des applications QALITEL / Epistolaire (Pré-requis techniques).

Vous pouvez télécharger le programme MAMP sur le site officiel de MAMP (http://www.mamp.info/en/index.html) ou via votre portail client si vous avez été enregistré comme utilisateur Mac par nos services.

Dans un premier temps, téléchargez le programme MAMP qui se présente sous forme d'un fichier .ZIP contenant le .DMG. A l'issue du téléchargement, exécutez le programme .DMG.

 Copiez ensuite le répertoire MAMP créé dans le répertoire /Applications/ comme cela est montré ci-dessous.

A l'issue de cette copie, MAMP est opérationnel. Pour le lancer, vous devez accéder au répertoire \Applications\MAMP\ et double cliquer sur le programme MAMP.

La console de management de MAMP est alors accessible.

Pour modifier les paramétrages de MAMP, il faut cliquer sur le bouton Préférences. vous accédez alors à l'écran ci-dessous :

A ce niveau, 2 paramétrages sont alors à réaliser :

Démarrage automatique 

Sur l'onglet Démarrer / Arrêter, cochez la case Lancer les serveurs au démarrage de MAMP. De cette manière, à chaque démarrage de votre Mac, MAMP sera automatiquement lancé et l'application QALITEL / Epistolaire disponible. Si vous n'activez pas cette case, alors vous devrez lancer manuellement MAMP (En cliquant sur l'icone MAMP) quand vous souhaiterez utiliser les applications QALITEL / Epistolaire.

Version de PHP 

MAMP est installé avec 2 versions de PHP. Il est préférable de fonctionner avec la version 5.3 (celle décrite dans ce tutorial). Aussi, assurez vous, en cliquant sur l'onglet PHP que la version 5.3.2 est bien sélectionnée. Si ce n'était pas le cas, cliquez sur la radio bouton puis validez votre saisie avec le bouton OK.

Pour accéder à la page d'accueil de MAMP, cliquez sur le bouton Ouvrir la page d'accueil. Nous allons à ce niveau créer la base de données ainsi que l'utilisateur MySQL qui sera ensuite utilisé dans le fichier de connexion de l'application QALITEL / Epistolaire. 

2.  Création de la base de données

Comme cela est mentionné précédemment, la page d'accueil de MAMP (accessible par la console MAMP ou par l'adresse http://localhost:8888) vous permet d'accéder à une console d'administration de MySQL (phpMyAdmin) via l'onglet phpMyAdmin de cette page.

Une fois dans l'interface de phpMyAdmin, vous disposez d'un champ de saisie Créer une base de données. Saisissez alors à ce niveau le nom de la base de données (en évitant tous les caractères spéciaux et accentués ainsi que les espaces). Validez ensuite en cliquant sur le bouton Créer.

3. Paramétrage d'un utilisateur de la base de données

Pour créer un nouvel utilisateur de votre base de données, cliquez sur le lien Privilèges présent dans le bandeau supérieur de la page d'accueil de phpMyAdmin. Cliquez ensuite sur le lien Ajouter un utilisateur. Entrez les différents paramètres comme montré si-dessous puis cliquez sur le lien Tout cocher pour activer tous les droits au nouvel utilisateur. 

4. Installation de l'application QALITEL / Epistolaire

L'installation de l'application QALITEL se fait en téléchargeant un fichier ZIP à partir de votre portail client. Le fichier ZIP contient 2 autres fichiers ZIP. L'un pour l'installation complète et l'autre pour la mise à jour.

Dans le cas d'une installation initiale, vous devez bien entendu choisir le ZIP complet.

Décompressez alors le fichier ZIP dans le répertoire des applications MAMP : \Applications\MAMP\htdocs\.

5. Configuration

Une fois les applications installées, il reste à effectuer quelques configurations.

Fichier de connexion des applications QALITEL 

Vous trouverez tous les détails sur cette page.

Extension Ioncubeloader 

Copiez le contenu du répertoire /Applications/MAMP/htdocs/xxxx/app/php_encode_linux/Linux_x86_32bits/ dans le répertoire /Applications/MAMP/htdocs/ioncube/

Extension ChartDirector 

Copiez le contenu du répertoire /Applications/MAMP/htdocs/xxxx/app/ChartDirector_linux/ChartDirector_Linux_32bits/lib/ dans le répertoire des extensions PHP à savoir : /Applications/MAMP/bin/PHP5.3/lib/php/extensions/no-debug-non-zts-20090626/

Configuration du fichier PHP.INI 

Vous trouverez ci-dessous les 2 lignes à insérer dans le fichier PHP.INI dans la rubrique Dynamic extensions. Le fichier PHP.INI est présent dans le répertoire /Applications/MAMP/CONF/PHP5.3/ 

6.  Premier lancement de l'application QALITEL /Epistolaire

Vous trouverez tous les détails sur cette page.

7. Sauvegarde de vos données

Vous trouverez tous les détails sur cette page.

Vous pouvez installer les outils d'administration de MySQL disponible gratuitement sur le site officiel de MySQL [1].

Téléchargez le fichier .DMG. A l'issue du téléchargement, la fenêtre suivante vous est proposée.  

Comme indiqué, copiez ensuite le répertoire MySQL Tools dans le répertoire des Applications.

Vous pourrez ensuite lancer l'application MySQL Administrator en cliquant sur le programme comme mentionné ci-dessous :

Cette application vous permettra entre autres choses de planifier des backups de votre base de données.