Projets
Pages enfant
  • 1- Installation
  • Créé par utilisateur-6c803, dernière modification le déc. 10, 2010

Vous regardez une version antérieure (v. /wiki/display/PROJ/1-+Installation) de cette page.

afficher les différences afficher l'historique de la page

« Afficher la version précédente Vous regardez la version actuelle de cette page. (v. 6) afficher la version suivante »

Pré-requis

Pour son fonctionnement, la portlet Zimbra nécessite d'avoir au préalable :

  • Une installation des binaires Maven en version 2.2.x
  • Un portail fonctionnel en version 3.0.x, 3.1.x ou 3.2.x
  • Une installation Zimbra en version 6.0.x
  • Une installation du connecteur d'authentification CAS/Zimbra

Téléchargement des sources

Il est possible de récupérer les sources de deux façons distinctes :

Téléchargement direct

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

Une fois l'archive récupérée, il faut la décompacter sur la machine où l'on souhaite installer la portlet :

 tar zxvf nancy2-portlet-zimbra-3.0.1-src.tar.gz

Client Subversion

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

Configuration

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 :

cp profiles-sample.xml profiles.xml

Voici les propriétés devant être renseignées dans ce fichier :

  • 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, ou encore http://cas.univ.fr/cas.
  • 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.

Déploiement

TODO

  • Aucune étiquette