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

Pré-requis

• Sympa 6.0 et ultérieur avec sympasoap d'activé

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 :

• en premier lieu, vous pouvez vous assurer de bien récupérer le wsdl ; par défaut l'url d'accès a la forme suivante :http://sympa.monuniv/sympa/wsdl
• ensuite, vous pouvez tester le service en utilisant le script python que l'on donne ici (par ex) : src/etc/test_ws_univ_rouen.py
  il est à éditer pour y modifier le username/password à utiliser (en plus de l'url du wsdl de votre sympa), ainsi vous testerez le web service soap de sympa directement (sans utiliser les mécanismes de cas et proxy cas), en toute indépendance également de l'ensemble du code de la portlet esup-portlet-sympa
• enfin vous pouvez même tester le code de la portlet en lui-même, cf fin du fichier de configurations config.properties, vous ne testerez pas là encore cependant les mécanismes d'authentification cas au travers de celui-ci ; pour cela après avoir modifier les paramètres adéquates dans config.properties, vous pouvez lancer un
  mvn test