Object API Application Migration Requirements in SAP Mobile Platform Version 2.3 SP03

Understand the requirements before upgrading to and migrating your Object API applications to SAP Mobile Platform version 2.3 SP03.

Native Client UltraLite® Database Version Compatibility

The Object API Application client stack (Android, Windows/Windows Mobile, BlackBerry, and iOS) in SAP Mobile Platform version 2.3 SP03 includes UltraLite version 16 as the on-device database. Previous versions of the client stack included UltraLite version 12:
  • UltraLite version 16 cannot read UltraLite databases that were created using previous versions of the software.
  • You cannot upgrade databases on devices.

See the topic UltraLite upgrades in the SQLAnywhere 16 documentation for details.

Client Stack Upgrades Are Not Supported

When migrating applications from SAP Mobile Platform version 2.3 SP02 and earlier to SAP Mobile Platform version 2.3 SP03, you must:
  1. Successfully synchronize all pending operations on the device prior to the upgrade.
  2. Unregister the application.
  3. Delete the database or uninstall the application; then upgrade the application.
  4. Re-register the application.

Set Up the Encryption Key in SAP Control Center

After upgrading SAP Mobile Server to version 2.3 SP03, the Administrator must configure the encryption key from SAP Control Center or synchronization fails for 2.3 SP03 clients of newly created projects:
  1. Log in to SAP Control Center.
  2. Click Configuration.
  3. Click General > Components.
  4. Select Replication > Properties.
  5. In the replication component properties screen, specify the E2E encryption certificate alias value.
  6. Save your changes and restart SAP Mobile Server.