MicroStrategy ONE

Enable Background Download in iOS

When background download is enabled, MicroStrategy Mobile tries to download all pre-cached data in the background when the application is running. Background download is triggered when MicroStrategy Mobile gets a push notification from the Apple Push Notification Server (APNS). The APNS for MicroStrategy Mobile is the Intelligence Server. For background download to be enabled on the MicroStrategy Mobile application, you must meet the following requirements:

  • The Mobile Server must be configured to use HTTPS. Refer to the Enabling Secure Communication chapter in the System Administration Guide for detailed instructions on how to configure the Mobile Server to use SSL. 

  • When you create a mobile configuration on the Mobile Administrator page, the following check boxes must be selected on the iPhone or iPad Settings tab:

    • Enable push notification 
    • Enable background download mode 
  • The .pem (permission) file must be stored on the Intelligence Server (the APNS for MicroStrategy Mobile). 
  • The Explicit App ID for Push Notification must be the same as the Bundle ID in the MicroStrategy Mobile Xcode project.

The high-level steps for enabling push services are listed below. Since most of these are the steps used for on any iOS device, refer to the Apple Developer site for detailed, up-to-date instructions for how to perform each step. MicroStrategy Mobile requirements are shown in bold.

  1. From the iOS Dev Center, register a new App ID. 

    1. For the Explicit App ID, enter the same Bundle ID you use in your MicroStrategy Mobile Xcode project. 

    2. Enable Push Notification. 

  2. On a local Mac machine, launch the Keychain utility to generate a Certificate Signing Request (CSR).

    1. Save the CSR on the local Mac machine. 
    2. Export the CSR as a .p12 file. 
  3. From the iOS Dev Center, create a new SSL certificate. 

    1. Use the CSR saved on the local Mac machine to create the SSL certificate 

    2. Download the generated .cer file to the local Mac machine and install it in your keychain. 

  4. On the local Mac machine, generate a .pem file and copy the .pem file to the appropriate location on the Intelligence Srver. 

    1. Use the .p12 file exported in step 2 and the .cer file downloaded in step 3 to generate a .pem file. 

    2. Save this file on the APNS (Apple Push Notification Server). For MicroStrategy Mobile, this is the Intelligence Server. 

  5. From the iOS Dev Center, make a provisioning profile. 
    1. Use the certificate the application was signed with to create the provisioning profile. 
    2. Sign the application with this provisioning profile. 
  6. Configure and compile MicroStrategy Mobile 
    1. Open the MicroStrategyMobile project in Xcode. 
    2. Select Capabilities, expand Background Modes, and select the Remote Notifications check box. 
    3. Run the project.