Upgrade packaged apps with the app upgrader (on-premises)

This section is relevant only for on-premises deployments of UFT Mobile.

When you upgrade the UFT Mobile server, packaged apps that were previously uploaded to UFT Mobile 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 UFT Mobile.

An app that is incompatible with the upgraded UFT Mobile 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 iOS Enabler (iOS) and then uploaded to UFT Mobile, 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 UFT Mobile. For details, see Package an Android app manually or Package an iOS app manually with the packager service.

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 in UFT Mobile and About app signing services .

For iOS apps: Make sure to also download the Packager Service for UFT Mobile 3.4, and install it on your Mac as described in Configure app signing services for iOS apps (on-premises).

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/UFTMobile/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 UFT Mobile server details, the UFT Mobile user, and select the operating systems of the apps you want to upgrade. When prompted, provide the UFT Mobile user password. If you have enabled the UFT Mobile 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 iOS Enabler (iOS) and then uploaded to UFT Mobile, the upgrader will not be able to upgrade them. Repackage your apps using the latest version of the these tools before uploading them to UFT Mobile. For details, see Package an Android app manually or Package an iOS app manually with the packager service.

Back to top