Installation and Configuration Guide
Sybase Mobile Sales for SAP
®
DOCUMENT ID: DC01180-01-0110-01 LAST REVISED: August 2010
Copyright © 2010 by Sybase, Inc. All rights reserved.
This publication pertains to Sybase software and to any subsequent release until otherwise indicated in new editions or technical notes. Information in this document is subject to change without notice. The software described herein is furnished under a license agreement, and it may be used or copied only in accordance with the terms of that agreement.
To order additional documents, U.S. and Canadian customers should call Customer Fulfillment at (800) 685-8225, fax (617) 229-9845.
Customers in other countries with a U.S. license agreement may contact Customer Fulfillment via the above fax number. All other international customers should contact their Sybase subsidiary or local distributor. Upgrades are provided only at regularly scheduled software release dates. No part of this publication may be reproduced, transmitted, or translated in any form or by any means, electronic, mechanical, manual, optical, or otherwise, without the prior written permission of Sybase, Inc.
Sybase trademarks can be viewed at the Sybase trademarks page at http://www.sybase.com/detail?id=1011207. Sybase and the marks listed are trademarks of Sybase, Inc. ® indicates registration in the United States of America.
Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.
Unicode and the Unicode Logo are registered trademarks of Unicode, Inc.
All other company and product names mentioned may be trademarks of the respective companies with which they are associated.
Use, duplication, or disclosure by the government is subject to the restrictions set forth in subparagraph (c)(1)(ii) of DFARS 52.227-7013 for the DOD and as set forth in FAR 52.227-19(a)-(d) for civilian agencies.
Contents
CHAPTER 1: Sybase Mobile Sales for SAP CRM
Solution Architecture ...1
CHAPTER 2: Installation Task Flow for Windows
Mobile ...3
CHAPTER 3: Installation Task Flow for iPhone ...7
CHAPTER 4: Planning Your Installation ...11
System Requirements ...11
Device Requirements ...12
Supported Languages ...13
Installation Prerequisites ...13
Server Prerequisites ...13
SAP CRM ESDMA Package Deployment
Prerequisites ...14
Device Prerequisites ...15
Upgrade Prerequisites ...16
Demo Mode ...16
CHAPTER 5: Installing Device Files for Mobile Sales
and Deploying an ESDMA Package Using the
Installer ...19
CHAPTER 6: Uninstalling Device Files for Mobile
Sales Using the Uninstaller ...21
CHAPTER 7: Troubleshooting ESDMA Deployment
...23
CHAPTER 8: Troubleshooting for Windows Mobile
...25
CHAPTER 9: Troubleshooting for iPhone ...27
APPENDIX A: Mobile Sales Configuration File for
Windows Mobile ...29
APPENDIX B: Deploying the SAP CRM ESDMA using
the Command Line Utility ...33
Preparing the SAP CRM ESDMA for Deployment ...33
Deploying the SAP CRM ESDMA to Unwired Server ...35
APPENDIX C: Obtaining Help and Additional
Information ...37
Index
...39
ContentsCHAPTER 1
Sybase Mobile Sales for SAP
CRM Solution Architecture
The Sybase® Mobile Sales for SAP® CRM solution enables the availability of key SAP CRM
processes on iPhone and Windows Mobile devices. The architecture leverages components from both SAP and Sybase to deliver a comprehensive push-enabled end-to-end solution. The key components of the architecture include:
• SAP® Customer Relationship Management (CRM)
• SAP NetWeaver® Mobile – this SAP middleware component provides for data
consolidation and data distribution services.
• Sybase Unwired Platform – Sybase Unwired Platform delivers the Sybase SAP DOE Connector that receives push messages from SAP and guarantees delivery to mobile devices.
• Sybase Relay Server – Relay Server solves IT security problems by letting servers and devices connect without requiring changes to your existing corporate firewall
configurations and policies.
• Sybase Mobile Sales for SAP CRM application, which runs on iPhone and Windows Mobile devices.
CHAPTER 2
Installation Task Flow for
Windows Mobile
This task flow defines a path for system administrators to install and provision the Sybase Mobile Sales for SAP® CRM application to a Windows Mobile device.
Note: For information on customizing the application for your organization, see the Sybase Mobile Sales for SAP Customization White Paper.
Installation Tasks
1. Review system and device requirements. See Chapter 4, Planning Your Installation on
page 11, with particular attentionn to installation prerequisites for the server and ESDMA package deployment.
2. Install Sybase Unwired Platform.
• Perform the installation based on your license type.
• When performing the installation, verify that the option to Start Unwired Platform
Services automatically is selected.
• See Installation Task Flows in the Sybase Unwired Platform Installation Guide.
3. Install Sybase SAP® DOE Connector. See the Installation Task Flows in the Sybase SAP DOE Connector Installation and Configuration Guide.
4. Install Sybase Mobile Sales for SAP CRM using the installation media.
Install the Mobile Sales application on the same machine as you installed Sybase Unwired Platform and Sybase SAP DOE Connector.
The installer:
• Deploys a CRM Entity Set Definitions for Mobile Applications (ESDMA) package.
Note: As a secondary method of ESDMA deployment, you can use the CLU utility.
See the Appendix: Deploying the SAP CRM ESDMA using the Command Line Utility in this guide for complete CLU instructions.
• Installs the CAB files for Windows Mobile Professional and Windows Mobile Standard. These files are required if you intend to deploy the Mobile Sales Application to Windows Mobile devices as-is, without customization.
The default installation location is: <UnwiredPlatform_InstallDir> \UnwiredPlatform\Mobile Sales for SAP CRM. The CAB files are located in the WM subdirectory.
Device Operating System CAB file names
Windows Mobile Professional SUPMessaging_Pro.cab
SybaseMobile-Sales_Pro_<version>.cab Windows Mobile Standard SUPMessaging_Std.cab
SybaseMobile-Sales_Std_<version>.cab
Provisioning Tasks
1. Register each device using Sybase Control Center so it can connect to Unwired Server. For
each device, be sure to note: • the user name
• Relay Server name, or Unwired Server name if Relay Server is not used.
• Relay Server port number, or Unwired Server port number if Relay Server is not used. • Relay Server farm ID (skip this is Relay Server is not used)
• activation code
See Registering and Setting Up Messaging Devices in the Sybase Control Center online help.
2. Ensure all device users have an SAP account.
3. (Optional) Modify the Mobile Sales system configuration for Windows Mobile in the SybaseCRM.Configuration.xml file. You must update and provision this file to the device before users log into the application (subscribe) for the first time. See Appendix A, Mobile Sales Configuration File for Windows Mobile on page 29.
4. Provision the application files to the device.
How many devices are you provision-ing?
Method Where to find more information
Personal/developer in-stallations
Copy the CAB file to each device to install.
Sybase Mobile Sales for SAP CRM De-vice User Guide for Windows Mobile > Installing Mobile Sales on Your Windows Mobile Device .
Enterprise/large installa-tions
Use Sybase Unwired Platform to provision the application to multiple devices.
Sybase Unwired Platform System Ad-ministration > System Administration > Device User Management > Device Pro-visioning > Afaria ProPro-visioning and De-vice Management .
5. Prepare instructions for device users. As the system administrator you can send users a
application to the device. Alternately, you can provide the location of the CAB files and users can copy the CAB files to their device, for example, using ActiveSync.
User Tasks
1. Device users install device prerequisites. See Installation Prerequisities on page 13. 2. Ensure that device users create a Notifications messaging account. See Sybase Mobile
Sales for SAP CRM User Guide for Windows Mobile > Creating a Notifications Messaging Folder.
3. Per the system administrator's instructions, users download and install the CAB files on
the device.
4. After CAB file installation, users indicate the Unwired Server connection information in
Sybase Settings before launching the Mobile Sales application.
Note: Connection settings do not need to be set if you are running Mobile Sales in Demo
mode.
See Sybase Mobile Sales for SAP CRM Device User Guide for Windows Mobile > Sybase Mobile Sales for SAP CRM > Connection Settings .
5. Device users start Sybase Mobile Sales for SAP CRM.
See Sybase Mobile Sales for SAP CRM Device User Guide for Windows Mobile > Starting Sybase Mobile Sales .
6. If necessary, users can unsubscribe or resubscribe from the device.
See Sybase Mobile Sales for SAP CRM Device User Guide for Windows Mobile > Getting Started with Mobile Sales > Unsubscribing and Resubscribing to Mobile Sales .
See also
• Appendix A, Mobile Sales Configuration File for Windows Mobile on page 29
• Chapter 5, Installing Device Files for Mobile Sales and Deploying an ESDMA Package Using the Installer on page 19
CHAPTER 3
Installation Task Flow for iPhone
This task flow defines a path for system administrators to install and provision the Sybase Mobile Sales for SAP CRM application to the iPhone device.
Installation Tasks
1. Review system and device requirements. See Chapter 4, Planning Your Installation on
page 11, with particular attention to installation prerequisites for the server and ESDMA package deployment.
2. Install Sybase Unwired Platform.
• Perform the installation based on your license type.
• When performing the installation, verify that the option to Start Unwired Platform
Services automatically is selected.
• See Installation Task Flows in the Sybase Unwired Platform Installation Guide.
3. Install Sybase SAP DOE Connector. See the Installation Task Flows in the Sybase SAP
DOE Connector Installation Guide.
4. Your implementation plan must include deployment of a CRM Entity Set Definitions for
Mobile Applications (ESDMA). You can use the Sybase Mobile Sales for SAP CRM installer to deploy the ESDMA package. Choose one the following:
• Deploy the ESDMA package using the command line utility (CLU). See the Appendix: Deploying the SAP CRM ESDMA using the Command Line Utility in this guide for complete CLU instructions.
• Install Sybase Mobile Sales for SAP CRM using the installation media.
Note: If you select this method, the installer also installs the device files for Windows
Mobile. These device files can be left in place or removed following the installation.
Provisioning Tasks
1. Register each device using Sybase Control Center so it can connect to Unwired Server. For
each device, be sure to note: • the user name
• Unwired Server name
• Unwired Server port number, or Relay Server port number if Relay Server is used • relay server farm ID (if applicable)
• activation code
See Registering and Setting Up Messaging Devices in the Sybase Control Center online help.
3. Provision the application files to the device and install the application.
Are you cus-tomizing the application?
Method Where to find more information
No Download and install the Sybase Mobile Sales & Task Flow application from the App Store.
Sybase Mobile Sales for SAP CRM Device User Guide for iPhone > Installing Mobile Sales on Your iPhone Device > Installing Mo-bile Sales from App Store
Yes Provision the application profile and application to the device. You can also place the application image on the network and send users information about how to obtain it and install it using iTunes.
• Sybase Unwired Platform System Ad-ministration > System AdAd-ministration > Device User Management > Device Pro-visioning > Apple ProPro-visioning for iPhone
• Sybase Mobile Sales for SAP CRM De-vice User Guide for iPhone > Installing Mobile Sales on Your iPhone Device > Installing Mobile Sales Using iTunes
4. If you are using Apple Push Notifications Service (APNS), confirm that the Unwired
Server has been configured for APNS and that a successful connection to the gateway has been established.
This is typically completed by the administrator in Sybase Control Center. See System Administration for Sybase Unwired Platform > System Administration > Device User Management > Device Provisioning > Apple Provisioning for iPhone.
User Tasks
1. Device users indicate the Unwired Server connection information in Sybase Settings
before launching the Mobile Sales application.
Note: Connection settings do not need to be set if you are running Mobile Sales in Demo
mode.
If you do not enter the connection information, the application prompts you to enter this information the first time you start it.
See Sybase Mobile Sales for SAP CRM User Guide for iPhone > Sybase Mobile Sales for SAP CRM > Connection Settings.
2. Users start Sybase Mobile Sales for SAP CRM.
See Sybase Mobile Sales for SAP CRM Device User Guide for iPhone > Starting Sybase Mobile Sales.
3. If necessary, users can unsubscribe or resubscribe from the device.
See Sybase Mobile Sales for SAP CRM Device User Guide for iPhone > Getting Started with Mobile Sales > Unsubscribing and Resubscribing to Mobile Sales.
4. If using Apple Push Notifications Service (APNS), the user must enable notifications on
each device. Users must go to the iPhone Settings app, select Sybase, then slide the
Notifications control to On.
CHAPTER 4
Planning Your Installation
Before you install or upgrade, plan your environment. View the release bulletin for the latest information on system requirements and patches.
1. Make sure your system meets all the requirements for your installation scenario. 2. Install the prerequisites.
See also
• Chapter 5, Installing Device Files for Mobile Sales and Deploying an ESDMA Package Using the Installer on page 19
System Requirements
Make sure your system meets all requirements before you install. See the release bulletin for the most current information about required system patches.
• For system and disk space requirements for Sybase Unwired Platform, including Unwired Server, Relay Server, and Afaria®, see the Sybase Unwired Platform Installation Guide.
• For system and disk space requirements for Sybase SAP DOE Connector, see the Sybase SAP DOE Connector Installation Guide.
Table 1. Disk space requirements
This table indicates the disk space requirements when installing Sybase Mobile Sales for SAP CRM on the machine running Sybase Unwired Platform using the Mobile Sales installation media.
Product Disk Space Required
Sybase Mobile Sales for SAP CRM 99.0 MB
Table 2. SAP Compatibility Matrix SAP product Supported versions
SAP® Customer Relationship Management
(CRM)
2007 SP04 and later 7.0 SP03 and later SAP NetWeaver® Mobile 7.1 SP09 and later
SAP product Supported versions
Entity Set Definitions for Mobile Applications (ESDMA)
MAS_SMARTPHONE_SALES_V00; version VG001
See also
• Server Prerequisites on page 13
• SAP CRM ESDMA Package Deployment Prerequisites on page 14
Device Requirements
Sybase Mobile Sales for SAP CRM can run on these devices.
Supported Devices
• Apple iPad, iOS 3.2 (compatibility mode) • Apple iPhone 4
• Apple iPhone 3GS, iOS 4.x • Apple iPhone 3G, iOS 4.x • Apple iPod touch 3G, iOS 4.x
Note: For better performance, Sybase recommends using an Apple iPhone 3GS or Apple
iPhone 4 device.
• Windows Mobile 6.1.x Professional • Windows Mobile 6.1.x Standard • Windows Mobile 6.0.x Professional • Windows Mobile 6.0.x Standard
Device Storage Requirements
Make sure you have the minimum free storage space before installing the Mobile Sales application on the device. You may need more depending on how much data you store on the device.
• Windows Mobile: 40MB internal storage • iPhone: 5MB
See also
Supported Languages
Mobile Sales labels and messages appear in several supported languages. • English
• French • German • Spanish
Live Mode
If your device is set to a supported language, Mobile Sales labels and messages automatically appear in that language. If your device is set to an unsupported language, you can select the Mobile Sales display language during login. the Mobile Sales default language is English; however, you can change to a different supported language after logging in.
Demo Mode
If you are running Mobile Sales in Demo mode, the Mobile Sales data displays in English, while application labels and messages appear in the selected supported language, or English for unsupported languages.
SAP System Messages
SAP system messages appear in the language defined for the SAP system. If the SAP system is set up for English, warning messages and field names appear in English, for example, when creating or updating an account, contact, or activity, or viewing and editing Analytics report options.
Installation Prerequisites
Install the required prerequisites for Sybase Mobile Sales for SAP CRM before launching the installer. There are three types of prerequisites: server prerequisites, ESDMA deployment prerequisites, and device prerequisites.
See also
• Device Requirements on page 12
Server Prerequisites
Sybase Unwired Platform and Sybase SAP DOE Connector must be installed before installing Sybase Mobile Sales for SAP CRM on the server.
Install Mobile Sales on the same machine as Sybase Unwired Platform and Sybase SAP DOE Connector.
Product Version Description
Sybase Unwired Platform 1.5.2 First, install Sybase Unwired Platform from the Sybase Unwired Platform instal-lation media.
Sybase SAP DOE Connec-tor
1.1 Second, install Sybase SAP DOE nector from the Sybase SAP DOE Con-nector installation media.
See also
• System Requirements on page 11
• SAP CRM ESDMA Package Deployment Prerequisites on page 14
SAP CRM ESDMA Package Deployment Prerequisites
Deployment of an SAP CRM ESDMA package is required for your Sybase Mobile Sales for SAP CRM implementation.
You can use the Sybase Mobile Sales installer to deploy the SAP CRM Entity Set Definitions for Mobile Applications (ESDMA) package.
Determine if you want the Mobile Sales installer to deploy an SAP CRM ESDMA package. The SAP CRM ESDMA:
• Must be deployed as part of the Sybase Mobile Sales for SAP CRM solution. If you do not deploy the ESDMA with the Mobile Sales installer, you must deploy the ESDMA using the command line utility.
See Appendix: Deploying the SAP CRM ESDMA using the Command Line Utility in this guide for complete CLU instructions.
• Is generated using the ESDMA Editor provided with gateway to SAP NetWeaver Mobile. Download the ESDMA zip file as an ESDMA bundle from gateway to SAP NetWeaver Mobile. The ESDMA generation process creates a zipped bundle that contains an XML metadata and WSDLs that define necessary metadata for the Sybase SAP DOE Connector. • Only needs to be deployed once,
• To the first installed node of the cluster if you have Sybase Unwired Platform installed as a cluster.
• Regardless of the variety of devices types you are targeting in your Sybase Mobile Sales for SAP CRM solution.
If yes, the installer prompts you for:
Field Detail
Location of the ESDMA bun-dle zip file
Provided by the SAP administrator. The ESDMA is downloaded from the NetWeaver/Mobile gateway using the ESDMA Browser.
Field Detail SAP Technical User ID and
Password
Provided by the SAP administrator; a technical user who can per-form all User actions on SAP server.
SUP Listener IP Address and Port
Provided by the Sybase Unwired Platform administrator.
SUP Admin User ID and Pass-word
Provided by the Sybase Unwired Platform administrator.
See also
• System Requirements on page 11 • Server Prerequisites on page 13
• Appendix B, Deploying the SAP CRM ESDMA using the Command Line Utility on page 33
• Chapter 5, Installing Device Files for Mobile Sales and Deploying an ESDMA Package Using the Installer on page 19
Device Prerequisites
Before the Mobile Sales application is installed on mobile devices, device prerequisites must be met. Users can individually install the prerequisites or the administrator can stage prerequisite installations for device users.
Windows Mobile device prerequisites
Product Version Description
Microsoft ActiveSync 4.5 or later (Optional) If provisioning the files man-ually, allows synchronization of files be-tween the Sybase Unwired Platform ma-chine and the Windows Mobile emulator or device. Download it on the Microsoft web site at http://www.microsoft.com/ windowsmobile/en-us/downloads/micro-soft/activesync-download.mspx. Install ActiveSync on the computer used to sync the device.
Product Version Description
.NET Compact Frame-work
3.5 You can download it from the Microsoft Web site at http://www.microsoft.com/ downloads/details.aspx?Family-ID=E3821449-3C6B-42F1-9FD9-00413 45B3385&displaylang=en.
Install .NET Compact Framework on the device.
.NET Compact Frame-work Messages for Win-dows Mobile
3.5 (Optional) Provides localized Windows Mobile error messages. All Mobile Sales messages are available in the supported languages.
Install .NET Compact Framework Mes-sages for Windows Mobile on the device. Note: Afaria provisioning features can be used to push the .NET Compact Framework
components to devices. See System Administration for Sybase Unwired Platform > System Administration > Device and User Management > Device Provisioning > Afaria Provisioning and Mobile Device Management.
Upgrade Prerequisites
Complete the required prerequisites for Sybase Mobile Sales for SAP CRM before launching the installer.
• Complete pending operations.
• Uninstall the existing version of Sybase Mobile Sales for SAP CRM from the server. See Chapter 6, Uninstalling Device Files for Mobile Sales Using the Uninstaller on page 21.
• Complete the Installation Task Flow appropriate for your implementation.
Demo Mode
Use demo mode to review the Mobile Sales application from the device without connecting to the enterprise.
By running Mobile Sales in demo mode, device users can review and evaluate the application functionality without connecting to the SAP backend system.
• For Windows Mobile devices:
1. Run the Sybase Mobile Sales for SAP CRM installer to copy the device files to a local
machine.
2. Copy the appropriate .cab files to a location where all device users have access. 3. Each device user navigates to this location from the device, for example using
ActiveSync, copies the .cab file and installs the Mobile Sales application.
4. Each device user launches Mobile Sales and selects Yes to launch the application in
demo mode. • For iPhone:
1. Each device user downloads the Mobile Sales application from App Store or iTunes
and runs the Mobile Sales installation on the iPhone device.
2. Each device user launches Mobile Sales and selects Yes to launch the application in
demo mode.
CHAPTER 5
Installing Device Files for Mobile
Sales and Deploying an ESDMA
Package Using the Installer
Use the installer to make Windows Mobile device-specific Sybase Mobile Sales for SAP CRM mobile application files available for provisioning from the server and to deploy a CRM ESDMA package.
Prerequisites
• Install the prerequisites.
• Determine if you want the Mobile Sales installer to deploy an SAP CRM ESDMA package. See SAP CRM ESDMA Package Deployment Prerequisites in this guide. • Shut down any Sybase products or processes, and associated third-party processes. • If you are installing the CRM ESDMA using the installer, verify that Unwired Server is
started.
• Verify that you are logged in with administrative rights.
• Install Sybase Mobile Sales for SAP CRM from the installation media on the same machine where you installed Sybase Unwired Platform and Sybase SAP DOE Connector. If Sybase Unwired Platform is installed in a cluster, install Sybase Mobile Sales for SAP CRM and deploy the SAP CRM ESDMA to the primary node.
Task
Sybase Mobile Sales for SAP CRM installs in the Sybase Unwired Platform installation directory:<UnwiredPlatform_InstallDir>\UnwiredPlatform\Mobile Sales for SAP CRM, where <UnwiredPlatform_InstallDir> is C:\Sybase
if the default location was used to install Sybase Unwired Platform.
1. Insert the Sybase Mobile Sales for SAP CRM installation media.
If you are installing from a Web download, extract the archive to a temporary directory on the local disk, not a shared drive.
2. On the installer welcome page, click Next. 3. Accept the terms of the license agreement.
a) Select the appropriate geographic location and read the license agreement. b) Select I Do Agree to the Terms of the Sybase License, for the Install Location
Specified, then click Next.
4. Select the checkbox if you want the installer to deploy a CRM ESDMA package, then click Next.
If you chose to deploy the SAP CRM ESDMA, the installer prompts you to enter the location of the ESDMA package, and connection information for SAP and SUP. Enter this information, then click Next.
5. Click Install.
The installation log, CRMInstall.log, is available in
<UnwiredPlatform_InstallDir>\UnwiredPlatform\InstallLogs.
Next
Provision the Mobile Sales application to the device.
See also
• Chapter 4, Planning Your Installation on page 11
• Chapter 2, Installation Task Flow for Windows Mobile on page 3 • SAP CRM ESDMA Package Deployment Prerequisites on page 14
CHAPTER 6
Uninstalling Device Files for
Mobile Sales Using the
Uninstaller
If you installed Sybase Mobile Sales for SAP CRM using the installation media, you can uninstall the device files using the Add or Remove Programs option on the Control Panel, which launches the uninstaller. Uninstall Mobile Sales before reinstalling or upgrading.
Prerequisites
You must remove the CRM ESDMA package (SAP_CRM:1.0) deployed to Sybase Unwired Server.
Use SCC or the command line utility (CLU) to remove the ESDMA package before running the uninstaller.
• See SCC online help to use the delete option to delete the SAP_CRM:1.0 package. • See the Sybase SAP DOE Connector Installation Guide, Appendix: SAP DOE Connector
Utility to run the removePackages command.
Task
Note: To uninstall the Mobile Sales application from a mobile device, see the user guide for
your device type: Sybase Mobile Sales for SAP CRM User Guide for Windows Mobile or Sybase Mobile Sales for SAP CRM User Guide for iPhone.
1. From the Control Panel, select Add or Remove Programs.
2. Select Sybase Mobile Sales for SAP CRM <version> , and click Change/Remove. 3. Click Next in the welcome window.
4. Click Uninstall.
5. Click Finish when the following message appears: The InstallShield wizard has successfully uninstalled Sybase Mobile Sales for SAP CRM <version> .
CHAPTER 7
Troubleshooting ESDMA
Deployment
Provides troubleshooting information when the message that the ESDMA deployment was unsuccessful.
If you attempted to deploy the SAP CRM ESDMA and received a message indicating that the deployment was not successful
Issue: Deployment of the SAP CRM ESDMA resulted in receiving a message indicating that
the deployment was not successful.
Solution: Check to verify that the Relay Server or Unwired Server port number used was
correct. If an incorrect port number was used, the ESDMA deployment fails.
Entering the incorrect port number or host causes problems with ESDMA deployment. The administrator needs to use SCC to delete or CLU to remove the ESDMA package
(SAP_CRM:1.0), then uninstall Mobile Sales for SAP CRM, and reinstall using the correct information.
To use Sybase Control Center: use the delete option to delete the SAP_CRM:1.0 package. See SCC online help for further instructions.
To use CLU:
• On the server where you attempted to run the installation, start up clu.bat. • Run the removePackages command.
• Log in to Sybase Control Center to verify that the package has been removed. • See Deploying the SAP CRM ESDMA using the Command Line in this guide for
instructions on redeploying the SAP CRM ESDMA.
See also
• Appendix B, Deploying the SAP CRM ESDMA using the Command Line Utility on page 33
CHAPTER 8
Troubleshooting for Windows
Mobile
Provides troubleshooting information when installing and configuring Sybase Mobile Sales for SAP CRM for Windows Mobile. See the Sybase Mobile Sales for SAP CRM Release Bulletin for the latest information. For information on Sybase Unwired Platform issues, see the Sybase Unwired Platform Release Bulletin.
Wrong Device for Code
Issue: When entering the Unwired Server connection information, the error Wrong Device for Code appears in the Sybase Settings log.
Solution: Use Sybase Control Center to clone the user, then have the device user restart the client.
1. From Sybase Control Center: a. Clone the user.
b. Delete the old user. 2. On the device:
a. Verify that Connection Properties are correct.
b. Go to Sybase Settings > Advanced > Restart Client to restart the client.
The client restart should automatically establish a connection.
3. Try again to connect.
Device Is Not Connected to Unwired Server
Issue: Device must be cradled or have network connectivity. Solution 1: Check that the device is connected to Unwired Server: • Start > Programs > Sybase Settings.
• Select Menu > Show Log.
• Check the log for Connected to Server, and look at the timestamp to see if you are currently connected.
Solution 2: Check that device is connected from Unwired Server:
• Start Sybase Control Center. See Sybase Unwired Platform Installation Guide. • Check if the status is connected and a device value is present. See Checking Unwired
CHAPTER 9
Troubleshooting for iPhone
Provides troubleshooting information when installing and configuring Sybase Mobile Sales for SAP CRM for iPhone. See the Sybase Mobile Sales for SAP CRM Release Bulletin for the latest information. For information on Sybase Unwired Platform issues, see the Sybase Unwired Platform Release Bulletin.
Connection Fails With No Error Message
Issue: Mobile Sales for iPhone does not always provide connection failed errors on the device. Workaround: If you suspect that you are not connected to the SAP system, for example, if you did not enter the Unwired Server connection information correctly, you can check on the device or by using Sybase Control Center.
On the device:
1. From within the Mobile Sales application, tap Settings > General > Connection Information.
2. View the Connection status: Failed or Active.
On Sybase Control Center:
1. Start Sybase Control Center. See Sybase Unwired Platform Installation Guide.
2. For the Unwired Platform Cluster, select Users > Messaging. Click Get Trace to retrieve
the device log. See also Sybase Control Center online help.
Synchronization with the SAP system is pending for a long period of time
Issue: While starting the Mobile Sales application from your iPhone, the phone shows the synchonization as pending for an excessively long time. This can be an indication that the connection to the SAP system had failed.
Workaround:
1. Resolve the connection issue. Contact the administrator for assistance, if necessary. 2. Unsubscribe the iPhone. See Unsubscribing to Mobile Sales in the iPhone Device User
Guide for additional information.
a. From the Mobile Sales home page, select Settings > General > Connection Information.
b. Tap Unsubscribe.
c. Confirm that you want to unsubscribe.
3. Start Mobile Sales, then tap Settings > General > Connection Information to see if the
connection is active. Starting Mobile Sales initiates the synchonization process with the successful connection.
APPENDIX A
Mobile Sales Configuration File
for Windows Mobile
System Administrators can modify the Mobile Sales system configuration for Windows Mobile in the SybaseCRM.Configuration.xml file. You must update and provision this file to the device before logging into the application (subscribing) for the first time.
The Mobile Sales installation for Windows Mobile contains two versions of this configuration file.
File name Location on Windows Mobile device Purpose SybaseCRM.Con- figuration_tem-plate.xml \Program Files\Mo-bile Sales\Tem-plates
To change system configuration set-tings for your company, modify this version of the configuration file. Mod-ify options that begin with SYS_. De-vice users can modify the other options in this file by changing application set-tings.
SybaseCRM.Con-figuration.xml
Note: Do not modify.
This file is the runtime version of the configura-tion file.
\Program Files\Mo-bile Sales\Data
During application startup, the Mobile Sales application copies the version from the Templates directory to the Da-ta directory. When device users change Settings from within the application, the new values are written to this con-figuration file.
Once you modify the template version of this file, you can provision it to one or more devices. For personal/developer installations, you can overwrite the default file in the Templates directory, for example, using ActiveSync. For enterprise installations, use Sybase Unwired Platform to provision the configuration file to the device. In Sybase Unwired Platform System Administration, see Systems Administration > Device User Management > Device
Table 3. Mobile Sales for Windows Mobile system configuration options Configuration option Description
SYS_PushToNativeContact Determines how native contacts synchronize with Mobile Sales contacts.
• Automatic – all new Mobile Sales contacts become personal contacts; however, you must manually indicate which new personal contacts become Mobile Sales contacts. Once connected, if you change contact data in one place, it automatically synchronizes it. • Manual (default) – you must indicate which
Mobile Sales contacts that you want to copy to your native contacts, and which personal contacts you want to convert to Mobile Sales contacts. Once you indicate this connection, changes to contact data in one place automat-ically synchronizes data between both con-tact instances.
• None – you cannot link personal and Mobile Sales contacts.
SYS_PushToNativeCalendar Determines how native calendar entries syn-chronize with Mobile Sales activities.
• Automatic – new Mobile Sales activities for meetings, tasks, and appointments become personal calendar entries; however, you must manually indicate which new personal calen-dar entries become Mobile Sales activities. Once connected, if you change data in one place, it automatically synchronizes it. • Manual (default) – you must indicate which
Mobile Sales activities that you want to copy to your native calendar, and which personal calendar entries you want to convert to Mo-bile Sales activities. Once you indicate this connection, changes to data in one place au-tomatically synchronizes data between both instances.
• None – you cannot link personal calendar entries and Mobile Sales activities.
Configuration option Description
SYS_MaximumLoginAttempts Indicates the maximum number of incorrect login attempts before the user is locked out of the ap-plication.
SYS_MaximumLoginAttemptsExceeded Indicates whether the device user has exceeded the maximum number of login attempts. If this option is set to true, the user has exceeded the limit. Instruct the device user to edit this file and set it back to false to be able to log into the ap-plication.
SYS_MinimumMemory Indicates the minimum memory required, in MB, for creating the database and initially subscribing to the SAP system. If this minimum memory is not met, a subscribe is not attempted. If the data-base already exists, this parameter is ignored. The default is 2MB.
In organizations where devices are expected to store large data sets, you can increase this value so that storage memory is not exhausted during the initial subscribe.
SYS_SubscriptionBlockSize Determines the number of messages processed in each message processing interaction from the message queue. The default is 10.
Note: Do not set this value to 0. Use caution in
setting this value to a large number or increasing it significantly; runtime memory could be con-sumed during the processing of a large block of messages, thus affecting overall performance. SYS_Enable_Accounts Enables the Accounts facet in the application. Enter false to disable the functionality and re-move the icon from the home screen.
SYS_Enable_Contacts Enables the Contacts facet in the application. En-ter false to disable the functionality and remove the icon from the home screen.
SYS_Enable_Activities Enables the Actvities facet in the application. Enter false to disable the functionality and re-move the icon from the home screen.
Configuration option Description
SYS_Enable_Leads Enables the Leads facet in the application. Enter
false to disable the functionality and remove the
icon from the home screen.
SYS_Enable_Opportunities Enables the Opportunities facet in the applica-tion. Enter false to disable the functionality and remove the icon from the home screen. SYS_Enable_SalesDocuments Enables the Sales Documents facet in the
appli-cation. Enter false to disable the functionality and remove the icon from the home screen. SYS_Enable_Analytics Enables the Analytics facet in the application.
Enter false to disable the functionality and re-move the icon from the home screen.
SYS_AskEnableDemoMode Enables a pop-up asking to run the the CRM app in demo mode. The default is true. Set this pa-rameter to false to disable the pop-up. If enabled, the user is prompted by the pop-up only once. The user is not prompted each time the user starts the application.
The app can be run in demo mode without instal-ling Sybase Messaging.
SYS_MappingKey Sets the Google maps API key. For additional information about the Google Maps API and li-censing, see http://www.google.com/enterprise/ earthmaps/maps.html.
Go to http://code.google.com/apis/maps/sign-up.html to sign up and generate the key.
See also
APPENDIX B
Deploying the SAP CRM ESDMA
using the Command Line Utility
If you choose to deploy the SAP CRM ESDMA manually, use the Sybase SAP DOE Connector command line utility (CLU). You can choose the CLU deployment method instead of deploying by using the Sybase Mobile Sales for SAP CRM installer. This task describes specific steps required to prepare and deploy the SAP CRM ESDMA.
Prerequisites
Generate the SAP CRM ESDMA using the ESDMA Editor provided with gateway to SAP NetWeaver Mobile. Download the ESDMA zip file as an ESDMA bundle from gateway to SAP NetWeaver Mobile.
The ESDMA generation process creates a zipped bundle that contains an XML document, very much like an WSDL, that defines necessary metadata for the Sybase SAP DOE Connector.
Task
When you deploy the SAP CRM ESDMA package using the CLU, you must complete steps unique to this type of ESDMA bundle.
Note: General documentation for the CLU is provided in the Sybase SAP DOE Connector Installation Guide, APPENDIX A: SAP DOE Connector Utility. To remove the SAP CRM ESDMA package, the general instructions provided for the removePackages command in that guide apply for this ESDMA package type.
See also
• SAP CRM ESDMA Package Deployment Prerequisites on page 14 • Chapter 7, Troubleshooting ESDMA Deployment on page 23
Preparing the SAP CRM ESDMA for Deployment
Follow these steps to unzip the ESDMA to the directory structure on the server where Sybase Unwired Platform is installed and create the sup-db.xml file.
Prerequisites
Task
1. On the server where Sybase Unwired Platform is installed, create a directory named ESDMA at <UnwiredPlatform_InstallDir>\Servers\UnwiredServer.
2. Extract the contents of the SAP CRM ESDMA to
<UnwiredPlatform_InstallDir>\Servers\UnwiredServer\ESDMA.
3. Under the ESDMA directory, create a directory named META-INF.
4. In the META-INF directory, create a file named sup-db.xml. a) Copy and paste the following to the contents of the sup-db.xml file.
<package name="SAP_CRM" short-name="SAP_CRM" sup-name="SAP_CRM“
version="1.0“
java-package="com.sybase.sap.crm.db“ cs-namespace="Sybase.Sap.Crm.Db“ oc-namespace="crm_db_"
<!-- Update with new host and port, listener.url must end with / doe/publish. -->
<property
name="listener.url"
value="http://<supserver host name>:<sup listener port>/ doe/publish" />
<database name="crm-database" /> <database-class name="CrmDatabase" />
<personalization-parameter name="language" type="string" owner="client" />
<include file="afx-esdma.xml" /> </package>
b) Replace the values highlighted with values applicable to your implementation:
<supserver host name> SUP server host name, or SUP server IP ad-dress
<sup listener port> The listener port for SUP server. Use 8000, the default value , or port number set during the Sybase Unwired Platform installation. Note: Change only <supserver host name> and <sup listener port>. The other values set in the sup-db.xml have been set to match subscription configuration in Sybase Unwired Platform. If you change these values, subscriptions may fail.
c) Save sup-db.xml to its location at <UnwiredPlatform_InstallDir>
\Servers\UnwiredServer\ESDMA\META-INF.
Deploying the SAP CRM ESDMA to Unwired Server
If you choose not to deploy the SAP CRM ESDMA using the Sybase Mobile Sales for SAP CRM installer, follow this procedure to deploy it using the command line utility.
Prerequisites
Verify that you have followed the steps in Preparing the CRM ESDMA for Deployment.
Task
1. Start the CLU.
a) In Windows Explorer or at a command prompt, navigate to %DOE-C_CLU_HOME%/ bin/.
b) Start up clu.bat.
2. At the CLU prompt, enter deploy.
3. As prompted, enter: 1. sup server url 2. sup admin username 3. sup admin password 4. sup technical user username 5. sup technical user password
4. As prompted, enter the path to the ESDMA directory:
<UnwiredPlatform_InstallDir>\Servers\UnwiredServer\ESDMA
The SAP CRM ESDMA is deployed to Unwired Server and a message displays indicating the deployment was successful.
You can log in to Sybase Control Center (SCC) to verify that the package (SAP_CRM:1.0) is properly installed and listed in the Package list.
APPENDIX C
Obtaining Help and Additional
Information
Use the Sybase Getting Started CD, SyBooks™ Online or CD or download, and online help, to
learn more about this product release.
• The Getting Started CD (or download) – contains release bulletins and installation guides in PDF format, and also contains other documents or updated information not included on the SyBooks CD.
• The SyBooks CD (or download) – contains product manuals. The Eclipse-based SyBooks browser allows you to access the manuals in an HTML-based format. Some
documentation is provided in PDF format, which you can access through the PDF directory on the SyBooks CD. See the SyBooks Installation Guide on the Getting Started CD, or the README.txt file on the SyBooks CD for instructions about installing and starting SyBooks.
• SyBooks Online at http://sybooks.sybase.com/ – is an online version of SyBooks that you can access using a standard Web browser. You can browse documents online, or download them as PDFs. In addition to product manuals, the Web site also has links to EBFs/ Maintenance, Technical Documents, Case Management, Solved Cases, newsgroups, and other resources.
• Online help in the product, if available.
To read or print PDF documents, you need Adobe Acrobat Reader, which is available as a free download from the Adobe Web site.
Note: A more recent release bulletin, with critical product or document information added
Index
D
demo mode 16 device requirements 12 disk space requirements
installer 11
E
ESDMA
deploying using CLU 33 deploying using installer 19 deployment prerequisites 14 troubleshooting deployment 23
I
installation planning 11 installation prerequisites 13 installation task flow
iPhone 7
Windows Mobile 3 installation using installer 19
M
Mobile Sales system architecture 1
