Error codes

This table lists the common errors and their suggested solutions.

Error Code Problem Suggested Solution
1003 Your test attempted to perform an unsupported action. For example, you might get this error if you try to perform a set() on a control that does not support set(). Use only recorded actions or actions whose support you have verified in other tests.
1009 UFT Mobile is unable to communicate with the app under test. The app most likely crashed during the test run. Check the app and make sure it runs properly by itself.
1103 UFT Mobile is unable to open the specified app.
  • Check that the app is installed on the device that you are testing. If it is not installed, either install the app on your device or use the UFT Mobile wizard to install the app at the beginning of the test.
  • Check that the app is not prompting you for a certificate approval when you launch it.
  • If your replay includes the installation of an app, and a system app pops up before or during replay, the installation will fail and UFT Mobile will issue this error.
1106 The JavaScript engine ID was not found. There is a problem with the packaging of your app. You may be using an app that was packaged with an older version of instrumentation. Delete the app from your device and reinstall it from the UFT Mobile console. For details, see Upload an app.
2007 UFT Mobile was unable to create a test because the device is not valid.
  • Check that the device still exists in the UFT Mobile lab.
  • If you manually entered the device's details, make sure they are correct.
2114 Failed to restart the device When a device is not connected or not trusted it cannot be restarted or reconnected. If the device is disconnected, check the connection info message .
2023 UFT Mobile was unable to create a test because the app is not valid.
  • Make sure that you are using the non-packaged version of the app, and not the packaged version.
  • Check that the app still exists in the UFT Mobile lab.
  • If you manually entered the app's details, make sure they are correct.
2024 Replay error in executeStep command
  • Make sure that you have provided a value for toggle.longpress. This applies to iOS devices.
2026 UFT Mobile failed to install the specified app.
  • Check that the app is compatible with the device's operating system version.
  • Check that your Internet connection is working.
2033 A request to Network Virtualization to start a new test failed, due to a general server error.
  • Checking the log files for any errors or warnings.
  • Contact your Network Virtualization administrator .
2036 The device has disconnected.
  • Wait a few seconds for the device to reconnect automatically.
  • If it does not reconnect automatically, reconnect it manually through the UFT Mobile lab.
2037 UFT Mobile is unable to stop an app on an Android device. Before starting replay, UFT Mobile tries to stop the application under test or additional apps, if the restart flag is enabled.
  • Uninstall the app manually.
  • Stop the app manually.
20443 You are trying to launch the packaged version of the app, when the app that is installed on the device is the non-packaged version. Launch the non-packaged version of the app, or alternatively install the packaged version of the app on the device.
2047 The app OS and the device OS do not match.

You may have attempted to run an iOS app on an Android device. This might happen if the iOS app and the Android app have the same IDs.

Try specifying the app OS type when you select the app. In UFT, go to the Object Repository and add the property “type” to the app identification properties.

2049 UFT Mobile was unable to create an Appium session for the device, and a test could not be created.

Check the validity of the device capabilities that you provided.

2055 For tests using Network Virtualization, the test failed to connect with the NV Test Manager server. Contact the UFT Mobile administrator to modify the NV Test Manager machine details in the NV Integration section of the Administration > Settings page.
2117 There was a failure in connecting a physical device
  • Unplug the USB cable connecting the device to the Connector machine. Wait a few seconds, and then plug it in again.
  • Confirm that the cable is not faulty by using another cable.
  • Make sure that a Security pop up dialog box is not open on the device.
  • Make sure that you have installed the proper driver for your device. Each device manufacturer has its own USB drivers for Windows. See for a list of links to Original Equipment Manufacturers (OEM) USB Drivers.

If none of these suggestions were effective in solving the problem, locate the UFT Mobile installation's log folder, and check for additional error messages in the log files.


Server: \Program Files\UFT Mobile Server\server\log

Connector :\Program Files\UFT Mobile Connector\connector\log


Server : opt/UFTMobile/server/log

Connector: opt/UFTMobile/connector/log

The device's remote view has expired, or another session was opened. Refresh or reload the remote view window. Note that you can only open one remote view session at a time, for a specific device.
2146 The action failed. You may have requested to start an action that is already running or stop an action that is not currently running. If you specified Start, make sure that the action is not already in progress. If you specified Stop, make sure that the action is in progress.
2162 An Appium error occurred during the processing of the test.

Make sure that your command parameters and Appium capabilities are correct. For details, see the Appium examples and the following sections:

2603 Failed to update the re-signed applications on the connectors.

For details, see the Connectors table.

2605 Unable to find one of the Agent apps.

Check for the Agent apps in the Agent directory on the UFT Mobile server machine.

2803 An application can't be uploaded because it was packaged using an incorrect version of the iOS Enabler.

Have the administrator download and install a recent version of the Enabler from UFT Mobile on ADM Marketplace, or copy it from the Agent directory on the UFT Mobile server machine. For details, see Package an iOS app manually with the packager service.

2810 One of the properties of the app packager Protocol, IP, or Port, is missing or incorrect. Contact the UFT Mobile administrator to modify these values in the Administration > Settings page in the Android/iOS Packaging Service sections.


The log in to UFT Mobile failed. You may have entered an incorrect login several times, resulting in your account being disabled.

Wait for the lockout time interval (by default 15 minutes) to end, and re-enter the correct password. If you do not remember your password, ask your administrator to generate a new one using the user_management.bat (Windows) or script (Linux) located in the UFT Mobile server installation's server > bin directory.

For details, see Manage user accounts with scripts (on-premises).


The license is missing or has expired.

Obtain a new license. For details, see License installation and management.


Photo simulation failed. The files cannot exceed 50% of the free storage on the device.

Choose a smaller image or clear the device's memory so that the image or video file will not exceed 50% of the free memory. The free memory is calculated when the Agent launches.


Photo simulation failed. Photo simulation is only supported for packaged apps. The target app is not packaged.

Package the target app and then perform photo simulation. For details, see App packaging and signing services.

For other errors related to app packaging, see Troubleshooting the app packager.

Back to top

See also: