webMathematica requiert que Java, un conteneur de servlets et Mathematica soient installés sur le système. Certaines fonctionnalités de Mathematica, et donc de webMathematica, requièrent l’utilisation de l’interface utilisateur de Mathematica. L’interface, à son tour, requiert un système X Window sous Linux. Les étapes de l’installation de webMathematica sont les suivantes :

1. Configuration de Java
2. Configuration de Tomcat
3. Configuration de Mathematica
4. Rendre les fichiers de licence accessibles à webMathematica
5. Installation et configuration de webMathematica
6. Configuration de Xvnc pour les éditions minimales ou serveur de Linux

Configuration de Java

Java est requis non seulement pour webMathematica mais aussi pour tout conteneur de servlet Java. Vous pouvez accéder au Java d’Oracle à partir de http://www.oracle.com/us/downloads/index.html.

Dans plusieurs distributions Linux, les progiciels Java peuvent également être installés soit par la ligne de commande, soit par l’intermédiaire de leurs centres logiciels :

RedHat/CentOS/Fedora

sudo yum install java-1.8.0-openjdk
sudo yum install java-1.8.0-openjdk-devel 

Debian/Ubuntu

sudo apt install openjdk-8-jre
sudo apt install openjdk-8-jdk

Pour vérifier la réussite de l’installation, dans la ligne de commande, exécutez :

java -version

Configuration de Tomcat

Installation

webMathematica est conçu pour fonctionner à partir d’un conteneur Java Servlet. Parmi les différents conteneurs Servlet disponibles, nous ne fournissons que des indications limitées avec Apache Tomcat.

1. Allez sur http://tomcat.apache.org/download-80.cgi.
2. Téléchargez le programme d’installation au format tar.gz.
3. Changez l’emplacement où vous souhaitez installer le serveur. Par exemple, si vous voulez l’installer à /usr/local, exécutez :

   cd /usr/local

4. Décompressez le programme d’installation à l’emplacement actuel :

   tar -xvzf apache-tomcat-<version>.tar.gz

Tester Tomcat

1. Pour démarrer le serveur Tomcat, dans le répertoire d’installation de Tomcat, exécutez :

   ./bin/startup.sh

2. Ouvrez un navigateur web et entrez “localhost:8080”. Si Tomcat a été correctement configuré, une page similaire à la suivante apparaît :
   
3. Pour arrêter le serveur Tomcat pour l’instant, dans le même répertoire, exécutez :

   ./bin/shutdown.sh

Problèmes courants éventuels :

• Le pare-feu de l’ordinateur bloque les demandes adressées à Tomcat. Par défaut, Tomcat fonctionne sur le port 8080. Assurez-vous que le port est ouvert pour accepter les paquets tcp sur le système qui exécute le serveur Tomcat.
• Si vous avez téléchargé Java depuis le site web d’Oracle, le serveur Tomcat peut ne pas être en mesure de trouver l’installation de Java. Dans ce cas, définissez la variable système JAVA_HOME dans le répertoire d’installation de Java, par exemple en exécutant ce qui suit sur une ligne de commande bash ou en ajoutant ces lignes à .bashrc, si votre Java a été installé dans /usr/local/jdk1.8.0.

  JAVA_HOME=/usr/local/jdk1.8.0
  export JAVA_HOME

Création d’un compte Tomcat (recommandé)

Il est recommandé de créer un compte utilisateur dédié pour faire fonctionner le serveur Tomcat, généralement appelé “tomcat”. Ce compte a besoin des autorisations nécessaires pour faire fonctionner le serveur Tomcat.

1. Pour créer le compte, exécutez dans le terminal :

   sudo useradd tomcat
   sudo passwd tomcat

2. Changez la propriété et le groupe du répertoire d’installation de Tomcat pour l’utilisateur “tomcat” en exécutant ces commandes à partir du répertoire parent de l’endroit où vous avez installé le serveur apache-tomcat :

   sudo chown -R tomcat apache-tomcat-<version>
   sudo chgrp -R tomcat apache-tomcat-<version>

3. Avec le nouveau compte, démarrez le serveur :

   su tomcat
   cd apache-tomcat-<version>/bin
   ./startup.sh

4. Ouvrez un navigateur web et entrez “localhost:8080”. Si l’utilisateur a été correctement configuré, cette page d’accueil Tomcat apparaît à nouveau :
   

Configuration de Mathematica

Pour configurer Mathematica, il faut installer le programme, l’activer avec votre clé d’activation et déplacer les informations de licence générées dans un endroit qui les rend accessibles globalement sur la machine en question.

Installation

Suivez les instructions pour installer Mathematica sous Linux.

Assurez-vous d’utiliser le nom de fichier approprié :

sudo sh Mathematica_12.x_LINUX.sh

Prenez note du répertoire d’installation que vous choisissez si vous n’utilisez pas le répertoire par défaut.

Activation

Activez Mathematica en utilisant l’activation en ligne ou manuelle.

Sur les systèmes Linux sans X Window installé, l’interface utilisateur de Mathematica ne sera pas disponible. Activez plutôt Mathematica par le biais du noyau.

1. Exécutez la commande suivante :

   math

2. Entrez votre clé d’activation. Veuillez noter que la clé d’activation a la forme XXXX-XXXX-XXXXXX.

Rendre les fichiers de licence accessibles à webMathematica

Par défaut, Mathematica place ses informations de licence dans un fichier mathpass à un emplacement spécifique à l’utilisateur. Pour rendre vos informations de licence accessibles à votre webMathematica, copiez le fichier mathpass dans le répertoire de base de Mathematica, accessible globalement, et définissez son autorisation afin que n’importe quel compte puisse lire le fichier.

