...

Chaque version est disponible soit en .zip (pour les machines Windows) ou en .tar.gz (pour les machines Linux/UNIX).

...

Le dépôt Subversion est ouvert en anonyme, il est recommandé de récupérer une version présente dans la branche 'tags' :

 svn co https://subversion.cru.fr/portlet-zimbra/tags/3.0.1 portlet-zimbra-3.0.1

...

La configuration de la portlet doit être réalisée dans un fichier profiles.xml présent à la racine des sources. Un fichier d'exemple profiles-sample.xml est fourni pouvant servir de base à toute nouvelle installation :

...

• deploy.dir : répertoire où sera déployée la portlet. Il s'agit d'un dossier qui se trouvera certainement à côté de celui de l'ENT, dans le répertoire webapps. Il est recommandé de conserver à la fin de ce dossier le numéro de version de la portlet et d'utiliser ensuite un lien symbolique pour préciser la version active, afin de faciliter les futures mises à jour.
• portlet.title/portlet.title.short : c'est le nom qui apparaîtra dans le portail aux utilisateurs une fois la portlet déployée et publiée.
• public.host : cette propriété doit être renseignée à la même valeur que celle du portail. En effet la portlet étant proxy CAS, cette information est nécessaire au calcul de l'URL de service.
• real.host : cette propriété doit être renseignée à la même valeur que celle du portail. En effet la portlet étant proxy CAS, cette information est nécessaire au calcul de l'URL de dépôt du PGT. Si vous travaillez dans un environnement mono-portail, elle doit avoir la même valeur que la propriété précédente. Si vous travaillez dans un environnement multi-serveur avec répartition de charge, elle doit être spécifique à l'instance de chaque serveur du cluster.
• deploy.uri : il est conseillé de laisser cette propriété à sa valeur par défaut. Voir la définition du contexte Tomcat.
• cas.server : il s'agit de l'URL du serveur CAS, par exemple http://cas.univ.fr^{Image Removed}, ou encore http://cas.univ.fr/cas^{Image Removed}.
• cas.callback.uri : cette propriété ne devrait pas être modifiée, la valeur par défaut convient à toutes les installations.
• zimbra.token.service.url : cette propriété doit contenir l'URL du connecteur d'authentification CAS/Zimbra.
• zimbra.soap.service.url : cette propriété doit contenir l'URL du service SOAP Zimbra, habituellement accédé en HTTPs à l'URI /service/soap de votre serveur Zimbra.
• zimbra.url : cette propriété doit contenir l'URL de votre serveur Zimbra, accédée par vos utilisateurs pour consulter leur messagerie. Elle est utilisée pour proposer des liens directs vers Zimbra depuis la portlet.
• log4j.level.main : cette propriété doit contenir la valeur error pour une installation de production.
• log4j.level.spring : cette propriété doit contenir la valeur warning pour une installation de production.
• log4j.level.main : cette propriété doit contenir la valeur error pour une installation de production.

Les logs de l'application (ne contenant aucune information importante, si ce n'est les exceptions pouvant se produire) peuvent être configurés de trois façons différentes, simplement en commentant/décommentant les sections correspondantes du fichiers profiles.xml.

Logs console

Dans ce mode, les logs sont écris directement sur la sortie standard et aboutissent généralement dans le fichier catalina.out de Tomcat.
Aucune configuration n'est nécessaire avec ce mode.

Logs syslog

Propriétés à renseigner :

• log4j.syslog.host : cette propriété doit contenir le nom du serveur syslog.
• log4j.syslog.facility : cette propriété doit contenir la facility syslog à utiliser.

Logs fichier

Propriétés à renseigner :

• log4j.file.file : cette propriété doit contenir le chemin du fichier de log.
• log4j.file.nb : cette propriété doit contenir le nombre de fichiers d'archives qui seront conservés
• log4j.file.size : cette propriété doit contenir la taille maximale d'un fichier de log, provoquant sa rotation vers un fichier d'archive.

Déploiement

TODO