1. Introduction à l'installation client |
|
|
Back to TopL'application Desktop Manager dispose d'un mécanisme d'installation automatique sur le disque du poste client de tous les composants nécessaires au bon fonctionnement de l'application. Il suffit d'ouvrir la base Desktop Manager sur son serveur pour provoquer l'installation des fichiers. Pour cette raison, la manière la plus rapide pour installer l'application (phase de test, pilote...) est d'envoyer aux utilisateurs concernés un mail contenant un lien vers la base ou de prévoir un mécanisme automatique d'ouverture de la base depuis le poste client (code dans le Queryclose dans la base Mail...).
Si la population à installer est importante, il conviendra d'utiliser plutôt le déploiement par package des composants (login script windows, sms...). Cela permet de ne pas avoir à gérer l'envoi de mails et leur suivi.
2. Fichiers binaires présents sur le poste client |
|
|
L'exécution automatique de Desktop Manager nécessite la présence des fichiers suivants sur le postes client :
Tous ces composants se trouvent dans la base Desktop Manager du serveur (documents Binary dans la vue Administration / Architecture / Install Files). Ils sont installés automatiquement sur le poste lors de la première ouverture de la base Desktop Manager depuis un poste client. Lors des ouvertures suivantes, l'application vérifie la présence des composants et les met à jour si une nouvelle version est disponible dans la base sur le serveur. L'actualisation des versions des composants sur les postes utilisateurs se fait donc automatiquement, l'administrateur se contentant de mettre à jour la base du serveur. La taille totale des fichiers à placer sur le poste de l'utilisateur est proche de 5 Mo.
Les chemins d'installation des composants (sous le répertoire Data du client Notes) nous permet de garantir que l'utilisateur aura le droit d'écrire et de mettre à jour les composants. Le choix de l'emplacement des fichiers se fait au niveau des documents de Setup dans la base Desktop Manager (vue Administration / Setup / Setup Documents) :
Le démarrage automatique de la base locale Desktop Manager Start (DskMgrStart.nsf), après l'authentification utilisateur, est réalisé par l'ajoût de la ligne StartupDBName=DskMgrStart.nsf dans le Notes.ini.
3. Fichiers de paramétrage présents sur le poste client |
|
|
Lors de l'exécution de l'application Desktop Manager sur le poste de l'utilisateur, des fichiers de paramétrage y sont automatiquement créés ou modifiés :
Lors de l'exécution de l'application Desktop Manager, les actions à effectuer sont traitées immédiatement. et celles qui ne peuvent pas l'être car le client Notes est ouvert sont consignées dans le fichier DskMgr.ini (modification de l'espace de travail, suppression du Cache.ndk). Elles seront exécutées à la fin de la session Notes, via le programme DskMgr.exe. Celui-ci consulte le contenu du fichier DskMgr.ini pour déterminer la liste des commandes à traiter. Le fichier DskMgr.ini est supprimé après son traitement.
Le fichier DskMgrPre.ini contient le Script qui sera exécuté tous les jours, au tout début de la session Notes (avant la demande de mot de passe). Ce fichier est habituellement utilisé pour la mise en place des fonctions de Roaming au niveau du poste client, afin de recopier les fichiers de configuration Notes. Le fichier DskMgrPre.ini est mis en place lors de l'application des Tâches ou des Profiles. Le traitement du fichier DskMgrPre.ini est réalisé par le composant DskMgrHook.dll.
Le fichier DskMgrPost.ini contient le Script qui sera exécuté tous les jours, à la fin de la session Notes, après le traitement du fichier DskMgr.ini. Ce fichier est habituellement utilisé pour la mise en place des fonctions de Backup au niveau du poste client, afin de sauvegarder les fichiers de configuration Notes. Le fichier DskMgrPost.ini est mis en place lors de l'application des Tâches ou des Profiles. Le traitement du fichier DskMgrPost.ini est réalisé par le composant DskMgr.exe.
Lors de l'exécution de l'application Desktop Manager sur le poste, toutes les opérations réalisées par les différents composants sont tracées dans des fichiers de Log (DskMgrLog*.txt) disponibles dans le répertoire %TEMP%\DskMgr\ de l'utilisateur (répertoire Temporaire) .
4. Installation automatique des fichiers sur le poste utilisateur |
|
|
Il existe plusieurs méthodes pour installer les fichiers sur le poste de l'utilisateur. Dans la plupart des cas, il faut forcer l'utilisateur à ouvrir la base Desktop Manager sur son serveur, ce qui provoque l'installation des fichiers sur son poste. Nous présentons ici les méthodes les plus souvent employées, mais il peut en exister d'autres.
Les 3 méthodes les plus souvent employées sont l'installation par envoi de Mail, l'installation par package et l'installation par ajout de code dans une base existante. L'installation par envoi de mail ou par ajout de code visent à faire ouvrir la base par l'utilisateur alors que la session Notes est active. L'installation par package (SMS, Login Script..) consiste à installer, lors de démarrage de la machine, les fichiers indispensables au lancement de la base locale Desktop Manager Starter. Lors de la première ouverture de la base, l'application installera tous les fichiers nécessaires.
Installation par Mail
L'installation par Mail consiste à envoyer aux utilisateurs un Mail contenant un lien base vers la base Desktop Manager sur son serveur. Ce Mail peut être programmé pour ouvrir la base Desktop Manager automatiquement, sans que l'utilisateur n'ait à cliquer sur le lien. Les Mails peuvent être envoyés directement depuis la base Desktop Manager. Pour plus de détail concernant la rédaction des Mails et leur expédition, se reporter au chapitre Les documents Mail de la présente documentation.
L'envoi de Mail avec un bouton dans le corps du message peut être utile s'il n'existe pas d'ID signataire reconnu pour tous les utilisateurs. Dans ce cas, il faudra signer la base Desktop Manager du serveur avec un ID applicatif et déclarer cet ID dans l'ECL d'administration du NAB. Il faudra ensuite rafraîchir les ECL de tous les postes, via le bouton présent dans le message. Ce bouton contiendra donc les lignes de code suivantes :
@RefreshECL("<nom de serveur>" : "names.nsf";"");
@Command([FileOpenDatabase];"<nom de serveur hébergeant la base Desktop Manager>":"<chemin de la base Desktop Manager>")
Installation par Package
L'installation par Package consiste à installer la base Desktop Manager Start (DskMgrStart.nsf) sur le poste et à modifier le fichier Notes.ini pour que le client Notes lance la base DskMgrStart.nsf au démarrage.
Liste des actions à réaliser dans la base Desktop Manager :
- Ouvrir la vue Administration / Architecture / Install Files de la base Desktop Manager du serveur.
- Cliquer sur le bouton Build DskMgrStart Db pour générer une base DskMgrStart.nsf prête à être déployée par package.
Liste des actions à réaliser dans le Script du package sur le poste de l'utilisateur :
- Copier le fichier DskMgrStart.nsf à la racine du répertoire <Notes Data> du client Notes
- Ajouter dans le Notes.ini la ligne StartupDbName=DskMgrStart.nsf
- Ajouter dans le Notes.ini la ligne $DskMgrDatabase=<chemin de la base Desktop Manager sur le serveur>
- Ajouter dans le Notes.ini la ligne $DskMgrServer=<Nom canonique du serveur hébergeant la base Desktop Manager>
La base DskMgrStart.nsf va être installée comme base de démarrage du client Notes. Elle sera donc exécutée après la phase d'authentification de l'utilisateur. A la fin de l'exécution, la base Desktop Manager Start va synchroniser ses données avec la base Desktop Manager du serveur. Pour cette raison, on indique dans le Notes.ini où est localisée la base Desktop Manager (variables $DskMgrServer et $DskMgrDatabase).
Remarques :
- Pour la base DskMgrStart.nsf, attention à ce que l'ID signataire de la base soit autorisé par la LCE du poste.
- Il est possible de remplacer la modification du Notes.ini (pour $DskMgrDatabase et $DskMgrServer) par l'ajout d'un document de paramétrage dans la base DskMgrStart.nsf qui contiendra alors le chemin de la base Desktop Manager sur le serveur
- Ouvrir la base DskMgrStart.nsf en accédant aux vues cachées (maintenir Ctrl et Shift appuyés en ouvrant la base)
- Se placer dans la vue (DskMgrParam), et créer un document en cliquant sur le bouton Create Param de la vue.
- Saisir les informations concernant la localisation de la base DskMgr.nsf sur son serveur.
- A la place du nom du serveur, il est possible de saisir le mot clé @MailServer pour indiquer le serveur de mail de l'utilisateur (valeur de la variable MailServer du Notes.ini).
- Enregistrer et fermer le document.
Installation code @Formula dans la base Mail
Il est possible de forcer l'ouverture de la base Desktop Manager sur son serveur en modifiant le code de la base Mail des utilisateurs (ou tout autre base ouverte par l'utilisateur). Il suffit de placer dans l'événement QueryClose de la Base Mail un code ouvrant la base Desktop Manager sur le serveur si l'application n'est pas déjà installée localement sur le poste (on teste l'existence de la base locale DskMgrStart.nsf) :
REM {Desktop Manager Database Location};
db_name := "<Desktop Manager database path>";
server_name := "<Desktop Manager database Server>";
REM {Open the Desktop Manager database if the local DskMgrStart.nsf database is missing};
@If(@IsError(@DbExists("":"DskMgrStart.nsf")) | @DbExists("":"DskMgrStart.nsf") = 0;
@If(@IsError(@DbExists(server_name:db_name)) | @DbExists(server_name:db_name) = 0;
@Success;
@PostedCommand([FileOpenDatabase];server_name:db_name));
@Success)
Cette solution est difficile à mettre en place s'il existe une multitude de Templates de messagerie différents. Elle est néanmoins facile à implémenter et reste transparente pour les utilisateurs (pas besoin d'action utilisateur comme l'ouverture d'un message ou le click sur un bouton). De plus, elle offre une bonne solution pour installer l'application sur les postes des nouveaux utilisateurs.
5. Installation pour les clients Notes <= 8.5.2 |
|
|
Si l'application doit être installée sur des clients Notes dont le numéro de version est égal ou inférieur à la 8.5.2, il n'est pas possible d'utiliser la ligne StartupDbName= du Notes.ini pour lancer la base au démarrage du client Notes. Il faut alors modifier les raccourcis permettant de lancer le client Notes (pour y ajouter la base DskMgrStart.nsf) ou alors utiliser la DLL Hook afin de forcer le démarrage. Cela change donc la manière de déployer l'application par package :
Installation par Package / Modification des raccourcis
L'installation par Package avec modification des raccourcis Notes consiste à installer la base Desktop Manager Start (DskMgrStart.nsf) sur le poste et à modifier les raccourcis Notes pour que le client Notes lance la base DskMgrStart.nsf au démarrage.
Liste des actions à réaliser dans le Script du package :
- Ouvrir la vue Product Installation / Install Files de la base Desktop Manager du serveur.
- Cliquer sur le bouton Build DskMgrStart Db pour générer une base DskMgrStart.nsf prête à être déployée par package.
- Copier le fichier DskMgrStart.nsf à la racine du répertoire <Notes Data> du client Notes
- Ajouter dans le Notes.ini la ligne $DskMgrDatabase=<chemin de la base Desktop Manager sur le serveur>
- Ajouter dans le Notes.ini la ligne $DskMgrServer=<Nom canonique du serveur hébergeant la base Desktop Manager>
- Copier le fichier DskMgr.exe quelque part sur le disque
- Exécuter le programme DskMgr.exe avec la ligne de commande suivante :
DskMgr.exe -S "<chemin du programme Notes.exe>" DskMgrStart.nsf
Exemple :
DskMgr.exe -S "c:\Program Files\Lotus\Notes\Notes.exe" DskMgrStart.nsf
La base DskMgrStart.nsf va être installée comme base de démarrage du client Notes. Elle sera donc exécutée après la phase d'authentification de l'utilisateur. A la fin de l'exécution, la base Desktop Manager Starter va synchroniser ses données avec la base Desktop Manager du serveur. Pour cette raison, on indique dans le Notes.ini où est localisée la base Desktop Manager (variables $DskMgrServer et $DskMgrDatabase).
Remarques :
- Pour la base DskMgrStart.nsf, attention à ce que l'ODS soit compatible avec la version du client Notes (ne pas déployer de l'ODS 48 sur des clients R6 ou R7).
- Pour la base DskMgrStart.nsf, attention à ce que l'ID signataire de la base soit autorisé par la LCE du poste.
- Il est possible de remplacer la modification du Notes.ini par l'ajoût d'un document de paramétrage dans la base DskMgrStart.nsf qui contiendra alors le chemin de la base Desktop Manager sur le serveur :
- Ouvrir la base DskMgrStart.nsf en accédant aux vues cachées (maintenir Ctrl et Shift appuyés en ouvrant la base)
- Se placer dans la vue (DskMgrParam), et créer un document en cliquant sur le bouton Create Param de la vue.
- Saisir les informations concernant la localisation de la base DskMgr.nsf sur son serveur.
- A la place du nom du serveur, il est possible de saisir le mot clé @MailServer pour indiquer le serveur de mail de l'utilisateur (valeur de la variable MailServer du Notes.ini).
- Enregistrer et fermer le document.
- Le composant DskMgr.exe est utilisé pour la modification des raccourcis pointant vers l'installation Notes que où on souhaite installer Desktop Manager. Comme il peut y avoir plusieurs versions de Notes d'installées sur la machine, on demande de préciser quelle est la bonne installation (on indique le chemin complet du Notes.exe). Le fichier DskMgr.exe utilisé pour l'installation ne sera pas celui utilisé par Desktop Manager. Il peut donc être supprimé à la fin de l'exécution du package. L'exe va traiter les raccourcis Notes suivants :
- Raccourcis présents sur le bureau de l'utilisateur.
- Raccourcis du Démarrer / Programmes / de l'utilisateur.
- Raccourcis de la barre de lancement rapide de l'utilisateur.
- Raccourci du menu de démarrage de Windows XP pour l'application de messagerie
- La barre de lancement de programmes d'Office
- Si le package d'installation est exécuté avec des droits d'administrateurs du poste, il est possible que les raccourcis localisés dans les répertoires de l'utilisateur ne soit traités car ils ne correspondront pas à l'identité exécutant le composant DskMgr.exe. Dans ce cas, il est possible d'ajouter le chemin à partir duquel une recherche récursive sera effectuée :
DskMgr.exe -S "<chemin du programme Notes.exe>" DskMgrStart.nsf "<chemin de départ de la recherche>"
Exemple :
DskMgr.exe -S "c:\Program Files\Lotus\Notes\Notes.exe" DskMgrStart.nsf "c:\Users\"
- Lors de son exécution, le composant DskMgr.exe produit un fichier de Log dans un sous répertoire du répertoire Temporaire de l'utilisateur (%TEMP%\DskMgr\).
Installation par Package / Utilisation du Hook
L'installation par Package avec utilisation du Hook consiste à installer la base Desktop Manager Start (DskMgrStart.nsf) et les composants DskMgr.exe et DskMgrHook.dll sur le poste pour que le client Notes lance la base DskMgrStart.nsf au démarrage.
Liste des actions à réaliser dans le Script du package :
- Ouvrir la vue Product Installation / Install Files de la base Desktop Manager du serveur.
- Cliquer sur le bouton Build DskMgrStart Db pour générer une base DskMgrStart.nsf prête à être déployée par package.
- Copier le fichier DskMgrStart.nsf à la racine du répertoire <Notes Data> du client Notes
- Copier le fichier DskMgr.exe dans le répertoire <Notes Data>\DM\
- Copier le fichier nDskMgrHook.dll dans le répertoire <Notes Data>\DM\
- Ajouter dans le Notes.ini la ligne $DskMgrDatabase=<chemin de la base Desktop Manager sur le serveur>
- Ajouter dans le Notes.ini la ligne $DskMgrServer=<Nom canonique du serveur hébergeant la base Desktop Manager>
- Ajouter dans le Notes.ini la ligne DskMgrExePath=<chemin du composant DskMgr.exe>
- Ajouter ou Modifier dans le Notes.ini la ligne EXTMGR_ADDINS= <chemin du composant nDskMgrHook.dll, sans la lettre 'n'>
Remarques :
- Pour la base DskMgrStart.nsf, attention à ce que l'ODS soit compatible avec la version du client Notes (ne pas déployer de l'ODS 48 sur des clients R6 ou R7).
- Pour la base DskMgrStart.nsf, attention à ce que l'ID signataire de la base soit reconnue dans la LCE du poste.
- Il est possible de remplacer la modification du Notes.ini par l'ajout d'un document de paramétrage dans la base DskMgrStart.nsf qui contiendra le chemin de la base Desktop Manager sur le serveur :
- Ouvrir la base DskMgrStart.nsf en accédant aux vues cachées (maintenir Ctrl et Shift appuyés en ouvrant la base)
- Se placer dans la vue (DskMgrParam), et créer un document en cliquant sur le bouton Create Param de la vue.
- Saisir les informations concernant la localisation de la base DskMgr.nsf sur son serveur.
- A la place du nom du serveur, il est possible de saisir le mot clé @MailServer pour indiquer le serveur de mail de l'utilisateur (valeur de la variable MailServer du Notes.ini).
- Enregistrer et fermer le document.
- Les composants DskMgr.exe et nDskMgrHook.dll seront utilisés par l'application Desktop Manager. Il faut donc les installer dans les chemins définis dans les documents Setup.
- Si le chemin du composant nDskMgrHook.dll sur le poste contient un espace (ex : "c:\Program Files\Notes\Data\DM\nDskMgrHook.dll"), il faudra indiquer un chemin court (ex : "c:\Progra~1\Notes\Data\DM\DskMg~1.dll") sur la ligne EXTMGR_ADDINS.
- Pour le composant nDskMgrHook.dll, attention à ne pas mettre la lettre 'n' de nDskMgrHook.dll sur la ligne du Notes.ini. Le nom du fichier contient un petit n, pas la déclaration dans le Notes.ini (EXTMGR_ADDINS=c:\Progra~1\Notes\Data\DM\DskMg~1.dll).
Commentaires
0 commentaire
Cet article n'accepte pas de commentaires.