Le Canal Stockage évolue pour devenir Esup File Manager (anciennement Esup Portlet Stockage) et apporter de nouvelles fonctionnalités.

Portlet JSR286, Spring MVC Portlet, Web 2.0, interface WAI, interface pensée pour mobiles (JQuery Mobile) et interaction avec ESUP-ECM (support de CMIS) font parties des points importants de cette évolution.

La version esup-filemanager 3.2.0 est maintenant disponible.

Spécifications

On peut retrouver les premières spécifications d'Esup File Manager ici .

Fonctionnalités

TODO

Téléchargement

Vous pouvez trouver la dernière version d'esup-filemanager sur Github :

https://github.com/uPortal-contrib/esup-filemanager/releases

Depuis la version 3.1.1, vous pouvez également retrouver une version packagée sur le maven central : 

https://repo1.maven.org/maven2/org/esupportail/portlet/filemanager/esup-filemanager

Gestion des sources

Afin de faciliter la collaboration autour de ce projet, nous utilisons GITHUB pour gérer le développement d'esup-filemanager :

https://github.com/uPortal-contrib/esup-filemanager

  1. master branch
    Branche de développement d'esup-filemanager - elle utilise "portlet 2.0" API (JSR 286).

  2. esup-filemanager-portlet_1_0 branch (déprécié)
    Branche de développement de la version compatible "portlet 1.0" (JSR 168) - les releases d'esup-filemanager en 2.x.x proviennent de cette branche directement.
    La version 2.2.2 sortie fin 2012 devrait être la dernière version issue de cette branche et donc la dernière version supportant "portlet 1.0", c'est à dire compatible avec les ENT Esup/uPortal de version inférieur à 4.x.
    [pour infos : sur cette version d'esup-filemanager vous devez appeler mvn jetty:run pour tester rapidement esup-filemanager]

Déploiement Test

Une fois dézippée, vous pouvez directement tester esup-filemanager ... avec pluto !

Pour cela il vous faut avoir un apache maven de disponible sur votre machine, en ligne de commande et depuis le répertoire dans lequel se trouve le fichier pom.xml tapez simplement

mvn clean portlet-prototyping:run

Depuis un navigateur, vous pouvez alors appeler une URL du type :

http://localhost:8080/pluto

Notez que le "drive" Bob correspond à file:/// par défaut.

Note: ce mode de fonctionnement d'esup-filemanager embarqué dans un pluto est un mode "dégradé" de cette application, en effet vous ne bénéficiez pas :

  • du CAS : la servlet n'est pas cassifiée ; la portlet fait du proxy-cas.
  • de l'interface accessible WAI 
  • de la vue mobile/smartphone 
  • de la récupération d'attributs utilisateurs depuis le portail (récupération des groupes comprise)

Ce mode est donc une facilité de mise au point, de développement d'esup-filemanager qui reste destinée à fonctionner dans un ENT complet.

Déploiement - Esup v4 / uPortal 4

Les fichiers que l'exploitant est amené à modifier sont les suivant :

Pour déployer esup-filemanager en portlet dans un Esup / uPortal, vous devrez lancer une commande similaire à celle-ci :

mvn clean package ; cd /opt/uPortal-runn/ ; ant deployPortletApp -DportletApp=/home/esup/esup-filemanager/target/esup-filemanager.war

Portlet preferences

Lors de la publication de la portlet Esup File Manager dans le portail Esup / uPortal, vous pouvez (re)définir quelques préférences :

Une partie de ces préférences peut également être configurée par l'utilisateur lui-même si lors de la publication vous activez le mode Edit.

Portlet Timeout

esup-filemanager fait les upload/download en utilisant les nouvelles possibilités de portlet2.0 et donc en passant par le portail/socle.
Le timeout positionné lors de la publication d'une portlet dans le portail est actif à la fois pour les uploads sans prendre en compte le fait qu'un échange de flux est en cours. Cela fait en effet l'objet d'un ticket sur le jira uPortal : https://issues.jasig.org/browse/UP-3552

Aussi, pour contourner ce problème, vous devez positionner un timeout (très) élevé lors de la publication d'esup-filemanager : positionné par défaut à 5000 (5 sec), vous pouvez le positionner par exemple à 7200000 (équivalent donc à 2 heures).

Sécurité

Rappel : faire fonctionner un ENT "en clair" (http) implique de fait que toutes les informations que l'on rend accessibles ou que l'on saisies dans l'ENT passent en clair, username/password potentiellement saisis dans la portlet Esup File Manager compris. On rappelle aussi que faire fonctionner un ENT en clair implique de faire circuler son cookie de session tomcat JSESSIONID en clair, ce qui peut permettre à un instant t (le temps de la session) une usurpation de session (session d'esup-filemanager comprise) ... cela suivant la sécurité/isolation du réseau utilisé ...

