Groupe 2F (stockage)
Date de création :	7 avril 2005
Dernière modification :
Diffusion :	internet

Installation du Canal Stockage V4.0

ATTENTION: Notez que le canal en V4 est actuellement en RC, et donc en phase de tests par plusieurs établissements. Une nouvelle version, dont la base de données change en grande partie, est en cours de développement. Il est donc déconseillé de le mettre en production, avec l'option de partage, pour le moment.

Présentation

Le Canal Stockage permet la gestion de documents au travers un espace de stockage personnalisé et/ou partagé.

Dans le cadre du développement du projet inJAC, le canal a été enrichi afin de gérer des fonctionnalités avancées comme la navigation entre plusieurs espaces de stockage, la gestion des droits …

Pré-requis

Dans la mise en place de la gestion des droits, le Canal Annuaire est utilisé pour sélectionner les utilisateurs. Il est donc nécessaire d'installer ce Canal avant d'installer le Canal Stockage.

Installation

Recopie des librairies utilisées

Configuration du Canal

Configuration générale du Canal

La configuration générale du Canal Stockage se fait via le fichier properties/CStockage.xml

Structure générale

La structure générale du fichier de configuration du canal est la suivante:

<CHANNEL_CONFIGURATION>			<!-- Racine du fichier de configuration -->
	
	<SERVER_ACCESS_CLASS>		<!-- Définition des classes permettant l'accès à différents types de serveurs -->
		<ACCESS/>				
	</SERVER_ACCESS_CLASS>	
		
	<CHANNEL_ACTION_CLASS>		<!-- Les actions possibles du Canal liées à chaque espace -->
		<ACTION/>				
	</CHANNEL_ACTION_CLASS>		
	
	<SPACE_ATTRIBUTES_CHECKED>	<!-- Liste des attributs de la balise SPACE dont on vérifie si la valeur est de la forme {...} -->
		<ATTRIBUTE/>		
	</SPACE_ATTRIBUTES_CHECKED>

	<SPACES>			<!-- Les espaces accessibles via le Canal -->
		<SPACE/>			
	</SPACES>
		
	<LDAP_ACCESS/>			<!-- Paramètres d'accès au LDAP -->
	
	<DATABASE_ACCESS>		<!-- Paramètres d'accès à la base de données -->
		<pool/>
	</DATABASE_ACCESS>
	
	<AUTHENTICATION/>		<!-- Paramètres liés à l'authentification -->
		
	<DEFAULT_OPTIONS_INTERFACE/> 	<!-- Paramètres divers de suppression -->
				
	<INVISIBLE_FILES>		<!-- Définition des fichiers invisibles dans le Canal -->
		<REG_EXP/>
	</INVISIBLE_FILES>
	
	<ALLOWED_DOCUMENTS/> 		<!-- Format que les documents doivent respecter -->
	
</CHANNEL_CONFIGURATION>

Définition des espaces

<SPACES personalization="true">
	<SPACE
		label="Espace à définir"
		url="http://URL:PORT/CONTEXT/"	
		
		path="chemin/vers/le/répertoire"
		pathRegexp="^(/slide/files)/.*:^(.).*:^/slide/files/(.).*:^(.).*:^/slide/files/(..).*:^(.).*:^/slide/files/(.*)"
		pathRegexpSeparator=":"
		
		serverType="webdav | cifs"
		actionType="classic | injac"
	
		authenticationMode="trusted | asked"
		login="admin"
		password="trusted"
		
		sharing="true | false"
		
		manageAcl="true | false"
		aclNamespace="DAV:"
		aclUserPrefix="/slide/users/"
		aclGroupPrefix="/slide/roles/"
		aclUportalGroup="uPortal"
		
		cifsDomain=""
		cifsResolveOrder="DNS,BCAST"
		cifsDisablePlainTextPassword="false"
	
		>
			<ALLOWED 
				attribute="attribut_uportal" 
				value="valeur_de_l_attribut"
			/>
	</SPACE>
</SPACES>

<SPACE
	label="Mes documents WEBDAV"
	url="http://mon_serveur:8080/"
 	
	path="/slide/files/{username}"
	pathRegexp="^(/slide/files)/.*:^(.).*:^/slide/files/(.).*:^(.).*:^/slide/files/(..).*:^(.).*:^/slide/files/(.*)"
	pathRegexpSeparator=":"
	
	serverType="webdav"
	actionType="classic"
	
	authenticationMode="trusted"
	password="trusted"
	
	sharing="true"
	
	manageAcl="true"
	aclNamespace="DAV:"
	aclUserPrefix="/slide/users/"
	aclGroupPrefix="/slide/roles/"
	aclUportalGroup="uPortal"
	
/>

<SPACE
	label="Mes documents CIFS"
	url="smb://192.192.192.192"
	
	path="/{storageFormLogin}"
	serverType="cifs"
	actionType="classic"

	authenticationMode="asked"

	cifsDomain="univ.fr"
	cifsResolveOrder="DNS,BCAST"
	cifsDisablePlainTextPassword="false"
	
/>

Accès au serveur LDAP

<LDAP_ACCESS 
	serverUrl="ldap://ldap.univ.fr:389"		
	people="ou=people,dc=univ,dc=fr"
	userKeyAttribute="uid"
	userDisplayNameAttribute="displayName"
/>

Accès à la base de données

<DATABASE_ACCESS 
	type="JNDI | JDBC"
	url="jdbc:mysql://localhost:3306/CWEBDAV"
	driverClassName="com.mysql.jdbc.Driver"
	username="portail_2005"
	password="p_2005"
/>

Paramètres généraux d'authentification

<AUTHENTICATION 
	usernameAttribute="username"
	httpsRedirection="true | false" 
/> 

Paramètres divers de suppression

<DEFAULT_OPTIONS_INTERFACE
	confirmDel="true"
	allowDelNonEmptyFolder="true"
/>

Fichiers invisibles

<INVISIBLE_FILES>
	<REG_EXP 
		pattern="^\..*"
	/>
</INVISIBLE_FILES>

Configuration du module inJAC

Structure générale

<INJAC>					<!-- Racine du fichier de configuration -->
	
	<METADATA_PROFILES>		<!-- Ensemble des profiles méta-données -->				
		<METADATA_PROFILE/>		
	</METADATA_PROFILES>
		
	
	<RENDERINGS>			<!-- Ensemble des noms de fichiers des skins utilisables pour le rendu des documents d'un espace injac -->
		<RENDERING/>		
	</RENDERINGS>
	
</INJAC>

Voyons plus en détail ces balises.

Liste de méta-données

<METADATA_PROFILES>
	
	<METADATA_PROFILE
		fileName="default.xml"
		label="Méta-données par défaut"
	/>
		
</METADATA_PROFILES>

Liste de feuilles de style pour rendu

<RENDERINGS>
	
	<RENDERING
		label="Rendu par défaut"
		skinFile="File.xml"		
	/>
		
</RENDERINGS>

Définition d'un profile de méta-données

Un format a été défini pour la définition des méta-données à saisir par l'utilisateur au moment de la soumission, ou de la publication d'un document.

<?xml version="1.0" encoding="ISO-8859-1"?>

<metas>
	<meta/>
</metas>

<meta 	
	name="---"
	label="---"
	input="text|textarea|select"
	choiceList="a,b,c"
	type="string|date"
	required="yes|no"
	level="edition|publication"
	defaultValue="---"
	comment="---"
	format="regexp|dateFormat"
/>

Remarque

Déploiement du Canal

Création : 7 avril 2005 - Yohan Colmant (Université de Valenciennes)
Modifications :