Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Troubleshooting Pega Mobile Client

Updated on September 3, 2019

This article describes the following troubleshooting information for Pega Mobile Client™.

Viewing logs when you are unable to log in to Pega Mobile Client

Pega Mobile Client login screen

Pega Mobile Client login screen

You enable Pega Mobile Client app debugging and set its log level by using a check box and a dropdown on the Build tab of your mobile app. When an error that is not related to invalid credentials occurs and you cannot log in to Pega Mobile Client (with this setting enabled), an alert box is displayed above the user name and password fields. To troubleshoot the cause of the problem, click System > Operations > Logs.

From the Build tab, you can also change the log level to one of the following choices: Silent, Error, Warning, Info, or Debug.

Viewing alerts and logs when offline-enabled mobile apps fail to synchronize data

If an offline-enabled mobile app that originates from the Pega Platform™ fails to synchronize data after reconnecting to the server, the Pega Platform generates a PEGA0066 alert. The alert includes pointers to device log dump files, which provide detailed information about the failure, such as the activity that preceded the event, entries collected from the native app, and entries from the JavaScript part of the Pega Platform application. Use the alert and device logs to facilitate error analysis and debugging.

To review alerts in the alert log on the server node, select Alerts from the Dev Studio developer toolbar.

To review corresponding system log entries, access the Log Files tool in Dev Studio and use the entry number from the alert's Correlation ID field to find the system log entry that contains device log information.

For more information about configuring and interpreting the alert, see Understanding the PEGA0066 alert - Mobile App Data-Sync Failure.

Version error message when logging in to Pega Mobile Client

Pega Mobile Client login screen error

Pega Mobile Client login screen

When you attempt to log in to the Pega Mobile Client (hybrid client) app, an error message might be displayed stating that the version of the Pega Mobile Client is incompatible with the requested application. If you see this message, reinstall a version of Pega Mobile Client that is supported.

Build fails because the updated file cannot be uploaded

When you obtain the file to upload your own image assets for Pega Mobile Client branding purposes, the bundle upload process might fail. This produces an error message similar to the following:

Mobile build failure reason: Unsupported file/folder assets have been found in

This problem occurs if the image assets were compressed on Apple Mac OS, which adds a layer of folders or files at the root level.

To solve this issue:

  1. Change the directory to the uncompressed folder of the file where the android and ios folders with your branding changes are located.
  2. Highlight both the android and ios folders.
  3. From the context menu, select Compress 2 Items. A compressed file named is created.
  4. Keep this file name or rename it to something more meaningful, such as
  5. Upload this updated assets file as described in Configuring a mobile app.

The Create build button is dimmed when you configure and build a mobile app

If the Create build button is dimmed when you attempt to configure and build your Android or iOS mobile app, you need to modify your access groups. This issue occurs in your app for all access groups created before March 28, 2015, that had their access roles cloned from the PegaRULES:SysAdm4 access role.

To fix your access groups so that the Create build button is available during the mobile app building process, perform these steps for each access role that has the described issue.

  1. In the Available roles section of the access group form, open the access role that was cloned from the PegaRULES:SysAdm4 access role.
  2. Add a new access class.
  3. Enter Data-Mobile- in the Class field.
  4. Set all access (Read instances, Write instances, Delete instances, and so on) to 5.
  5. Grant the pzCreateAndPublishMobileBuild privilege by entering this name in the Name field.
  6. Set its level to 5 in the Level field.
  7. Click Submit.

HTTP Basic authentication failed error during login

This issue applies only if the Oracle WebLogic web application server is used by the Pega Platform. If you attempt to log in to the Pega Mobile Client offline-enabled mobile app and the HTTP Basic authenticationfailed error is generated, make sure that preemptive authentication is being used by the Oracle WebLogic web application server that hosts the Pega Platform. Set the following Oracle SOA 11g partner link binding property to true:


Related articles

Pega Mobile Client


Pega Platform 7.1.9 Pega Mobile Client Mobile Pega Express Communications and Media Consumer Services Financial Services Government Healthcare and Life Sciences Insurance Healthcare and Life Sciences Manufacturing Consumer Services Consumer Services

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us