1. Pour identifier l’emplacement de votre fichier mathpass, évaluez dans Mathematica :

   $PasswordFile

2. Pour identifier l’emplacement du répertoire de base, évaluez :

   $BaseDirectory

Par exemple :

In[1]:= $PasswordFile                                                          

Out[1]= /home/user/.Mathematica/Licensing/mathpass

In[2]:= $BaseDirectory                                                          

Out[2]= /usr/share/Mathematica

Ces emplacements de répertoires sont utilisés dans les instructions suivantes.

1. Le répertoire de licence peut ne pas encore exister. Si c’est le cas, créez-le en exécutant la commande suivante :

   sudo mkdir -p /usr/share/Mathematica/Licensing

2. Copiez le fichier mathpass dans le répertoire Licensing du répertoire de base :

   sudo cp /home/user/.Mathematica/Licensing/mathpass /usr/share/Mathematica/Licensing/. 

3. Autorisez l’accès en lecture au fichier mathpass pour tous les comptes :

   sudo chmod a+r /usr/share/Mathematica/Licensing/mathpass

Installation et configuration de webMathematica

Installation

1. Téléchargez le fichier d’installation de webMathematica depuis votre portail utilisateur et décompressez-le pour vous assurer qu’il est ouvert et décompressé.
2. Placez le répertoire webMathematica décompressé dans le répertoire webapps de votre serveur Tomcat Apache, où $TOMCAT_INSTALL est le répertoire d’installation de votre serveur Tomcat :

   sudo mv webMathematica $TOMCAT_INSTALL/webapps/

3. Si vous avez créé un utilisateur Tomcat pour exécuter le serveur, changez également la propriété du dossier webMathematica :

   sudo chown -R tomcat $TOMCAT_INSTALL/webapps/webMathematica
   sudo chgrp -R tomcat $TOMCAT_INSTALL/webapps/webMathematica

4. Redémarrez le serveur à partir du compte qui possède le dossier :

   su tomcat
   cd $TOMCAT_INSTALL/bin
   ./shutdown.sh
   ./startup.sh

Tests et dépannage

Le progiciel webMathematica est fourni avec des pages par défaut qui peuvent être utilisées pour tester la configuration de webMathematica.

1. Accédez à la page de base en faisant pointer un navigateur vers “localhost:8080/webMathematica”.

   

2. Comme premier test, cliquez sur l’exemple Hello World. La page Hello World fournissant l’heure et la date actuelles apparaît.

   

3. Si Hello World ne fonctionne pas, vérifiez le fichier log en exécutant :

   less $TOMCAT_INSTALL/logs/webMathematica.log

Problème courant éventuel :

Dans le fichier log ci-dessus, recherchez l’erreur ....com.wolfram.kerneltools.state.StateMachine [ERROR] Could not find MathLink executable. Dans un tel cas, webMathematica n’a pas pu trouver le fichier exécutable du noyau de Mathematica. Cela peut se produire si vous avez installé Mathematica dans un emplacement non standard ou si votre webMathematica n’est pas couplé avec sa version recommandée de Mathematica, par exemple webMathematica 3.5.2 avec Mathematica 12.2. Pour les couplages recommandés avec d’autres versions de produits actuellement prises en charge, voir ici.

Pour pointer vers la version correctement couplée de Mathematica, configurez webMathematica.

1. Sur la ligne de commande, allez à $TOMCAT_INSTALL/webapps/webMathematica/WEB-INF/ et localisez le fichier MSPConfiguration.xml.
2. Ouvrez le fichier MSPConfiguration.xml dans un éditeur de texte et localisez la section suivante :

   <KernelPool>
         <KernelPoolName>General</KernelPoolName>
         <URLPattern>/*</URLPattern>
   </KernelPool>

3. Modifiez et changez cette section comme suit :

   <KernelPool>
         <KernelPoolName>General</KernelPoolName>
         <KernelExecutable>
         /usr/local/Wolfram/Mathematica/12.x/Executables/MathKernel
         </KernelExecutable>
         <URLPattern>/*</URLPattern>
   </KernelPool>

Remarque : Ces instructions supposent que Mathematica 12.x a été installé dans /usr/local/Mathematica/12.x/. Si vous avez un autre répertoire d’installation, remplacez le répertoire d’installation que vous avez utilisé.

Configuration de Xvnc pour les éditions minimales ou serveur de Linux

De nombreuses distributions “Server” ou “Minimal” de Linux n’incluent pas de serveur X Window par défaut. Certaines fonctionnalités de Mathematica, et donc de webMathematica, requièrent un serveur X Window pour être disponibles. Par exemple, l’exemple Plot ne peut pas s’exécuter correctement sans un système X Window quelconque. Pour ces raisons, il est recommandé d’utiliser un serveur Xvnc.

1. Installez un serveur Xvnc, pouvant généralement être obtenu par des applications d’installation en ligne de commande comme yum ou apt.
2. Lancez un affichage vnc avec la commande “vncserver”. Pour cela, vous devez d’abord fournir un numéro d’affichage (généralement 1).
3. Configurez webMathematica pour utiliser l’affichage en éditant le fichier $TOMCAT_INSTALL/webapps/webMathematica/WEB-INF/MSPConfiguration.xml pour y inclure le code suivant :

   <KernelPool>
   ....
   <FrontEndLaunchFlags>
   -display :1 -nogui 1000x500+10+10
   </FrontEndLaunchFlags>
   ....
   </KernelPool>

[English]