Problem: An Error Occurred While Updating ArcGIS Survey123 to Version 3.12 on an Android D

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.