Professional Documents
Culture Documents
© Copyright 2003 SAP AG. All rights reserved. JAVA® is a registered trademark of Sun Microsystems, Inc.
No part of this publication may be reproduced or transmitted in any J2EE™ is a registered trademark of Sun Microsystems, Inc.
form or for any purpose without the express permission of SAP AG.
The information contained herein may be changed without prior JAVASCRIPT® is a registered trademark of Sun Microsystems, Inc.,
notice. used under license for technology invented and implemented by
Netscape.
Some software products marketed by SAP AG and its distributors
contain proprietary software components of other software vendors. MarketSet and Enterprise Buyer are jointly owned trademarks of SAP
AG and Commerce One.
Microsoft®, WINDOWS®, NT®, EXCEL®, Word®, PowerPoint® and
SQL Server® are registered trademarks of Microsoft Corporation. SAP, SAP Logo, R/2, R/3, mySAP, mySAP.com, xApps, mySAP
Business Suite, and other SAP products and services mentioned herein
IBM®, DB2®, DB2 Universal Database, OS/2®, Parallel Sysplex®, as well as their respective logos are trademarks or registered
® ® ® ® ®
MVS/ESA, AIX , S/390 , AS/400 , OS/390 , OS/400 , iSeries, trademarks of SAP AG in Germany and in several other countries all
pSeries, xSeries, zSeries, z/OS, AFP, Intelligent Miner, WebSphere®, over the world. All other product and service names mentioned are the
TM
Netfinity®, Tivoli®, Informix and Informix® Dynamic Server are trademarks of their respective companies.
trademarks of IBM Corp. in USA and/or other countries.
HTML, DHTML, XML, XHTML are trademarks or registered Documentation in the SAP Service Marketplace
®
trademarks of W3C , World Wide Web Consortium, Massachusetts You can find this documentation at the following Internet address:
Institute of Technology. service.sap.com/instguides
Typographic Conventions Icons
Contents
May 2005 4
Installation Guide: SAP CRM Groupware Connector
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).
Implementation Considerations
Groupware Connector consists of the following components:
• Groupware Connector
• Groupware Connector Proxy
May 2005 5
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. 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. See next chapter for more details.
Integration
Relation of the components in Groupware Integration solution is provided in the following diagram.
Groupware
Groupware Groupware
Native Groupware
Connector Groupware
Server(s)
API Server
Proxy Server
SOAP
CRM
over Groupware
CRM Groupware DCOM / RMI
HTTP Connector
Adapter
Groupware Groupware
Groupware Groupware
Native Native Groupware
Connector Groupware
Server(s)
API API Server
Proxy Server
Groupware
Server (as
AddressBook
provider)
Groupware Connector deals with CRM via Groupware Adapter. SOAP over HTTP is used for collaboration.
Connection to Groupware Servers is provided via one or more Proxy instances. Connector uses native to
implementation platform protocol for internal collaboration with Proxies:
• DCOM for Exchange Groupware Connector, a Win32 executable
• RMI for Lotus Groupware Connector, a Java application.
Internal communication between Connector and its proxies is optimized to consume as minimum network
traffic as possible, thus allowing to build largely distributed solutions where Proxies provide link to remote
Groupware Servers.
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. This provides the
configuration easiest to maintain, but at the same time it provides the lowest performance.
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). Additional
instance of Groupware Connector Proxy is recommended to be setup in each LAN node of the Wide Area
Network. Instances of the Groupware Connector Proxy can be installed or removed after initial setup was
performed.
Following options can be considered to select the best solution
• Minimum required bandwidth between Groupware Connector and Remote Proxy instance is
128kbps.
• Minimum required bandwidth between Groupware Connector Proxy and remove Groupware Server
is 1Mbps. (This is the case for the simplest configuration).
• 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.
6 May 2005
Installation Guide: SAP CRM Groupware Connector
Variables
Variables Description
<SAPSID> SAP system ID in uppercase letters
May 2005 7
Installation Guide: SAP CRM Groupware Connector
Prerequisites
Process Flow
1. You print out the relevant checklist:
8 May 2005
Installation Guide: SAP CRM Groupware Connector
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 Preparations
! Action
Install Microsoft Outlook
Installation Process
! Action
May 2005 9
Installation Guide: SAP CRM Groupware Connector
Post-Installation Activities
! Action
None
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
Installation Guide: SAP CRM Groupware Connector
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.
Hardware Requirements
Component Description
Processor Intel PIII 600 MHz or higher
Minimum RAM 256 MB
Minimum Disk Space 500 MB
Display Mode 640x480x16 or better
Network Configuration Min 128kbps line, LAN is recommended
May 2005 11
Installation Guide: SAP CRM Groupware Connector
Component Description
Operating System Microsoft Windows 2000, Windows XP, Windows 2003
Exchanger Server Exchange Groupware Connector is compatible with following
versions of Exchange Server:
o MS Exchange Server 2003
o MS Exchange Server 2007
Collaboration Data Objects Collaboration Data Objects library is only available with the
(CDO) 1.2.1 following products:
o MS Exchange Server 2007
o MS Exchange Server 2003
o MS Outlook 2007
o MS Outlook 2003
SAP Groupware Connector must not be installed on groupware server system as the system
will already be overloaded, so we insist on installing Groupware Connector directly on groupware
server system itself.
Component Description
Operating System Microsoft Windows 2000, Windows XP, Windows 2003
Lotus Domino Server Lotus Domino Groupware Connector is compatible with
following versions of Lotus Domino Server:
o Lotus Domino 6.5.x
o Lotus Domino 7.0.x
Sun JDK or Sun JRE Sun JDK 1.4.2 or higher, or Sun JRE 1.4.2 or higher are
available for download starting from the link below:
http://java.sun.com/j2se/1.4.2/download.html
12 May 2005
Installation Guide: SAP CRM Groupware Connector
Sun Java Mail API 1.3.1 Available for download starting from:
http://java.sun.com/products/javamail/downloads/index.html.
Extract the downloaded zip file into a directory on the hard disk.
You will have to enter the file location during the installation
process.
Javabeans Activation Available for download starting from the link below:
Framework (JAF) 1.0.2 http://java.sun.com/products/javabeans/glasgow/jaf.html
Extract the downloaded zip file into a directory on the hard disk.
You will have to enter the file location during the installation
process.
Lotus Domino Server The version of the default Lotus Domino Server must be 6.5.x
or higher
May 2005 13
Installation Guide: SAP CRM Groupware Connector
4 Installation Preparations
4.1 Gathering Parameters of Groupware Adapter
This chapter describes how parameters, required for configuration of connection to Groupware Adapter, can
be obtained.
To determine the HTTP URL of the SOAP listener, perform the following steps:
1. Obtain HTTP server Host Name and Port
a. Enter the transaction code SMICM and choose Services.
b. On the Service Display screen, get the Host Name and the Service Name/Port for the HTTP
protocol (see the figure below).
This forms the http://[Host Name]:[Service Name/Port] part of the URL address.
2. Determine the relative path of the SOAP listener:
a. Enter the transaction code SICF.
b. Expand the tree to locate the soap node (usually found in default_host → sap → bc → soap
→rfc).
c. The path below the default_host node forms the rest of the URL address (sap/bc/soap/rfc),
i.e. finally you get http://[Host Name]:[Service Name/Port]/sap/bc/soap/rfc
14 May 2005
Installation Guide: SAP CRM Groupware Connector
3. The User Name, Password, Client and Language of the CRM System should be obtained from
Administrator of the CRM System.
May 2005 15
Installation Guide: SAP CRM Groupware Connector
The installation routine must be performed under the user account, which will be used for
running the SAP CRM Exchange Connector Service. During installation user account should
belong to local Administrators group.
The mailbox alias used in the installation settings is recommended to correspond to the same
user.
To create new account to be used as Exchange Connector’s administrative account, follow the steps below.
Use these steps as checklist if you are going to use already available account:
1. On computer with MS Exchange Server choose Start → Programs → Microsoft Exchange →
Active Directory Users and Computers.
2. Check whether the Groupware administrative account exists.
3. If not, select Users folder and execute Action New User from menu.
The options displayed below will be needed later during the installation process.
16 May 2005
Installation Guide: SAP CRM Groupware Connector
4. Start Exchange System Manager. In the left window locate the node that represents your
Exchange server.
Open the nodes following the path: First Organization Name → Administrative Groups →
First Administrative Group → Servers.
5. Select the target server and right-click on it.
7. Add the NT user account that was used as the Exchange Connector administrative account (See
Step 3). Grant at least following permissions:
May 2005 17
Installation Guide: SAP CRM Groupware Connector
• Read Permissions
• Receive As
• Send As.
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. Alternativelly one may desire to
setup access permission per individual mailbox or public folder.
Installation of Exchange Groupware Connector includes custom ExAclSet tool for batch assigning of
Client access permissions in mailbox folders. Refer to Batch-Assigning Access Rights for MS
Exchange Connector chapter in Adminstration Guide for more details.
Microsoft Outlook can be used for configuration diagnostics and troubleshooting purposes. It may be helpful
to have it installed on the computer with MS Exchange Server too.
When installing CDO (Collaboration Data Objects library) with MS Outlook 2000/XP/2003, make sure that:
18 May 2005
Installation Guide: SAP CRM Groupware Connector
• The Corporate or Workgroup mode is selected at the startup of MS Outlook. 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
NOTE: Collabaration data Objects (CDO) are no longer available with Outlook 2007 (Outlook 12).
Kindly download the CDO from the following micrsoft webstie link …
http://www.microsoft.com/downloads/details.aspx?FamilyID=E17E7F31-079A-43A9-BFF2-
0A110307611E&displaylang=en
You need to have permission to create sub-folders in the existing public folder.
1. Start MS Outlook. (You may need to create a user mail profile for the administrative account. In
this case, refer to the MS Outlook documentation on creating a new user profile.)
2. In the File menu, select New and choose Folder.
3. In the Name box, enter a folder name.
4. In the Folder contains box, select Contact items.
5. In the Select where to place the folder box, select the public folder where you want to include
your new public folder.
6. Start the MS Exchange System Manager.
7. Select the created folder. It can be found under the following node: First Organization Name →
Administrative Groups → First Administrative Group → Folders → Public Folders
8. Choose Action → Properties.
9. Provide SMTP e-mail addresses on the E-Mail addresses property page. This e-mail address
will be used to identify the public folder for Groupware Connector during the installation routine.
Make sure that Hide from Address Book is unchecked on Exchange Advanced property page.
10. Memorize the SMTP address of the public folder. You will need to enter it during the installation
process.
11. To setup valid access permissions to the Groupware Connector administrative account, press
the Client Permissions button on the Permissions property screen. At least Editor role
permissions are required.
20 May 2005
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 ...
6. Start MSH (Microsoft Shell) in Exchange Server System.
7. Use the following command to add permission to the public folder created in Step 3,
Get-PublicFolderStatistics -user "xxx" -accessright "editor" -identity "\yyy"
Where, xxx => To the User you wanted to Grant access permissions
yyy => Public folder name created in Step-3 with absolute path like \CRMContact
8. Then use this SMTP e-mail addresses on the E-Mail addresses property page. This e-mail address
will be used to identify the public folder for Groupware Connector during the installation routine.
Outlook Address Book is the client configuration. You will have to configure the same on every client
computer.
To register public folder in Outlook Address Book
May 2005 21
Installation Guide: SAP CRM Groupware Connector
1. To enable the Service, add an Outlook Address Book to the user profile.
using Outlook 2000
a. In the Tools menu, select Services.
b. On the Services tab, select Add.
c. In the Available information services box, select Outlook Address Book.
d. Press OK twice.
e. Restart Outlook.
using Outlook 2003
a. In the Tools menu, select E-mail accounts
b. Select View or change existing directories and address books, press Next
c. Ensure Outlook Address Book is listed.
d. If not present, click Add and select Addition Address Books. Press Next and select Outlook
Address Book.
e. Restart Outlook.
2. Setup the Contacts folder to be displayed in the Address Book dialog box.
a. (Using Outlook 2000) Select the View menu and then select Folder List, if the Folder List is
not visible.
(Using Outlook 2003) Select the Go menu and then select Folder List, if the Folder List is not
visible.
b. In the Folder List, Right-click on Contacts folder you want to display in the Address Book
dialog box and select Properties, go to the Outlook Address Book tab.
c. Select the Show this folder as an e-mail Address Book check box.
d. Enter the name for the Contacts folder you want to appear in the Show names from the box
in the Address Book dialog box.
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.
22 May 2005
Installation Guide: SAP CRM Groupware Connector
You may refer to Domino 5 Administration Help: Server Configuration → Setting up Notes users for more
details on this topic.
1. Start Lotus Domino Administrator and go to People & Groups tab
2. Expand the Public Address Book and right-click on People, select Register person
3. Fill in the user information and then press the Add person button and the Register button.
May 2005 23
Installation Guide: SAP CRM Groupware Connector
c. In the Access drop-down list, select at least Editor access level. Make sure that the Delete
documents checkbox is selected.
In Lotus Domino 6 it is possible for Administrator to grant access permissions for multiple
databases at the time. For more details see following section in Lotus Domino Administrator 6
Help Security The database access control list Editing entries in multiple ACLs.
This operation requires following access priveledges: Full access administrators, Administrator,
Database administrator. For more details see Lotus Domino Administrator 6 Help Server
access for Notes users, Internet users, 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. Refer to Batch-Assigning Access Rights for Lotus Domino Connector chapter
in Adminstration Guide for more details.
24 May 2005
Installation Guide: SAP CRM Groupware Connector
3. Get SMTP address of the database to be used when configuring target for Public Contacts
during setup routine.
To create new database
1. Start Lotus Domino Administrator
2. Select menu File Database New …
3. Provide nessesary information in pop-up dialog
It is recommended to use file names that are not longer than the 8.3 convention. The use of long
file names is possible if long file names are supported by the operating system the Lotus Domino
server works on.
Make sure that the Inherit future design changes option is not selected.
May 2005 25
Installation Guide: SAP CRM Groupware Connector
c. Add the Lotus Connector’s administrative account to the Access Control List, select the
Person as the User type and Designer as the Access authorization. Make sure the Delete
documents option is checked.
d. Assign the Reader access for the Default user and all other users of type Person displayed
in the Access Control List. Check that Read public documents is the only option enabled for
the users.
e.
The Lotus Groupware Connector must have rights to add, change and delete contacts in the
contacts database. The Connector must have the permission to change some elements of
design, such as the prefix and the suffix of the contact name. Designer’s rights permit to
perform these actions.
26 May 2005
Installation Guide: SAP CRM Groupware Connector
2. Go to People & Groups tab, expand Address Book and select Mail-In database & Resources.
b. On the Database Information tab provide domain, server, and filename information.
May 2005 27
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. Steps below are not
required in that case.
1. Name part is the value provided in Mail-in field during registering the database in Public Address
Book
2. To obtain Internet Domain part
a. Select the Configuration tab, expand the Messaging group, select Domains and expand
Global Domain on the right and then select your domain.
b. Open the Global Domain document and go to Conversions tab. The Internet domain to be
used is provided in local primary Internet domain field.
28 May 2005
Installation Guide: SAP CRM Groupware Connector
May 2005 29
Installation Guide: SAP CRM Groupware Connector
30 May 2005
Installation Guide: SAP CRM Groupware Connector
Field Enter
Enabled Choose Yes to enable Directory Assistance for this directory.
7. Select the Rules tab to enter the following fields:
Field Enter
Rule # One or more rules that describe the names in the directory. By default, the
first rule contains all asterisks, indicating all names in the directory (for
example, All).
Enabled Choose:
No – to disable a specific rule
Yes – to enable a specific rule
By default, the first rule is enabled.
Trusted for Choose:
Credentials
Yes – to allow Lotus Domino to use this directory to authenticate Web
clients with names that correspond to the rule.
No (default) – to prevent Lotus Domino from using this directory to
authenticate Web clients with names that correspond to the rule.
8. To specify (up to five) replicas of the secondary directory to use for Directory Assistance, press
the Replicas tab and enter the following fields.
If you authenticate web clients registered in the secondary directory and you also include the
directory in the directory catalog on the Replicas tab, specify the replica of the secondary Lotus
Domino directory you used to build the source directory catalog.
Do not specify a replica of the directory catalog in this field.
Field Enter
Database links Open the replica of the secondary directory and choose Edit → Copy As
Link → Database Link.
Select the Database links field and choose Edit → Paste.
Use database links only on Lotus Domino Release 5 servers. Using
database links may delay server startup because when you restart a
server that uses Directory Assistance, server tasks need to retrieve
database information from the remote servers the links refer to. Use
database links only if the servers the links refer to are consistently
available.
Replica # The server name and file name of each replica of the secondary directory,
for example:
Server name: Mail1/SAP
Directory file name: PUBLICNAMES.NSF
Next to each replica selected Enabled.
If you specify a replica in the Database links field and in the Replica field, the Replica field takes
precedence.
9. Press Save and Close. Restart the server.
May 2005 31
Installation Guide: SAP CRM Groupware Connector
Make sure you have rights to create replica databases on a server. You can check it by using
Domino Administrator. Select the server you need and then select Configuration Tab → Server
→ Current Server Document Security Tab Server Access Create Replica Databases.
Please contact Administrator to perform this step if you do not have that permission.
3. Grant access permission to Lotus Connectors’ administrative account on replica database. Refer
to the same point of Preparing Database for Storing CRM Contacts
4. Setup replication schedule in Lotus Notes client. See Notes 5 Help for details; section Notes
Away from the Office The Notes Replicator.
5. Repeat steps 1 and 2 for all necessary Private Address Book databases.
To provide exlusion list with location of replica databases of user’s Private Address Book
1. Finish the installation of Lotus Groupware Connector.
2. Create private-contact-map.xml in the Lotus Connector’s installation folder using Notepad or any
other text editor.
3. Provide list of exlusions using the sample below
32 May 2005
Installation Guide: SAP CRM Groupware Connector
<message xmlns="http://schema.sap.com/groupware">
<userlist method="read">
<user smtp_address="test1@epam.com">
<private-contact-map>
<server>epmsd007/mn/ep</server>
<file>mail/test01_ab</file>
</private-contact-map>
</user>
</userlist>
</message>
5 Installation Process
5.1 Installing MS Exchange Groupware Connector
Use
This procedure explains how to install the MS Exchange Groupware Connector on Windows 2000/XP/2003
platform.
Procedure
1. Log on to your host using prepared Groupware Connector’s administrative account.
2. Launch setup.exe
3. Click Next on the Welcome screen.
4. Read the text on the Installation Prerequisites screen and check if your computer meets all the software
and hardware requirements. If yes, press Next.
5. Select the type of SAP Groupware Connector you want to install. Check if you want to install instance of
Default Groupware Connector Proxy. Then press Next, wait while setup routine detects required
software.
May 2005 33
Installation Guide: SAP CRM Groupware Connector
6. Select the folder where the setup program will install the SAP Groupware Connector. The default folder
is: C:\Program Files\SAP\SAP Groupware Connector\<ServerType>.
o To select a different folder, choose Browse.
o Press Next
7. Provide the Groupware Adapter parameters. Refer to chapter Gathering Parameters of Groupware
Adapter for more details.
Press Next.
8. Provide Exchange Server connectivity options. NT Domain, NT User Name and Password parameters
will be used as LogOn information for Groupware Connector’s service. Groupware Connector will access
Exchange store using given account. Default reciepent SMTP Mail-id is optional. Properties of the
currently logged on users are provided by default. Press Next.
In case of parameters validation failure, more information can be obtained from the log files located in
%SystemRoot%\Temp\GWC_Installation_Logs.
34 May 2005
Installation Guide: SAP CRM Groupware Connector
These options are typically used to prevent replication of very old calendar items. One may use the
same to limit replication of contacts too
May 2005 35
Installation Guide: SAP CRM Groupware Connector
10. Review your settings on summary window and press Next to start copying files.
Procedure
1. Log on to your host using prepared Groupware Connector’s administrative account.
2. Launch setup.exe
3. Click Next on the Welcome screen.
4. Read the text on the Installation Prerequisites screen and check if your computer meets all the software
and hardware requirements. If yes, press Next.
36 May 2005
Installation Guide: SAP CRM Groupware Connector
5. Select ‘Exchange’ as Groupware Type. Select ‘Proxy’ in Component combo. Then press Next, wait while
setup routine detects required software.
6. Provide NT account to run Exchange Groupware Connecotor Proxy’s service. Proxy will access
Exchange store using given account. Properties of the currently logged on users are provided by default.
Press Next.
May 2005 37
Installation Guide: SAP CRM Groupware Connector
7. Review your settings on summary window and press Next to start copying files.
38 May 2005
Installation Guide: SAP CRM Groupware Connector
9. On the computer with installed Groupware Connector launch Admin Tool and register newly installed
Proxy instance. To do so
a. Goto Proxies General page and click Add New Proxy button on toolbar
b. In the popup dialog provide provide required values and press OK. Press Apply button in main
window to save changes to configuration file.
c. It is strongly recommended to set one Proxy instance as Default. This will ensure the messages
will be processed in case no explicit mapping configured for some target Exchange server.
10. The installtion and registration of new Proxy instance is complete.
May 2005 39
Installation Guide: SAP CRM Groupware Connector
Procedure
1. Log on to your host using prepared Groupware Connector's administrative account.
2. Launch setup.exe
3. Click Next on the Welcome screen.
4. Read the text on the Installation Prerequisites screen and check if your computer meets all the software
and hardware requirements. If yes, press Next.
5. Select the type of SAP Groupware Connector you want to install. Check if you want to install instance of
Default Groupware Connector Proxy. Then press Next, wait while setup routine detects required
software.
6. Select the folder where the setup program will install the SAP Groupware Connector. The default folder
is: C:\Program Files\SAP\SAP Groupware Connector\Lotus\1
o To select a different folder, choose Browse.
o Press Next
40 May 2005
Installation Guide: SAP CRM Groupware Connector
7. Select the folder containaing the NOTES.jar file. The default folder is: C:\Lotus\Notes
o To select a different folder, choose Browse.
o Press Next
8. Select the path where the Sun Java Mail API is installed.
o To select a different folder, choose Browse.
o Press Next
May 2005 41
Installation Guide: SAP CRM Groupware Connector
10. Provide the Groupware Adapter parameters. Refer to chapter Gathering Parameters of Groupware
Adapter for more details.
Press Next.
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, more information can be obtained from the log files located
in %SystemRoot%\Temp\GWC_Installation_Logs.
42 May 2005
Installation Guide: SAP CRM Groupware Connector
12. Specify global Lotus to CRM synchronization options, then press Next.
These options are typically used to prevent replication of very old calendar items. One may use the
same to limit replication of contacts too
May 2005 43
Installation Guide: SAP CRM Groupware Connector
13. Review your settings on summary window and press Next to start copying the files.
44 May 2005
Installation Guide: SAP CRM Groupware Connector
Procedure
1. Log on to your host using prepared Groupware Connector’s administrative account.
2. Launch setup.exe
3. Click Next on the Welcome screen.
4. Read the text on the Installation Prerequisites screen and check if your computer meets all the software
and hardware requirements. If yes, press Next.
5. Select ‘Exchange’ as Groupware Type. Select ‘Proxy’ in Component combo. Then press Next, wait while
setup routine detects required software.
May 2005 45
Installation Guide: SAP CRM Groupware Connector
6. Select the folder where the setup program will install the SAP Groupware Proxy. The default folder is:
C:\Program Files\SAP\SAP Groupware Connector\Lotus\1
o To select a different folder, choose Browse.
o Press Next
7. Select the folder containaing the NOTES.jar file. The default folder is: C:\Lotus\Notes
o To select a different folder, choose Browse.
o Press Next
46 May 2005
Installation Guide: SAP CRM Groupware Connector
8. Select the path where the Sun Java Mail API is installed.
o To select a different folder, choose Browse.
o Press Next
May 2005 47
Installation Guide: SAP CRM Groupware Connector
10. Review your settings on summary window and press Next to start copying files.
48 May 2005
Installation Guide: SAP CRM Groupware Connector
12. On the computer with installed Groupware Connector launch Admin Tool and register newly installed
Proxy instance. To do so
a. Goto Proxies General page and click Add New Proxy button on toolbar
b. In the popup dialog provide provide required values and press OK. Press Apply button in main
window to save changes to configuration file.
c. It is strongly recommended to set one Proxy instance as Default. This will ensure the messages
will be processed in case no explicit mapping configured for some target Lotus Domino server.
13. The installtion and registration of new Proxy instance is complete.
May 2005 49
Installation Guide: SAP CRM Groupware Connector
6 Post Installation
6.1 Running SelfTest
It is recommended to run SelfTest.cmd, located in Groupware Connector’s installation folder, after installation
is complete. This will launch the connector in self-test mode. Connector will check the configuration by trying
to connect to CRM Adapter, Groupware Server and so on.
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. No ERROR messages should be logged.
The last message in the output should be “Self Test Succeeded” in case of success and “Self Test
Failed” in case of failure.
7 Additional Information
7.1 Installation Troubleshooting
7.1.1 MS Exchange Connector
Alert Window Problem and Solution
Cause:
The user, who is currently logged in, does not have
administrator privileges on the current computer.
Solution:
Review the Required Parameters section and set
appropriate privileges for the user.
Cause:
The MS SOAP Toolkit Version 3 is not installed on the
target machine.
Solution:
You have to install the MS SOAP Toolkit from below
path and restart the Installation Wizard …
http://www.microsoft.com/downloads/details.aspx?Fa
milyId=C943C0DD-CEEC-4088-9753-
86F052EC8450&displaylang=en
50 May 2005
Installation Guide: SAP CRM Groupware Connector
Cause:
o Either Server Name or Mailbox Alias is invalid
when providing Exchange Server parameters.
o Requred MS CDO library is not installed.
Solution:
A detailed error description is available in the file:
C:\Temp\Logs\ExchangeGWConnector.log
Correct your settings or check the documentation to
tune the MS Exchange Server properly for work with
CDO.
Cause:
The given user name and/or the password are not
valid.
Solution:
Correct the user_name and/or the password.
May 2005 51
Installation Guide: SAP CRM Groupware Connector
Cause:
Soap.jar is not found. The Installation Wizard stops.
Solution:
Check the folder where the Apache SOAP is installed.
If it is not installed, you have to close the installation,
install the required software and restart the Installation
Wizard.
Cause:
Mail.jar is not found. The Installation Wizard stops.
Solution:
Check the folder where the Sun Java Mail API 1.2 is
installed. If it is not installed, close the installation,
install the required software and restart the Installation
Wizard.
Cause:
Activation.jar is not found. The Installation Wizard
stops.
Solution:
Check the folder where the JavaBeans Activation
Framework is installed. If it is not installed, close the
installation, install the required software and restart
the Installation Wizard.
Cause:
Current Lotus Client password is not valid.
Resolution:
Enter a valid password.
Cause:
The Path to the Notes home directory was not found.
Resolution:
Check your environment.
52 May 2005
Installation Guide: SAP CRM Groupware Connector
Setting multiple instances of Groupware Connector components intended only for testing purposes and not
supported in Production environment.
Components of Groupware Connector will talk only to the components having the same instance ID. E.g.:
Groupware Connector installed with instance ID equal to 3 will connect only to Proxy instances installed with
instance ID equal to 3.
May 2005 53