Support de webdav et cifs

esup-filemanager propose des implémentations spécifiques pour ces protocoles (s'appuyant sur les librairies Sardine et JCIFS).

Encodage / URIEncoding

esup-filemanager peut utiliser des requêtes HTTP en passant en paramètre HTTP le nom des répertoires ou fichiers.
En fait il ne le fait maintenant plus (V2 et supérieur) que lors de l'upload de fichiers en utilisant "XHR" : le navigateur fait alors bien un POST, mais le contenu de ce POST contient alors directement le contenu du fichier lui-même, alors que le nom du fichier est passé en paramètre HTTP, c'est à dire codé directement dans l'URL de la forme : "...&qqfile=lenom_du_fichier_qui_peut_avoir_des_accents_héhô.pdf"

esup-filemanager utilise UTF-8 dans l'ensemble de l'application, on considère cela comme une bonne pratique, malheureusement Tomcat utilise par défaut l'ISO-8859-1 pour ce qui concerne l'encodage des url en elles-mêmes.

Aussi, nous vous conseillons de configurer votre Tomcat pour utiliser l'UTF-8 comme encodage des urls.

Pour ce faire, dans votre fichier server.xml, ajoutez dans vos balises Connector l'attribut URIEncoding="UTF-8"

-> Nous estimons que c'est une bonne pratique à généraliser sur vos installations Tomcat.

Plus d'infos ici : http://wiki.apache.org/tomcat/FAQ/CharacterEncoding#Q2

Screenshots

Annexes

Notes pour cassifier rapidement un service SFTP

Montage d'espaces Windows

Récupération et affichage du quota

Remarques et demandes d'évolution

Présentation (Vidéo et Slides) lors de Esup Days n°11 "Nouveau canal stockage"

English page on jasig.org.

Contacts

Merci de vous abonner et d'utiliser la liste mail "esup-utilisateurs" pour nous contacter (problèmes techniques notamment) :

https://listes.esup-portail.org/sympa/info/esup-utilisateurs

Crédits & Licence

Copyright (C) 2018 Esup Portail http://www.esup-portail.org
Copyright (C) 2018 UNR RUNN http://www.unr-runn.fr
Copyright (C) 2018 RECIA http://www.recia.fr
@Author (C) 2018 Vincent Bonamy <Vincent.Bonamy@univ-rouen.fr>
@Contributor (C) 2018 Jean-Pierre Tran <Jean-Pierre.Tran@univ-rouen.fr>
@Contributor (C) 2018 Julien Marchal <Julien.Marchal@univ-nancy2.fr>
@Contributor (C) 2018 Julien Gribonvald <Julien.Gribonvald@recia.fr>
@Contributor (C) 2018 David Clarke <david.clarke@anu.edu.au>
@Contributor (C) 2018 Pierre Bouvret <pierre.bouvret@u-bordeaux4.fr>
@Contributor (C) 2018 Franck Bordinat <franck.bordinat@univ-jfc.fr>
@Contributor (C) 2018 Pascal Rigaux <pascal.rigaux@univ-paris1.fr>
@Contributor (C) 2018 Olivier Franco <olivier.franco@insa-lyon.fr>
@Contributor (C) 2018 Maxime Bossard <maxime.bossard@recia.fr>
@Contributor (C) 2018 Guillaume Colson <guillaume.colson@univ-lorraine.fr>
@Contributor (C) 2018 Denis Elbaz <denis.elbaz@univ-perp.fr>
@Contributor (C) 2018 Dominique Lalot <dominique.lalot@univ-amu.fr>

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.