proj-esup-grouper

Raccourcis espace

Arborescence des pages

Vous regardez une version antérieure (v. /wiki/pages/viewpage.action?pageId=125075458) de cette page.

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

Vous regardez la version actuelle de cette page. (v. 1) afficher la version suivante »

Note d'installation pour l'utilisation des groupes Grouper dans le portail esup 3.2.4 via le GroupStore du RECIA.

conventions :

<esupSrc> : le réperoire des sources d' eSup

<uportalSrc> : le répertoire du check out de uPortal

<customDir> : le répertoire des custom de eSup.

Etape 1 : Description

Pour faciliter l'intégration, les sources ont été packagées sous forme de jar via un projet maven et sont disponibles sur le repository du RECIA. Donc la récupération des jar sera automatique en suivant les étapes décrites après.

Les sources du projet peuvent être récupérées sur simple demande (actuellement disponible uniquement sur le svn du RECIA).

L'intégration choisie par le RECIA avec la version 2.6 du portail était l'utilisation d'un webservice qui interrogeait directement la base grouper via l'api grouper, ce web service avait été réalisé alors que le grouper-ws n'existait pas encore. Pour le passage à la version 3.2 du portail nous avons choisi d'intégrer directement les accès à l'API grouper dans le portail en ne passant plus par un système de webservices afin de gagner en performance. En fait les sources de l'ancien webservices sont intégrées directement dans le portail et il n'y a plus de déclaration webservices, de telle façon a ce que nous puissions faire marche arrière si les performances attendues ne sont pas au rendez-vous et si cela génère plus de problèmes que prévus finalement (problème de compatibilités de librairies lors des prochaines versions de grouper.

Actuellement l'intégration fonctionne très bien mais nous n'avons pas encore pus tester en charge ce que cela pouvait donner.

Pourquoi choisir ce groupStore plutôt que celui du JASIG :

- Intégration dynamique des groupes via un fichier de configuration qui lie un groupe uPortal et une branche définie d'un groupe Grouper, et on peut définir ainsi plusieurs mapping dans intervenir sur la base de données des groupes du Portail.

- Affichage et navigation dans l'arborescence des groupes grouper et listing de leurs membres possible via le groupManager, les groupes sont aussi visible dans le permissionManager et le channelManager.

Etape 2 : Intégration au portail Esup 3.2.4

Les dépendances pour l'api grouper et le groupStore RECIA (ESCO)

Pour la compilation

cp <esupSrc>/uPortal_rel-3.2.4/pom.xml <customDir>/uPortal/

Edition du fichier pom.xml pour ajouter les repository

vim <customDir>/uPortal/pom.xml

ajouter les lignes suivantes dans la liste des repositories défini, entre le repository jasig-3rd-party et sonatype-nexus-snapshots par exemple (ligne 66)

 <repository>
            <id>Recia</id>
            <name>esco repo</name>
            <url>http://www.esco-portail.org/nexus/content/repositories/public/</url>
            <releases><enabled>true</enabled></releases>
            <snapshots><enabled>false</enabled></snapshots>
        </repository>

cp <esupSrc>/uPortal_rel-3.2.4/uportal-impl/pom.xml <customDir>/uPortal/uportal-impl/

Edition du fichier pom.xml pour ajouter les dépendances 

vim <customDir>/uPortal/uportal-impl/pom.xml

ajouter les lignes suivantes dans la liste des dependencies, juste avant le commentaire <!-- esup dependencies -->

<!-- esco dependencies -->
    <dependency>
      <groupId>org.esco.grouper</groupId>
      <artifactId>esco-grouper-portal-groupManager</artifactId>
      <version>0.0.3-grouper-1.6.3</version>
      <exclusions>
        <exclusion>
           <groupId>org.springframework</groupId>
           <artifactId>spring</artifactId>
        </exclusion>
        <exclusion>
           <groupId>net.sf.ehcache</groupId>
           <artifactId>ehcache</artifactId>
        </exclusion>
      </exclusions>
    </dependency>
    <dependency>
        <groupId>edu.internet2.middleware.subject.provider</groupId>
        <artifactId>ldap-source-adapter</artifactId>
        <version>0.0.3-grouper-1.6.3</version>
        <exclusions>
        <exclusion>
           <groupId>org.springframework</groupId>
           <artifactId>spring</artifactId>
        </exclusion>
        <exclusion>
           <groupId>net.sf.ehcache</groupId>
           <artifactId>ehcache</artifactId>
        </exclusion>
      </exclusions>
    </dependency>

des exclusions sont a définir afin d'éviter les incompatibilités avec les librairies uPortal

La deuxième dépendance est facultative, nous l'utilisons afin d'éviter des connexion multiples au ldap, cela agit comme la définition d'un pool ldap. Il s'agit en fait de l'intégration de vtldap faite part l'université de washington disponible ici http://staff.washington.edu/fox/grouper/, pour des raisons de praticité ces sources ont été intégrées sous forme de module au projet maven du groupStrore RECIA.

  • Aucune étiquette