Guide d`installation d`eRoom Instant Messaging Integration
Transcription
Guide d`installation d`eRoom Instant Messaging Integration
Guide d'installation d’eRoom Instant Messaging Integration Services Version 1.3 Copyright © 1994-2007 EMC Corporation. Tous droits réservés. Sommaire SOMMAIRE Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . À propos d’eRoom Instant Messaging Integration Services . . . . . . . . Composants de eRoom Instant Messaging Integration Services . . . . . . Configuration requise. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Présentation de l'installation d’eRoom Instant Messaging Integration Services Préparation de l'installation de l'eRoom Instant Messaging Integration Services Extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation de l'eRoom Instant Messaging Integration Services Extension . . . Pour installer la passerelle IM d’eRoom . . . . . . . . . . . . . . . . . . . Configuration de la passerelle IM d’eRoom . . . . . . . . . . . . . . . . . . . . Configuration de la messagerie instantanée dans eRoom . . . . . . . . . . . . Paramètres du site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Mappage de l'adresse IM vers un champ LDAP . . . . . . . . . . . . . . . Pour plus d'informations . . . . . . . . . . . . . . . . . . . . . . . . . . . . Notes relatives au dépannage . . . . . . . . . . . . . . . . . . . . . . . . . Guide d'installation des Services d'intégration de messagerie instantanée d'eRoom . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 1 2 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 4 5 6 7 8 8 9 9 iii Sommaire iv Guide d'installation des Services d'intégration de messagerie instantanée d'eRoom Introduction Introduction Ce document décrit comment installer l'eRoom Instant Messaging Integration Services Extension. Il précise également la configuration système requise et contient d'autres informations sur la configuration nécessaire pour l'installation du serveur et l'exécution des eRoom Instant Messaging Integration Services. À propos d’eRoom Instant Messaging Integration Services eRoom Instant Messaging Integration Services permet aux participants d'eRoom de bénéficier au maximum de la vitesse, du confort et du caractère multi-directionnel de la messagerie intantanée (IM) pour aider les équipes d'un projet à communiquer de façon efficace et à en retirer des résultats fructueux. Grâce à eRoom Instant Messaging Integration Services, eRoom peut bénéficier de l'infrastructure existante en matière de messagerie instantanée pour : ■ afficher la présence des participants au projet dans la messagerie instantanée; ■ faciliter les discussions en messagerie instantanée urgente avec d'autres membres de l'équipe ; ■ envoyer des alertes et des notifications IM à plusieurs équipes. Composants de eRoom Instant Messaging Integration Services eRoom Instant Messaging Integration Services est constitué des deux composants suivants : ■ l'eRoom Instant Messaging Integration Services Extension (également appelée « passerelle IM d’eRoom »), qui est installée séparément du programme d'installation d'eRoom ; ■ IMlogic IM Manager 7. Guide d'installation des Services d'intégration de messagerie instantanée d'eRoom 1 Configuration requise Configuration requise Pour utiliser eRoom Instant Messaging Integration Services, vous avez besoin d'une infrastructure de messagerie instantanée d'entreprise existante. Une infrastructure IM prise en charge comporte les éléments suivants : Configuration requise Description Réseaux de messagerie instantanée Microsoft Live Communications Server 2005, Enterprise Edition SP1 Clients de messagerie instantanée Microsoft Windows Messenger 5.1 Remarque : la configuration par défaut de Live Communications Server (LCS) 2005 Enterprise SP1 contient un filtre qui empêche eRoom d'envoyer un IM contenant un lien. Vous devez supprimer ou modifier le filtre de l'URL IM afin que les utilisateurs puissent recevoir des messages instantanés contenant des liens vers eRooms. Vous pouvez le faire à l'aide du composant logiciel enfichable Live Communications Server, puis redémarrer ensuite le service LCS. Présentation de l'installation d’eRoom Instant Messaging Integration Services Pour qu’eRoom Instant Messaging Integration Services fonctionne sur votre site, voici une présentation des étapes à suivre, dans l'ordre que vous devez respecter : 1. Installez IMlogic IM Manager 7. Pour plus d'informations, consultez la documentation d'IMlogic, notamment le guide IM Manager Installation Guide (Guide d'installation du IM Manager). 2. Installez l'eRoom Instant Messaging Integration Services Extension, également nommée dans ce document « passerelle IM d’eRoom ». Reportez-vous à “Pour installer la passerelle IM d’eRoom” , page 5. 2 Guide d'installation des Services d'intégration de messagerie instantanée d'eRoom Préparation de l'installation de l'eRoom Instant Messaging Integration Services Extension 3. Configurez la passerelle IM d’eRoom avec IM Manager en utilisant l'IM Manager Administrator UI. Reportez-vous à “Configuration de la passerelle IM d’eRoom” , page 6. 4. Configurez les paramètres du site eRoom devant utiliser la passerelle IM d’eRoom. Reportez-vous à “Configuration de la messagerie instantanée dans eRoom” , page 7. Remarques : ■ La configuration par défaut d’IM Manager suppose que le serveur LCS et le serveur d’IM Manager se trouvent sur la même machine. Si ce n'est pas le cas, indiquez le nom du serveur et le port corrects dans le fichier IMmLinkage.xml , de la façon suivante : Dans C:\Program Files\IMlogic\IMLinkage\config\IMLinkage.xml, recherchez <!-- nom d'hôte ou adresse IP du serveur LCS --> <serveur>localhost</serveur> <!-- port du serveur LCS --> <port>5059</port> Changez localhost en nom de la machine (ou nom du pool, avec Enterprise) de votre serveur LCS (machine). Changez également 5059 en 5060. ■ La machine de la passerelle IM doit également se trouver dans le même domaine que la machine LCS. Préparation de l'installation de l'eRoom Instant Messaging Integration Services Extension Avant d'installer l'eRoom Instant Messaging Integration Services Extension (passerelle IM), vérifiez que vous disposez des informations suivantes, nécessaires au programme d'installation : ■ Chemin d'accès du répertoire où vous allez installer la passerelle IM. Valeur par défaut C:\Program Files\eRoom Server\Instant Messaging Gateway. Guide d'installation des Services d'intégration de messagerie instantanée d'eRoom 3 Installation de l'eRoom Instant Messaging Integration Services Extension ■ Nom d'utilisateur et mot de passe local que le programme d'installation peut créer. Installation de l'eRoom Instant Messaging Integration Services Extension Le programme d'installation de la passerelle IM est distinct du programme d'installation d'eRoom, et doit être exécuté sur la machine sur laquelle IM Manager est installé. Avant d'entamer la première étape de l'installation, le programme d'installation vérifie les points suivants : ■ serveur d’IM Manager-- S'il ne le trouve pas, le programme d'installation s'arrête et l'erreur suivante apparaît : « The installation cannot proceed because the IMlogic IM Manager server cannot be found. The instant messaging gateway must be installed on the machine where the IMlogic IM Manager server is installed. » (L'installation ne peut se poursuivre car le serveur du IMlogic IM Manager est introuvable. La passerelle de messagerie instantanée doit être installée sur la même machine que le serveur du IMlogic IM Manager .) ■ .Net Framework v1.1 -- S'il ne le trouve pas, le programme d'installation s'arrête et l'erreur suivante apparaît : « The installation cannot proceed because .Net Framework v1.1 is not installed on this machine. Please install .Net Framework v1.1 and run the instant messaging gateway installer again. » (L'installation ne peut se poursuivre car .Net Framework v1.1 n'est pas installé sur cette machine. Veuillez installer .Net Framework v1.1 et exécuter à nouveau le programme d'installation de la passerelle de messagerie instantanée.) 4 Guide d'installation des Services d'intégration de messagerie instantanée d'eRoom Installation de l'eRoom Instant Messaging Integration Services Extension Pour installer la passerelle IM d’eRoom Suivez les étapes ci-après pour installer l'eRoom Instant Messaging Integration Services Extension, ou la passerelle IM : 1. Dans le centre de téléchargement d’EMC (https://emc.subscribenet.com) téléchargez le produit eRoom Instant Messaging Integration Services (InstantMessageGateway.exe). 2. Double-cliquez sur le fichier InstantMessageGateway.exe que vous avez téléchargé pour lancer l'installation de la passerelle IM. 3. Dans la page de bienvenue, cliquez sur Next (Suivant). 4. Dans la page License Agreement (Contrat de licence), lisez le contrat de licence jusqu'au bout. Cliquez sur Yes (Oui) pour accepter les termes de la licence et poursuivre l'installation. 5. Dans la page Destination Folder (Dossier de destination), indiquez où vous voulez installer la passerelle. Valeur par défaut C:\Program Files\eRoom Server\Instant Messaging Gateway. Cliquez sur Next (Suivant) pour continuer. 6. Dans la page Choose Website (Sélection du site Web), sélectionnez le site Web dans lequel vous voulez qu'eRoom crée les racines virtuelles de la passerelle IM. Le site Web par défaut est sélectionné à l'origine. Cliquez sur Next (Suivant) pour continuer. Une boîte de dialogue s'ouvre et affiche le message indiquant que SSL doit être activé pour le serveur sur lequel vous installez la passerelle IM. Cliquez sur OK pour ignorer ce message. 7. Dans la page Set Up the Instant Message Getaway Account (Définir le compte de la passerelle de la messagerie instantanée), indiquez un compte d'utilisateur Windows que le serveur eRoom utilisera pour se connecter à la passerelle IM d’eRoom. (Veuillez noter le nom du compte et le mot de passe car vous aurez besoin de ces informations ultérieurement pour les paramètres du site.) Cliquez sur OK. Le programme d'installation crée le compte s'il n'existe pas. Si ce compte parvient à se connecter correctement, vous passez à l'étape suivante. Guide d'installation des Services d'intégration de messagerie instantanée d'eRoom 5 Configuration de la passerelle IM d’eRoom 8. Dans la page Ready to Install the Program (Prêt pour installer le programme), vous pouvez vérifier vos paramètres ou poursuivre l'installation. ❒ Pour vérifier ou modifier des paramètres, cliquez sur Back (Précédent). ❒ Si ces paramètres vous conviennent, cliquez sur Next (Suivant) pour commencer la copie des fichiers du programme. 9. Lorsque le programme d'installation a terminé de copier les fichiers, l'installation est terminée et vous pouvez cliquer sur Finish (Terminer). Remarques : ■ Le programme d'installation place un fichier nommé ERIMEngine.ima sur le serveur de la passerelle IM dans C:\Program Files\eRoom Server\Instant Messaging Gateway\. IM Manager a besoin de ce fichier pour installer l'extension IM (passerelle). ■ La racine virtuelle ERIMGateway est configurée pour utiliser l'authentification intégrée de Windows. ■ Le compte de la machine .Net et le compte d'authentification IM (celui que vous allez saisir dans les paramètres du site) ont un accès en lecture au répertoire mappé vers la racine virtuelle ERIMGateway. À présent, vous êtes prêt à configurer la passerelle IM en utilisant l'IM Manager Administrator UI, comme indiqué à la section suivante. Configuration de la passerelle IM d’eRoom Suivez les étapes ci-après pour configurer la passerelle IM d’eRoom : 1. Connectez-vous à l'interface utilisateur de l'IM Manager Administrator UI (Démarrer> Programmes > IMlogic > IM Manager Administrator UI). 2. Dans le volet de gauche, développez Extensions et cliquez sur Add Extension (Ajouter une extension) pour ouvrir la boîte de dialogue Add Extension (Ajouter une extension). 3. Remplissez la boîte de dialogue Add Extension (Ajouter une extension) de la façon suivante : ❒ Dans Display Name (Nom d'affichage), saisissez « ERIMEngine ». 6 Guide d'installation des Services d'intégration de messagerie instantanée d'eRoom Configuration de la messagerie instantanée dans eRoom ❒ Dans Extension Type (Type d'extension), sélectionnez identity (identité). ❒ Cochez la case Enabled (Activé). ❒ Dans Deployment location (Lieu du déploiement), sélectionnez One Relay (Un relais) et saisissez son nom, en général celui de la machine. ❒ Ne remplissez pas Custom configuration (Configuration personnalisée). ❒ Dans File Package location (Emplacement de l'ensemble de fichiers), cliquez sur Browse (Parcourir) et recherchez le fichier ERIMEngine.ima installé avec la passerelle IM. La valeur par défaut du chemin de ce fichier est C:\Program Files\eRoom Server\Instant Messaging Gateway\ERIMEngine.ima. ❒ Cliquez sur Submit (Envoyer) pour installer le fichier .ima. 4. Activez le fichier .ima en redémarrant le relais de la façon suivante : ❒ Accédez à Services. ❒ Redémarrez le service IMLogRelayService. Remarque : si le relais ne démarre pas, vérifiez les paramètres de configuration (stockés dans le fichier appconfig.xml) pour vérifier si le format XML est correct et si les paramètres sont valides. 5. Pour afficher l'état de l'extension, accédez à la page Extensions Dashboard (Tableau de bord des extensions) de l'interface utilisateur de l'administrateur. (Dans le volet de gauche de l'IM Manager Administrator UI, développez Extensions, puis cliquez sur Extensions Dashboard (Tableau de bord des extensions).) Configuration de la messagerie instantanée dans eRoom Les services de messagerie instantanée d'eRoom fonctionnent avec eRoom Server version 7.3 ou ultérieure. Guide d'installation des Services d'intégration de messagerie instantanée d'eRoom 7 Configuration de la messagerie instantanée dans eRoom Paramètres du site Après avoir 1) installé IM Manager, 2) installé la passerelle IM d’eRoom, et 3) configuré la passerelle IM d’eRoom avec IM Manager, accédez aux paramètres du site eRoom pour terminer l'installation. Pour ouvrir les paramètres du site, procédez comme suit : ■ Dans la page Mes eRooms, cliquez sur Paramètres du site dans la section Administration. ■ Sur votre machine locale, utilisez le module Microsoft Management Console (MMC) d'eRoom en choisissant Démarrer > Programmes > Administration d'eRoom > Administration du serveur eRoom. Pour plus d'informations sur la gestion des paramètres à l'échelle du site de la messagerie instantanée dans eRoom, reportez-vous à la section Paramètres du site : Messagerie instantanée de la rubrique Administration du site de l'aide d'EMC Documentum eRoom 7. Mappage de l'adresse IM vers un champ LDAP Pour mapper les adresses IM des membres d'eRoom vers un champ LDAP, vous pouvez procédez comme suit : 1. Créez des identités IM sur la page Paramètres du site. Cette procédure est décrite dans la section Paramètres du site : Messagerie instantanée de la rubrique Administration du site de l'aide d'eRoom 7. 2. Dans la page Mappage des champs de l'assistant Connexion de répertoire, vérifiez que le mappage de l'adresse IM est correct. Cette page est décrite dans la procédure Pour ajouter une connexion de répertoire LDAP de la rubrique Répertoires d'entreprise de l'aide d'eRoom 7. 3. Exécutez la synchronisation de répertoire afin de synchroniser le champ de l'adresse IM des membres d'eRoom. Cette tâche est décrite dans la section Synchronisation de la liste des membres de la rubrique Répertoires d'entreprise de l'aide d'eRoom 7. 8 Guide d'installation des Services d'intégration de messagerie instantanée d'eRoom Configuration de la messagerie instantanée dans eRoom Pour plus d'informations Pour plus d'informations sur la messagerie instantanée dans eRoom, consultez la rubrique Messagerie instantanée dans eRoom de l'aide d'eRoom 7, que vous pouvez ouvrir en cliquant sur dans la barre de commande qui se trouve en haut des pages eRoom. Visitez le site EMC Software CustomerNET (http:// softwaresupport.emc.com) pour télécharger des documentations supplémentaires, accéder à la base de connaissances du support technique et obtenir les toutes dernières informations sur le produit. Notes relatives au dépannage ■ Pour les erreurs d’IM Manager, consultez l'Observateur d'événements. ■ Pour les erreurs relatives aux extensions chargées, vérifiez <%SystemDrive%>\IMLinkage.log (par exemple, C:\IMLinkage.log). Guide d'installation des Services d'intégration de messagerie instantanée d'eRoom 9 Configuration de la messagerie instantanée dans eRoom 10 Guide d'installation des Services d'intégration de messagerie instantanée d'eRoom