Application Web

L’installation de la partie Web se réfère à une installation classique d’un serveur Apache/Tomcat.

Versions recommandées :

  • OpenJDK version « 11.0.19 »
  • Apache Tomcat version 8.5.89
  • CAS (Central Authentication Service) version « 4 et plus » (si utilisé)

Récupération de l’application

Vous pouvez récupérer la dernière version de l’application via le lien : https://download-sig.univ-lorraine.fr/prive/calcium

Demande d’accès

Contactez nous sur calcium-contact@univ-lorraine.fr afin d’avoir un accès !

Redémarrage du serveur

Nous vous conseillons de programmer un redémarrage toutes les nuits du service Tomcat sur le serveur d’application.

Emplacement de l’application

L’application se dépose classiquement dans le répertoire webapps du serveur Tomcat.

Accès restreint

Il est important de signaler que cette version de Calcium est une application web, donc il faut restreindre les accès à Calcium par le biais des ACL ou de VPN.

Seuls les personnes habilitées à utiliser Calcium doivent pouvoir accéder à l’URL. Ensuite elles devront bien entendu encore s’authentifier.

Apache

Module Apache

Dans la configuration Apache, définir le module suivant :

module proxy ws-tunnel : LoadModule proxy_wstunnel_module

Le module proxy d’Apache va permettre de faire le lien entre apache et tomcat (https://httpd.apache.org/docs/2.4/fr/mod/mod_proxy_ajp.html)

VirualHost Apache

RewriteEngine on
RewriteCond %{HTTP:UPGRADE} ^websocket$ [NC,OR]
RewriteCond %{HTTP:CONNECTION} Upgrade$ [NC]
RewriteRule .* ws://xxxx.univ.fr:<PORT_HTTP>%{REQUEST_URI} [P,L]
   
# AJP vers Tomcat
ProxyPass / ajp://xxxx.univ.fr:<PORT_AJP>/
  
# Directives recommandees
ProxyPreserveHost on
ProxyRequests Off
ProxyVia Off

Les ports indiqués à titre d’exemple (<PORT_HTTP> et <PORT_AJP>) sont ceux utilisés et définis selon votre propre installation Tomcat (server.xml, voir ci-dessous).

Tomcat

Fichier server.xml

Connecteurs

  • Mise en commentaire de la ligne : <Listener className="org.apache.catalina.core.JasperListener"/> du fichier context.xml
  • Définition des connecteurs du server.xml
<Connector port="20010" protocol="HTTP/1.1" connectionTimeout="20000" />
<Connector port="20019" protocol="AJP/1.3" connectionTimeout="10000" keepAliveTimeout="10000" address="0.0.0.0" secretRequired="false" />

Host

  • Paramètre docBase est un chemin relatif
<Host name="localhost"  appBase="webapps" unpackWARs="true" autoDeploy="false" copyXML="false">
   <Context path="" docBase="/.../tomcat/webapps/Calcium-1.x.y">
         <Manager pathname=""/>
   </Context>
</Host>

Autres

  • Si cela est nécessaire (voir logs au lancement), supprimer le fichier tomcat-juli.jar dans le dossier tomcat/bin

Fichier de paramètres application.yml

Plus d’informations sur la page spécifique :

Paramétrage applicatif

Paramètres de lancement Java

Paramètres préconisés :

export JAVA_OPTS="-server -Xms10m -Xmx1024m -XX:-UseGCOverheadLimit -XX:+UseParallelGC
-XX:+HeapDumpOnOutOfMemoryError -Dnetworkaddress.cache.ttl=3600 -Djava.awt.headless=true"

Ajouter les options suivantes en cas de proxy avec vos valeurs : -Dhttp.proxyHost=dns_name_proxy -Dhttp.proxyPort=port_proxy

Options d’environnement Java

Vérifier que votre variable d’environnement concernant le langage soit fixée sur la langue française :

LANG=fr_FR.UTF-8