Copie de Configuration et paramétrage d'Harmony

Configuration et paramétrage d'Harmony

Fichiers de configuration des serveurs et des chemins Harmony

Deux solutions sont possibles pour le stockage des tables des serveurs et des chemins Harmony :

• Le fichier séquentiel-indexé Fconfig.dhfi (tables des serveurs et des chemins), mais cette solution est considérée comme obsolète.

• Les fichiers texte DivaltoServer.cfg (table des serveurs) et DivaltoPath.cfg (table des chemins), qui sont la solution préconisée. Attention : Lorsque ces fichiers sont présents, le fichier Fconfig.dhfi n'est plus utilisé. Les deux fichiers doivent alors obligatoirement exister. Le fichier des chemins peut éventuellement être vide s'il n'y a pas de chemins spécifiques à définir (le chemin Divalto existe de manière implicite).

Dans les deux cas, les tables peuvent être garnies à l'aide d'un zoom (voir les rubriques Déclaration des serveurs de données et Déclaration des chemins Harmony).
Remarque : Le bouton "Export dans .cfg" du zoom des serveurs ou du zoom des chemins permet de créer les deux fichiers .cfg à partir d'un fichier Fconfig existant.

Format d'une ligne "Serveur" dans la table des serveurs
<NAME>Nom<ADDRESS>AdresseIp<SQLPATH>CheminSql<COMMENT>Commentaire<TYPE>Type<OS>WINDOWS<PORT>port
Format d'une ligne "Chemin" dans la table des chemins
<NAME>NomDuChemin<PATH>CheminDuChemin<MULTIBASE>OptionMultibase<SHARENAME>NomPourLesReservations

Déclaration des serveurs de données

Harmony utilise une table de serveurs de données. Chaque élément de cette table sert à identifier un serveur (Xlan ou SQL) et à définir les paramètres nécessaires à la connexion au réseau. Les serveurs de fichiers auxquels un client doit avoir accès sont localement paramétrés dans le fichier Fconfig.dhfi ou dans le fichier texte DivaltoServer.cfg (voir la rubrique Fichiers de configuration des serveurs et des chemins Harmony).
Un zoom, accessible depuis le menu d'Harmony (choix Paramétrage : Serveurs)) ou depuis l'utilitaire Xpath.dhop (bouton Serveurs ou choix du menu Outils : Zoom des serveurs), permet ce paramétrage.
Les paramètres d'un serveur sont les suivants :

Les paramètres d'un serveur sont spécifiques à chaque type de réseau/serveur. Suivant le type de réseau à installer, on pourra au besoin se reporter à la rubrique :
Déclaration des serveurs Unix du client Windows. Déclaration des serveurs Windows du client Windows.
(**) Cas particulier d'un serveur SQL : pour configurer un serveur de type "SQL", appelez le programme Xpsql.dhop et consultez la documentation en ligne (XlanSql).

Chemins implicites

Sous Harmony, chaque utilisateur dispose d'une liste de chemins d'accès dits "implicites". Ainsi, lorsque le chemin d'accès complet à un fichier n'est pas précisé (ce qui est généralement le cas), Harmony le recherche d'abord en suivant le premier chemin implicite puis, si nécessaire, en suivant le second, le troisième et ainsi de suite jusqu'à trouver le fichier.
La notion de chemin implicite est détaillée au chapitre Accès aux fichiers d'Harmony.

Déclaration des chemins Harmony

Sous Harmony, les chemins d'accès aux fichiers peuvent référencer des chemins spécifiques, appelés "chemins Harmony". Leur emploi est facultatif en local mais obligatoire au niveau d'un serveur Xlan.
La notion de chemin Harmony est détaillée au chapitre Accès aux fichiers d'Harmony.
Les chemins Harmony utilisés sur un ordinateur sont localement paramétrés dans le fichier Fconfig.dhfi ou dans le fichier texte DivaltoPath.cfg (voir la rubrique Fichiers de configuration des serveurs et des chemins Harmony).
Un zoom accessible depuis le menu d'Harmony (choix Paramétrage : Chemins Harmony) ou depuis l'utilitaire Xpath.dhop (bouton Chemins ou choix du menu Outils : Zoom des chemins) permet ce paramétrage.
Chaque chemin contient les deux premiers paramètres suivants :

Exemples :

Conseil pratique : Il est généralement inutile de créer des chemins Harmony sur les postes autonomes ou les postes clients d'un serveur. Réservez les chemins Harmony aux serveurs Xlan.
Attention : en local, un chemin Harmony ne doit jamais en référencer un autre (la récursivité est interdite). Par exemple : La définition de chemins suivante est correcte : Divalto = c:/Divalto/ Sources = c:/Divalto/Sources/ Mais celle-ci est erronée : Divalto = c:/Divalto/ Sources = /Divalto/Sources/
Remarque : Le chemin Divalto est prédéfini. Il correspond au dossier x:/Divalto, où x est l'unité disque sur laquelle a été installé le run-time d'Harmony.

Réservation globale ou réservation par base sur un serveur
Principe : Pour gérer le partage des fichiers dans un contexte multi-utilisateurs, les programmes d'application effectuent des "réservations" sur le serveur de données. Toute réservation spécifie le chemin Harmony d'accès au fichier(s) concerné(s).
Définitions : Un serveur multi-bases est par exemple un serveur fonctionnant en mode ASP qui héberge les mêmes applications pour des sociétés utilisatrices différentes, ou un serveur sur lequel sont stockées à la fois une base en exploitation et une base de test. Sur ce serveur, cohabitent donc plusieurs exemplaires physiques des mêmes fichiers logiques. Bien entendu, les réservations faites pour une société A n'ont alors rien à voir avec celles faites pour la société B et il faut les différencier. Nous utiliserons dans la suite de cette rubrique le mot Structure pour désigner par exemple la société X ou le groupe des utilisateurs de la base de test ou le groupe des utilisateurs de la base en exploitation.
On distingue alors deux cas :

