PROBLEM
An error occurred while updating ArcGIS Survey123 to version 3.12 on an Android device
Description
The Google Play Store has implemented requirements to improve the security of data used by applications stored on devices. Previously, installed applications had access to both 'public' storage and application-specific 'private' storage on the device. In Android developer terms, these are called 'external' and 'scoped' storage, respectively. Applications are now required to store all data in scoped (private) storage.
The 3.12 release of ArcGIS Survey123 includes an automatic migration process that starts when the application is opened for the first time. This process migrates original 3.11 data, including surveys and user settings to scoped storage. In some cases, the migration fails, and an error code is returned.
Cause
There are several reasons why the Android storage migration fails. Refer to the list of error codes and their descriptions below.
Solution or Workaround
For each error code, please refer to the resolution steps in the table below.
As part of the migration process, Survey123 writes a log file named ‘migration.log’ in the original ArcGIS folder on the Android device (typically found at /Internal storage/ArcGIS, /sdcard/ArcGIS, /storage/emulated/0/ArcGIS, or similar).
Note: If the issue is not resolved using the resolution steps, retain a copy of the log file and contact Esri Support Service for further assistance.
| Code | Description | Resolution Steps |
|---|---|---|
| 2900 | Application exception due to unknown error | Provide a copy of the log file and contact Esri Support for further assistance. |
| 2901 | Storage access permission rejected. The user has denied the application access to the storage device. | Restart the application. A dialog appears asking permission to access the storage device. Permission must be granted for the migration to proceed. |
| 2902 | ArcGIS data folder not found in legacy storage | Refer to the error message in the log file for the expected path to the legacy ArcGIS folder. Please confirm that this folder exists at this location. |
| 2903 | Failed verification because file does not exist in destination location | Refer to the error message in the log file for the expected file not found in new storage location. |
| 2904 | Failed verification because file sizes are not equal | Refer to the error message in the log file for the file which is of not equal size in the old and new storage location. |
| 2905 | Storage device does not have enough free space | Refer to the error message in the log file for the total storage device space, the available free space, and the size of the ArcGIS folders that must be copied for the migration. The minimum required space is two times the ArcGIS folder size. Manually free up storage on the device to permit the migration to occur. |
| 2906 | Failed to remove legacy settings file | Ensure that no other instance of Survey123 is open, and that no other application has opened files or folders in the ArcGIS legacy storage location. Rerun the migration. |
| 2907 | Failed to create folder in destination location | Restart the application. A dialog will appear asking permission to access the storage device. Permission must be granted for the migration to proceed. |
| 2908 | Failed to remove existing zip archive | Ensure that no other instance of Survey123 is open, and that no other application has opened files or folders in the ArcGIS legacy storage location. Rerun the migration. |
| 2909 | Failed to remove folder from legacy storage | Ensure that no other instance of Survey123 is open, and that no other application has opened files or folders in the ArcGIS legacy storage location. Rerun the migration. |
| 2910 | Database does not exist in scoped storage following file migration | Confirm that the survey database file exists in the legacy storage location prior to migration process. |
| 2911 | Failed to update map library paths in settings file | Ensure that the settings file exists in the scoped storage location and that no other application has the file open. Rerun the migration. |
| 2912 | Failed to copy data file to scoped storage | Restart the application. A dialog will appear asking permission to access the storage device. Permission must be granted for the migration to proceed. |
| 2913 | Failed to copy data file over an existing file in scoped storage | Ensure that no other instance of Survey123 is open, and that no other application has opened files or folders in the scoped storage location. Rerun the migration. |
| 2914 | Failed to open settings file for updating | Ensure that the settings file exists in the scoped storage location and that no other application has the file open. Rerun the migration. |
| 2915 | Failed to update known devices paths | Ensure that the settings file exists in the scoped storage location and that no other application has the file open. Rerun the migration. |
| 2917 | Failed to add file to zip archive | Rerun the migration. |
| 2918 | Failed to open log file for writing | Confirm that the legacy data storage location exists. |
| 2919 | Settings file does not exist in scoped storage following file migration | Confirm that the Survey123 settings file exists in the legacy storage location. |
| 2920 | Failed to read from scoped storage during preflight test | Confirm that the expected scoped storage location exists. |
| 2921 | Failed to write to scoped storage during preflight test | Confirm that the expected scoped storage location exists. |
| 2922 | Failed to write to scoped storage during preflight test | Confirm that the expected scoped storage location exists. |
| 2923 | Failed to write to scoped storage during preflight test | Confirm that the expected scoped storage location exists. |
| 2924 | Failed to write to scoped storage during preflight test | Confirm that the expected scoped storage location exists. |
| 2925 | Failed to write to scoped storage during preflight test | Confirm that the expected scoped storage location exists. |
| 2926 | Failed to write zip archive | Rerun the migration. |
Article ID:000025129
- ArcGIS Survey123 Field App Android
Get help from ArcGIS experts
Download the Esri Support App
Related Information
Discover more on this topic
Search for related information
Find training related to this topic
Explore ideas and give feedback