Documentation:Configuration de CIFS
Un article de AlfrescoWiki.
Sommaire |
[modifier] Présentation
Common Internet File System (CIFS), aussi connu sous le nom Server Message Block (SMB) est un protocole dont l'utilisation la plus connue est le partage de fichiers à travers un réseau local. Ce protocole permet l'accès à des serveurs qui sont vues comme des ressources locales.
Microsoft utilise CIFS dans toutes les variantes de Windows pour fournir la notion de partage, et de voisinage réseau. Unix/Linux l'utilise aussi via Samba, et Apple possède plusieurs clients et serveurs. Par conséquent, c'est un protocole qui facilite l'interopérabilité.
[modifier] Applications
CIFS possède une partie cliente et une partie serveur. La partie serveur est celle qui s'applique à Alfresco, et permet d'exposer l'entrepôt de données à travers le voisinage réseau. Cela signifie que l'entrepôt va être visible dans le voisinage, et pourra être connecté sous forme d'un lecteur réseau classique.
[modifier] Utilisation du serveur CIFS
Le serveur CIFS est accessible dans le voisinage réseau, sous un nom fonction du nom de machine du serveur, avec le suffixe '_A' à la fin. Par exemple si le nom de machine du serveur est 'MYPC01', alors le serveur CIFS sera disponible sous le nom 'MYPC01_A'.
Ce "_A" sert à différencier le service CIFS du partage de fichiers classique existant sur le serveur.
A partir de la version 2.1E, le nom par défaut devient 'MYPC01A' et non plus 'MYPC01_A'
[modifier] Activation du serveur CIFS sous windows
Pour activer le serveur CIFS sous Windows, la DLL Win32NetBIOS.dll doit être copiée depuis C:\alfresco\bin (chemin à adapter en fonction de votre configuration) dans le un répertoire faisant partie des chemins du système (path), par exemple c:\windows\system32. (une autre possibilité est d'ajouter C:\alfresco\bin à la variable path du système.
Le serveur Alfresco doit être redémarré une fois que la DLL a été copiée.
Cette opération n'est pas nécessaire avec un système Unix/Linux.
[modifier] Paramétrage de CIFS
TODO : modifier ce paragraphe pour faire ces modifications dans file-servers-custom.xml
Si vous ne pouvez pas vous connecter au serveur CIFS, vous pouvez avoir besoin (selon les réseaux) de spécifier le domaine à utiliser dans la configuration du serveur CIFS.
Il faut démarrer le serveur au moins une fois avant de faire cette modification
Pour spécifier le domaine, éditez le fichier file-servers.xml dans le dossier \webapps\alfresco\WEB-INF\classes\alfresco (ou équivalent sur votre installation) et éditez la ligne suivante :
<host name="${localname}_A"/>
afin que le domaine apparaisse sous cette forme :
<host name="${localname}_A" domain="MONDOMAINE"/>
[modifier] dépannage de CIFS
[modifier] Cas particulier de la connexion en local : Ajout de la carte réseau de bouclage
Dans le cas où vous voulez connecter un poste Windows à lui-même (le serveur Alfresco fonctionne en local), vous pouvez avoir à activer une carte de bouclage (carte réseau virtuelle). Ce besoin peut être vérifié si vous arrivez à vous connecter depuis une machine tierce, mais pas depuis le serveur.
Voici les opérations à effectuer.
- Panneau de configuration
- Ajout de matériel
- Sélectionner "autres périphériques"
- suivant
- sélectionner l'option "Oui, j'ai déjà connecté le matériel" puis suivant
- sélectionner en bas de la liste "Ajouter un nouveau périphérique matériel" puis suivant
- sélectionner "Installer le matériel que je...." puis suivant
- sélectionner "Carte réseau" puis suivant
- sélectionner le fabricant "Microsoft" et "Carte de bouclage Microsoft" puis suivant.
- Vérifier la présence de la carte en tapant "ipconfig /all" dans une console
- redémarrer le serveur Alfresco si il était lancé
- ouvrir une fenêtre de commande
- taper nbtstat - n
- les connexions sont listées et votre adresse ip visualisée (adresse ip de votre serveur CIFS)
- dans l'explorateur, taper la ligne de commande suivante \\nom_de_ma_machine_a\alfresco
- donner le nom d'utilisateur : admin mot de passe : admin
[modifier] La fenêtre de connexion se réouvre en permanence
Ce problème est causé par un client qui se connecte au serveur de fichier en utilisant le port SMB 445 au lieu de NetBIOS.
Ce mécanisme peut être désactivé en ajoutant la clé suivante à la base de registre :
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\NetBT\Parameters] "SMBDeviceEnabled"=dword:00000000
Un redémarrage du client est nécessaire pour la prise en compte. Placer la valeur à "1" ou supprimer la clé restaure le fonctionnement d'origine.
[modifier] Configuration avancée
TODO
- Déclarer un partage sur le user home
- Déclarer un partage sur un chemin quelconque
- Définir une adresse de bind
- Débuguer une connexion CIFS
- activer / désactiver CIFS
- CIFS et WCM
- Faire cohabiter Alfresco et Samba ( http://forum.alfresco-fr.org/viewtopic.php?id=177 )
[modifier] Références
Page du wiki Anglophone : http://wiki.alfresco.com/wiki/File_Server_Configuration
L'authentification CIFS : http://wiki.alfresco.com/wiki/CIFS_Server_Authentication
CIFS sous Linux : http://wiki.alfresco.com/wiki/CIFS_linux
