Configuration et paramétrage d'Harmony

Configuration et paramétrage d'Harmony

Menu d'Harmony

Dans le menu Démarrer de Windows, sélectionnez le choix <Tous les programmes : Divalto : Harmony> : le menu "système" d'Harmony Harmony.dhop est affiché. Le cas échéant, validez par "O" la création du fichier des modèles d'imprimantes Fprinters.
Remarque : le bon fonctionnement du logiciel nécessite :

• L'introduction d'un code d'utilisation.

• La création préalable d'une "mémoire commune système" par le programme DhsDivalto.exe. Ce programme est exécuté automatiquement au démarrage d'une session utilisateur, à condition que le programme DhSession.exe soit présent dans le groupe de démarrage (l'ajout de ce dernier dans le groupe de démarrage est effectué à l'installation d'Harmony). Voir aussi la rubrique Installation d'Harmony sous plusieurs comptes / profils utilisateur.

Le paramétrage d'Harmony s'effectue pour l'essentiel à partir de ce menu :

• Déclaration des serveurs.

• Déclaration des chemins Harmony.

• Chemins implicites.

• Utilisateurs d'Harmony.

• Déclaration des unités imprimante et V24.

• Etc.

Quelques autres paramètres sont situés dans la base de registre (section Divalto.ini).

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.

Utilisateurs d'Harmony

Tout utilisateur travaillant sous Harmony doit s'identifier, de manière à mettre en place ses chemins implicites et ses droits d'accès Harmony. A cet effet, Harmony utilise une table stockée dans le fichier XLOGF.

Déclaration des utilisateurs

La gestion de Xlogf se fait par l'utilitaire Xlog1.dhop, après identification par Xlog.dhop avec le code utilisateur ROOT.
Voir aussi : Livre "Import et synchronisation des utilisateurs d'un annuaire LDAP".

Identification automatique au lancement d'une tâche Harmony (version 6)

Par défaut, aucun code utilisateur n'est affecté à une fenêtre Harmony lancée depuis le gestionnaire de programmes de Windows. Ceci oblige l'utilisateur à s'identifier à chaque ouverture de fenêtre Harmony.
Une identification implicite (avec affectation correspondante des chemins implicites et des droits d'accès de l'utilisateur) est toutefois possible, à condition de renseigner la variable d'environnement X_USER. Pour ce faire, modifiez la base de registres pour y ajouter/modifier la clé X_USER avec la valeur correspondante dans le chapitre ENVIRONMENT de HKEY_CURRENT_USER.
Vous accédez aussi aux variables d'environnement par le panneau de configuration : Choix Système, Onglet Avancé, Bouton Variables d'environnement, cadre Variables utilisateur.
Conseil : à l'installation du run-time d'Harmony, garnissez la zone Code utilisateur pour affecter automatiquement une valeur à X_USER.
Vous pouvez donner les valeurs suivantes à X_USER :

• Directement le code utilisateur voulu (20 caractères maximum). Dans ce cas, Harmony identifie automatiquement l'utilisateur avec le code spécifié. Exemple : X_USER=JOEL

• ! (point d'exclamation). Dans ce cas, Harmony identifie automatiquement l'utilisateur avec le code employé lors de l'ouverture de session Windows. Cette méthode est pratique (et conseillée) lorsqu'un même poste est utilisé par plusieurs utilisateurs ou sous Windows Terminal Server Edition (TSE). Exemple : X_USER=!

Remarque : lorsque X_USER est défini, le Login est tout de même demandé, au premier chargement d'une fenêtre Harmony, si un mot de passe est défini dans Xlogf pour l'utilisateur (voir la rubrique Gestion des mots de passe Harmony).
Attention : de plus, définir X_USER n'affranchit pas du fait qu'il faut déclarer les utilisateurs dans la base Harmony, par Xlog1.dhop.

Gestion des mots de passe Harmony

Le mot de passe d'un utilisateur peut être modifié de deux manières :

• Par l'utilisateur lui-même, lors d'un Login par Xlog.dhop (sauf dans le cas d'un serveur sécurisé).

• Par l'administrateur du système, par Xlog1.dhop.

Tant que la session Windows reste ouverte, Harmony mémorise localement les mots de passe tapés. De cette manière, un utilisateur ne devra saisir son mot de passe qu'une seule fois (cas où X_USER est défini ; si ce n'est pas le cas, le mot de passe est demandé à chaque ouverture de fenêtre Harmony).
Pour forcer la ressaisie du mot de passe (l'utilisateur quitte son poste et ne veut pas que quelqu'un travaille sur son ordinateur sans s'identifier), trois méthodes sont possibles :

• Fermer la session utilisateur Windows.

• Associer un mot de passe à l'écran de veille et forcer la mise en veille immédiate.

• Appeler Xlog.dhop et entrer un code utilisateur à espace. Dans ce cas, Harmony "oublie" le mot de passe de l'utilisateur courant.

Déclaration des utilisateurs d'un réseau Harmony

Tout utilisateur qui désire accéder à un serveur de fichiers Xlan doit être déclaré dans le fichier des utilisateurs du serveur. En principe, tous les utilisateurs du réseau doivent donc être déclarés deux fois : une fois dans le fichier Xlogf des serveurs d'applications (ou des postes client fonctionnant en mode local) et une fois dans le fichier Xlogf du serveur de fichiers !
Pour éviter cette redondance, on aura intérêt à centraliser la gestion des utilisateurs sur le serveur de fichiers.
Il faut pour cela que les clients du serveur de fichiers référence non le fichier Xlogf local (cas par défaut) mais le fichier Xlogf du serveur de fichiers. Pour ce faire, modifiez par XdivaltoMajIni le chapitre [System] de la section Divalto.ini de la base de registre des clients (serveurs d'applications ou postes fonctionnant en mode local) pour y inclure la clé :
ServeurXlogf=nom_du_serveur
où nom_du_serveur est le nom Harmony du serveur concerné.
Remarques :
La centralisation de la gestion des utilisateurs va de pair avec celle des fichiers de chemins implicites (voir rubrique Implantation des fichiers d'implicites sur un réseau client-serveur Harmony).
Xlogf est recherché : - En local, dans le dossier /Divalto/Sys/. - En réseau, dans le dossier //nom_du_serveur/Divalto/Sys/, où nom_du_serveur est le nom spécifié dans la clé ServeurXlogf de Divalto.ini.
Cas d'une installation multi-bases (mode ASP) :
Plusieurs fichiers Xlogf peuvent cohabiter sur une installation (sur un ou plusieurs serveurs). Pour déterminer le fichier Xlogf à utiliser pour un poste client, modifiez sur ce poste la valeur de la clé ServeurXlogf comme suit :

• ServeurXlogf=//nom_de_serveur/… Xlogf est alors recherché dans le répertoire indiqué du serveur. Exemple : ServeurXlogf=//nom_de_serveur/divalto/societeUn

• ServeurXlogf=/… Xlogf est alors recherché en local, dans le répertoire indiqué. Exemple : ServeurXlogf=/divalto/societeDeux

Attention :
Si votre serveur de fichiers est un serveur Windows et si votre site nécessite d'être sécurisé, consultez la rubrique Installation d'un serveur Xlan sécurisé.
Voir aussi :
Rubrique Installation d'Harmony sous plusieurs comptes / profils utilisateur.

Utilisateur par défaut pour Odbc

Le choix Paramétrage : Utilisateur par défaut pour ODBC du menu d'Harmony (qui lance l'utilitaire xDefautUserForOdbc) permet de définir un utilisateur par défaut, qui sera utilisé lors des connexions à Odbc pour le compte courant.
Si un utilisateur par défaut est défini, la boîte de dialogue de connexion n'est plus affichée, ce qui permet en particulier :

• De ne plus avoir à ressaisir à chaque fois son code utilisateur et son mot de passe.

• De lancer des requêtes en automatique et en tâche de fond.

Les paramètres à saisir sont les suivants :

Profils de connexion

Lorsqu'un poste client léger dialogue avec un serveur d'applications, il doit préciser et paramétrer le mode de transport qui permettra de véhiculer les informations. Les paramètres à spécifier sont regroupés dans un "Profil de connexion". Un ou plusieurs profils de connexion peuvent être utilisés sur un même serveur d'applications.
Types de connexion
Il existe trois types de connexion :

• Local. A configurer lorsque le poste client léger est aussi serveur d'applications.

• Réseau LAN. A configurer lorsque le poste client léger se connecte au serveur d'applications en mode Socket. Dans ce cas, le profil doit aussi spécifier le nom du serveur (plus, éventuellement, son adresse IP et le port TCP/IP à utiliser).

• Service Web. A configurer lorsque le poste client léger se connecte au serveur d'applications en mode Service Web. Dans ce cas, le profil doit aussi spécifier une Url d'accès au service Web sur le serveur. Ce mode nécessite d'installer le service IIS de Microsoft sur le serveur d'applications.

Remarque : Ces trois modes peuvent cohabiter sur un même serveur.
Gestion des profils de connexion sur le serveur d'applications
L'utilitaire XConfigProfil.dhop permet de gérer les profils de connexion sur un serveur d'applications.
Remarque : Les profils de connexion sont stockés, sur le serveur d'applications, dans la base de registres de l'utilisateur (chapitre [ProfilConnexion] de la section Divalto.Ini). Chaque profil fait l'objet d'une clé dans ce chapitre.
Diffusion des profils de connexion vers les postes clients légers

• Les profils de connexion sont stockés, sur le poste client, dans la base de registres de l'utilisateur (chapitre [ProfilConnexion] de la section Divalto.Ini). Chaque profil fait l'objet d'une clé dans ce chapitre.

• Lorsque l'utilisateur d'un poste client léger se connecte au serveur d'applications, il fait référence à un profil de connexion qui doit être impérativement présent dans sa base de registre. En particulier, il est nécessaire d'inscrire un profil de connexion initial qui servira au moins à la toute première connexion au serveur. Pour enregistrer un premier profil dans la base de registre, il est possible d’accompagner l’installeur d’un .reg :

L'utilitaire XconfigProfil.dhop permet de créer puis d'exporter les profils de connexions dans un fichier .reg. Ce fichier peut ensuite être envoyé vers les postes clients pour y être exécuté. Les profils sont alors intégrés à la base de registre de l'utilisateur sur son poste. Attention toutefois : les fichiers .reg étant des fichiers « sensibles », ils risquent d'être filtrés par les logiciels "antivirus".

• Ensuite, il est possible de récupérer d'autres profils par le bouton « Réactualiser » des Options Avancées de connexion. On rapatrie ainsi sur le poste client les dernières mises à jour de profils effectuées sur le serveur d'applications. Remarque : Une mise à jour automatique est aussi effectuée lorsque l'utilisateur se connecte au serveur plus d'une heure après sa dernière connexion.

Choix d'un profil de connexion par l'utilisateur
L'utilisateur choisit le profil adapté dans les Options Avancées de la boîte de dialogue de connexion au serveur d'applications.
Attention, un changement de profil ne concerne pas les tâches Harmony déjà chargées mais sera pris en compte lors des ouvertures de fenêtre Harmony ultérieures. Voir aussi : Profils utilisateur.
Choix d'une stratégie de sécurité pour Divalto
Lorsque l'utilisateur lance une application Divalto, une boîte de connexion est normalement ouverte pour lui permettre de (ou le forcer à) s'identifier. Plusieurs solutions d'identification sont disponibles (pour en connaître la liste et le fonctionnement, voir le paramètre Options d'identification de la boîte des Options de connexion avancées).
Au niveau du paramétrage des profils de connexion, l'administrateur peut forcer une méthode d'identification donnée pour tous les utilisateurs de ce profil ou, au contraire, laisser ces utilisateurs libres de choisir eux-mêmes leur méthode.
Voir la rubrique Conseils de mise en place d'une stratégie de sécurité Divalto.
Limitation de l'accès aux options de connexion avancées
Au niveau du paramétrage des profils de connexion, l'administrateur peut aussi préciser si l'utilisateur a toute liberté pour modifier les options de connexion avancées ou si certaines options lui sont interdites. Dans ce deuxième cas, l'administrateur qui se rend sur le poste d'un utilisateur peut, sous réserve de saisie d'un mot de passe, récupérer ponctuellement le droit d'accès à toutes les options (voir le paragraphe Passage en mode administrateur de la rubrique Options de connexion avancées).

Remarque :
Sur un poste client, les profils de connexion ne sont jamais supprimés, même s'ils n'existent pas ou plus sur le serveur d'applications, cela pour éviter de perdre une connexion qui n'aurait pas été définie ou qui aurait été supprimée côté serveur. Côté client, la suppression des profils de connexion obsolètes doit donc être effectuée à la main.
Les profils de connexion sont stockés dans la base de registre du poste client à l'adresse suivante :
HKEY_CURRENT_USER\Software\Divalto\divalto.ini\ProfilConnexion

Gestion des profils de connexion

L'utilitaire xConfigProfil.dhop permet de gérer les profils de connexion d'un serveur d'applications.
Pour y faire appel, sélectionnez le choix "Gestion des Profils de connexion en client léger" du menu "Paramétrage" du menu Harmony.
Vous pouvez créer, modifier ou supprimer des profils, à la manière habituelle avec un objet "Tableau".
Un profil de connexion comporte les paramètres suivants :

De plus, l'utilitaire propose les deux commandes supplémentaires suivantes :

Profils utilisateur

Les Options de connexion Avancées du client léger comportent :

• Les informations nécessaires à la connexion au serveur d'applications (codes utilisateur, mots de passe, profil de connexion, programme à exécuter).

• L'environnement de travail de l'utilisateur.

• Ses préférences concernant par exemple le thème de couleurs, la couleur des polices par défaut, la langue d'affichage et d'impression.

Tous ces paramètres sont enregistrés dans un "Profil utilisateur".
S'il est amené à utiliser Divalto dans différents contextes, l'utilisateur peut définir plusieurs profils. Une simple sélection du profil voulu dans la boîte de connexion lui permet alors de retrouver les paramètres adaptés au contexte du moment.
Quand définir plusieurs profils utilisateur
L'utilisateur sera amené à définir plus d'un profil dans les cas suivants :

• Connexion à une base réelle ou à une base de test.

• Connexion au réseau local d'entreprise ou à distance en mode nomade.

• Connexion à différents serveurs.

• Connexion dans différentes langues.

• Pour les partenaires, connexion vers les différents environnements de leurs clients.

Remarque :
L'utilisation d'un thème de couleurs spécifique à chaque profil peut être une manière pratique d'identifier visuellement et immédiatement le contexte d'exécution de chaque fenêtre Harmony.
Création, modification et suppression de profils utilisateur
Contrairement aux profils de connexion ou aux environnements de travail, la gestion des profils utilisateur s'effectue directement sur le poste client, non pas avec un utilitaire de saisie mais depuis les Options Avancées de la boîte de connexion au serveur.
L'utilisateur peut définir un profil par défaut qui lui sera systématiquement proposé à chaque nouvelle connexion au serveur.
Si l'utilisateur ne crée pas de nouveaux profils, il utilisera le profil par défaut créé à l'installation du client léger (ce profil ne porte pas de nom mais il peut être personnalisé, en particulier pour ce qui concerne les préférences de l'utilisateur).
Remarque : Les profils de connexion sont stockés, sur le poste client, dans la base de registres de l'utilisateur (chapitre [ProfilClientLeger] de la section Divalto.Ini). Chaque profil fait l'objet d'une clé dans ce chapitre.
Choix du profil par l'utilisateur
L'utilisateur choisit son profil dans la boîte de connexion du client léger. S'il a défini un "profil par défaut", celui-ci lui est proposé à chaque nouvelle connexion au serveur. Il peut alors éventuellement sélectionner un autre profil dans la liste proposée par le multi-choix "Profil" de la boîte de connexion.
Attention, la sélection d'un profil différent ne concerne pas les tâches Harmony déjà chargées.
Raccourcis vers l'application en précisant le profil utilisateur
Si l'on est amené à utiliser Divalto dans différents contextes et donc à employer plusieurs profils d'utilisation, il peut être intéressant de créer autant de raccourcis que de profils. Avec l'option "Toujours utiliser ce profil", cela permet d'ouvrir directement la fenêtre de l'application, sans répondre à aucune question préalable, quelque soit le contexte d'exécution.
Exemple :
Un commercial a besoin d'une connexion au réseau local d'entreprise lorsqu'il travaille au sein de sa société et d'une connexion par service Web lorsqu'il est en déplacement. Sur son poste, après avoir défini les profils utilisateur "Entreprise" et "Deplacement", il crée deux raccourcis (par exemple sur son Bureau) qui lui permettront de se connecter automatiquement au serveur d'applications de sa société, en utilisant l'un ou l'autre profil selon son lieu de travail.
Pour créer ces raccourcis, reportez-vous au paragraphe "Raccourci vers l'application en précisant le profil utilisateur" de la rubrique Raccourcis vers l'application.

Installation multi-environnement

Objectif
La notion de système multi-environnement a été introduite pour donner la possibilité à un utilisateur de changer dynamiquement son environnement de travail Harmony. Ceci s'avère pratique :

• Pour un utilisateur final disposant d'un environnement de test et d'un environnement d'exploitation réelle ou disposant d'un environnement local et d'un environnement réseau.

• Pour un développeur désirant reproduire les environnements de ses clients sur son propre ordinateur.

• Pour l'administrateur d'un serveur ASP qui désire se connecter sous les différents environnements des clients hébergés.

• Pour mettre à disposition des aides de versions différentes ou des aides traduites en langue étrangère selon les clients hébergés.

Définition de la notion d'environnement Harmony
L'environnement Harmony signifie :

• Un serveur de fichier Xlogf (base de données des utilisateurs Harmony).

• Un serveur de fichier paramètres des langues (TranslateParams.txt).

• Un serveur d'aides pour les applications s'exécutant en mode client léger et un serveur d'aides pour les applications tournant encore en version 6 (voir la rubrique Installation des aides sur un site multi-environnement).

• Un serveur pour la fonctionnalité "Search".

Changer d'environnement consiste alors à changer les chemins d'accès aux différents fichiers (Xlogf, TranslateParams.txt, aides), ce qui permet en particulier de récupérer les chemins implicites, les codes langue et les aides liés à l'utilisateur dans l'environnement choisi.
Gestion des environnements sur le serveur d'applications
L'utilitaire XConfigEnv.dhop permet de gérer les environnements Harmony d'un serveur d'applications.
Remarque : Les environnements sont stockés, sur le serveur d'applications, dans le chapitre [Environnement] de la section Divalto.Ini de la base de registres de l'utilisateur. Chaque environnement fait l'objet d'une clé dans ce chapitre. La clé conventionnellement nommée "Courant" fait référence à l'environnement qui doit être chargé par défaut. Si elle contient le nom d'un environnement absent de la liste, le chapitre [Environnement] est ignoré (on utilise alors les paramètres habituels ServeurXlogf, CheminLangues, CheminAidesWeb et CheminAides).
Diffusion des environnements vers les postes clients légers
Les environnements sont stockés, sur le poste client, dans la base de registres de l'utilisateur (chapitre [Environnement] de la section Divalto.Ini). Chaque environnement fait l'objet d'une clé dans ce chapitre.
L'utilisateur peut récupérer les environnements du serveur d'applications par le bouton « Réactualiser » des Options Avancées de connexion. Il rapatrie ainsi sur le poste client les dernières mises à jour d'environnements effectuées sur le serveur. Remarque : Une mise à jour automatique est aussi effectuée lorsque l'utilisateur se connecte au serveur plus d'une heure après sa dernière connexion.
Choix de l'environnement par l'utilisateur

• En mode client léger, l'utilisateur choisit l'environnement adapté dans les Options Avancées de la boîte de dialogue de connexion au serveur d'applications. Voir aussi : Profils utilisateur.

• Pour les applications tournant encore en version 6, l'utilisateur doit cliquer avec le bouton droit de la souris sur l'icône Divalto de la zone de notification (Traybar). Dans certains environnements Windows (TSE notamment), l'utilisateur ne dispose pas d'une Traybar. Le changement d'environnement Harmony peut alors être obtenu en faisant appel à l'utilitaire xDivaltoSelectEnv.exe (éventuellement via un raccourci placé sur le bureau). Remarque : Si la liste des environnements ne comporte qu'un élément unique, le choix d'un environnement n'existe pas dans la Traybar.

Attention, un changement ne concerne pas les tâches Harmony déjà chargées mais sera pris en compte lors des ouvertures de fenêtre Harmony ultérieures.
Pilotage du changement d'environnement
En mode local, il est possible de piloter le changement d'environnement, par exemple via un raccourci placé sur le bureau, en faisant suivre l'appel à xDivaltoSelectEnv.exe des commandes :

• /env:"nom de l'environnement"

• /cmd:"commande à lancer" (facultative)

Exemples :
Raccourci "Au bureau" :
xDivaltoSelectEnv.exe /env:"bureau" ou, si on veut lancer le menu Divalto : xDivaltoSelectEnv.exe /env:"bureau" /cmd:"c:\divalto\sys\xrtdiva.exe divalto.dhop"
Raccourci "A la Maison" :
xDivaltoSelectEnv.exe /env:"maison" ou xDivaltoSelectEnv.exe /env:"maison" /cmd:"c:\divalto\sys\xrtdiva.exe divalto.dhop"

Gestion des environnements

L'utilitaire xConfigEnv.dhop permet de gérer les environnements Harmony d'un serveur d'applications.
Pour y faire appel, sélectionnez le choix "Gestion des Environnements" du menu "Paramétrage" du menu Harmony.
Vous pouvez créer, modifier ou supprimer des environnements, à la manière habituelle avec un objet "Tableau".
Un environnement Harmony comporte les paramètres suivants :

Le mot réservé "null" permet d'effacer un chemin.
De plus, l'utilitaire propose les deux commandes supplémentaires suivantes :

Déclaration des unités imprimante et V24

Il existe deux cas pour lesquels vous devez déclarer une voie de type V24 :

• Utilisation d'un logiciel de communication.

• Impression "directe" (sans passer par le spouleur) sur une voie série ou parallèle.

Pour déclarer ces unités, appelez le choix <Paramétrage : Unités V24> du menu Harmony.dhop. Une unité est définie par un chemin d'accès (nom Windows du port d'entrée/sortie : COM1:, COM2:, LPT1:, LPT2:, ...), par son type (voie série ou parallèle) et, dans le cas d'une voie série, par ses paramètres de communication (vitesse, protocole, etc.).

Pool des tâches

Le pool de tâches est une fonctionnalité d'Harmony qui permet de réduire notablement le temps de chargement des programmes.
Le principe général est le suivant : Des tâches (xRtDiva.exe côté serveur et xWpf.exe côté client) restent résidentes en mémoire après la fin des programmes. Elles sont ainsi immédiatement disponibles lorsque l'utilisateur relance de nouveaux programmes. De plus, Harmony anticipe un lancement ultérieur de manière à toujours conserver au moins une tâche libre en avance dans le pool.
Exemple schématique :

• L'exécution de l'interface d'accueil charge xRtDiva pour ses propres besoins.

• Un deuxième xRtDiva est immédiatement chargé et placé dans le pool des tâches en attente.

• L'appel d'un zoom à partir de l'IA ne charge pas xRtDiva mais utilise la tâche libre du pool.

• A la sortie du zoom, xRtDiva reste chargé en mémoire et est replacé dans la liste des tâches en attente.

• Un nouvel appel de zoom (ou d'un autre programme) à partir de l'IA ré-utilise la tâche libérée précédemment.

Un nouveau pool est créé à chaque appel de l'IA. Tous les programmes ou zooms appelés ensuite depuis cet IA sont rattachés à ce pool.
Remarque : Un pool est identifié de manière unique. xConsole permet de visualiser les tâches inactives (si l'option "Filtrer les tâches inactives des pools" est désactivée). La colonne "Pool Id" indique le numéro du pool, la colonne "Pool en attente" affiche "A" pour les tâches du pool en attente.
Pour améliorer encore les temps de chargement, il est possible de paramétrer les pools de tâches : voir la rubrique suivante Paramétrage du pool des tâches.

Paramétrage du pool des tâches

Dans le but d'optimiser les temps de chargement des programmes au moment où l'utilisateur y fait appel, il est possible de paramétrer le pool des tâches sur les points suivants :

• Pré-ouverture de connexions à la base SQL. Un programme d'application a besoin d'ouvrir une ou plusieurs connexions à la base SQL. Anticiper ces ouvertures au démarrage de la tâche qui va être mise en attente dans le pool peut améliorer les performances. Par défaut, cette fonctionnalité est désactivée. Pour la mettre en oeuvre, il faut saisir deux clés dans le chapitre System de la base de registre HKEY_LOCAL_MACHINE des serveurs d'applications (par xDivaltoMajIni.exe) :

• • PoolNbSqlConnections (string) : Nombre de connexions à ouvrir.

  • PoolSqlConnectionName (string) : Nom de la connexion à utiliser (déclarée dans le fichier Connexions.xml de l'environnement courant).

• Pré-chargement de modules Diva. Dans le même esprit, un programme d'application a souvent besoin de charger un ou plusieurs modules Diva. Anticiper ces chargements au démarrage de la tâche qui va être mise en attente dans le pool va améliorer les performances. Par défaut, cette fonctionnalité est désactivée. Pour la mettre en oeuvre, il faut créer le fichier xNopModules.txt et le mettre en ligne. Format du fichier (voir le fichier xNopModules-Modele.txt livré en exemple) : <prefixes> p1 p2 ... </prefixes> <modules> module1.dhop module2.dhop ... xxmod1.dhop xxmod2.dhop ... </modules> Entre les balises <prefixes> et </prefixes>, mentionnez une liste de préfixes (un préfixe par ligne). Entre les balises <modules> et </modules>, mentionnez tous les modules Diva à charger (un nom de module par ligne). Lorsque le nom commence par "xx", xx est successivement remplacé par chacun des préfixes de la liste des préfixes et chaque module obtenu est pré-chargé. Exemple : Si le fichier contient les lignes ci-dessus, les modules module1.dhop, module2.dhop, p1mod1, p2mod1, p1mod2 et , p2mod2 seront pré-chargés.

Divalto.ini

Gestion de Divalto.ini

Le paramétrage du système Harmony s'effectue, dans la base de registre, dans les sections HKEY_LOCAL_MACHINE\Software\Divalto\Divalto.ini et HKEY_CURRENT_USER\Software\Divalto\Divalto.ini :

• Dans HKEY_LOCAL_MACHINE, figurent les paramètres liés à l'ordinateur et qui ne dépendent pas de l'utilisateur (voir en particulier la rubrique Configuration de la mémoire commune).

• Dans HKEY_CURRENT_USER, figurent les paramètres locaux à la session qui sont susceptibles de varier suivant l'utilisateur (paramétrage imprimantes par exemple).

Les paramètres d'installation ou de configuration doivent être ajoutés, supprimés ou mis à jour avec les utilitaires Harmony adéquats, à savoir xDivaltoMajIni, xDivaltoPrinters ou DivaltoViewer.
Voir aussi : Modification de Divalto.ini sous TSE
Remarque : Divalto.ini évolue au fur et à mesure des versions d'Harmony. Toutefois, en cas de mise à jour de version, le paramétrage existant n'est pas cassé. Ainsi, les adaptations qui y ont été apportées ne sont pas perdues.

Structure de Divalto.ini

Les sections Divalto.ini dans la base de registre sont structurés en CHAPITRES. Dans la documentation d'Harmony, les chapitres sont représentés entourés de crochets.
Un chapitre contient une ou plusieurs valeurs, chaque valeur étant identifiée par une clé. Dans la documentation d'Harmony, une valeur est représentée par sa clé, suivie immédiatement du caractère "=" et de la valeur proprement dite.
Attention, les espaces sont presque toujours significatifs ; par contre, les caractères majuscules et minuscules sont équivalents.
Exemple :
[System] <==> chapitre System
NbFichiersIndexes=100 <==> clé NbFichiersIndexes, valeur 100
NbFichiersDivers=20 <==> clé NbFichiersDivers, valeur 20

Configuration de la mémoire commune

La section HKEY_LOCAL_MACHINE\Software\Divalto\Divalto.ini de la base de registre contient en particulier des paramètres utilisés par le programme d'initialisation de la mémoire commune d'Harmony DhsDivalto.exe :

• Nombre maximum de tâches (clé NbTaches). Par défaut, ce nombre vaut 2000. Cette valeur doit être comprise entre 16 (minimum) et 10000 (maximum).

• Nombre maximum de fichiers ouverts par tâche (clé NbFichiersParProcess). Déprécié. Cette clé n'est plus utilisée, car ce nombre est désormais déterminé dynamiquement par le système.

• Nombre maximum de fichiers séquentiels-indexés (clé NbFichiersIndexes). Indique le nombre maximal de fichiers séquentiels indexés différents susceptibles d'être ouverts simultanément. Ce paramètre concerne l'ensemble des tâches Harmony. Un même fichier ouvert simultanément par plusieurs tâches compte pour une seule unité. Par défaut ce paramètre vaut 200. Il doit être supérieur à 10.

• Nombre maximum de descriptifs de clés (clé NbDescriptifsCles). A partir de Harmony 2019-405. Ce paramètre permet de limiter la taille du tableau pour les clés des tdf. Initialement, ce paramètre était égal au nombre maximum de fichiers séquentiels indexés (clé NbFichiersIndexes), or il s'avère que seul les fichiers réels, minoritaires, utilisent ce type de clés. Par ailleurs chaque entrée dans ce tableau est relativement volumineuse, d'où l'intérêt de réduire la taille de ce tableau. De manière empirique on peut déterminer que celui-ci est de l'ordre de 30 à 40% de NbFichiersIndexes, et la valeur par défaut est donc de 60.

• Nombre maximum d'autres fichiers (clé NbFichiersDivers). Indique le nombre maximal de fichiers (non séquentiels indexés) différents susceptibles d'être ouverts simultanément. Ce paramètre concerne l'ensemble des tâches Harmony. Un même fichier ouvert simultanément par plusieurs tâches compte pour une seule unité. Par défaut, ce paramètre vaut 40 et doit être supérieur à 10.

• Nombre maximum de réservations d'enregistrement (clé NbReservEnreg). Obsolète, ce paramètre est conservé pour des raison de rétro-compatibilité. Indique le nombre maximal de réservations d'enregistrement susceptibles d'être faites simultanément. Le langage DIVA n'impose aucune limite au nombre de réservations mais il convient de ne pas saturer la table "système" associée. Ce paramètre concerne l'ensemble des tâches Harmony. Pour assurer un nombre suffisant, Harmony s'assure que ce nombre soit toujours supérieur à 5 fois le nombre de tâches ; ainsi, la valeur indiquée dans le registre n'est pas prise en compte si elle ne respecte pas ce critère.

• Nombre maximum de réservations d'enregistrement personnalisé (clé NbReservEnregMax). A partir de Harmony 2019-405. Cette valeur permet de passer outre la règle ci-dessus et forcer un nombre de réservation d'enregistrement inférieur au seuil de 5 fois le nombre de tâches. Si cette valeur est différente de 0, c'est elle qui prime. Ceci permet de réduire le volume de la mémoire commune ; par exemple, si NbTaches = 2000, le nombre de réservations d'enregistrement minimal calculé selon la règle énoncée précédemment sera de 10 000. Fixer la présente valeur à 4000 permettra de réduire le volume de la mémoire commune.

• Nombre maximum de réservations d'entité (clé NbReservEntites). Obsolète, ce paramètre est conservé pour des raison de rétro-compatibilité. Indique le nombre maximal de réservations d'entité susceptibles d'être faites simultanément. Les entités sont réservées par la fonction FSHARE du langage Diva. Ce paramètre concerne l'ensemble des tâches Harmony. Pour assurer un nombre suffisant, Harmony s'assure que ce nombre soit toujours supérieur à 5 fois le nombre de tâches ; ainsi, la valeur indiquée dans le registre n'est pas prise en compte si elle ne respecte pas ce critère.

• Nombre maximum de réservations d'entité personnalisé (clé NbReservEntitesMax). A partir de Harmony 2019-405 Cette valeur permet de passer outre la règle ci-dessus et forcer un nombre de réservation d'entité inférieur au seuil de 5 fois le nombre de tâches. Si cette valeur est différente de 0, c'est elle qui est utilisée, même si elle ne respecte pas le seuil 5*NbTaches. Réduire cette valeur permet de réduire le volume de la mémoire commune.

• Nombre maximum de licences V7 (clé NbLicences) Ce nombre est lié au nombre maximum de tâches. Sa valeur par défaut est de 3000 soit 1.5x le nombre maximum de tâches.

• Nombre maximum de chemins (clé NbChemins) Taille de la liste des chemins Harmony (50 par défaut).

• Nombre maximum de licences distributeurs (clé NbLicencesDistributeur) Cela concerne les programmes spécifiques ou les add-on qu'un distributeur voudrait distribuer sous son propre système de licences. Valeur par défaut : 200

• Nombre maximum de serveurs (clé NbServeurs) Taille maximum de la table des serveurs et des voies série dans la mémoire commune. Par défaut 255.

• Nombre maximum de boites à lettres (clé NbBal) Obsolète. La valeur par défaut est 60. Les programmes standards n'utilisent plus cette fonctionnalité. Les programmes spécifiques qui l'utiliseraient encore devraient changer progressivement abandonner cette fonctionnalité.

Recommandation :
A moins de rencontrer des problèmes liés à :

• des problèmes taille mémoire de Xlan

• des problèmes récurrents de saturation des tables de réservations (d'enregistrement ou d'entités)

Nous recommandons de laisser les clés NbReservEntitesMax et NbReservEnregMax à leur valeur par défaut (0) et de laisser Harmony gérer automatiquement les seuils de réservations.
Dans les cas où il serait nécessaire de personnaliser les nombres de réservations, il est impératif de connaître finement les besoins minimaux de l'architecture concernée car l'utilisation des deux clés sus-mentionnées outrepasse les garde-fous précédemment en place et présente des risques de stabilité des applications pour les utilisateurs.
Attention : une modification sur ces paramètres n'est pas immédiatement répercutée (relancez Windows ou arrêtez et relancez Harmony par xDivaltoRestart.exe).