groupware connector

Installation GuideSAP CRM Groupware Connector Release 4.0 Document Version 2.1.6 – December 20, 2007 SAP AG Neurottstraße 16 69190 Walldorf Germany T +49/18 05/34 34 24 F +49/18 05/34 34 20 www.sap.com © Copyright 2003 SAP AG. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be changed without prior notice. Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors. Microsoft®, WINDOWS®, NT®, EXCEL®, Word®, PowerPoint® and SQL Server® are registered trademarks of Microsoft Corporation. IBM®, DB2®, DB2 Universal Database, OS/2®, Parallel Sysplex®, MVS/ESA, AIX , S/390 , AS/400 , OS/390 , OS/400 , iSeries, pSeries, xSeries, zSeries, z/OS, AFP, Intelligent Miner, WebSphere®, Netfinity®, Tivoli®, Informix and Informix® Dynamic Server trademarks of IBM Corp. in USA and/or other countries. ORACLE® is a registered trademark of ORACLE Corporation. UNIX , X/Open , OSF/1 , and Motif are registered trademarks of the Open Group. LINUX is a registered trademark of Linus Torvalds and others. ® ® ® ® TM ® ® ® ® ® JAVA® is a registered trademark of Sun Microsystems, Inc. J2EE™ is a registered trademark of Sun Microsystems, Inc. JAVASCRIPT® is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented by Netscape. MarketSet and Enterprise Buyer are jointly owned trademarks of SAP AG and Commerce One. SAP, SAP Logo, R/2, R/3, mySAP, mySAP.com, xApps, mySAP Business Suite, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. All other product and service names mentioned are the trademarks of their respective companies. are Disclaimer Some components of this product are based on Java™. Any code change in these components may cause unpredictable and severe malfunctions and is therefore expressively prohibited, as is any decompilation of these components. Any Java™ Source Code delivered with this product is only to be used Citrix®, the Citrix logo, ICA®, Program Neighborhood ®, MetaFrame®, WinFrame , VideoFrame , MultiWin and other Citrix product names referenced herein are trademarks of Citrix Systems, Inc. HTML, DHTML, XML, XHTML are trademarks or registered trademarks of W3C , World Wide Web Consortium, Massachusetts Institute of Technology. ® ® ® ® by SAP’s Support Services and may not be modified or altered in any way. Documentation in the SAP Service Marketplace You can find this documentation at the following Internet address: service.sap.com/instguides Typographic Conventions Type Style Example Text Represents Words or characters that appear on the screen. These include field names, screen titles, pushbuttons as well as menu names, paths and options. Cross-references to other documentation Example text Emphasized words or phrases in body text, titles of graphics and tables Names of elements in the system. These include report names, program names, transaction codes, table names, and individual key words of a programming language, when surrounded by body text, for example, SELECT and INCLUDE. Screen output. This includes file and directory names and their paths, messages, names of variables and parameters, source code as well as names of installation, upgrade and database tools. Exact user entry. These are words or characters that you enter exactly in the system as they appear in the documentation. Variable user entry. Pointed brackets indicate that you replace these words and characters with appropriate entries. Keys on the keyboard, for example, function keys (such as F2) or the ENTER key. Icons Icon Meaning Caution Example Note Recommendation Syntax EXAMPLE TEXT Example text Example text <Example text> EXAMPLE TEXT Installation Guide: SAP CRM Groupware Connector Contents Installation Guide – SAP CRM Groupware Connector Release 4.0...........5 1 Introduction....................................................................................................... 5 1.1 Naming Conventions ............................................................................................ 7 1.2 New Features ........................................................................................................ 8 2 Installation – Step by Step ............................................................................... 8 2.1 Installing MS Exchange Groupware Connector ................................................. 9 2.2 Installing MS Exchange Groupware Connector Proxy ...................................... 9 2.3 Installing Lotus Domino Groupware Connector .............................................. 10 2.4 Installing Lotus Domino Groupware Connector Proxy ................................... 11 3 Installation Planning....................................................................................... 11 3.1 Hardware and Software Requirements ............................................................. 11 3.2 Required Parameters.......................................................................................... 13 4 Installation Preparations................................................................................ 14 4.1 Gathering Parameters of Groupware Adapter.................................................. 14 4.2 Preparing Administrative Account for MS Exchange Connector ................... 15 4.3 Installing Microsoft Outlook .............................................................................. 18 4.4 Preparing Public Folder for Storing CRM Contacts......................................... 20 4.5 Using the Contacts Folder as Address Book in the MS Outlook.................... 21 4.6 Preparing Administrative Account for Lotus Domino Connector .................. 23 4.7 Preparing Database for Storing CRM Contacts ............................................... 24 4.7 Setting Up the Directory Assistance on the Lotus Domino Server ................ 29 4.8 Preparing for Replication of Private Contacts ................................................. 32 4.9 Installing Lotus Notes Client ............................................................................. 33 5 Installation Process........................................................................................ 33 5.1 Installing MS Exchange Groupware Connector ............................................... 33 5.2 Installing MS Exchange Groupware Connector Proxy .................................... 36 5.3 Installing Lotus Domino Groupware Connector .............................................. 40 5.4 Installing Lotus Domino Groupware Connector Proxy ................................... 45 6 Post Installation .............................................................................................. 50 6.1 Running SelfTest ................................................................................................ 50 6.2 Tuning the Performance..................................................................................... 50 7 Additional Information ................................................................................... 50 7.1 Installation Troubleshooting.............................................................................. 50 7.2 Upgrading from 2.0 Release .............................................................................. 52 7.3 Upgrading from 2.1 Release .............................................................................. 53 7.4 Uninstalling the Groupware Connector ............................................................ 53 7.5 Installing Multiple Instances of Connector....................................................... 53 May 2005 4 Installation Guide: SAP CRM Groupware Connector Installation Guide – SAP CRM Groupware Connector Release 4.0 1 Introduction Purpose This installation guide provides step-by-step instructions for installing the components of the 2.1 release of SAP CRM Groupware Connector environment. This guide also specifies the requirements for the installation and proper operation of the connectors. The following topics are discussed: • • • • Architecture of the Groupware Connectors Hardware and software requirements Preliminary actions before installing Groupware Connectors Step-by-step installation instructions Skill in performing typical Groupware administrative tasks is expected when preparing Groupware Servers for integration. There are two SAP CRM Groupware Connectors available, one for the Microsoft (MS) Exchange Server and one for the Lotus Domino Server. Groupware Connectors for SAP CRM release 4.0 allow two-way replication from different SAP CRM applications to the groupware and back. The scope of the product includes replication of contacts (business partner), appointments and tasks (activity and resource planning). Object types in different systems SAP CRM Business partner MS Exchange Groupware Server Contact • • Contacts folder in User’s Mailbox (private contacts) Public folder (public contacts) Lotus Domino Groupware Server Contact (Person) • • User’s private contact database (private contacts) Public contacts database (public contacts) Activity Management or Resource Planning Task • Tasks folder in User’s Mailbox To Do (Task) • User’s mail database: to-do frameset, calendar frameset Activity Management or Resource Planning Appointment, Meeting • Calendar folder in User’s Mailbox Calendar Entry (Appointment) • User’s mail database: calendar frameset Implementation Considerations Groupware Connector consists of the following components: • • Groupware Connector Groupware Connector Proxy May 2005 5 6 May 2005 . Following options can be considered to select the best solution • • • Minimum required bandwidth between Groupware Connector and Remote Proxy instance is 128kbps. It is recommended to setup Groupware Connector and Default instance of Groupware Connector Proxy on the computer in the same Local Area Network with the CRM server (Groupware Adapter). When using Remote Proxy in comparison to setting up the Proxy to deal with remote Groupware Servers … o Network utilization is about 5 times less during CRM Groupware replication. This provides the configuration easiest to maintain. Instances of the Groupware Connector Proxy can be installed or removed after initial setup was performed. Internal communication between Connector and its proxies is optimized to consume as minimum network traffic as possible. Integration Relation of the components in Groupware Integration solution is provided in the following diagram.Installation Guide: SAP CRM Groupware Connector The solution requires installation of one instance of Groupware Connector and one or more instances of Groupware Connector Proxies. See next chapter for more details. Minimum required bandwidth between Groupware Connector Proxy and remove Groupware Server is 1Mbps. thus allowing to build largely distributed solutions where Proxies provide link to remote Groupware Servers. (This is the case for the simplest configuration). The number of installed instances of Groupware Connector Proxies depends on following points: • • Geographical distribution of the organization and Wide Area Network (WAN) landscape Desired performance of the solution. Additional instance of Groupware Connector Proxy is recommended to be setup in each LAN node of the Wide Area Network. Groupware Connector Proxy CRM CRM Groupware Adapter SOAP over HTTP Groupware Connector Groupware Native API Groupware Server (as AddressBook provider) Groupware Native API Groupware Groupware Groupware Server(s) Server Server DCOM / RMI Groupware Connector Proxy Groupware Native API Groupware Groupware Groupware Server(s) Server Server Groupware Connector deals with CRM via Groupware Adapter. a Java application. a Win32 executable RMI for Lotus Groupware Connector. SOAP over HTTP is used for collaboration. Connection to Groupware Servers is provided via one or more Proxy instances. The simplest configuration is when Groupware Connector and one instance of Groupware Connector Proxy per entire organization are installed on the same box in the same LAN with CRM server. but at the same time it provides the lowest performance. Connector uses native to implementation platform protocol for internal collaboration with Proxies: • • DCOM for Exchange Groupware Connector. − May 2005 7 . log on as user c11adm and change to the directory /usr/sap/C11. the following naming conventions apply: Variables Variables <SAPSID> <sapsid> <DBSID> <dbsid> <SAPinst_INSTDIR> <INSTDIR> <CD-DIR> <OS> Description SAP system ID in uppercase letters SAP system ID in lowercase letters Database system ID in uppercase letters Database system ID in lowercase letters Installation directory for the SAP installation tool SAPinst Installation directory for the SAP system Directory on which a CD is mounted Operating system name within a path The following examples show how the variables are used: − Log on as user <sapsid>adm and change to the directory /usr/sap/<SAPSID>. change to /sapcd1/UNIX/AIX_64.1 Naming Conventions In this documentation.Installation Guide: SAP CRM Groupware Connector o Performance of Groupware CRM replication can be up to 100 times faster (depending on WAN bandwidth) because Remote Proxy will not utilze the network while detecting the changes. If your SAP system ID is C11. 1. Change to the directory <CD-DIR>/UNIX/<OS>. If the CD is mounted on /sapcd1 and your operating system is AIX. 2 Installing MS Exchange Groupware Connector Proxy [Page 9]. 8 May 2005 . 2 Installation – Step by Step Purpose You use the tables in the following sections as checklists to navigate through the installation when you install your SAP system. Prerequisites Process Flow 1. and post-installation) are listed in these tables. see table Installing Lotus Domino Groupware Connector [Page 10]. To install Lotus Domino Groupware Connector Proxy.2 New Features Area General Description In comparison to 2. see table 2. preparation. you follow the link for that step to the corresponding section. 2. installation. To install MS Exchange Groupware Connector Proxy. You perform the procedure described there. you mark the corresponding entry in the printed table with ! to log the progress of your installation. You follow the installation sequence exactly as shown in the tables.Installation Guide: SAP CRM Groupware Connector 1. You proceed with the next step listed in the table. This prevents you from missing important information. After you have successfully completed the installation step. You print out the relevant checklist: To install MS Exchange Groupware Connector. this one includes performance improvements and internal architecture changes to handle largely-distributed organizations in WAN environment. see table Installing MS Exchange Groupware Connector [Page 8]. Use the links to the general descriptions of the actions and to any additional information to help you perform the actions. All necessary installation phases (planning. see table Installing Lotus Domino Groupware Connector Proxy [Page 11].0 family of groupware connector. − − − − If a step is required for your installation. To install Lotus Domino Groupware Connector. 2.1 Installing MS Exchange Groupware Connector Installation Planning Careful planning is a prerequisite for the successful installation of the system. ! Action Hardware and Software Requirements Required Parameters Installation Preparations ! Action Gather Parameters of Groupware Adapter Prepare Administrative Account for MS Exchange Connector Install Microsoft Outlook Prepare Public Folder for Storing CRM Contacts Installation Process ! Action Follow the steps described in Installing MS Exchange Groupware Connectorchapter Post-Installation Activities ! Action Run SelfTest Start AdminTool to tune the performance options.Installation Guide: SAP CRM Groupware Connector 2.2 Installing MS Exchange Groupware Connector Proxy Installation Planning Careful planning is a prerequisite for the successful installation of the system. ! Action Hardware and Software Requirements Installation Preparations ! Action Install Microsoft Outlook Installation Process ! Action May 2005 9 . 3 Installing Lotus Domino Groupware Connector Installation Planning Careful planning is a prerequisite for the successful installation of the system.Installation Guide: SAP CRM Groupware Connector Follow the steps described in Installing MS Exchange Groupware Connector Proxy chapter Post-Installation Activities ! Action None 2. ! Action Hardware and Software Requirements Required Parameters Installation Preparations ! Action Gather Parameters of Groupware Adapter Prepare Administrative Account for Lotus Domino Connector Prepare Database for Storing CRM Contacts Set Up the Directory Assistance on the Lotus Domino Server Prepare for Replication of Private Contacts Install Lotus Notes Client on the computer for Groupware Connector Installation Process ! Action Follow the steps described in Installing Lotus Domino Groupware Connector chapter Post-Installation Activities ! Action Run SelfTest Start AdminTool to tune the performance options. 10 May 2005 . 1 Hardware and Software Requirements The following table lists the requirements. 3. The host machine must meet the following requirements: Hardware Requirements Component Processor Minimum RAM Minimum Disk Space Display Mode Network Configuration Description Intel PIII 600 MHz or higher 256 MB 500 MB 640x480x16 or better Min 128kbps line. ! Action Hardware and Software Requirements Installation Preparations ! Action Install Lotus Notes Client on the computer for Groupware Connector Proxy Installation Process ! Action Follow the steps described in Installing Lotus Domino Groupware Connector Proxy chapter Post-Installation Activities ! Action None 3 Installation Planning Make sure that you read Installation – Step by Step [page 8] before you start installation planning. LAN is recommended May 2005 11 .4 Installing Lotus Domino Groupware Connector Proxy Installation Planning Careful planning is a prerequisite for the successful installation of the system.Installation Guide: SAP CRM Groupware Connector 2. aspx?FamilyID=E1 7E7F31-079A-43A9-BFF2-0A110307611E&displaylang=en MS SOAP Toolkit 3.4.Installation Guide: SAP CRM Groupware Connector Software Requirements for the MS Exchange Connector Component Operating System Exchanger Server Description Microsoft Windows 2000.0 MS SOAP toolkit can be downloaded from the: http://www.com/downloads/details. Windows 2003 Lotus Domino Groupware Connector is compatible with following versions of Lotus Domino Server: o Lotus Domino 6. CDO is not part of standard installation and required to download from the Microsoft download center. Windows XP. Windows 2003 Exchange Groupware Connector is compatible with following versions of Exchange Server: o MS Exchange Server 2003 o MS Exchange Server 2007 Collaboration Data Objects library is only available with the following products: o MS Exchange Server 2007 o MS Exchange Server 2003 o MS Outlook 2007 o MS Outlook 2003 Using Microsoft Outlook 2003 you need to add CDO 1.sun.4.com/j2se/1. Windows XP.x o Lotus Domino 7.2/download.5 or higher MS Internet Explorer 5. It is necessary to install MS Outlook as the default mail client.html Sun JDK or Sun JRE 12 May 2005 .5 SP2 or higher Collaboration Data Objects (CDO) 1. For Microsoft Exchange Server 2007 and Outlook 2007.microsoft. Software Requirements for the Lotus Domino Connector Component Operating System Lotus Domino Server Description Microsoft Windows 2000.4.5. http://www.1 as a custom installation option because it is not part of the general installation.1 MSXML3 Internet browser SAP Groupware Connector must not be installed on groupware server system as the system will already be overloaded.com/downloads/details.0.x Sun JDK 1.2 or higher.aspx?FamilyId=C9 43C0DD-CEEC-4088-9753-86F052EC8450&displaylang=en Available with IE 5.2.microsoft.2.2 or higher are available for download starting from the link below: http://java. or Sun JRE 1. so we insist on installing Groupware Connector directly on groupware server system itself. refer to section Installation Preparations. Extract the downloaded zip file into a directory on the hard disk.sun.com/products/javamail/downloads/index.html Extract the downloaded zip file into a directory on the hard disk.5 or higher Lotus Domino Designer 6.1 Available for download starting from: http://java. Javabeans Activation Framework (JAF) 1. May 2005 13 . you have to know all parameters that have to be entered during the installation procedure.5.x or higher 3.sun.jar You must install one of the following: • • • Lotus Notes 6.2 Required Parameters Before starting the Installation Wizard. Sun Java Mail API 1.3. You will have to enter the file location during the installation process. You will have to enter the file location during the installation process.Installation Guide: SAP CRM Groupware Connector Notes.2 Available for download starting from the link below: http://java.5 or higher Lotus Domino Administrator 6.5 or higher The version of the products listed above should be the same as the version of the default Lotus Domino Server. These parameters are: • For configuring connection to Groupware Adapter URL (HTTP URL of the SOAP listener) User Name Password Client Language • For configuring connection to Lotus Domino Server Global Domain Name Server Name (Host Name for Lotus Domino) Server Port (HTTP Server Port) User Name (Short user name of administrative account prepared for Groupware Connector) Password (Internet password of that account) • For configuring connection to Microsoft Exchange Server Server Name Domain\User Name (Administrative account prepared for Groupware Connector) Password For more details. Lotus Domino Server The version of the default Lotus Domino Server must be 6.com/products/javabeans/glasgow/jaf.html.0. On the Service Display screen. Enter the transaction code SICF. This forms the http://[Host Name]:[Service Name/Port] part of the URL address. perform the following steps: 1. b. Determine the relative path of the SOAP listener: a. b.e.1 Gathering Parameters of Groupware Adapter This chapter describes how parameters. Obtain HTTP server Host Name and Port a. c. finally you get http://[Host Name]:[Service Name/Port]/sap/bc/soap/rfc 14 May 2005 . Expand the tree to locate the soap node (usually found in default_host → sap → bc → soap →rfc). get the Host Name and the Service Name/Port for the HTTP protocol (see the figure below). The path below the default_host node forms the rest of the URL address (sap/bc/soap/rfc).Installation Guide: SAP CRM Groupware Connector 4 Installation Preparations 4. required for configuration of connection to Groupware Adapter. To determine the HTTP URL of the SOAP listener. 2. Enter the transaction code SMICM and choose Services. i. can be obtained. Read/Write access for Public Folder intended to store Public Contacts. 4. Administrative account is used as logon information for Groupware Connector’s Windows NT service (see Log On tab in service properties). Client and Language of the CRM System should be obtained from Administrator of the CRM System.Installation Guide: SAP CRM Groupware Connector 3. Password. The User Name.2 Preparing Administrative Account for MS Exchange Connector Exchange Groupware Connector requires administrative account with following access permissions: • • Read/Write access for all mailboxes intended for replication. May 2005 15 . The options displayed below will be needed later during the installation process. 16 May 2005 . 3. The mailbox alias used in the installation settings is recommended to correspond to the same user. During installation user account should belong to local Administrators group. Use these steps as checklist if you are going to use already available account: 1. To create new account to be used as Exchange Connector’s administrative account. If not. which will be used for running the SAP CRM Exchange Connector Service.Installation Guide: SAP CRM Groupware Connector The installation routine must be performed under the user account. Check whether the Groupware administrative account exists. follow the steps below. select Users folder and execute Action New User from menu. On computer with MS Exchange Server choose Start → Programs → Microsoft Exchange → Active Directory Users and Computers. 2. In the left window locate the node that represents your Exchange server. Grant at least following permissions: May 2005 17 . In the menu. 7.Installation Guide: SAP CRM Groupware Connector 4. Open the nodes following the path: First Organization Name → Administrative Groups → First Administrative Group → Servers. 5. choose Properties and select the Security tab. 6. Add the NT user account that was used as the Exchange Connector administrative account (See Step 3). Select the target server and right-click on it. Start Exchange System Manager. Alternativelly one may desire to setup access permission per individual mailbox or public folder. Microsoft Outlook can be used for configuration diagnostics and troubleshooting purposes. This will install required MAPI support libraries. When installing CDO (Collaboration Data Objects library) with MS Outlook 2000/XP/2003. Inbox. click Client Permissions. Press Mailbox Rights button and make sure that Full Mailbox Access right is granted. All required MAPI libraries are already installed with MS Exchange Server. To setup individual public folder permissions: 1. Enable Advanced Features in View menu. To setup individual mailbox permissions: 1. Installation of Exchange Groupware Connector includes custom ExAclSet tool for batch assigning of Client access permissions in mailbox folders. Open desired user’s properties and go to Exchange Advanced tab. This operation needs to be performed for each individual mailbox intended for synchronization with CRM. 2. Outbox.Installation Guide: SAP CRM Groupware Connector • • • Read Permissions Receive As Send As. It may be helpful to have it installed on the computer with MS Exchange Server too. Start Exchange System Manager and select desired public folder. or 1. assign Editor-Role client permissions to following mailbox folders: Calendar. Make sure that Editor role is assigned to Groupware Connector’s administrative account. make sure that: 18 May 2005 . 3. This is the easiest way to configure access permissions but it will grant access to administrative account to all mailboxes and all public folders on the given server. Open folder Properties and go to Permissions tab. 4. Tasks. 2. On client computer with MS Outlook.3 Installing Microsoft Outlook Installation of Microsoft Outlook is required when MS Exchange Groupware Connector components are installed on the different computer from MS Exchange Server. On computer with MS Exchange Server choose Start → Programs → Microsoft Exchange → Active Directory Users and Computers. Refer to Batch-Assigning Access Rights for MS Exchange Connector chapter in Adminstration Guide for more details. Contacts. This option can be reconfigured in already installed Ms Outlook using Tools Options Mail Services Reconfigure Mail Support • Make sure you are able to login to Groupware administrative account specified above. May 2005 19 .Installation Guide: SAP CRM Groupware Connector • The option Collaboration Data Objects is enabled during the installation: • The Corporate or Workgroup mode is selected at the startup of MS Outlook. 7. Use the following steps to create a new public folder: You need to have permission to create sub-folders in the existing public folder. 20 May 2005 . This e-mail address will be used to identify the public folder for Groupware Connector during the installation routine.aspx?FamilyID=E17E7F31-079A-43A9-BFF20A110307611E&displaylang=en 4. In the Folder contains box. 1. Make sure that Hide from Address Book is unchecked on Exchange Advanced property page.microsoft. In this case. To setup valid access permissions to the Groupware Connector administrative account. Provide SMTP e-mail addresses on the E-Mail addresses property page. 6. You will need to enter it during the installation process. Start MS Outlook. Any public folder that conforms to the following requiremens can be used to store Public Contacts: • • • The folder is for Contact Items Read/Write permissions are granted to Groupware Connector administrative account. In the Select where to place the folder box. select New and choose Folder. 10.) 2. 5. select Contact items. press the Client Permissions button on the Permissions property screen. At least Editor role permissions are required. Choose Action → Properties. In the File menu.com/downloads/details. Memorize the SMTP address of the public folder. Select the created folder. It can be found under the following node: First Organization Name → Administrative Groups → First Administrative Group → Folders → Public Folders 8. 4. refer to the MS Outlook documentation on creating a new user profile. enter a folder name. Start the MS Exchange System Manager.4 Preparing Public Folder for Storing CRM Contacts This chapter describes how Public Folder for storing Public Contacts can be configured. SMTP address is configured for folder. Kindly download the CDO from the following micrsoft webstie link … http://www. 11.Installation Guide: SAP CRM Groupware Connector NOTE: Collabaration data Objects (CDO) are no longer available with Outlook 2007 (Outlook 12). In the Name box. (You may need to create a user mail profile for the administrative account. select the public folder where you want to include your new public folder. 3. 9. Installation Guide: SAP CRM Groupware Connector NOTE : If Organisation using Exchange Server 2007 then follow only steps from 1 to 5 and from step 6 onward follows here .. This e-mail address will be used to identify the public folder for Groupware Connector during the installation routine. refer to the MS Outlook Help.. Use the following command to add permission to the public folder created in Step 3. 7. Then use this SMTP e-mail addresses on the E-Mail addresses property page. Get-PublicFolderStatistics -user "xxx" -accessright "editor" -identity "\yyy" Where. Start MSH (Microsoft Shell) in Exchange Server System. 6. You will have to configure the same on every client computer.5 Using the Contacts Folder as Address Book in the MS Outlook It is possible to use the Exchange Contacts folder as a part of the Address Book in MS Outlook. Outlook Address Book is the client configuration. For more details. To register public folder in Outlook Address Book May 2005 21 . xxx => To the User you wanted to Grant access permissions yyy => Public folder name created in Step-3 with absolute path like \CRMContact 8. 4. Installation Guide: SAP CRM Groupware Connector 1. select Add. 22 May 2005 . b. c. A Contact item must have an entry in the E-mail field or the fax phone number field to appear in the Outlook Address Book. select Outlook Address Book. Right-click on Contacts folder you want to display in the Address Book dialog box and select Properties. 2. Restart Outlook. e. select E-mail accounts b. On the Services tab. select Services. using Outlook 2003 a. In the Tools menu. d. Select View or change existing directories and address books. if the Folder List is not visible. e. c. If not present. Press OK twice. To enable the Service. Press Next and select Outlook Address Book. Enter the name for the Contacts folder you want to appear in the Show names from the box in the Address Book dialog box. b. d. Select the Show this folder as an e-mail Address Book check box. d. In the Folder List. go to the Outlook Address Book tab. a. if the Folder List is not visible. Setup the Contacts folder to be displayed in the Address Book dialog box. press Next c. In the Available information services box. Restart Outlook. (Using Outlook 2003) Select the Go menu and then select Folder List. In the Tools menu. (Using Outlook 2000) Select the View menu and then select Folder List. click Add and select Addition Address Books. add an Outlook Address Book to the user profile. Ensure Outlook Address Book is listed. using Outlook 2000 a. Grant access permission to administrative account in all concerned mailboxes. Use these steps as checklist if you are going to use already available account: You may refer to Domino 5 Administration Help: Server Configuration → Setting up Notes users for more details on this topic. May 2005 23 . follow the steps below. 4.Installation Guide: SAP CRM Groupware Connector 4. Start Lotus Notes client b. Expand the Public Address Book and right-click on People. To do so each Lotus Notes user needs to add Lotus Connector’s account into Acess Control List of his database. a. select Register person 3. Start Lotus Domino Administrator and go to People & Groups tab 2.6 Preparing Administrative Account for Lotus Domino Connector Before starting the SAP Groupware Connector Installation Wizard. To create new account to be used as Lotus Connector’s administrative account. 1. Fill in the user information and then press the Add person button and the Register button. you need to setup administrative account. Right-click on the database and select Database Access Control …. You need to fulfill the following steps: 1. and Domino servers Customizing access to a Domino server Restricting administrator access Installation of Lotus Domin Groupware Connector includes custom ACLRighs tool for batch assigning of database access permissions. Internet users.Installation Guide: SAP CRM Groupware Connector c. This operation requires following access priveledges: Full access administrators. 4. Database administrator. Make sure that the Delete documents checkbox is selected. For more details see following section in Lotus Domino Administrator 6 Help Security The database access control list Editing entries in multiple ACLs. Register it in Public Address Book 24 May 2005 . select at least Editor access level. Create the database using Personal Address Book template. Refer to Batch-Assigning Access Rights for Lotus Domino Connector chapter in Adminstration Guide for more details.7 Preparing Database for Storing CRM Contacts Lotus Groupware Connector replicates public contacts into dedicated database. In Lotus Domino 6 it is possible for Administrator to grant access permissions for multiple databases at the time. For more details see Lotus Domino Administrator 6 Help Server access for Notes users. Administrator. In the Access drop-down list. 2. Provide nessesary information in pop-up dialog It is recommended to use file names that are not longer than the 8. Get SMTP address of the database to be used when configuring target for Public Contacts during setup routine. Select menu File Database New … 3. 4. Go to Files tab b. Start Lotus Domino Administrator 2. Make sure that the Inherit future design changes option is not selected. Right-click on the newly created database and select Access Control → Manage as displayed below: May 2005 25 . Grant access permission to the database to Lotus Connectors’ administrative account. The use of long file names is possible if long file names are supported by the operating system the Lotus Domino server works on. To create new database 1. a.Installation Guide: SAP CRM Groupware Connector 3.3 convention. Start Lotus Domino Administrator 26 May 2005 . e. Assign the Reader access for the Default user and all other users of type Person displayed in the Access Control List. To register the database in Public Address Book 1. such as the prefix and the suffix of the contact name.Installation Guide: SAP CRM Groupware Connector c. Add the Lotus Connector’s administrative account to the Access Control List. Designer’s rights permit to perform these actions. The Lotus Groupware Connector must have rights to add. select the Person as the User type and Designer as the Access authorization. Check that Read public documents is the only option enabled for the users. Make sure the Delete documents option is checked. d. The Connector must have the permission to change some elements of design. change and delete contacts in the contacts database. server. May 2005 27 . Go to People & Groups tab. On the Basics tab provide Mail-In name b. Click on Add Mail-In Database on the right pane a. 3.Installation Guide: SAP CRM Groupware Connector 2. and filename information. expand Address Book and select Mail-In database & Resources. On the Database Information tab provide domain. Name part is the value provided in Mail-in field during registering the database in Public Address Book 2. Open the Global Domain document and go to Conversions tab. 1. The Internet domain to be used is provided in local primary Internet domain field. expand the Messaging group. b. select Domains and expand Global Domain on the right and then select your domain. 28 May 2005 .Installation Guide: SAP CRM Groupware Connector To obtain the SMTP address of the database one needs to get name and domain to form string like the one shown below <name>@<domain> SMTP address can be explicitly specified in Internet Addess field of Mail-In database. To obtain Internet Domain part a. Steps below are not required in that case. Select the Configuration tab. 6. for the database that stores Public Contacts. Use the same file name and path for each replica to easily setup multiple servers to use the directory assistance.Installation Guide: SAP CRM Groupware Connector 4. then select the template. Enter the name of a server on which to create the database. 3. Enter a file name for the database.7 Setting Up the Directory Assistance on the Lotus Domino Server The Directory Assistance is a feature that enables users and servers to locate information in a directory that is not a server's primary Lotus Domino Directory. 4. You may enter any title. You may enter any file name. In the Lotus Domino Administrator. On each server in the domain that will use the database for Directory Assistance a replica of the database is to be created. select the Configuration tab. Make sure that an Inherit future design change is selected and press OK. Create a replica of the Directory Assistance database on each server that will use it. 2. for example Directory Assistance. You have to create a database to setup the Directory Assistance database for a Lotus Notes domain. you have to carry out the following procedures: • • • Create the Directory Assistance database Setup servers to use Directory Assistance Create a Directory Assistance document for a secondary Lotus Domino Directory To create the Directory Assistance database 1. choose File → Database → New. To setup one server to use Directory Assistance 1. for example. To setup Directory Assistance in a Lotus Notes domain. 7. In the Lotus Domino Administrator. May 2005 29 . for example DA. In the Use Directory on field. Select Template Server and a server that stores the Directory Assistance template (DA50. 2. 5. You can setup the Directory Assistance for secondary Lotus Domino directories. choose the server where you want to modify the Lotus Domino Directory. Enter a title for the database.NSF.NTF). enter a domain name. Choose Server → All Server Documents. for example DIRECTORIES\DA. 2. Expand Directory → Directory Assistance. Company Name The name of the Company associated with this directory. select a server that stores the Directory Assistance database. relative to other directories in the Directory Assistance database. 6. provide the path relative to the data directory. A number representing the order in which this directory is searched. enter the file name you defined for the replica of the Directory Assistance database on this server. Search Order 30 May 2005 . In the Lotus Domino Administrator select the Configuration tab. Press OK. 7. Public Address Book). To setup multiple servers to use Directory Assistance 1. On the Basics tab in the Directory Assistance database name field. In the Use Directory on field choose the server where you want to modify the Lotus Domino Directory. 4. 5.NSF. Select the Server documents for servers that use the same file name for the replica of the Directory Assistance database. Public). 3. 3. 8.NSF.Installation Guide: SAP CRM Groupware Connector 3. If the Directory Assistance database is in a sub-directory. To create a Directory Assistance document for a secondary Lotus Domino Directory 1. In the server window on the left pane of the Lotus Domino Administrator. 9. On the Basics tab. provide the path relative to the data directory.NSF. If the Directory Assistance database is in a sub-directory. Choose Actions → Set Directory Assistance Information. If you do not see the server window. Select Add directory assistance. 4. for example. 5. The name of the Notes domain associated with the secondary directory. enter the following fields: Field Domain Type Domain Name Enter Choose Notes. Enter the file name you defined for the Directory Assistance database on these servers. Select a specific server document and press Edit Server. enter DA. Repeat Steps 5 to 8 for each set of servers that uses the same file name and path for the replica of the Directory Assistance database. do not specify the primary Notes domain (for example. DIRECTORIES\DA. Press Save and Close. Select the Configuration tab. 4. press servers icon. If the secondary directory is not associated with the Notes domain. 2. 6. The domain name must be different from the primary Notes domain and from all other domain names configured in Directory Assistance. for example DA. Multiple directory assistance documents can use the same Company name (for example. for example. 6.NSF. 5. A checkmark appears next to each document. All). 9. May 2005 31 . Trusted for Credentials Choose: Yes – to allow Lotus Domino to use this directory to authenticate Web clients with names that correspond to the rule. Restart the server. the Replica field takes precedence. If you authenticate web clients registered in the secondary directory and you also include the directory in the directory catalog on the Replicas tab. for example: Server name: Mail1/SAP Directory file name: PUBLICNAMES. Replica # The server name and file name of each replica of the secondary directory. If you specify a replica in the Database links field and in the Replica field. the first rule is enabled. To specify (up to five) replicas of the secondary directory to use for Directory Assistance. Choose: No – to disable a specific rule Yes – to enable a specific rule By default. Use database links only if the servers the links refer to are consistently available. Enabled 8. Select the Database links field and choose Edit → Paste. indicating all names in the directory (for example. server tasks need to retrieve database information from the remote servers the links refer to. Do not specify a replica of the directory catalog in this field. Use database links only on Lotus Domino Release 5 servers.Installation Guide: SAP CRM Groupware Connector Field Enabled Enter Choose Yes to enable Directory Assistance for this directory. Using database links may delay server startup because when you restart a server that uses Directory Assistance.NSF Next to each replica selected Enabled. Select the Rules tab to enter the following fields: Field Rule # Enter One or more rules that describe the names in the directory. By default. No (default) – to prevent Lotus Domino from using this directory to authenticate Web clients with names that correspond to the rule. Field Enter Database links Open the replica of the secondary directory and choose Edit → Copy As Link → Database Link. press the Replicas tab and enter the following fields. Press Save and Close. 7. the first rule contains all asterisks. specify the replica of the secondary Lotus Domino directory you used to build the source directory catalog. Make sure you have rights to create replica databases on a server.xml in the Lotus Connector’s installation folder using Notepad or any other text editor. To setup replication of users Private Address Book onto the server 1. Default value for postfix is ‘_ab’. 3. Refer to the same point of Preparing Database for Storing CRM Contacts 4. Create private-contact-map. In case exclusion approach is selected. 5. File name of the replica database should follow the next approaches: 1. This approach is the default one. See Notes 5 Help for details.8 Preparing for Replication of Private Contacts To support replication of private contacts Groupware Connector requires a replica of Personal Address Book on Lotus server. section Notes Away from the Office The Notes Replicator. You can check it by using Domino Administrator. Postfix expected by Groupware Connector can be reconfigured using Groupware Connectors AdminTool. Finish the installation of Lotus Groupware Connector. To provide exlusion list with location of replica databases of user’s Private Address Book 1. Please contact Administrator to perform this step if you do not have that permission. In Lotus Notes the client should Right-Click on the Private Address Book database and select Replication New Replica … 2. Grant access permission to Lotus Connectors’ administrative account on replica database. Select the server you need and then select Configuration Tab → Server → Current Server Document Security Tab Server Access Create Replica Databases. Use naming convention – postfix is appended to base filename as provided in the Mail file field on Mail tab of the user’s properties in Public Address Book. Repeat steps 1 and 2 for all necessary Private Address Book databases.xml file if the Groupware Connector after the setup is complete. next sample lines will have to be added into private-contactmap.Installation Guide: SAP CRM Groupware Connector 4. 2. Provide filename of the user’s Private Address Book in config file as exclusion to the first rule. 3. Select the target server and give filename using one of the approaches described above. Setup replication schedule in Lotus Notes client. Provide list of exlusions using the sample below 32 May 2005 . 2. Launch setup. 5. Log on to your host using prepared Groupware Connector’s administrative account. Select the type of SAP Groupware Connector you want to install. 5 Installation Process 5. If yes. Then press Next.com"> <private-contact-map> <server>epmsd007/mn/ep</server> <file>mail/test01_ab</file> </private-contact-map> </user> </userlist> </message> 4. 2.Installation Guide: SAP CRM Groupware Connector <message xmlns="http://schema.sap. Check if you want to install instance of Default Groupware Connector Proxy.exe 3. Click Next on the Welcome screen. When installing Lotus Notes client make sure that it uses the Connectors Administrative Account. 4.com/groupware"> <userlist method="read"> <user smtp_address="test1@epam. Procedure 1. May 2005 33 .1 Installing MS Exchange Groupware Connector Use This procedure explains how to install the MS Exchange Groupware Connector on Windows 2000/XP/2003 platform.9 Installing Lotus Notes Client Lotus Domino Groupware Connector uses API provided by Lotus Notes Client to access Lotus Domino Server. press Next. Read the text on the Installation Prerequisites screen and check if your computer meets all the software and hardware requirements. wait while setup routine detects required software. 8. Provide the Groupware Adapter parameters. choose Browse. more information can be obtained from the log files located in %SystemRoot%\Temp\GWC_Installation_Logs. Default reciepent SMTP Mail-id is optional.Installation Guide: SAP CRM Groupware Connector 6. Press Next 7. NT Domain. Provide Exchange Server connectivity options. Press Next. Press Next. Refer to chapter Gathering Parameters of Groupware Adapter for more details. NT User Name and Password parameters will be used as LogOn information for Groupware Connector’s service. Properties of the currently logged on users are provided by default. o o To select a different folder. The default folder is: C:\Program Files\SAP\SAP Groupware Connector\<ServerType>. Groupware Connector will access Exchange store using given account. 34 May 2005 . Select the folder where the setup program will install the SAP Groupware Connector. In case of parameters validation failure. One may use the same to limit replication of contacts too May 2005 35 . Specify global Exchange to CRM synchronization options. These options are typically used to prevent replication of very old calendar items. then press Next.Installation Guide: SAP CRM Groupware Connector 9. 5. 2.Installation Guide: SAP CRM Groupware Connector 10. 36 May 2005 . 4. Read the text on the Installation Prerequisites screen and check if your computer meets all the software and hardware requirements. press Next. Procedure 1. Launch setup. Press Finish to exit the Wizard.exe 3. 11. The installation is complete. Log on to your host using prepared Groupware Connector’s administrative account. Review your settings on summary window and press Next to start copying files.2 Installing MS Exchange Groupware Connector Proxy Use This procedure tells you how to install the separate MS Exchange Groupware Connector Proxy component on Windows 2000/XP/2003 platform. Click Next on the Welcome screen. If yes. Properties of the currently logged on users are provided by default. Provide NT account to run Exchange Groupware Connecotor Proxy’s service. Proxy will access Exchange store using given account. 6. Select ‘Exchange’ as Groupware Type. Select ‘Proxy’ in Component combo. Then press Next. wait while setup routine detects required software. Press Next.Installation Guide: SAP CRM Groupware Connector 5. May 2005 37 . 38 May 2005 .Installation Guide: SAP CRM Groupware Connector 7. Press Finish to exit the Wizard. 8. Review your settings on summary window and press Next to start copying files. The installtion and registration of new Proxy instance is complete. Press Apply button in main window to save changes to configuration file. Goto Proxies General page and click Add New Proxy button on toolbar b.Installation Guide: SAP CRM Groupware Connector 9. This will ensure the messages will be processed in case no explicit mapping configured for some target Exchange server. May 2005 39 . On the computer with installed Groupware Connector launch Admin Tool and register newly installed Proxy instance. 10. To do so a. c. It is strongly recommended to set one Proxy instance as Default. In the popup dialog provide provide required values and press OK. Procedure 1. If yes. Select the folder where the setup program will install the SAP Groupware Connector. 2. Then press Next.Installation Guide: SAP CRM Groupware Connector 5. 5. Press Next 40 May 2005 . wait while setup routine detects required software. The default folder is: C:\Program Files\SAP\SAP Groupware Connector\Lotus\1 o o To select a different folder.3 Installing Lotus Domino Groupware Connector Use This procedure tells you how to install the Lotus Domino Groupware Connector on Windows 2000/XP/2003 platform. 6. press Next. Select the type of SAP Groupware Connector you want to install. Check if you want to install instance of Default Groupware Connector Proxy. Launch setup. 4. choose Browse. Log on to your host using prepared Groupware Connector's administrative account. Click Next on the Welcome screen. Read the text on the Installation Prerequisites screen and check if your computer meets all the software and hardware requirements.exe 3. Select the path where the Sun Java Mail API is installed. Press Next May 2005 41 .jar file. choose Browse. choose Browse. The default folder is: C:\Lotus\Notes o o To select a different folder. o o To select a different folder. Select the folder containaing the NOTES.Installation Guide: SAP CRM Groupware Connector 7. Press Next 8. Press Next 10. Provide the Groupware Adapter parameters. choose Browse. Enter you Lotus Domino Server parameters. more information can be obtained from the log files located in %SystemRoot%\Temp\GWC_Installation_Logs.Installation Guide: SAP CRM Groupware Connector 9. See topic Mail Setting up SMTP routing Prepare your system for sending messages to the Internet Global domain document in Domino Administrator Help for details In case of parameters validation failure. 42 May 2005 . 11. Refer to chapter Gathering Parameters of Groupware Adapter for more details. o o To select a different folder. Select the path where the Javabeans Activation Framework is installed. Press Next. Press Next. These options are typically used to prevent replication of very old calendar items. then press Next. Specify global Lotus to CRM synchronization options. One may use the same to limit replication of contacts too May 2005 43 .Installation Guide: SAP CRM Groupware Connector 12. Installation Guide: SAP CRM Groupware Connector 13. 14. Review your settings on summary window and press Next to start copying the files. Press Finish to exit the Wizard. 44 May 2005 . The installation is complete. Log on to your host using prepared Groupware Connector’s administrative account. wait while setup routine detects required software.exe 3. May 2005 45 . Then press Next. 5.Installation Guide: SAP CRM Groupware Connector 5. press Next. Select ‘Proxy’ in Component combo. Procedure 1. If yes. 4. Launch setup. Read the text on the Installation Prerequisites screen and check if your computer meets all the software and hardware requirements. Select ‘Exchange’ as Groupware Type. Click Next on the Welcome screen.4 Installing Lotus Domino Groupware Connector Proxy Use This procedure tells you how to install the separate Lotus Domino Groupware Connector Proxy component on Windows 2000/XP/2003 platform. 2. jar file. The default folder is: C:\Program Files\SAP\SAP Groupware Connector\Lotus\1 o o To select a different folder. Press Next 7.Installation Guide: SAP CRM Groupware Connector 6. Select the folder containaing the NOTES. Select the folder where the setup program will install the SAP Groupware Proxy. The default folder is: C:\Lotus\Notes o o To select a different folder. choose Browse. Press Next 46 May 2005 . choose Browse. o o To select a different folder. choose Browse. Press Next May 2005 47 . Select the path where the Javabeans Activation Framework is installed. Press Next 9.Installation Guide: SAP CRM Groupware Connector 8. o o To select a different folder. Select the path where the Sun Java Mail API is installed. choose Browse. Press Finish to exit the Wizard. 11. Review your settings on summary window and press Next to start copying files. 48 May 2005 .Installation Guide: SAP CRM Groupware Connector 10. To do so a. 13. The installtion and registration of new Proxy instance is complete. It is strongly recommended to set one Proxy instance as Default. Goto Proxies General page and click Add New Proxy button on toolbar b. May 2005 49 . In the popup dialog provide provide required values and press OK.Installation Guide: SAP CRM Groupware Connector 12. This will ensure the messages will be processed in case no explicit mapping configured for some target Lotus Domino server. Press Apply button in main window to save changes to configuration file. c. On the computer with installed Groupware Connector launch Admin Tool and register newly installed Proxy instance. cmd. after installation is complete.1 MS Exchange Connector Alert Window Problem and Solution Cause: The user. Solution: You have to install the MS SOAP Toolkit from below path and restart the Installation Wizard … http://www.2 Tuning the Performance Launch Admin Tool to tune the performance options of Groupware Connector. does not have administrator privileges on the current computer.com/downloads/details.1.microsoft.aspx?Fa milyId=C943C0DD-CEEC-4088-975386F052EC8450&displaylang=en 50 May 2005 . Refer to Administration Guide for more details.Installation Guide: SAP CRM Groupware Connector 6 Post Installation 6.1 Running SelfTest It is recommended to run SelfTest. 6. Cause: The MS SOAP Toolkit Version 3 is not installed on the target machine. No ERROR messages should be logged. located in Groupware Connector’s installation folder. This will launch the connector in self-test mode.1 Installation Troubleshooting 7. Stop the Groupware Connector service before starting the self test because they use same Groupware Adapter resources and slef-test may fail. Result of the execution will be available on Console and in log files. Solution: Review the Required Parameters section and set appropriate privileges for the user. The last message in the output should be “Self Test Succeeded” in case of success and “Self Test Failed” in case of failure. Groupware Server and so on. 7 Additional Information 7. Connector will check the configuration by trying to connect to CRM Adapter. who is currently logged in. Solution: You have to install JRE 1.2 or higher and restart the Installation Wizard.4.log Correct your settings or check the documentation to tune the MS Exchange Server properly for work with CDO. If the required programs are not installed. The installation is cancelled. Solution: Check the documentation to determine the possible location of this file. does not have administrator privileges on the current computer. Cause: The given user name and/or the password are not valid. you have to close the installation. Solution: Correct the user_name and/or the password.jar is not found. Requred MS CDO library is not installed.Installation Guide: SAP CRM Groupware Connector Cause: o o Either Server Name or Mailbox Alias is invalid when providing Exchange Server parameters. install the required software and restart the Installation Wizard. Cause: NSCO.1. Solution: A detailed error description is available in the file: C:\Temp\Logs\ExchangeGWConnector. Solution: Review the Required Parameters section and set appropriate privileges for the user. May 2005 51 .2 Lotus Domino Connector Alert Window Problem and Solution Cause: The Installation Wizard has detected that no Java Runtime Environment is installed. Cause: The user currently logged in. 7. The Installation Wizard stops. 2. 52 May 2005 . To provide the most sufficient way of upgrading from 2. Cause: Current Lotus Client password is not valid.1 family of Groupware Connector have much difference in architecture from 2. The Installation Wizard stops. The Installation Wizard stops. you have to close the installation. Cause: Mail.jar is not found. close the installation. The Installation Wizard stops. close the installation. Solution: Check the folder where the Sun Java Mail API 1. Setup an instance of 2. Resolution: Check your environment.0 connector will be stopped and disabled once the installation succeeded. The installation routine will check the presence of 2.0 release the procedure is organized in following way: 1.jar is not found. Cause: The Path to the Notes home directory was not found. Solution: Check the folder where the Apache SOAP is installed.1 release of connector. Cause: Activation.0 family. install the required software and restart the Installation Wizard.Installation Guide: SAP CRM Groupware Connector Cause: Soap. 7. If it is not installed. Solution: Check the folder where the JavaBeans Activation Framework is installed. Resolution: Enter a valid password.jar is not found.2 Upgrading from 2. If it is not installed. If it is not installed.2 is installed. install the required software and restart the Installation Wizard. install the required software and restart the Installation Wizard.0 release on the same computer and will import configuration options and run-time data from previous installation.0 Release The 2. 1 Release To upgrade the 2. Setting multiple instances of Groupware Connector components intended only for testing purposes and not supported in Production environment. Press Finish to exit the installation.4 Uninstalling the Groupware Connector From Windows Start menu open Settings Control Panel Add/Remove Programs.1 release. 7. 5.3 Upgrading from 2. 3. 2. Uninstall 2. To setup additional instance of connector component launch following command line from setup folder Setup. May 2005 53 . Verify success of the installation of 2. Launch the installation routine. 7.g. Select the option “Repair/Upgrade all installed components” and press Next. Click Yes on the query for keeping configuration files if you need only rewriting of binary files. Components of Groupware Connector will talk only to the components having the same instance ID.0 release if verification is successful.0 release otherwise.exe /Instance=N where N gives the id of the instance in range 1 to 4. E. This will allow connecting different CRM systems to different Groupware using same hardware.5 Installing Multiple Instances of Connector For reusing same hardware when testing in different landscapes option to install multiple instances of Groupware Connector on one box is available. Uninstall 2.Installation Guide: SAP CRM Groupware Connector 2. Select SAP Groupware Connector component and press Change/Remove to uninstall or modify installation. 4.1 release and enable NT services of 2.1 release of Groupware Connector component to new version 1. Press Next to perform the upgrade procedure. Click No to regenerate the configuration files by the values provided during the first installation. 7.: Groupware Connector installed with instance ID equal to 3 will connect only to Proxy instances installed with instance ID equal to 3. 3.