Pré-requis

Pour pouvoir installer le canal, il nécessaire d'avoir au préalable récupéré et installé les éléments suivants :

• le canal Annuaire en version 3.0 minimum
• le framework MAG en version 2.3 minimum
• disposer d'une base de données qui hébergera les tables SOF. Les bases de données suivantes ont été validées :
• MySql 4.1 minimum (pour gestion des requêtes avec EXISTS)
• Oracle 9i

  Installation

L'installation du canal SOF repose sur les actions suivantes :

• Création de la base de données
• Initialisation du référentiel
• Configuration des fichiers
• Déploiement

  Création de la base de données

• Les tables de FUN peuvent se trouver dans la base uPortal (pour tests uniquement)
• Pour Mysql, lancer le script docs/database/mysql/base.sql
• Pour oracle, lancer le script docs/database/oracle/oracle.sql qui créera un nouvel utilisateur pour la base FUN

  Initialisation du référentiel

• Lancer le script docs/database/referentiel.sql
• Prendre modèle sur le script referentiel_nancy2.sql pour initialiser le référentiel avec les données indispensables propres à votre établissement
  Important

Pour aller plus loin dans les possibilités de paramétrage, consultez la documentation de paramétrage.

Configuration des fichiers

• Copie le fichier build.sample.properties en build.properties puis l'adapter
• Adapter le fichier properties sql-fun.mysql.sample.properties (ou sql-fun.oracle.sample.properties selon votre cas) qui définit la connexion à la base FUN et le renommer en sql-fun.properties
• Adapter le fichier sql-scol.sample.properties qui contient les informations de connexion à la base externe de scolarité (ne pas oublier de supprimer le .sample du nom du fichier)
• Dans sql-fun.properties, la propriété sgbd peut prendre les valeurs oracle ou mysql
• Copier le fichier properties/csof.sample.xml en csof.xml
• Modifier l'entrée

  <cannuaire directories="persPriveSimple"/>
  

  pour y faire référence à une entrée définie dans votre canal annuaire
• Il convient également de paramètrer l'accès à votre ldap. Il est possible de spécifier un bind non anonyme via les attributs binddn et bindpass. Pour un bind anonyme, laisser ces attributs à vide.

  <ldap server-url="ldap://ldap.univ.fr:.../dc=univ,dc=fr
          ldap://ldap2.univ.fr:.../dc=univ,dc=fr" base="ou=People"
          uidquery="(&amp;(objectClass=n2classpersonnel)(uid=%login%))"
          binddn="" bindpass=""/>
  

• Vous devez également modifier le préfixe qui doit servir à identifier de manière unique les objets CDM générés par le site

  <cdm uniquePrefix="NC2-"/>
  

• Pour ne pas initialiser SOF avec les données d'une base de scolarité externe, positionner l'attribut initEnabled de l'élément scol ainsi :

  <scol initEnabled="N"/>
  

• Adapter les fichier sql-specif-fun.sample.xml et sql-specif-scol.sample.xml (voir partie personnalisation - ne pas oublier d'enlever le sample du nom)
• D'une manière générale, à chaque fichier sample du répertoire properties doit maintenant correspondre un fichier identique sans le sample

  Déploiement

• Copier manuellement dans la webapp uPortal les jar se trouvant dans lib
• Ajouter éventuellement les jar correspondant aux drivers de votre base de données (ces jars ne sont pas distribués avec le canal SOF)
• Déployer l'application avec un ant deploy
• La classe à référencer dans la publication de channel uPortal est fr.unire.portal.channels.fun.csof.CSof
• Il faut mettre un timeout de + de 25 secondes sur la channel car la génération d'un fichier CDM peut-être longue