====== MacOS X (via Homebrew)======

Merci de [[mailto:bado@unice.fr?subject=[WIKI WIMS EDU] installation de WIMS sur Mac|m'envoyer vos retours]] suite à votre propre installation afin de pouvoir mettre à jour cette documentation.

===== 1. Pré-requis et logiciels tiers : =====

==== Command line tools (Xcode) ====

  * Installez les "command line tools" sur la machine.
  * Pour cela, tapez ceci dans le terminal : <code bash>xcode-select --install</code>
nb. : si jamais cette commande ne fonctionnait pas, vous avez la possibilité de le télécharger sur le site Apple ici : https://developer.apple.com/download/more/?name=command%20line%20tools


==== Logiciels tiers ====

Nous utiliserons le système "[[http://brew.sh/index_fr.html| Homebrew]]" pour télécharger et installer les paquets tiers.

Commencez donc par installer Homebrew (si ce n'est déjà fait) : 
<code bash>ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"</code>

Si brew est déjà installé, mettez-le à jour ainsi : 
<code bash>brew update
brew upgrade</code>


Puis installez les paquets tiers :

<code bash>brew install gd latex2html gnuplot octave maxima pari yacas wget imagemagick graphviz fortune qrencode open-babel coreutils gnu-sed gmp gap-system/gap/gap awk</code>


  * Importance relative des logiciels tiers :
    * Pari/GP    (100% importance)
    * Maxima     (100% importance)
    * GNU Octave (20%  importance)
    * Yacas      (10%  importance)
    * GAP        (10%  importance) 
    * Povray     ( 5%  importance)
    * Graphviz   ( 5%  importance)
    * Macaulay   (~0%  importance)
    * fortune and strfile
    * gmp pour units-filter
    * coreutils (gnu utilities : tac, date -d, stat -c, du --exclude). Ils sont installés par brew avec le nom gtac, gdate, gstat, gdu
Les coreutils (+gnu sed) nécessitent des liens symboliques pour être reconnus :
<code bash>ln -s /usr/local/bin/gtac /usr/local/bin/tac
ln -s /usr/local/bin/gdate /usr/local/bin/date
ln -s /usr/local/bin/gstat /usr/local/bin/stat
ln -s /usr/local/bin/gdu /usr/local/bin/du
ln -s /usr/local/bin/gsed /usr/local/bin/sed</code>

=== Modules Perl ===
Installez ensuite quelques modules Perl nécessaires : 
<code bash>sudo cpan install URI::URL</code> (URI::URL est par exemple utilisé par le script adm/urldecode)
<code bash>sudo cpan install WebService::Validator::HTML::W3C</code>


=== Autres logiciels ===
Installez certains logiciels tiers non installables via brew //(peut être fait plus tard)//
    * Macaulay 2 : http://faculty.math.illinois.edu/Macaulay2/Downloads/MacOSX/index.html
    * povray : pour le moment il semble qu'un bug empêche povray de s'installer via brew : https://github.com/Homebrew/homebrew/issues/45317 (semble bon maintenant)
    * W3C Validator : http://validator.w3.org/docs/install.html#install-prereq-sp
    * MacTex peut être une bonne alternative à l'installation de texlive par Homebrew


Un variante (et une simplification) consiste à utiliser les paquets Homebrew disponibles : 

    * <code bash>brew install Macaulay2/tap/M2</code> 

Suite à une incompatibilité avec la colorisation de gap, ajouter un fichier gap.ini contenant : SetUserPreference( "UseColorPrompt", false );// à placer dans /usr/local/Cellar/gap/4.12.2/libexec //



=====2. Installation de WIMS : =====
Créez un répertoire/utilisateur **wims**.
Attention : ce répertoire doit être accessible à APACHE. Nous préconisons les droits suivants :  drwxr-xr-x , que vous pouvez obtenir facilement avec cette instruction :
<code bash>mkdir wims;chmod 755 wims;cd wims</code>

Téléchargez-y la dernière version de wims sur le site de sourcesup, 
 https://sourcesup.renater.fr/frs/?group_id=379
par exemple dans le répertoire wims (remplacez le lien ci-dessous par celui de la dernière version sur sourcesup)
<code bash>wget https://sourcesup.renater.fr/frs/download.php/latestfile/531/wims-4.XX.tgz</code>
Décompactez-le
<code bash>tar xzf wims-4.XX.tgz</code>
 
Lancez la compilation :
  * Lors d'une première installation (assez long) : <code bash>./compile --mathjax --jmol --modules --geogebra --shtooka</code>
  * Lors des mises à jour : <code bash>./compile --mathjax --jmol --geogebra</code>

NB : l'option ''--mathjax'' permet d'installer la librairie "MathJax", offrant un bonne compatibilité avec Chrome.
L'option ''--jmol'' permet l'installation de la librairie javascript Jsmol,
l'option ''--modules'' installe tous les modules pédagogiques, ne le faire qu'à la première installation (la mise à jour est ensuite automatique),
l'option ''--geogebra'' installe les libraires javascript utiles pour utiliser Geogebra.


====Configuration WIMS d'Apache :====
<code bash>sudo bin/apache-config</code>
  
Pour que WIMS fonctionne, vous devez vous assurer que votre serveur apache permet l'exécution de scripts CGI. Pour cela, commencez par repérer le fichier de configuration d'Apache, avec cette commande :
<code bash>httpd -V</code>
Parmi toutes les informations qui apparaissent, repérez la ligne contenant ceci :
<code apache>SERVER_CONFIG_FILE=...</code>
Elle vous indique où se trouve votre fichier de configuration d'Apache. Par défaut, ce devrait être ''/private/etc/apache2/httpd.conf''
Éditez alors ce fichier, pour y rechercher la ligne suivante :
<code apache>LoadModule cgi_module libexec/apache2/mod_cgi.so</code>
Elle ne doit surtout pas être désactivée. Si elle commence par un dièse (#), retirez-le et enregistrez, tout simplement.

Redémarrez votre serveur Apache : 
<code bash>sudo apachectl restart</code>

Vérifiez les permissions des fichiers (normalement ceci est fait automatiquement à la fin de l'installation)
<code bash>sudo bin/setwimsd</code>

Pour une installation individuelle, vous pouvez avoir besoin de rajouter votre nom (my_name) au groupe _www, quelque chose comme:
  sudo dseditgroup -o edit -a _www -t my_name staff
Si Povray a été installé, rajoutez une ligne de permission dans le fichier povray.conf
(il est dans ''/opt/local/etc/povray/3.6/povray.conf'')
<code autoconf>read+write* = $WIMS/tmp/sessions</code>

en remplaçant $WIMS par l'adresse du répertoire wims.
===== 3. Première configuration de WIMS =====
Suivez la page suivante pour configurer votre installation : [[installation:first_config| Configuration de WIMS]]

Vous aurez quelques éléments spécifique à une installation MacOS à fournir : 

==== Technical topics / Questions techniques : ====
Sur Mac, il vous faudra sûrement ajouter des chemins dans la ligne PATH afin que WIMS trouve les logiciels tiers installés via Homebrew.
le champ complet PATH sur Mac est le suivant (vous pouvez remplacer l'existant par celui-ci) 
  /usr/local/bin:/usr/bin:/bin:/usr/X11/bin/:/Library/TeX/texbin:/usr/local/Cellar/gap/4.12.2/bin/

Si vous n'avez pas installé gap & Macaulay via Homebrew, il est nécessaire d'indiquer le path correspondant. Par exemple :
  /usr/local/bin:/usr/bin:/bin:/usr/X11/bin/:/Library/TeX/texbin:/Applications/Macaulay2-1.21/bin:/Applications/gap/bin


===== 4. Versions Validées ====

wims 4.24 - Ventura 13,4.1 (25/07/2023)