Upgrade packaged apps with the app upgrader

When you upgrade the Mobile Center server, packaged apps that were previously uploaded to Mobile Center need to be upgraded or they will not be available for users during testing. During the server upgrade, the installer recognizes that you may have apps on the server that require repackaging, and prompts you to run the upgrader. If you choose not to run the upgrader when prompted, you can run it manually.

About the app upgrader

The upgrader enables you to upgrade your apps in one operation, instead of uploading each app again to Mobile Center.

An app that is incompatible with the upgraded Mobile Center server is displayed as a faded card, with an error icon in the right-hand corner. This could happen if you originally packaged your app manually and then uploaded it to the server.

If your apps were packaged manually using either Android Enabler (Android) or MC Enabler (iOS) and then uploaded to Mobile Center, the upgrader will not be able to upgrade your apps. You will need to repackage your apps using the latest version of these tools before uploading them to Mobile Center. For details, see Package an Android app manually or Package an iOS app manually on a Mac machine

Back to top

Considerations before using the app upgrader

To run the upgrader on Android apps signed with a private key, or on iOS apps, you must have already configured the app packager. The upgrader uses the same settings. See Define packaging settings and Set up app signing services .

For iOS apps: Make sure to also download the Packager Service for Mobile Center 2.70, and install it on your Mac as described in Configure app signing services for iOS apps.

Back to top

Run the app upgrader

To manually upgrade your apps with the app upgrader tool:

  1. Change directory to the PackagingUpgradeTool directory:

    Linux cd <path to your server installation folder>server/PackagingUpgradeTool Default: opt/mc/server/PackagingUpgradeTool
    Windows From a command prompt:
    cd <Path to your server installation folder>\server\PackagingUpgradeTool
  2. From the command line, run the following command to start the app packager upgrader tool:

    Linux ./packaging-upgrade-tool.sh
    Windows packaging-upgrade-tool.bat
  3. Specify the credentials for the Mobile Center user, and select the operating systems of the apps you want to upgrade. If you have enabled the Mobile Center server to work with LDAP, use your LDAP credentials or use the credentials for the "admin@default.com" user.

Back to top

Troubleshooting

If your apps were packaged manually using either the Android Enabler or the MC Enabler (iOS) and then uploaded to Mobile Center, the upgrader will not be able to upgrade. Repackage your apps using the latest version of the these tools before uploading them to Mobile Center. For details, see Package an Android app manually or Package an iOS app manually on a Mac machine.

Back to top