Web Version 3 docref : 0/fr Prologue - www.prologue.fr Pour nous contacter au sujet de ce document : support@prologue.fr Tel : +33 01 69 29 39 39 Fax : +33 01 69 29 90 43
Table des matières 1 - Généralités... p.3 1.1 - Copyright... p.3 1.2 - A propos... p.3 1.3 - Convention de typographie... p.3 2 - Introduction... p.4 3 - Architecture et fonctionnement de Web...p.5 4 - Installation de Web... p.7 4.1 - Pré-requis à l'installation de Web... p.7 4.2 - Procédure d'installation du DM Web Client...p.7 4.2.1 - Installation des fichiers programmes... p.8 4.2.2 - Installation sur le serveur Web...p.9 4.2.2.1 - Installation du logiciel SoftArtisans... p.9 4.2.2.2 - Installation et paramétrage de Use It Messaging Application Connector... p.10 4.2.2.3 - Installation de Web... p.15 4.2.3 - Le paramétrage du site web de Web.. p.18 4.2.4 - Paramétrage du répertoire virtuel DMWEB... p.19 4.2.5 - Accès à Web... p.21 5 - Configuration de l'authentification intégrée pour le client Web...p.23 5.1 - Paramétrages du client Web...p.23 5.2 - Paramétrage du poste client...p.27 5.3 - Création automatique du compte fax...p.29 5.4 - Problèmes pouvant être rencontrés... p.34 6 - Tech Issues... p.36 6.1 - Désinstallation et réinstallation du client Web... p.36 6.2 - Erreur serveur sur le client Web...p.37 6.3 - Erreur sur Default.asp... p.40 6.4 - Problème patch sécurité et 2000 2is... p.40 6.5 - Visualisation des fax dans les en-cours...p.41 6.6 - Mode java sous 2003/XP... p.43 6.7 - Visualisation des en-cours et du Time-out de session... p.43 2/43
1 - Généralités 1.1 - Copyright Tous droits réservés. Aucune partie de cette documentation ne peut être reproduite, stockée sur un système d'archivage ou transmise à quelque fin ou par quelque moyen que ce soit, sans la permission écrite préalable de l'éditeur, sauf s'il s'agit de courtes citations reprises dans des articles ou des critiques. Toutes les marques citées dans ce manuel sont les propriétés de leurs auteurs respectifs. Au cours de la préparation de cette documentation, les auteurs et l'éditeur ont particulièrement veillé à l'exactitude de son contenu. Toutefois ces informations sont fournies sans garantie, expresse ou implicite. Les auteurs, les revendeurs et les distributeurs ne peuvent pas être tenus pour responsables des dommages éventuellement causés ou censés avoir été causé, de manière directe ou indirecte par cette documentation. Les informations contenues dans ce document pourront faire l'objet de modifications sans préavis. Sauf mention contraire, les sociétés, les noms et données utilisés dans les exemples sont fictifs. 1.2 - A propos Avant de commencer le mise en place du produit, assurez vous de bien lire les instructions de configuration, les conseils ainsi que toute autre information essentielle contenue dans ce guide. 1.3 - Convention de typographie Ce guide s'appuie sur les conventions suivantes : Caractères gras Libellés des champs et des boîtes de dialogue. Nom des touches. Commandes et boutons à utiliser Caractères italiques Titres des autres parties, chapitres et sections du manuel. Titres des autres manuel. Noms de logiciels Prologue et d'autres éditeurs. Caractères espacement fixe Puce Remarque : à Exemples de syntaxe de codes, de clés et d'instructions. Procédure courte ou sous-procédure étape par étape. Les remarques contiennent des informations importantes mises en exergue par rapport au texte. Attention : indique les Les messages de ce type indiquent les précautions que vous précautions à prendre devez observer pour éviter une erreur ou un problème risquant de porter à conséquence. 3/43
2 - Introduction Web offre une solution fax avantageuse à toute entreprise qui désire privilégier une stratégie Internet/Intranet. Web d'imecom est une interface de Use It Messaging Server conçue pour permettre à tout client d'internet ou d'un Intranet équipé d'un navigateur compatible, de bénéficier des principales fonctionnalités d'un client fax dédié. L'interface Web fournit un accès contrôlé depuis n'importe quelle station Windows équipée du navigateur Internet Explorer version 3.02 et supérieures ou du navigateur Netscape Navigator versions 3.0 et supérieures. Tout Web pourra émettre et recevoir des fax, consulter ses propres journaux d'émission, visualiser ses fax avec le visualisateur ShowFax d'imecom ou avec Adobe Acrobat Reader, en convertissant les fax au format PDF. Web pourra également sélectionner des pages de garde personnelles ou publiques afin d'y inscrire texte, commentaires, informations sur le ou les destinataires et l'émetteur. En outre, il pourra mettre en attachement de nombreux types de documents dans leur format natif (.doc,.xls...) et les fax seront émis immédiatement ou en différé selon la demande de l'utilisateur. 4/43
3 - Architecture et fonctionnement de Web Web accède aux fonctionnalités fax du DM Server via une page HTML chargée depuis le site Web contacté. Web, suivant la version du navigateur employé, pourra être utilisé, en plus du mode HTML, en mode Java. Le mode Java est supporté par les navigateurs Internet Explorer versions 4.0 et supérieures et Netscape versions 4.06 et supérieures. Il doit être activé par l'utilisateur (voir l'aide en ligne de Web ). En mode HTML (mode par défaut), toutes les données des pages HTML sont statiques. En mode Java, grâce aux applets Java inclus dans les pages HTML, certaines des données présentées sont mises à jour dynamiquement par l'utilisateur qui pourra par exemple, redimensionner les colonnes d'un tableau ou encore effectuer des tris par colonnes... Les paramètres d'affichage suivants sont conseillés en mode Java : Résolution standard de 800 x 600 pixels, 65 536 couleurs. Tout Web doit posséder un compte utilisateur fax ouvert via l'administration de Use It Messaging Server. La création de ce compte fax impliquera la 5/43
création de répertoires personnels sur le serveur de fichiers et son enregistrement dans le fichier Intfax.cnf. Chaque utilisateur désirant charger la page HTML contenant l'application Use It Messaging Client Web devra d'abord s'identifier par son login courant (nom, domaine et mot de passe). Le serveur authentifiera le login auprès du contrôleur de domaine, vérifiera dans sa propre base l'existence d'un compte fax pour ce login, puis ouvrira une session pour ce compte fax si toutes les vérifications sont positives. Sur le serveur web, en plus de l'application Web, doivent être installés, Internet Information Server 4 (IIS4) et le logiciel SoftArtisans qui permet le téléchargement des pièces jointes. L'utilisateur pourra visualiser la liste de ses propres fax reçus présents dans son répertoire..\userrcv et, s'il est équipé d'une plate-forme Windows, il pourra les visualiser grâce à l'option ShowFax qu'il aura soit téléchargée puis installée localement, soit lancée sur le serveur. L'utilisateur aura également la possibilité de visualiser ses fax convertis au format pdf avec le logiciel Acrobat Reader d'adobe. 6/43
4 - Installation de Web Cette section vous explique comment installer le DM Web Client, le client web dédié au fax d'imecom. La machine où sont installés les programmes est appelée «serveur de fichiers». 4.1 - Pré-requis à l'installation de Web Satisfaire les configurations requises, «Introduction au Web». Le serveur web : Le serveur web, sous Windows NT Server, doit impérativement être Microsoft Internet Information Server 4 (IIS). Pour cela, nous vous conseillons l'installation d'option Pack 4 et plus particulièrement de ces deux composants, IIS et NTS. Posséder un compte utilisateur NT ayant les droits «Utilisateur local» et de «Lecture» sur le serveur de communication (DM Server, Fax Gateway). Ce compte sera utilisé pour le lancement de l'application. Posséder un compte utilisateur DM Fax Client dédié au serveur web de Use It Messaging Server. Ce compte utilisateur devra posséder les droits «Administrateur». Les clients web : Tous les utilisateurs de Use It Messaging Server doivent domaine NT à défaut de pouvoir être tous authentifiés. appartenir au même Chaque client devra posséder son propre compte fax ou utiliser un compte fax «Invité». Les clients doivent être équipés du navigateur Internet Explorer version 3.02 et supérieures, ou, du navigateur Netscape version 3.0 et supérieures. Use It Messaging Server est uniquement supporté, en mode Java, par les navigateurs Netscape à partir de la version 4.06 et Internet Explorer 5.0. En ce qui concerne Internet Explorer 6.0, il est nécessaire de mettre à jour la virtuelle machine. 4.2 - Procédure d'installation du DM Web Client L'installation de Web s'effectue en suivant les 3 étapes ci-dessous : Installation des fichiers programme sur le serveur de fichiers. Installation du serveur web (Installation du logiciel SoftArtisans, Installation et paramétrage de Use It Messaging Application Connector, Installation de Use It Messaging Client Web. Paramétrage du site web de Web. 7/43
4.2.1 - Installation des fichiers programmes Suivez la procédure décrite ci-dessous pour installer les fichiers du programme à partir du CD-ROM. Remarquez que vous ne pouvez pas exécuter les programmes Imecom à partir du CD-ROM. L'installation de ces fichiers effectue la création et la mise à jour d'un fichier de configuration central (Config.cfg). Celui-ci répertorie chaque module et version de module installé. Il est mis à jour lors de l'installation d'un nouveau produit ou lors d'une actualisation des versions. Attention : Le ficher Config.cfg est utilisé par le système, il ne doit être ni modifié, ni détruit manuellement. Installation des fichiers programmes sur le serveur de fichiers : Insérez le CD-ROM «Web» d'imecom dans votre lecteur CD-ROM. Suivez les instructions correspondant à votre cas de figure : Si l'autorun s'est lancé : Sélectionnez «Installation du produit». Si aucun autorun n'est lancé : Sélectionnez la commande Exécuter dans le menu Fichier du Gestionnaire de programmes. Saisissez d:\intfax\i386\setup.exe (d: correspond au lecteur de CD-ROM) et cliquez sur OK. La boîte de dialogue d'accueil apparaît. Après avoir lu les notes d'introduction et les contraintes d'installation, cliquez sur Suivant. La boîte de dialogue Répertoire d'installation apparaît. Le champ Répertoire principal d'installation doit être déjà renseigné par le chemin d'accès complet au répertoire d'installation des fichiers de programme du DM Server déjà installé sur la machine. Le chemin de cette arborescence est indiqué dans la registry par la valeur : HKEY_LOCAL_MACHINE/SOFTWARE/Imecom/IntFax/NetRootPath. Cliquez sur Installer pour lancer la procédure de copie. 8/43
4.2.2 - Installation sur le serveur Web L'installation sur le serveur web, s'effectue selon les trois opérations suivantes : Installation du logiciel SoftArtisans. Installation et paramétrage de DM Application Connector. Installation de l'application Web. 4.2.2.1 - Installation du logiciel SoftArtisans SoftArtisans est un logiciel redistribuable placé dans le répertoire :...\Ifbin\i386\Redist\softarti du serveur de fichiers de DM Server lors de la copie des fichiers programme (étape 1). Attention : Cette version installée de SoftArtisans, nécessaire à l'utilisation de Use It Messaging Cmient Web d'imecom, a une durée de vie limitée. Nous vous conseillons d'acquérir la licence ou, de vous procurer une mise à jour à l'adresse suivante : http://www.softartisans.com. Depuis le serveur de fichiers de Use It Messaging Server : 1. Sélectionnez, depuis l'explorateur, le répertoire...\ifbin\i386\redist\softarti. 2. Double-cliquez le programme d'installation SETUPSVR.EXE. 3. La boîte de dialogue d'accueil de SoftArtisans apparaît. Cliquez sur le bouton Suivant après avoir pris connaissance des notes d'introduction. 4. La boîte de dialogue d'agrément de licence apparaît. Après avoir lu les termes du contrat de licence, cliquez sur Yes. 5. La boîte Setup Type apparaît. Sélectionnez le type Compact - For use on a production server puis cliquez sur Next. 6. Depuis la boîte Select Program Folder qui s'est affichée, sélectionnez le groupe de programmes de SoftArtisans qui vous est proposé puis cliquez sur Next. La dernière boîte de dialogue s'affiche, cliquez sur Finish pour terminer l'installation. 9/43
4.2.2.2 - Installation et paramétrage de Use It Messaging Application Connector Les quelques fichiers programme du DM Application Connector, nécessaires au fonctionnement dude Web, ont été copiés automatiquement lors de l'étape 1. Depuis la machine du serveur web : Sélectionnez, depuis l'explorateur, le répertoire...\ifbin\i386 du serveur de fichiers. Double-cliquez le programme d'installation SETUPSVR.EXE La boîte de dialogue d'accueil d'imecom de Use It Messaging Server apparaît. Cliquez sur le bouton Suivant après avoir pris connaissance des instructions. La boîte Installation/Désinstallation des services apparaît. Cette boîte de dialogue affiche les services installés, à installer ou à désinstaller. Elle indique le répertoire principal d'installation des fichiers de l'application. Les services disponibles qui peuvent être installés (non grisés) sont ceux pour lesquels les fichiers programme correspondants auront été copiés (étape 1) dans le répertoire principal du serveur de fichiers de Web. 10/43
Remarque : Les noms de service déjà cochés indiquent leur installation locale. Le service «Contrôleur» apparaît toujours coché mais grisé, s'il est installé sur une machine distante. Sélectionnez DM Application Connector parmi les services à installer. Sélectionnez DM Application Connector parmi les services à installer. Cliquez sur Suivant. La boîte de dialogue Contrôle des services permet d'indiquer le compte utilisateur affecté au démarrage du service de DM Application Connector. 11/43
Renseignez la boîte de dialogue selon les indications données ci-après : Nom de l'utilisateur : Nom du compte utilisateur dédié au démarrage des services de DM Server et de ses options. En l'occurrence, de DM Application Connector. Nom de domaine : Nom de la machine ou du domaine dans lequel est déclaré le compte utilisateur saisi précédemment. Mot de passe et Confirmation du mot de passe : Mot de passe du compte utilisateur saisi précédemment. Un mot de passe fictif est inscrit par défaut afin d'obliger l'installateur à en saisir un nouveau. Cliquez sur Suivant. Avant le terme de l'installation, la boîte de dialogue d'administration de Use It Messaging Application Connector s'affiche : 12/43
Dans la zone Etats des sorties, cliquez sur la sortie Fax pour l'activer. L'icône verte indique que la sortie sélectionnée est opérationnelle. Depuis l'écran principal, dans la zone Configuration, cliquez sur le bouton Paramètres. 13/43
Depuis l'onglet Soumission, indiquez dans le champ Répertoire (des fichiers de soumission) le chemin UNC du répertoire de dépose des fichiers de DM Application Connector à l'aide du bouton Ajouter pour parcourir l'arborescente. Cliquez sur OK pour valider tous les nouveaux paramètres de Use It Messaging Application Connector. Validez l'écran vous indiquant le succès de l'installation. 14/43
4.2.2.3 - Installation de Web L'installation de Web doit être effectuée sur le serveur web où s'exécute Internet Information Server 4. Depuis la machine du serveur web : Sélectionnez, depuis l'explorateur, le répertoire...\ifbin\i386 du serveur de fichiers. Double-cliquez le programme d'installation SETUPSVR.EXE La boîte de dialogue d'accueil d'imecom du DM Server apparaît. Cliquez sur le bouton Suivant après avoir pris connaissance des instructions. La boîte Installation/Désinstallation des services apparaît. Cette boîte de dialogue affiche les services installés, à installer ou à désinstaller. Elle indique le répertoire principal d'installation des fichiers de l'application. Les services disponibles pouvant être installés (non grisés) sont ceux pour lesquels les fichiers programme correspondants auront été copiés (étape 1) dans le répertoire principal du serveur de fichiers de Use It Messaging Server. Remarque : Les noms de service déjà cochés indiquent leur installation locale. Le service «Contrôleur» apparaît toujours coché mais grisé, s'il est installé sur une machine distante. 15/43
Cochez Web Client parmi les services à installer. Cliquez sur Suivant. La boîte de dialogue Contrôle des services permet d'indiquer le compte utilisateur affecté au démarrage du service de Use It Messaging Application Connector. Complétez les champs (voir description ci-dessous) puis cliquez sur Suivant. Nom de l'utilisateur : Nom du compte utilisateur dédié au démarrage des services de DM Server et de ses options. En l'occurrence, du DM Web Client. Nom de domaine : Nom de la machine ou du domaine dans lequel est déclaré le compte utilisateur saisi précédemment. Mot de passe et Confirmation du mot de passe : Mot de passe du compte utilisateur saisi précédemment. Un mot de passe fictif est inscrit par défaut afin d'obliger l'installateur à en saisir un nouveau. Depuis la boîte de dialogue Paramètres du DM Web Client, dans le champ Choix de la machine, choisissez dans la liste, le nom de machine où le service du Use It Messaging Application Connector a été installé. 16/43
Dans le champ Choix du site Internet, choisissez dans la liste, l'option Site Web par défaut. Dans la zone Répertoire Internet Virtuel, modifiez ou conservez le nom du répertoire proposé par défaut. Vous pouvez également vider ce champ de toute information si vous souhaitez installer ce serveur web à la racine du répertoire Internet. Renseignez la zone Domaine utilisateur Web par le nom du domaine NT auquel tous les utilisateurs et futurs utilisateurs de Web doivent appartenir. Seuls les utilisateurs appartenant au domaine indiqué dans ce champ pourront être authentifiés. Cliquez sur Suivant. 17/43
4.2.3 - Le paramétrage du site web de Web Pour accédez à l'administration MMC d'internet Information Server 4 : Depuis le groupe de programmes Windows NT 4.0 Option Pack, sélectionnez Gestionnaire des services Internet dans Microsoft Internet Information Server. Sélectionnez Site Web par défaut. 18/43
4.2.4 - Paramétrage du répertoire virtuel DMWEB Depuis l'administration d'internet Information Server 4, sélectionnez le répertoire «DMWeb» nouvellement créé et placé dans le dossier Site Web par défaut. Dans le menu Action, sélectionnez la commande Propriétés, la fenêtre Propriétés de DMWeb apparaît. Sélectionnez l'onglet Documents afin de paramétrer la page de Web qui sera affichée par défaut. Vérifiez que l'option Activer le document par défaut est cochée : 19/43
Si Default.asp n'apparaît pas dans la liste : Cliquez sur Ajouter, saisissez Default.asp puis validez. Si Default.asp est présent dans la liste, placez le, si besoin, en première position à l'aide des flèches. Validez 20/43
4.2.5 - Accès à Web Depuis votre navigateur, saisissez l'adresse Internet ou Intranet du site IfWeb à atteindre : Pour la première session, saisissez vos login et mot de passe dans la boîte d'identification qui s'est affichée : Après identification, la page HTML du DM Web Client se charge : 21/43
Pour l'utilisation du DM Web Client, consultez l'aide en ligne en cliquant sur : 22/43
5 - Configuration de l'authentification intégrée pour le client Web 5.1 - Paramétrages du client Web Installation du client Web Lors du lancement de l'installation du client web, laissez le champ répertoire virtuel à vide et choisir un site. Dans le cas où le client web aurait déjà été installé dans un répertoire virtuel, paramétrer 2is de la façon suivante : Faire pointer le site web (ici le site web par défaut) sur imeweb. Créez l'application "imeweb3": Sur la configuration de l'application, activer les chemins relatifs (normalement pris en charge par le setup du client web à partir de la version 7.31 R3) : 23/43
Activation de l'authentification intégrée Activez l'authentification intégrée au niveau du site : 24/43
Choisissez data et data/logon pour appliquer la nouvelle authentification 25/43
Modifiez le fichier "global.asa" sous data pour activer l'authentification intégrée au niveau du client web (WindowsAuthentication= TRUE) : 26/43
5.2 - Paramétrage du poste client Lors de la première connexion à partir de Internet Explorer 5 ou 6, une authentification peut-être demandée. Suite à cette authentification, ajoutez dans les sites web de l'intranet local, le client web : Par défaut, le niveau de sécurité dans cette zone est : 27/43
28/43
5.3 - Création automatique du compte fax Activer à partir d'un compte administrateur, la création automatique des comptes fax dans le client web : Valider la configuration Avec la création du compte automatique, la première connexion se déroule de la façon suivante : Choisissez la langue : 29/43
Entrez le nom et le prénom du nouvel utilisateur: Ces informations sont utilisées pour créer l'utilisateur fax. 30/43
Le compte fax créé est le suivant : 31/43
La page préférence est ensuite présentée : 32/43
Après validation, la page "fax reçus" est affichée : Lors de la prochaine connexion, cette page sera la première page affichée. 33/43
5.4 - Problèmes pouvant être rencontrés Après avoir saisi les informations de l'utilisateur, la page suivante est affichée: Pour avoir plus d'informations, activezles traces avec l'url suivante: http:///data/trace/trace2.asp Récupérez le fichier trace sous firmax\imeweb\data\trace\imetrace.txt. Dans le cas présent, l'erreur est : Dans le cas où une erreur persisterait, il est possible de désactiver la vérification du compte dans la sam. Créez la valeur CheckUserInSAM est l'initialiser à 0 : 34/43
35/43
6 - Tech Issues 6.1 - Désinstallation et réinstallation du client Web Lors d'une désinstallation/réinstallation, l'erreur suivante peut apparaître : Cause Le composant ImeWeb3 n'a pas été supprimé lors de la désinstallation. Résolution Supprimez le composant imweb3, manuellement sous MTS, puis relancez le setup. 36/43
6.2 - Erreur serveur sur le client Web Lorsque la page Emission est choisie, l'erreur suivante apparaît : Cause Ceci peut être dû à un problème de droits pour le compte choisi dans MTS. Résolution Vérifiez les droits et en particulier les paramètres 37/43
Pour le reste, un utilisateur appartenant au groupe utilisateur du domaine doit suffire. 38/43
Pour certaine configuration, opter pour un user du groupe administrateur. Note : Lors de la mise à jour des droits, il est recommandé de rebooter la machine pour être sûr que la modification a bien été répercutée. Pour le compte ayant servit à l'installation du client Web, il doit également posséder le privilège "d'ouvrir une session en tant que tâche". Si cette condition n'est pas respectée, vous obtenez l'erreur "DEFAULT.ASP, vous retrouverez également un message d'erreur dans le journal application de source COM+ expliquant un plantage de l'objet IMEWEB3. Pour les utilisateurs, l'appartenance au groupe utilisateur du domaine suffit à condition que ce groupe possède le privilège "d'ouvrir une session" sur le serveur hébergeant IIS, sans ce privilège, l'authentification sur IIS est impossible et vous obtenez le message "ACCES REFUSE". 39/43
6.3 - Erreur sur Default.asp L'utiilisateur s'authentifie, l'erreur suivante apparaît : Cause Ceci peut être dû à un problème de droits pour le compte choisi dans MTS. Résolution Vérifiez les droits et en particulier les paramètres. 6.4 - Problème patch sécurité et 2000 2is Tous les patchs sécurité 2000. Erreur pages asp, error 'asp 031' Chemin parents non autorisé Cause et résolution Vérifiez l'option Activer les chemins sur le répertoire virtuel. 40/43
6.5 - Visualisation des fax dans les en-cours Impossible de visualiser les fax dans les en-cours Cause et résolution Sous 2is 2003, ajouter une extension FAX dans la liste des types MIME du site : 41/43
De plus, au niveau du client, décochez la confirmation à l'ouverture : 42/43
6.6 - Mode java sous 2003/XP Pas de chargement de l'applet java Cause et résolution LA VM Microsoft n'est plus installé sous XP ou 2003, il existe plusieurs solutions : Installer le java SDK Microsoft et les mises à jour : Cette combinaison n'a pas été testée à ce jour. Installer la Sun Java Virtual Machine (JVM) : Cette combinaison a été testée et elle fonctionne (14 Mo de téléchargement, 65 Mo après installation). Pour plus d'informations : http://java-virtual-machine.net/download.html 6.7 - Visualisation des en-cours et du Time-out de session A partir de la vue En-cours, l'utilisateur après le Time-out de session (20 minutes par défaut) lance une nouvelle action, type «Renvoyer» ; dans ce cas, le fichier généré ne contient pas le préfixe utilisateur. Cause et résolution Fermez le client web et relancez le. Dans une prochaine version, le Time-Out de session sur les en-cours, affichera automatiquement la page de login. 43/43