Librairies partagées

Uportal utilise le répertoire "CATALINA_BASE/shared/lib" pour ses librairies. Par défaut, Tomcat 6.0 n'autorise pas le chargement des libs depuis ce répertoire. Il faut donc modifier le fichier "CATALINA_BASE/conf/catalina.properties" et modifier la valeur de la clé "shared.loader" de la façon suivante :

shared.loader=${catalina.base}/shared/classes,${catalina.base}/shared/lib/*.jar

Sessions partagées

Les portlets, de manière générale, reposent sur le partage de données entre le portail et elles-mêmes. Tomcat ne le permet par par défaut. Il faut donc ajouter "emptySessionPath="true"" dans le fichier "CATALINA_BASE/conf/server.xml" :

<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" emptySessionPath="true"/>

Augmentation de la mémoire

Les allocations mémoire sont paramétrées dans les scripts d'environnement (env.cmd et env.sh)

Les paramètres de mémoire présents dans les fichiers ne sont pas des paramètres de production : il convient de les adapter en fonction des besoins !

 Il existe une différence entre JAVA_OPTS et CATALINA_OPTS :

  • Le premier concerne les paramètres pour le serveur et tout ce qui gravite autour (processus d'arrêt, ...) ;
  • e second concerne les paramètres pour le serveur uniquement (tels que la taille du tas, le logger du garbage collector, les ports JMX, ...).

Il est possible de définir directement dans le fichier server.xml la description des contextes de chacune des applications déployées. Cela permet de ne pas perdre les configurations entre les différents redéploiement (supprimant les fichiers de description des contextes).

Scripts de lancement

Les scripts suivants permettent d'exécuter Tomcat avec l'ensemble des applications uPortal, CAS et portlets. Ils sont disponibles en PJ :

Si les bonnes pratiques sont respectées, il faudra modifier l'alimentation de la variable CATALINA_BASE

En cas d'utilisation de PORTAL_LOG et PORTAL_LOG_DIR (pour renseigner automatiquement la variable environment.build.log.logfileDirectory du fichier esup.properties), il sera nécessaire de passer par le script ant.sh pour exécuter les tâches ANT. Il est conseillé dans ce cas de ne pas ajouter ANT_HOME dans l'environnement de la machine afin de ne pas pouvoir utiliser ANT sans passer par le script ant.sh.

 

 

https://wiki.jasig.org/pages/viewpage.action?pageId=42696767
https://subversion.cru.fr/esup/tags/esup-uPortal-3.2.4-esup-1.0.0-RC3/resources/scripts/
http://svn.apache.org/repos/asf/tomcat/trunk/bin/catalina.sh