Provisioning an iPhone Application with iTunes

If your internal users do not have an App Store account, use iTunes as an alternative method of provisioning the Sybase-packaged iPhone application. 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 App ID 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.

Task

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:
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 on which Sybase Control Center has been installed. Save the certificate in <SUP_Home>\Servers\MessagingServer\bin\.
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:
1. Configure Application name with the same name used to configure the product name in Xcode. If the certificate does not automatically appear, browse to the directory.
2. Change the push gateway information to match that used in the production environment.
3. 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 whether 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 application, 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 hexadecimal string.
3. Select the Device ID and click Properties.
4. Check that the APNS device token has been passed correctly from the application by verifying that a value is in the row. A device token appears only 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 the APNS gateway, the device receives 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 make sure 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.