Distributing applications to iOS devices

This topic provides information for administrators to distribute BMC Remedy ITSM - Mobility: Service Desk applications over-the-air (OTA) to iOS devices. 

To distribute applications for iOS devices

1. Unzip the ClientDistribution.zip file that you received from BMC on on a computer that is running the Apple Mac OS operating system.
    A ClientDistribution folder is created.
2. Join the iOS Developer Enterprise Program, and create certificates and a provisioning profile for the BMC Remedy ITSM - Mobility: Service Desk Incident Management or Approvals application, as follows:
   1. Go to the iOS Developer Enterprise Program website.
   2. From the Apple Developer Portal, obtain a Distribution developer certificate that allows you to sign applications. You need to create a Distribution Certificate.
      
   3. Create a new App ID as the bundle identifier. This is the ID of the Mobility application. For, example:
      1. For Incidents, you could use the string com.bmc.nextgenmobile.IncidentsMobile as the bundle identifier.
      2. for Approvals, you could use the string com.bmc.nextgenmobile.ApprovalsMobile as the bundle identifier.
   4. After you create the new App ID, you need to change the <id> field in the InicidentsMobile-app.xml and ApprovalsMobile-app.xml.
       These files are in folders ClientDistribution/IncidentsMobile/ios and ClientDistribution/ApprovalsMobile/ios respectively.
   5. In the iOS provisioning portal, create a Distribution profile that identifies the Mobility application (Incident Management or Approvals).
      
   6. Obtain the certificate for using the OS push notification as follows:
      1. Configure the App ID that you created in step 2c.
         
      2. Create the Push SSL certificate for production.
   7. Download the iPhone developer certificate, Push SSL certificate, and provisioning profile to your local computer, and save them in the certificate folder, which is inside the ClientDistribution folder.
   8. Create a .p12file from the iPhone developer certificate as follows:
      1. In the certificate folder, double-click the iPhone developer certificate to add the certificate to the keychain.
      2. In the Keychain Access utility, navigate to Certificates.
          The iPhone developer certificate should be listed.
      3. Look for a certificate named: iPhone Distribution... 
      4. Expand the certificate.
          A private key should be listed.
      5. Hold the Command key and select both the certificate and the key.
         
      6. Right-click on the selected items, and click Export.
      7. Assign a file name, the location to save the file, and select Personal Information Exchange (.p12) as the file format.
      8. Click Save.
         
      9. In the dialog box that appears, create a password for the .p12 file. You must enter this password when you use this certificate to sign applications.
   9. Create a .p12file from the Push SSL certificate as follows:
      1. In the certificate folder, double-click the Push SSL certificate to add the certificate to the keychain.
      2. Navigate to Certificates.
          The Push SSL certificate should be listed.
      3. Expand the Apple Production iOS Push Service.
          A private key should be listed.
      4. Hold the Command key and select both the certificate and the key.
      5. Right-click on the selected items, and click Export.
         
      6. Assign a file name, the location to save the file, and select Personal Information Exchange (.p12) as the file format.
      7. Click Save.
      8. In the dialog box that is displayed, create a password for the .p12 file. You must enter this password when you use this certificate to push notification.
3. Download the Adobe Flex SDK 4.6 and the Adobe Air SDK from the following URLs:
   • http://www.adobe.com/cfusion/entitlement/index.cfm?e=flexsdk
   • http://www.adobe.com/special/products/air/sdk/
4. Unzip the two SDK files and merge all of the folders in the Adobe Air SDK into the Flex SDK.
5. Copy the merged Flex SDK folder to the ClientDistribution folder.
6. Go to the appropriate file:
   • For Incident Management, go to the buildIncidentsMobile.sh file.
      The shell script is available in ClientDistribution/IncidentsMobile/ios.
   • For Approvals, go to the buildApprovalsMobile.sh file.
      The shell script is available in ClientDistribution/ApprovalsMobile/ios.
7. Update the following four variables with the App ID that you registered in step 2c:
   • KEY_STORE
   • STORE_PASSWORD
   • PROVISION_PROFILE
   • FLEX_SDK_DIR
8. Run the appropriate batch file to create the ipa file in the ClientDistribution/IncidentsMobile or ClientDistribution/ApprovalsMobiledirectory, as appropriate. (It may take 10 - 15 minutes for this step to complete.)
   • For Incident Management, run the buildIncidents.sh batch file.
   • For Approvals, run the buildApprovalsMobile.sh batch file.
9. Upload the appropriate files and folder to a web server for web distribution.
   • For Incident Management, upload the index.html, IncidentsMobile.plist, IncidentsMobile.ipa files and the icons folder from the ClientDistribution/IncidentsMobile folder.
   • For Approvals, upload the index.html, ApprovalsMobile.plist, ApprovalsMobile.ipa files and icons folder form the ClientDistribution/ApprovalsMobile folder.
10. Update the appropriate files to provide the correct URL.
    • For Incident Management, update the index.html, and IncidentsMobile.plist files, to provide the URL of the IncidentsMobile.plist, IncidentsMobile.ipa files and the icon folder.
    • For Approvals, update the index.html, and ApprovalsMobile.plist files, the to provide the URL of the ApprovalsMobile.plist, ApprovalsMobile.ipa files and the icon folder.