[FOLIO-2655] Upgrade fails on failure to update reference data Created: 22/Jun/20  Updated: 24/Mar/23

Status: Open
Project: FOLIO
Components: None
Affects versions: None
Fix versions: None

Type: Bug Priority: P2
Reporter: Wayne Schneider Assignee: Unassigned
Resolution: Unresolved Votes: 0
Labels: keep-bug, platform-backlog, platform-core
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original estimate: Not Specified

Issue links:
Relates
relates to RMB-873 TenantLoading Reference Data Upgrade Open
relates to FOLIO-2604 SPIKE: investigate upgrade/migrate st... Closed
relates to UXPROD-3111 Improved management of reference data... Draft
Sprint: CP: Roadmap backlog
Development Team: Core: Platform

 Description   

By using the UI or the APIs (that is, in sanctioned ways) it is possible to create user data that conflicts with incoming reference data on module upgrade.

This conflict causes loading reference data to fail.

This failure aborts the entire upgrade. Okapi continues to route to the original (un-upgraded) module set for the tenant.

The storage module schemas, however, may have been fully or partially upgraded, so system storage may be left in an inconsistent state. It is likely impossible to know the state of the system storage without Okapi logfile analysis and module code inspection.

There are a few ways to address this, from fairly simple to quite complex:

  • Modules could log a failure to load reference data as a warning or error in the log, but still respond to the tenant initialization request with a success or partial-success error code.
  • Okapi could respond to the tenant install call with a status of something like "enabled with warnings" and (ideally) a message in the install API response.
  • Modules could adopt a more precise and nuanced approach to managing reference data. For example, reference data could be treated as immutable, and protected from updates either using the UI or the API.
  • Modules could adopt a layered approach to reference data management, as proposed in https://folio-org.atlassian.net/wiki/display/SYSOPS/Upgrades+with+Reference+data

This issue was created to address the immediate concern of upgrade failure leaving a system in an inconsistent state.

See also


Generated at Thu Feb 08 23:22:16 UTC 2024 using Jira 1001.0.0-SNAPSHOT#100246-sha1:7a5c50119eb0633d306e14180817ddef5e80c75d.