• Tous les utilisateurs appartiennent à la même structure. Le serveur est mono-base et les réservations peuvent être globales à tout le serveur : on parle alors de réservation "Par Serveur". C'est le mode par défaut.

• Les utilisateurs appartiennent à différentes structures. Le serveur est multi-bases et les réservations doivent être spécifiques à chaque base : on parle alors de réservation "Par Base". Dans ce cas, remarquez que chaque structure dispose bien entendu, sur le serveur, d'un jeu de chemins Harmony qui lui est propre.

Les deux derniers paramètres d'un chemin Harmony peuvent être ignorés dans le cas le plus courant d'un serveur mono-base (ainsi que sur les postes clients). Ils permettent de mettre en oeuvre une réservation "Par Base" sur un serveur multi-bases, pour CE chemin :

Remarques :

• Pour les bases de données SQL, les réservations sont toujours faites "Par Base".

• Même si les réservations sont normalement faites "Par Base", il reste possible d'effectuer certaines réservations "Par Serveur" : il suffit, pour ces réservations, de spécifier un chemin pour lequel l'option multi-base n'est pas cochée (par exemple, le chemin /divalto du serveur).

• Toutes les réservations qui ne sont pas faites via un chemin comportant l'option "Par Base" sont globales au serveur. C'est en particulier le cas lorsqu'une réservation est effectuée directement sur le serveur avec un chemin Windows (par exemple c:\divalto\fic).

Exemples :

Déclaration des chemins implicites

Une liste de chemins implicites est enregistrée dans un fichier .txt (un fichier par liste). La constitution d'un tel fichier s'obtient en faisant appel à l'utilitaire Xpath.dhop.
Chaque ligne d'un fichier d'implicites contient un chemin d'accès (local ou réseau). Le nombre total de lignes n'est pas limité.
Exemples :
/divalto/sys/ d:/src/ //serveurcompta/fichiers/comptabilité
Remarques :
S'il n'est pas présent dans une liste, le chemin implicite /Divalto/Sys/ (qui mène au dossier "système" d'Harmony) est automatiquement ajouté en fin de liste.
Pour améliorer les performances, il est conseillé :

• De placer les chemins menant à des dossiers locaux avant les chemins menant sur le réseau.

• De placer le chemin /Divalto/Sys/ en tête de liste.

• De réduire le nombre d'implicites au minimum, afin de limiter les recherches inopérantes lors de l'ouverture des fichiers.

Fichiers de chemins implicites et utilisateurs

Chaque utilisateur déclaré dans la base des utilisateurs d'Harmony (Cf. rubrique Implantation des fichiers d'implicites sur un réseau client-serveur Harmony) peut disposer de son propre fichier de chemins implicites mais un même fichier peut aussi être affecté à plusieurs utilisateurs.
Remarque : si aucun fichier n'est spécifié dans les paramètres d'un utilisateur, Harmony lui affecte automatiquement le fichier ImplicitesDefaut.txt.
En pratique, le plus simple est de limiter au maximum le nombre de fichiers présents sur le site. A cet effet, on pourra par exemple affecter le même fichier aux utilisateurs qui exécutent les mêmes applications (et qui, par voie de conséquence, accèdent aux mêmes fichiers).
Exemple :
Sur un site, les utilisateurs LISE, JEAN, PAUL et MAX travaillent sur la compta et la gestion commerciale ; LINE et CATY uniquement sur la compta ; LUC uniquement sur la paie. On simplifie le paramétrage se limitant à 3 fichiers d'implicites :

• Paie.txt : spécifié dans les paramètres de l'utilisateur LUC, il contient les chemins d'accès aux fichiers de la paie.

• Compta.txt : spécifié dans les paramètres des utilisateurs LINE et CATY, il contient les chemins d'accès aux fichiers de la compta.

• ImplicitesDefaut.txt : contient les chemins d'accès aux fichiers de la compta et de la gestion commerciale (aucun fichier n'étant spécifié dans les paramètres des utilisateurs LISE, JEAN, PAUL et MAX).

Implantation des fichiers d'implicites sur un réseau client-serveur Harmony

Les fichiers d'implicites peuvent être stockés en local. Mais dans ce cas, les fichiers communs à plusieurs utilisateurs (voir l'exemple de la rubrique Fichiers de chemins implicites et utilisateurs) devront être créés plusieurs fois.
Pour éviter cette redondance, on aura intérêt à centraliser la gestion des fichiers d'implicites et donc à implanter ces fichiers sur le serveur. La centralisation de la gestion des fichiers d'implicites va de pair avec celle des utilisateurs : pour l'obtenir, il faut modifier (par XdivaltoMajIni) la clé ServeurXlogf du chapitre [System] de Divalto.ini sur les postes client (Cf. rubrique Déclaration des utilisateurs d'un réseau Harmony).
Conseils pratiques :

• Centralisez la gestion des utilisateurs et des chemins implicites. Remarque : la gestion des serveurs et des chemins Harmony ne peut pas être centralisée.

• Limitez au maximum le nombre de fichiers de chemins implicites. Pour cela, affectez le même fichier aux utilisateurs qui exécutent les mêmes applications. Utilisez le fichier d'implicites par défaut ImplicitesDefaut.txt pour les utilisateurs "majoritaires". Créez de nouveaux fichiers uniquement pour les autres utilisateurs.