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)
Mémoire allouée en production
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 !
JAVA_OPTS ou CATALINA_OPTS ?
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, ...).
Contexte des applications (Production)
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 :
Bonnes pratiques
Si les bonnes pratiques sont respectées, il faudra modifier l'alimentation de la variable CATALINA_BASE
Utilisation de PORTAL_LOG
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.