Pré-requis

Pour pouvoir faire fonctionner esup-mondossierweb, il est nécessaire d'avoir installé au préalable :

• Un Tomcat avec uPortal et esup-portal-ws : http://sourcesup.cru.fr/esup-portal-ws/admin/index.html
  ?Télécharger uportal-ws-server.jar et le copier dans votre hiérarchie uPortal (/uPortal/lib).
  ?Activer Axis en modifiant le fichier/uPortal/webpages/WEB-INF/server-config.wsdd, en y ajoutant le code suivant:

<service name="UportalService" provider="java:RPC">
<parameter name="allowedMethods" value="getUser,getUserAttributes,getGroupById,getGroupByName,getSubGroups,getSubGroupsById,getSubGroupsByName,
getRootGroup,getGroupHierarchyById,getGroupHierarchyByName,getGroupHierarchy,getUserGroups,isUserMemberOfGroup"/>
<parameter name="className" value="org.esupportail.portal.ws.server.UportalService"/>
<parameter name="scope" value="application"/>
</service>

• Le Web Service de l'AMUE :
  ?déployer apows.war dans Tomcat (qui sera ensuite présent dans webapps/apows).
  ?renseigner ses paramètres de connexion (jdbcUrl, user et password) à Apogee dans 'webservices-SpringContext.xml' présent dans le répertoire 'apows/WEB-INF/classes'. Attention, pour que la mise à jour de l'adresse étudiant fonctionne, le compte utilisé doit avoir les droits d'update sur la base. Cependant, cette mise à jour peut être désactivée dans le fichier 'properties' de l'application.
  ?Si besoin est (apows ne se trouvant pas dans le répertoire webapp de Tomcat) ajouter le contexte du WS dans le fichier server.xml du répertoire 'conf' de Tomcat, ex :

<Context path="/apows" docBase="C:/esupdev/esupdev-2.5-esup-2.1.01/uPortal-quick-start/webapps/apows" crossContext="true" reloadable="true"/>

Installation

• Récupérer la distribution de esup-mondossierweb
• Configurer les bases indispensables au fonctionnement l'application. Suivre les étapes suivantes : 
  ?Pour un déploiement servlet, créer un fichier 'build-servlet.properties' sur la base du fichier d'exemple 'build-servlet-example.properties'. Ce fichier décrit votre déploiement servlet.
  ?Pour un déploiement portlet, créer un fichier 'build-portlet.properties' sur la base du fichier d'exemple 'build-portlet-example.properties'. Ce fichier décrit votre déploiement portlet.
  

  Remarque :
  Pour l'utilisation de la target 'start', le fichier 'esup-portail.keystore' est disponible dans le répertoire utils/cas du projet esup-mondossierweb

  Attention :
  Pour un déploiement portlet au sein d'Uportal, esup-mondossierweb doit être déployé au même niveau qu' UPortal.

  ?Renseigner les fichiers (du répertoire 'properties') de configuration 'application.properties' et 'log4j.properties' (dans le repertoire logging) sur la base des fichiers *-example.properties. Dans le répertoire 'monDossierWeb' créer le fichier monDossierWeb.xml sur la base du fichier monDossierWeb-exemple.xml et le renseigner.D'autres options sont configurables via les beans Spring (notemment dans dao.xml pour changer le type d'accès a la BD) : leur description se trouve à la fin de la rubrique 'Utilisation'.
  ?Renseigner configUrlServices.properties du répertoire 'webapp/WEB-INF/classes' en donnant les urls d'accès au Web Service de l'Amue.
  ?Pour un déploiement servlet, créer le web-servlet.xml sur la base de web-servlet-example.xml en indiquant les bonnes urls du serveur CAS : urls de logout, login, et serviceValidate.
  ?Lancer la tache Ant '_toServlet' ou '_toPortlet' du build.xml suivant le type de déploiement désiré. Vous pouvez ensuite passer au déploiement.