Guida all'installazione di eroom Instant Messaging Integration Services Versione 1.3
Copyright 1994-2007 EMC Corporation. Tutti i diritti riservati.
Sommario SOMMARIO Introduzione........................................... 1 Informazioni su eroom Instant Messaging Integration Services........... 1 Componenti di eroom Instant Messaging Integration Services........... 1 Requisiti di sistema....................................... 2 Panoramica sull'installazione di eroom Instant Messaging Integration Services.... 2 Preparazione dell'installazione di eroom Instant Messaging Integration Services Extension........................................... 3 Installazione di eroom Instant Messaging Integration Services Extension........ 4 Per installare il gateway IM di eroom......................... 5 Configurazione del gateway IM di eroom.......................... 6 Configurazione della messaggistica immediata in eroom................. 7 Impostazioni del sito................................... 8 Mappatura di un indirizzo IM a un campo LDAP................... 8 Per ulteriori informazioni................................. 9 Note sulla risoluzione dei problemi........................... 9 Guida all'installazione di eroom Instant Messaging Integration Services iii
Sommario iv Guida all'installazione di eroom Instant Messaging Integration Services
Introduzione Introduzione Nel presente documento viene descritta la procedura di installazione di eroom Instant Messaging Integration Services Extension e vengono fornite le informazioni relative ai requisiti di sistema e alla configurazione necessarie per installare il server ed eseguire eroom Instant Messaging Integration Services. Informazioni su eroom Instant Messaging Integration Services eroom Instant Messaging Integration Services consente ai partecipanti a una eroom di sfruttare la velocità e la semplicità della messaggistica immediata per consentire ai team di progetto di comunicare in modo efficace per la realizzazione del progetto. Grazie a eroom Instant Messaging Integration Services, è possibile avvalersi dell'infrastruttura di messaggistica immediata esistente di un'organizzazione per svolgere le seguenti attività: Visualizzare la presenza dei partecipanti al progetto mediante la messaggistica immediata. Semplificare le discussioni di messaggistica immediata con altri membri del team. Inviare avvisi e notifiche di messaggistica immediata ai team distribuiti. Componenti di eroom Instant Messaging Integration Services eroom Instant Messaging Integration Services include i due componenti indicati di seguito. eroom Instant Messaging Integration Services Extension (denominato anche "gateway IM di eroom"), installato separatamente dal programma di installazione di eroom. IMlogic IM Manager 7. Guida all'installazione di eroom Instant Messaging Integration Services 1
Requisiti di sistema Requisiti di sistema Per utilizzare eroom Instant Messaging Integration Services, è necessario disporre di un'infrastruttura aziendale di messaggistica immediata. Di seguito sono riportate le infrastrutture IM supportate. Requisito Descrizione Reti di messaggistica immediata Microsoft Live Communications Server 2005, Enterprise Edition SP1 Client di messaggistica immediata Microsoft Windows Messenger 5.1 Nota: nella configurazione predefinita di Live Communications Server (LCS) 2005 Enterprise SP1 è presente un filtro che impedisce a eroom di inviare un messaggio immediato contenente un collegamento. Per consentire agli utenti di ricevere i messaggi contenenti collegamenti alle eroom, è necessario rimuovere o modificare il filtro URL IM. Tale operazione può essere effettuata utilizzando lo snap-in di Live Communications Server e successivamente riavviando il servizio LCS. Panoramica sull'installazione di eroom Instant Messaging Integration Services Di seguito sono descritti i passaggi necessari per installare correttamente eroom Instant Messaging Integration Services e l'ordine in cui effettuarli. 1. Installare IMlogic IM Manager 7. Per informazioni dettagliate, fare riferimento alla documentazione di IMlogic, inclusa la guida IM Manager Installation Guide. 2. Installare eroom Instant Messaging Integration Services Extension, che nel presente documento è anche denominato "gateway IM di eroom". Consultare la sezione Per installare il gateway IM di eroom a pagina 5. 2 Guida all'installazione di eroom Instant Messaging Integration Services
Preparazione dell'installazione di eroom Instant Messaging Integration Services Extension 3. Configurare il gateway IM di eroom con IM Manager utilizzando l'interfaccia IM Manager Administrator UI. Consultare la sezione Configurazione del gateway IM di eroom a pagina 6. 4. Impostare il sito di eroom per l'utilizzo del gateway IM di eroom. Consultare la sezione Configurazione della messaggistica immediata in eroom a pagina 7. Note Nella configurazione predefinita di IM Manager è necessario che i server LCS e IM Manager siano installati sullo stesso computer. In caso contrario, specificare il nome server e la porta corretti nel file IMmLinkage.xml, nel modo indicato di seguito. In C:\Programmi\IMlogic\IMLinkage\config\IMLinkage.xml, individuare quanto segue: <!-- hostname or ip address of LCS server --> <server>localhost</server> <!-- port of LCS server --> <port>5059</port> Sostituire localhost con il nome del computer (o con il nome del pool, se si tratta di un'azienda) su cui è installato il server LCS. Modificare anche 5059 in 5060. Inoltre, è necessario che il gateway IM si trovi nello stesso dominio del computer LCS. Preparazione dell'installazione di eroom Instant Messaging Integration Services Extension Prima di installare eroom Instant Messaging Integration Services Extension (gateway IM), verificare che siano disponibili le informazioni richieste dal programma di installazione indicate di seguito. Il percorso della directory in cui sarà installato il gateway IM. La directory predefinita è C:\Programmi\eRoom Server\Instant Messaging Gateway. Guida all'installazione di eroom Instant Messaging Integration Services 3
Installazione di eroom Instant Messaging Integration Services Extension Un nome utente locale e una password che possano essere create dal programma di installazione. Installazione di eroom Instant Messaging Integration Services Extension Il programma di installazione del gateway IM è diverso dal programma di installazione di eroom e deve essere eseguito sul computer sul quale è installato IM Manager. Prima di iniziare l'installazione, mediante il programma di installazione vengono effettuati i controlli riportati di seguito. Server IM Manager: se non viene individuato, l'installazione si interrompe e viene visualizzato il seguente messaggio di errore: "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." (Impossibile continuare l'installazione in quanto il server IMlogic IM Manager non è stato individuato. È necessario che il gateway di messaggistica immediata sia installato sul computer sul quale è installato il server IMlogic IM Manager)..Net Framework v1.1: se non viene individuato, l'installazione si interrompe e viene visualizzato il seguente messaggio di errore: "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." (Impossibile continuare l'installazione..net Framework v1.1 non è installato su questo computer. Installare.NetFramework v1.1 ed eseguire nuovamente il programma di installazione del gateway di messaggistica immediata). 4 Guida all'installazione di eroom Instant Messaging Integration Services
Installazione di eroom Instant Messaging Integration Services Extension Per installare il gateway IM di eroom Per installare eroom Instant Messaging Integration Services Extension oppure il gateway IM, effettuare la procedura riportata di seguito. 1. Dal sito di download di EMC (https://emc.subscribenet.com), scaricare il prodotto eroom Instant Messaging Integration Services (InstantMessageGateway.exe). 2. Fare doppio clic sul file InstantMessageGateway.exe scaricato per avviare l'installazione del gateway IM. 3. Nella schermata iniziale fare clic su "Next" (Avanti). 4. Scorrere la schermata License Agreement (Contratto di licenza) per leggere il Contratto di licenza. Fare clic su "Yes" (Sì) per accettare i termini della licenza e procedere con l'installazione. 5. Nella schermata Destination Folder (Cartella di destinazione) specificare la cartella in cui si desidera installare il gateway. La directory predefinita è C:\Programmi\eRoom Server\Instant Messaging Gateway. Fare clic su "Next" (Avanti) per continuare. 6. Nella schermata Choose Website (Scegli sito Web) selezionare il sito Web in cui si desidera creare le directory principali virtuali per il gateway IM. Inizialmente è selezionato il sito Web predefinito. Fare clic su "Next" (Avanti) per continuare. Viene visualizzata una finestra di dialogo con un messaggio che indica che è necessario attivare SSL per il server sul quale si sta installando il gateway IM. Fare clic su "OK" per chiudere il messaggio. 7. Nella schermata Set Up the Instant Message Gateway Account (Configura account per il gateway IM) specificare un account utente Windows che sarà utilizzato dal server eroom per accedere al gateway IM di eroom. Annotare il nome utente e la password in quanto tali informazioni saranno necessarie in seguito per le impostazioni del sito. Fare clic su "Next" (Avanti). Il programma di installazione consente di creare l'account nel caso in cui non esista. Se, invece, è possibile effettuare l'accesso dall'account, andare al passaggio successivo. Guida all'installazione di eroom Instant Messaging Integration Services 5
Configurazione del gateway IM di eroom 8. La schermata Ready to Install the Program (È ora possibile installare il programma) consente di rivedere le impostazioni oppure di continuare l'installazione. Per rivedere oppure modificare le impostazioni, fare clic su "Back" (Indietro). Se non si desidera effettuare modifiche, fare clic su "Next" (Avanti) e avviare la copia dei file di programma. 9. Una volta terminata tale operazione, l'installazione è completa e quindi è possibile fare clic su "Finish" (Fine). Note Il programma di installazione inserisce un file denominato ERIMEngine.ima nel server gateway IM, nel seguente percorso: C:\Programmi\eRoom Server\Instant Messaging Gateway\. Tale file è necessario in IM Manager per installare l'estensione della messaggistica immediata (gateway). La directory principale virtuale ERIMGateway è impostata per l'utilizzo dell'autenticazione integrata di Windows. L'account.Net del computer e l'account di autenticazione IM (vale a dire quello immesso in Impostazioni del sito) ottengono l'accesso in lettura alla directory mappata alla directory principale virtuale ERIMGateway. A questo punto è possibile configurare il gateway IM mediante l'interfaccia IM Manager Administrator UI, come descritto nella sezione successiva. Configurazione del gateway IM di eroom Per configurare il gateway IM di eroom, effettuare la procedura riportata di seguito. 1. Accedere all'interfaccia IM Manager Administrator UI (Start > Programmi > IMlogic > IM Manager Administrator UI). 2. Nel riquadro a sinistra espandere Extensions (Estensioni) e fare clic su Add Extension (Aggiungi estensione) per aprire la finestra di dialogo corrispondente. 3. Compilare la finestra di dialogo Add Extension (Aggiungi estensione) come riportato di seguito. 6 Guida all'installazione di eroom Instant Messaging Integration Services
Configurazione della messaggistica immediata in eroom In Display Name (Nome visualizzato) digitare "ERIMEngine". In Extension Type (Tipo di estensione) scegliere "identity" (identità). Selezionare la casella di controllo Enabled (Attivata). In Deployment location (Percorso di distribuzione) scegliere "One Relay" (Un solo inoltro) e digitarne il nome (in genere corrisponde al nome del computer). Lasciare vuoto il campo Custom configuration (Configurazione personalizzata). In File Package location (Percorso pacchetto file) fare clic su "Browse" (Sfoglia) e andare al file ERIMEngine.ima installato con il gateway IM. Il percorso predefinito del file è il seguente: C:\Programmi\eRoom Server\Instant Messaging Gateway\ERIMEngine.ima. Fare clic su "Submit" (Invia) per installare il file ima. 4. Rendere effettivo il file ima avviando nuovamente l'inoltro come riportato di seguito. Andare a Services (Servizi). Riavviare il servizio IMLogRelayService. Nota: se non è possibile avviare l'inoltro, verificare le impostazioni di configurazione (memorizzate nel file appconfig.xml) per accertarsi che il formato XML sia corretto e che le impostazioni siano valide. 5. Per visualizzare lo stato dell'estensione, andare alla pagina Extensions Dashboard (Dashboard estensioni) dell'interfaccia Administrator UI. Nel riquadro di sinistra dell'interfaccia IM Manager Administrator UI, espandere Extensions (Estensioni) e fare clic su Extensions Dashboard (Dashboard estensioni). Configurazione della messaggistica immediata in eroom eroom Instant Messaging Services funziona con eroom Server versione 7.3 o successive. Guida all'installazione di eroom Instant Messaging Integration Services 7
Configurazione della messaggistica immediata in eroom Impostazioni del sito Dopo aver installato IM Manager, il gateway IM di eroom e aver configurato il gateway IM con IM Manager, andare a Impostazioni del sito di eroom per completare l'installazione. Per aprire Impostazioni del sito, effettuare una delle operazioni riportate di seguito. Dalla pagina eroom personali utente fare clic su "Impostazioni del sito" nella sezione Amministrazione. Nel computer locale utilizzare lo snap-in MMC di eroom (Start > Programmi > eroom Administration > eroom Server Administration). Per ulteriori informazioni sulla gestione delle impostazioni del sito per la messaggistica immediata in eroom, consultare la sezione Impostazioni dei siti: Messaggistica istantanea dell'argomento Amministrazione di siti nella Guida in linea di EMC Documentum eroom 7. Mappatura di un indirizzo IM a un campo LDAP Per mappare gli indirizzi IM dei membri di una eroom a un campo LDAP, è possibile effettuare la procedura riportata di seguito. 1. Creare identità IM nella pagina Impostazioni del sito. Questa procedura è descritta nella sezione Impostazioni dei siti: Messaggistica istantanea in Amministrazione di siti della Guida in linea di eroom 7. 2. Nella pagina Mappatura campi della procedura guidata di connessione alla directory, verificare che la mappatura LDAP all'indirizzo IM sia corretta. In questa pagina viene descritta la procedura Per aggiungere la connessione a una directory LDAP in Directory aziendali della Guida in linea di eroom 7. 3. Eseguire la sincronizzazione della directory in modo da sincronizzare il campo di indirizzi IM dei membri di eroom. Tale operazione è descritta nella sezione Sincronizzazione dell'elenco dei membri in Directory aziendali della Guida in linea di eroom 7. 8 Guida all'installazione di eroom Instant Messaging Integration Services
Configurazione della messaggistica immediata in eroom Per ulteriori informazioni Per informazioni sulla messaggistica immediata in eroom, consultare la sezione Messaggistica immediata in eroom della Guida in linea di eroom 7, disponibile facendo clic sul pulsante " " della barra di controllo nella parte superiore di una pagina eroom. Visitare il sito Web EMC Software CustomerNet (http:// softwaresupport.emc.com) per scaricare documentazione aggiuntiva, accedere alla Knowledge Base del supporto tecnico e ottenere informazioni aggiornate sui prodotti. Note sulla risoluzione dei problemi Per errori di IM Manager, verificare il Visualizzatore eventi. Per errori relativi alle estensioni caricate, verificare in <%SystemDrive%>\IMLinkage.log (ad esempio, C:\IMLinkage.log). Guida all'installazione di eroom Instant Messaging Integration Services 9
2011-2013 EMC Corporation. All Rights Reserved. EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice. THE INFORMATION IN THIS PUBLICATION IS PROVIDED AS IS. EMC CORPORATION MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Use, copying, and distribution of any EMC software described in this publication requires an applicable software license. EMC2, EMC, and the EMC logo are registered trademarks or trademarks of EMC Corporation in the United State and other countries. All other trademarks used herein are the property of their respective owners.