InstallationL'installation de la partie Web se réfère à une installation classique d'un serveur Apache/Tomcat. Versions utilisées : - Apache 2.4 (avec https)
- Tomcat 7.0.85
| Astuce |
|---|
| title | Redémarrage du serveur |
|---|
| Nous vous conseillons de programmer un redémarrage toutes les nuits du service Tomcat sur le serveur d'application. |
| Astuce |
|---|
| title | Récupération de l'application |
|---|
| Vous pouvez récupérer la dernière version de l'application via le lien : http://download-sig.univ-lorraine.fr/prive/calcium
| Avertissement |
|---|
| Dans le cadre d'une migration prendre la version 1.0.9 sur le serveur dans un premier temps avant de passer aux autres versions qui peuvent nécessité le passage de scripts SQL ! |
|
| Astuce |
|---|
| title | Emplacement de l'application |
|---|
| | L'application se dépose classiquement dans le répertoire webapps du serveur tomcat. |
Configuration spécifiqueApache| Astuce |
|---|
| Dans la configuration Apache, définir le module suivant : | Bloc de code |
|---|
| module proxy ws-tunnel : LoadModule proxy_wstunnel_module |
|
| Astuce |
|---|
| Voic la partie conf apache dans le virtualhost : Exemple avec un frontal apache et un env tomcat sur un backend qui ecoute sur un port HTTP pour la partie websocket/push et en AJP pour le reste( ici port http : 20010 et port ajp : 20019 ) Le VH apache est hébergé sur un serveur dédié alors que le tomcat peut être hébergé sur un serveur d'application. Le backend est le serveur qui héberge l'appli J2EE. En fait le <backend>.univ.fr et le <nom>.univ.fr peuvent être les mêmes suivant votre configuration. | Bloc de code |
|---|
| #################
# La partie web PUSH socket
#################
RewriteEngine on
RewriteCond %{QUERY_STRING} ^((?!X-Atmosphere-Transport=websocket).)*$
RewriteRule ^/PUSH(.*)$ http://<backend>.univ.fr:20010/PUSH$1 [P]
# PUSH
ProxyPass /PUSH ws://<nom>.univ.fr:20010/PUSH
ProxyPassReverse /PUSH ws://<nom>.univ.fr:20010/PUSH
######################################
#Find du traitement PUSH Websocket
######################################
#############################
# Redirection de tout le reste
##############################
# AJP vers Tomcat
ProxyPass / ajp://<backend>.univ.fr:20019/
|
|
TomcatFichier server.xml| Astuce |
|---|
| Définition des connecteurs du server.xml | Bloc de code |
|---|
<Connector port="20010" protocol="HTTP/1.1" connectionTimeout="20000" />
<Connector port="20019" protocol="AJP/1.3" connectionTimeout="10000" keepAliveTimeout="10000" /> |
Définition du host | Bloc de code |
|---|
| <Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="false" copyXML="false">
<Context path="" docBase="/.../tomcat/webapps/Calcium-Next-1.x.y">
<Manager pathname=""/>
</Context>
</Host> |
|
Fichier app.properties (mise en place de la clé de cryptage)Dans le répertoire : /tomcat/webapps/Calcium-Next-x.y.z/WEB-INF/classes, modifier le fichier app.properties tel que : | Bloc de code |
|---|
| encryption.key = CleDeCryptage123 |
| Avertissement |
|---|
| Cette clé a été définie au moment de la migration. Elle doit être basée sur 16 caractères alpha numériques sans caractères spéciaux (accent, etc...)ATTENTION à ne pas mettre d'espace blanc à la fin de la clé |
Paramètres de lancement JAVA| Astuce |
|---|
| title | Paramètres de lancement |
|---|
| Paramètres de lancement JAVA préconisés | Bloc de code |
|---|
| export JAVA_OPTS="-server -Xms10m -Xmx1024m -XX:-UseGCOverheadLimit -XX:+UseParallelGC
-XX:+HeapDumpOnOutOfMemoryError -Dnetworkaddress.cache.ttl=3600 -Djava.awt.headless=true" |
|
Options d'environnement JAVAVérifier que votre variable d'environnement concernant le langage soit fixée sur la langue française : | Bloc de code |
|---|
| LANG="fr_FR@euro"
ou
LANG=fr_FR.UTF-8 |
Ficher context.xml |