XenMobile Server

Apple Volume Purchase

You can manage iOS app licensing by using Apple iOS volume purchase. The volume purchase solution simplifies the process to find, buy, and distribute apps and other data in bulk for an organization.

With volume purchase, you can use XenMobile to distribute public app store apps.

  • Volume purchase is not supported for MAM enrollment. You must enroll volume purchase devices in MDM or MDM+MAM.
  • Volume purchase is not supported for Citrix mobile productivity apps.
  • Although you can distribute the XenMobile public store apps with volume purchase, the deployment is not optimal. Enhancements to XenMobile and the Secure Hub store are required to address the limitations.
  • For a list of known issues with distributing the XenMobile public store apps through volume purchase, see CTX222633 in the Citrix Knowledge Center.

With volume purchase, you can distribute the applicable apps directly to your devices. Or, you assign content to your users by using redeemable codes. You configure settings specific to the iOS volume purchase in XenMobile.

XenMobile periodically reimports volume purchase licenses from Apple to ensure that the licenses reflect all changes. Such changes include when you manually delete an imported app from the volume purchase. By default, XenMobile refreshes the volume purchase license baseline a minimum of every 1440 minutes (24 hours). You can change the volume purchase baseline interval through the server property, VPP.baseline. See Server properties.

The App auto update setting also relies in the VPP.baseline server property and THE apps update on the same schedule set in that property.

This article focuses on using volume purchase with managed licenses, which enables you to use XenMobile to distribute apps. If you currently use redemption codes and want to change to managed distribution, see this Apple Support document Migrate from redemption codes to managed distribution with the Volume Purchase.

For information about the iOS volume purchase, see https://volume.itunes.apple.com/us/store. To enroll in volume purchase, go to https://deploy.apple.com/qforms/open/register/index/avs. To access your volume purchase store in iTunes, go to https://volume.itunes.apple.com/?l=en.

After you save these iOS volume purchase settings in XenMobile, the purchased apps appear on the Configure > Apps page in the XenMobile console.

  1. In the XenMobile console, click the gear icon in the upper-right corner. The Settings page appears.

  2. Click Volume purchase. The Volume purchase configuration page appears.

    Volume purchase configuration screen

  3. Configure these settings:

    • Store user password in Secure Hub: Select whether to store a user name and password in Secure Hub for XenMobile authentication. The default is to store the information by using this secure method.
    • User property for Volume purchase country mapping: Type a code to allow users to download apps from country-specific app stores.

    XenMobile uses this mapping to choose the property pool of the volume purchase. For example, if the user property is United States, that user cannot download apps if the volume purchase code is for the United Kingdom. Contact your volume purchase plan administrator for more information about the country mapping code.

  4. For each volume purchase account you want to add, click Add. The Add a Volume purchase account dialog box appears.

    iOS Settings configuration screen

  5. Configure these settings for each account that you add:


    If you use Apple Configurator 1, upload a license file: Go to Configure > Apps, go to a platform page, and then expand Volume purchase.

    • Name: Type the volume purchase account name.
    • Suffix: Type the suffix to appear with the app names obtained through the volume purchase account. For example, if you enter VP, the Secure Mail app appears in the apps list as Secure Mail - VP.
    • Company Token: Copy and paste the volume purchase service token obtained from Apple. To obtain the token: In the Account Summary page of the Apple volume purchase portal, click the Download button to generate and download the volume purchase file. The file contains the service token and other information, like the country code and expiry. Save the file in a secure location.
    • User Login: Type an optional authorized volume purchase account administrator name used to import custom B2B apps.
    • User Password: Type the volume purchase account administrator password.
    • App Auto Update: If On, volume purchase apps automatically update when an update exists on the Apple store. Default is Off.
  6. Click Save to close the dialog box.

  7. Click Save to save the Volume purchase configuration.

    A message appears stating that XenMobile adds the apps to the list on the Configure > Apps page. On that page, notice that the app names from your volume purchase account include the suffix you provided in the preceding configuration.

You can now configure the volume purchase app settings and then tune your delivery group and device policy settings for volume purchase apps. After you complete those configurations, users can enroll their devices. The following notes provide considerations for those processes.

  • When configuring volume purchase app settings (Configure > Apps), enable Force license association to device.

    An advantage of using the Apple volume purchase and Deployment Program with supervised devices: The ability to use XenMobile to assign the app at the device (rather than user) level. As a result, you don’t have to use an Apple ID device. Also, users don’t receive an invitation to join Apple volume purchase. Users can also download the apps without signing into their iTunes account.

    Apps configuration screen

    To view the volume purchase info for that app, expand Volume purchase. Notice in the Volume purchase License Keys table, the license is associated with a device. If the user removes the token and then imports it again, the word Hidden appears instead of the serial number, because of Apple privacy restrictions.

    Apps configuration screen

    To disassociate a license, click the row for the license and then click Disassociate.

    Apps configuration screen

    If you associate volume purchase licenses with users, XenMobile integrates users into your volume purchase account. Also, associates their iTunes ID with the volume purchase account. The iTunes ID of users is never visible to your company or to the XenMobile Server. Apple transparently creates the association to retain user privacy. You can retire a user from Apple volume purchase, to disassociate all licenses from the user account. To retire a user, go to Manage > Devices.

    Devices configuration screen

  • When you assign an app to a delivery group, by default XenMobile identifies the app as an optional app. To make sure that XenMobile deploys an app to devices, go to Configure > Delivery Groups. On the Apps page, move the app to the Required Apps list.
  • When an update for an app is available, the Volume Purchase pushes the update to the app and automatically updates the app on devices. For more information, see Check for the app updates.

    Apps configuration screen

    XenMobile displays a License Expiration Warning when the Apple volume purchase has expired.

    License Expiration Warning screen

Check for the app updates

If you turn on the App Auto Update setting when adding a Volume Purchase account, XenMobile Server periodically checks for the new versions of the Volume-Purchased apps (required apps) and the optional apps subscribed from the Citrix Secure Hub store and updates them. Once XenMobile Server receives a new version of a required app, it pushes the new version to the device for installation automatically without prompting you to manually update them. However, to auto-update the optional apps, the property apple.ios.optional_app_update must be set to True. Otherwise, you have to manually update the optional apps. For more information, see Server properties.

To manually check for the new version of any app and update it, do the following steps:

  1. Click Configure > Apps.

    The Apps page appears.

  2. Select an app and click Edit.

  3. Go to the Platform page and then click the Check for Updates button next to Version.

  4. On the Update dialog box, apply the update if a new version is available.

Apple Volume Purchase