If you encounter a failure while performing an update or upgrade, use the following approaches to troubleshoot and resolve issues:
- When conducting an update or upgrade, view the History tab to identify if an error occurred. As status messages are returned, the options to view logs, download logs, and export curated organization warnings are also available and can provide insight into whether action is required. It is recommended that you filter the log level to severe to determine specific logs during the update time period.
- If you encounter a message about a deployment failing to refresh for a particular deployment, do the following:
- On the Logs page in ArcGIS Enterprise Manager, click Manage columns.
- Enable the Stack trace option to make it a visible column.
- If you encounter a time-out error in the stack trace, such as Timing out patch operation, this may be because the start up time for one or more containers has exceed expected wait times and timed out, causing the upgrade to fail. To address this issue, increase the value for containerStartUpTimeoutSeconds in ArcGIS Enterprise Administrator API by clicking System > Properties. The new value must be greater than the default value of 1,800 seconds. Once you've increased the value, run the upgrade again.
- If members cannot access the organization after an upgrade, for example, administrators or other member accounts cannot sign in to ArcGIS Enterprise Manager or the portal, it may be due to an issue with the relational data store. If this is the case, do the following:
- If ArcGIS Enterprise Manager or the Upgrade progress page is inadvertently closed during the upgrade process, you can refer to the ArcGIS Enterprise Administrator API for current status and progress. Details are provided there for an update, upgrade, or rollback and can be used for troubleshooting as necessary.