Provisioning an iPhone Application with iTunes

To provision the Sybase-packaged iPhone application to your internal users, especially if they do not have an App Store account, use iTunes as an alternative method. You can also use this method if you are building your own iPhone application.

Prerequisites

The following prerequisites must be performed by the developer before the administrator can configure the Apple Push Notification Service (APNS):

Sign up for the iPhone Developer Program, which gives you access to the Developer Connection portal. Registering as an enterprise developer gets you the certificate you need to sign applications with.
Download and customize the default Sybase iPhone application for your Sybase Mobile Workflow or Sybase Mobile CRM solution.
Create an AppID and ensure that it's configured to use Apple Push Notification Service (APNS).
Create and download an enterprise APNS certificate that uses Keychain Access in the Mac OS. The information in the certificate request must use a different common name than the development certificate they might already have. This is because the enterprise certificate also creates a private key, which must be distinct from the development key. This certificate must also be imported as a login keychain and not a system key chain and the developer should validate that the certificate is associated with the key in the Keychain Access application. Get a copy of this certificate.
Create an enterprise provisioning profile and include the required device IDs with the enterprise certificate. The provisioning profile authorizes devices to use applications you have signed.
Create the Xcode project ensuring the bundle identifier corresponds to the bundle identifier in the specified App ID. Ensure you are informed of the "Product Name" used in this project.
Used APNS initialization code in the codeline.

Developers can review complete details in the iPhone OS Enterprise Deployment Guide at http://manuals.info.apple.com/en_US/Enterprise_Deployment_Guide.pdf.

Apple Push Notifications are iPhone-specific. Each application that supports Apple Push Notifications must be listed in Sybase Control Center with its certificate and application name. You must perform this task for each application.

Confirm that the IT department has opened ports 2195 and 2196, by executing these commands: telnet gateway.push.apple.com 2195 telnet feedback.push.apple.com 2196 If the ports are open, you can connect to the Apple push gateway and receive feedback from it.
Copy the enterprise certificate (*.p12) to the computer upon which Sybase Control Center has been installed. Ensure it is saved to the <SUP_Home>\Servers\MessagingServer\bin\ directory.
In Sybase Control Center, expand the Servers folder and click Server Configuration for the primary server in the cluster.
In the Messaging tab, select Apple Push Configuration, and do the following:
1. Configure Application name with the same name used to configure the Product Name in Xcode.
2. If the certificate is not displaying automatically, browse to the directory.
3. Change the Push Gateway information to match that used in the production environment.
4. Restart Unwired Server.
Verify that the server environment is set up correctly:
1. Open <SUP_Home>\Servers\UnwiredServer\logs\APNSProvider.
2. Open the log file that should now appear in this directory. The log file indicates if the connection to the push gateway is successful or not.
Deploy the application and the enterprise distribution provisioning profile to your users’ computers.
Instruct users to use iTunes to install the application and profile, and how to enable notifications. In particular, device users must:
- Download the Sybase CRM 1.0 application from the App Store.
- In the iPhone Settings app, slide the Notifications control to On.
Verify that the APNS-enabled iPhone is set up correctly:
1. Click Device Users.
2. Review the Device ID column. The application name should appear correctly at the end of the hexidecimal string.
3. Select the Device ID and click Properties.
4. Check that the APNS Device Token has been passed correctly from the application by verify that a value is in the is row. A device token only appears after the application runs.
Test the environment by initiating an action that results in a new message being sent to the client. If you have verified that both device and server can establish a connection to APNS gateway, the device will receive notifications and messages from the Unwired Server. This includes CRM messages, workflow messages, and any other messages and meant to be delivered to that device. Allow a few minutes for the delivery or notification mechanism to take effect and monitor the pending items in the Device Users data to see that the value increases appropriately for the applications.
To troubleshoot APNS, use the <SUP_Home>\Servers\Unwired Server\log\trace\APNSProvider log file. You can increase the trace output by editing <SUP_Home>\Servers\MessagingServer\Data\TraceConfig.xml and configuring the tracing level for the APNSProvider module to debug for short periods.