Cette documentation d'installation correspond à la version 4.0 et supérieure du projet Esup Sympa.

Pré-requis

Afin d'éviter des pbs d'encodage, assurez-vous d'avoir appliqué le patch issu de ce rapport de bug : [#7318] Encoding problem on symp soap

Configuration

Configuration basique

La configuration en utilisant le fichier config.properties seul permet de mettre en place la portlet Esup Sympa pour un serveur sympa (et un robot).

Les paramètres de configuration sont détaillés dans ce fichier.

Fichiers de configuration avancée

 Pour une configuration avancée et notamment pour pouvoir utiliser plusieurs robots/serveur sympa, vous pouvez modifier le fichier src/main/webapp/WEB-INF/context/applicationContext.xml

Dans la propriété serverList du bean domainService vous ajouterez par exemple une entrée de cette façon :

     <entry key="sympa2.monuniv.fr">
               <bean
                     scope="session">
                   <property name="adminUrl" value="https://sympa2.monuniv.fr/sympa/net/admin/%l"/>
                   <property name="connectUrl" value="https://cas.monuniv.fr/cas/login?service=%s%3Fchecked_cas=1"/>
                   <property name="name" value="monuniv.fr"/>
                   <property name="newListUrl" value="https://sympa2.monuniv.fr/sympa/net/create_list_request"/>
                   <property name="homeUrl" value="https://sympa2.monuniv.fr/sympa/net"/>
                   <property name="endPointUrl" value="https://sympa2.monuniv.fr/sympasoap"/>
                   <property name="timeout" value="5000"/>
                   <property name="credentialRetriever" ref="casCredentialRetrieverImpl"/>
                   <property name="indentityRetriever" ref="userIdentityRetrieverImpl"/>
                   <property name="cacheManager" ref="cacheManager"/>
                   <property name="newListForRoles">
                       <set>
                           <value>ADMINS</value>
                       </set>
                   </property>
               </bean>
           </entry>

Déploiement

A partir des sources : 

  1. mvn clean -Dmaven.test.skip=true package : création du war : target/esup-portlet-sympa.war (attention le web.xml issu de ce war ne contient pas encore la partie de conf correspondante eu déploiement esup/uportal/pluto)

  2. depuis les sources de uportal : ant deployPortletApp -DportletApp=/opt/canaux/esup-portlet-sympa/target/esup-portlet-sympa.war , ou depuis les sources de esup-uPortal : ant portlet.deploy -DportletApp=/opt/canaux/esup-portlet-sympa/target/esup-portlet-sympa.war

Utilisez alors l'interface graphique d'administration pour publier la portlet sympa.

uPortal's Portlet Overlays

Depuis la version 5.0 d'esup-portlet-sympa, vous pouvez aussi utiliser le mécanisme de portlet overlays d'uPortal - cf https://wiki.jasig.org/display/UPM42/Deploying+Portlets+to+uPortal

En effet, la portet esup-portlet-sympa est poussée sur le maven central désormais : https://repo1.maven.org/maven2/org/esupportail/sympa/esup-portlet-sympa/

Tests

Plusieurs tests peuvent être effectués pour s'assurer de la bonne disponibilité du web service soap de votre serveur de listes sympa :