Important Upgrade Considerations
This section outlines all changes that require special consideration for customers in production. Configuration changes may be needed to prevent operational interruptions. See checklist for guidelines on how to fill this out.
Changes and Required Actions
|Functional Area||Change or Addition||Considerations|
|Affected app or module||What has been changed or added that should be noted for this release||What challenges may arise related to this change or addition|
When can the action be taken (before, during or after upgrade)?
If applicable, detail what action(s) must be taken here
Is this action required for the next release?
|Name of user leaving comment: comment on what you encountered or ask a question @mention Contact person||User name of person that can provide additional detail.|
Include issue link for bug fix, story or feature that applies
|Data Import & Inventory|
Update to the default MARC Bib-to-Inventory Instance MAP:
After upgrade, library may want to review their local default MARC Bib-to-Inventory Instance map, and decide if they want to add this revised mapping into it.
Follow the instruction to update the rules.
|Data Import||Reminder when upgrading||When upgrading from one flower release to the next, confirm that the deployed modules are of compatible modules and are in the same release. If incompatible modules versions, Kafka messages consumed by older versions of modules can cause problems. When entity schema changes in such a way it usually leads to an API version bump and if module that requires a specific version of the API deployed and the API is not there - it results in an error. Unfortunately, there is no such mechanism for changes in Kafka message payload - topics that are used are the same, therefore a consumer in an older module version will consume the messages.|
|Settings, Circulation, Loan history||The circulation setting "Loan history" as been updated to "Loan anonymization"||Please note: The permission names have not been updated, and still refer to "Loan history"||N/A||N/A|
|Permissions, Circulation||With the permission "Settings (Circ): Can view loan history", the Save button on the Loan anonymization page is no longer visible (UICIRC-767).|
In addition, a new permission has been created, "Settings (Circ): Can edit loan history", for which the Save button on the Loan anonymization page is visible and can be selected (UICIRC-766).
|Please note: The permission names contain the old name of the setting (Loan history), but refer to the circulation setting Loan anonymization.||Update your users' permissions and/or permission sets, as required.||N/A|
Permission ui-tenant-settings.settings.enabled - display name "Settings (Tenant): View" has been made invisible
The permission is used to grant basic view to Settings > Tenant but grants no other functionality. It implies that you can use it to give view-only access to content in that area, which is not the case. Making the permission visible: false removes that confusion.
Recommend removing "Settings (Tenant): View" from any users prior to upgrading to Nolana.
You can also remove the permissions after upgrade by enabling Settings > Developer > Configuration > List invisible permissions in add perm menus and then editing the relevant user records.
Update your users' permissions and/or permission sets, as required.
Recommend removing "Settings (Tenant): View" from any users prior to upgrading to Nolana.
Actual cost will not be fully implemented for Nolana. It is recommended that you wait until Orchid to start using actual cost.
If you start using actual cost in Nolana, the “Lost items requiring actual cost” processing page will not be available for billing. This means that you will need to bill actual cost via a manual fee/fine that will NOT change Item status from “Declared lost”/”Aged to lost” to “Lost and paid” when the fee is paid.
If you started using actual cost in Nolana, when Orchid is implemented you will need to you will need to mark items as “do not bill” on the “Lost items requiring actual cost” processing page if fee was billed manually. The "Lost item fee policy" includes a setting For lost items not charged a fee/fine, close the loan after <interval>. Using this setting to "expire" actual cost lost items will eliminate the need for this if you set the <interval> to a smaller time period.
For details about when various actual cost functions will be available, see slide deck
|Resource Access||Improvements to Settings > Calendar|
The interface for adding, editing, or removing calendars from service points has significant UI improvements and has changed to a tabular UI format. Additionally, calendars can now be assigned to multiple service points and exceptions can store multiple openings and closures.
|All calendar-related permissions have changed may need to be updated.|
Permissions provided by ui-calendar 7.x have been updated to more specific ones; most notably, this includes the ".all" permission. Administrators may want to go through user's permissions and re-evaluate what is necessary with these new specific permissions.
The database schema used for mod-calendar has been overhauled, however, no special action is required. As part of the upgrade from 1.15.0 to 2.0.0, all existing data will be transformed and preserved. If you are not already on mod-calendar 1.15.0, we recommend upgrading to it before upgrading to 2.0.0.
|Data export - Export authority records||New default job-profile for authorities was added.|
Use MARC authority app
|It requires to load reference for module.|
|Locations||Locations and location units moved from reference data to sample data|
When initially enabling mod-inventory-storage for a tenant a few locations and location units (institutions, campuses, libraries) can automatically be created. Before Nolana loadReference=true triggered this, from Nolana on loadSample=true is needed.
Adjust scripts that expects them as reference data.
|Search||Routing was changed to default. All indexes should be recreated.||During the upgrade process|
mod-search indices will need to recreate for both instance and authority as described here
|Search||When using AWS OpenSearch, the response returned by the bulk api is malformed which is causing errors in mod-search. The issue does not occur with local instances of OpenSearch or ElasticSearch, only instances in AWS Infrastructure. Due to this, performance gains could not be determined. When the issue is resolved by AWS, this can be revisited.|
During the upgrade process before reindexing
Set environment variable INDEXING_DATA_FORMAT = json
Mapping rules were changed. It's required to update default mapping rules in the database.
|Only applies to a library that has MARC authority records in Morning Glory environment|
Apply after mod-source-record-manager upgrade. Please do the following actions.
|Fees/Fines||The buttons (e.g. Pay, Waive, Transfer) on the top of the Fees/Fines History and Fee/Fine Details pages have been replaced with an ACTIONS menu. This has been done so that the pages match the design of the rest of FOLIO. The functionality has not changed.|
|Inventory single record import/quickMarc derive||DB Read/Write split should be disabled for mod-source-record-manager||In case Read instance is not synchronising fast enough, some single record operations could fail||When mod-source-record-manager is deployed do not pass the environment variables for DB_HOST_READER and DB_PORT_READER (it won't be enabled by default)|
|Data Import||Settings and Configuration||Refer to Settings and Configuration page for details on modules involved in Data Import. Adjust if needed to optimise performance.|
|NCIP||Settings and Configuration||New optional configuration. Default value if not set: FOLIO|
|SMTP configuration||SMTP configuration was moved from mod-configuration to mod-email||Interesting information for FOLIO SysAdmins|
|App||New Permissions||Deprecated Permissions||Product Owner|
|Dashboard||Dashboard: Dashboard Administrator|
|Bulk edit||Bulk edit: In app - Update user records|
|App||Known issue||Workaround||JIRA issue||Product Owner|
|Users||Mail notices do not get sent to proxy, even when that value is selected, but get sent to sponsor||Currently no work around; this is new work to do the back-end of what is visible in the UI.||Julie Bickle|
|mod-inventory-storage||Authorities update through quick-marc are applied to mod-search records with a delay of 1 update||Remove ||MODINVSTOR-1006||Khalilah Gambrell|
Files generated by following jobs are available only for several hours due to AWS Identity and Access Management (IAM) instance profile settings:
|Repeat exports again||Magda Zacharska|
|Bulk edit||Intermittent error "Something went wrong" after rearranging columns while editing holdings record. The error occurs on the Are you sure form before any changes are committed.||Restart bulk edit.|
|mod-search||boundWith flag is not updated in mod-search|
|Title level requests||No known workarounds.||, CIRC-1684, CIRC-1693||Stephanie Buck|
|Purging a tenant||After disabling modules with purge option for one tenant other tenants get this error:|
This affectes only modules where environment variable DB_MAXSHAREDPOOLSIZE is set.
|After disabling modules with purge option restart all modules where environment variable DB_MAXSHAREDPOOLSIZE is set.||Julian Ladisch|
Additional known issues (Reminder change filter to Release = Nolana)
|Key||Summary||T||Updated||Potential Workaround||Development Team||Status||Resolution||Release|
Notes on functionality
PO Release Presentations
|Presentation||Presentation date||Presenter||SIG meeting (link)||Notes|
|Acquisitions||November 1, 2022||Dennis Bridges||Agenda and Meeting Notes#:~:text=Demo%20Nolana%20Release%20highlights|
|ERM: Agreements||November 2, 2022||Owen Stephens|
|View slide 2-4, and recording from 10:14-37:10 (includes Dashboard 13:45-17:45)|
|Dashboard||November 2, 2022||Owen Stephens|
|View slide 2, and recording from 13:45-17:45|
|Bulk edit||November 10, 2022||Magda Zacharska||Bulk edit related recording starts at 26:20|
|Date (verified in BugFest)||Bug fixed||Documentation on GitHub|
|Date||Hotfix release (needs more info added here)||github link|
Nonfunctional Requirements (NFR) Features
All Closed Bugs and Stories
Remaining Open Bugs at Time of Release
Assuming the FOLIO support policy remains unchanged, Nolana will be supported with critical security and bug fixes until Poppy (R2 2023) release (around April 2023). With the Nolana release Lotus has reached end of life and is no longer supported.