SVN/Maven depuis une machine non routable

Si vous souhaitez télécharger/déployer la portlet depuis une machine non routable, vous allez être confronté à des difficultés :

• La commande svn checkout ne prend pas en compte les variables d'environnement UNIX/Linux pour la définition d'un serveur proxy HTTP
• Maven ne prend pas en compte les variables d'environnement UNIX/Linux pour la définition d'un serveur proxy HTTP

Pour indiquer au binaire svn d'utiliser un proxy HTTP pour la récupération des sources, vous devez éditer le fichier ~/.subversion/servers et renseigner les propriétés suivantes (à la fin du fichier) :

[global]
http-proxy-exceptions = *.univ.fr
http-proxy-host = cache.univ.fr
http-proxy-port = 3128

Si votre serveur proxy nécessite une authentification, vous devez également renseigner les deux propriétés suivantes :

http-proxy-username = user
http-proxy-password = password

Pour indiquer à Maven d'utiliser un proxy HTTP, vous devez éditer le fichier ~/.m2/settings.xml :

<settings>
  <proxies>
    <proxy>
      <active>true</active>
      <protocol>http</protocol>
      <host>cache.univ.fr</host>
      <port>3128</port>
      <nonProxyHosts>*.univ.fr</nonProxyHosts>
    </proxy>
  </proxies>
</settings>

Important : certaines dépendances Maven sont hébergées sur des sites en HTTPs (c'est le cas du repository Maven ESUP). Malheureusement, Maven considère qu'HTTPs est un protocole différent d'HTTP et ne lui applique pas les paramètres de proxy. De plus il n'est pas possible de spécifier à la fois un proxy HTTP et un proxy HTTPs (bug en cours de résolution dans Maven 2.2.x). Il est donc nécessaire de :

• Lancer la commande mvn package jusqu'à l'obtention d'une erreur lors de la récupération de certaines dépendances
• Modifier le fichier ~/.m2/settings.xml pour remplacer http par https
• Relancer la commande mvn package
• Recommencer depuis le début en inversant http et https

Une fois les dépendances présentes dans le cache local de Maven, cette gymnastique n'aura plus lieu d'être.

Simplification du déploiement dans un environnement cluster

TODO

Multi-domaine Zimbra

Il est possible d'utiliser la portlet dans un environnement comprenant plusieurs domaines Zimbra :

• Une seule installation Zimbra, plusieurs domaines de messagerie, URL différentes selon le domaine
• Plusieurs installations Zimbra

Dans ce cas, il suffit de publier plusieurs fois la portlet avec des paramètres de publication différents.
Voici un exemple de fichier de publication :

<channel-definition script="classpath://org/jasig/portal/io/import-channel_v2-6.crn"><title>Zimbra</title>
<name>Zimbra</name>
<fname>portlet-zimbra</fname>
<desc>Zimbra</desc>
<type>Portlet</type>
<class>org.jasig.portal.channels.portlet.CSpringPortletAdaptor</class>
<timeout>30000</timeout>
<hasedit>N</hasedit>
<hashelp>N</hashelp>
<hasabout>N</hasabout>
<secure>N</secure>
<locale>en_US</locale>
<categories>
  <category>CATEGORIE</category>
</categories>
<groups>
  <group>GROUPE</group>
</groups>
<parameters>
  <parameter>
    <name>portletApplicationId</name>
    <value>deploy.uri</value>
    <description/>
    <ovrd>N</ovrd>
  </parameter>
  <parameter>
    <name>portletName</name>
    <value>zimbra</value>
    <description/>
    <ovrd>N</ovrd>
  </parameter>
</parameters>
<portletPreferences>
  <portletPreference>
    <name>zimbra.token.service.url</name>
    <values>
      <value>http://zcs-auth.univ.fr/getToken</value>
    </values>
  </portletPreference>
  <portletPreference>
    <name>zimbra.soap.service.url</name>
    <values>
      <value>https://zimbra.univ.fr/service/soap</value>
    </values>
  </portletPreference>
  <portletPreference>
    <name>zimbra.url</name>
    <values>
      <value>http://zimbra.univ.fr/getToken</value>
    </values>
  </portletPreference></portletPreferences>
</channel-definition>

Ce fichier de publication contient des paramètres à modifier :

• fname : chaque publication de la portlet doit avoir un fname unique
• groups : chaque publication de la portlet doit s'adresser à des groupes/utilisateurs différents (ceux qui ne partagent pas le même domaine Zimbra)
• portletPreferences :
  • zimbra.token.service.url : le serveur d'authentification peut être différent pour deux installations Zimbra distinctes, cependant il doit utiliser le même serveur CAS que le portail
  • zimbra.soap.service.url : le serveur SOAP peut être différent pour deux installations Zimbra distinctes
  • zimbra.url : l'URL du webmail Zimbra peut être différente pour deux installations Zimbra distinctes, ou pour une même installation accessible dans plusieurs domaines distincts

Important : si vous omettez ces paramètres lors de la publication de la portlet, alors les URL utilisées seront celles définies dans le fichier profiles.xml.