Changes
Jira Legacy | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Additionally, in dcb-service
[Ingest]
In Sierra - deleted=true means ONLY deleted records, and suppressed=true means ONLY suppressed records. The default is to return all and that's what we want. Do not send deleted or suppressed parameters when harvesting.
[General]
Re-elect selected bib on cluster if current is deleted
[Security]
remove anon auth from remaining rest endpoints
[General]
Query for page then expand in separate query (Cluster export optimisations for pushing to ES/OS)
[Refactor]
Move record clustering service into package.
[Rework]
Cluster controller to use service and improve response time
[Polaris]
Override the isEnabled method to honor settings from config
Force page-size to 100 maximumFlexible handling of pickup location context - allow the place request command to optionally specify a context for the pickup location, if not provided default to the patron home context
Add canonicalPType field to interaction Patron and set this coming out of the Sierra host LMS adapter
graphql - Add ProcessStatus query to graphql endpoint
ingest - Add human readable timestamps HRTS to process state for sierra to make it easier to diagnose harvesting issues
Change patron type lookups to range mapping
Add pickup location code context to data model
Implement validatePatronByUniqueIdAndSecret option for patron auth
Deployment
Summary
Change Category | Required | Recommended | Not Required |
---|---|---|---|
Complete reset | (DCB Postgres, OpenSearch) (Keycloak) | ||
Environment configuration | No changes to keycloak | ||
Host LMS configuration or setup | (New systems) | ||
Service configuration | |||
Ingest | (New sources) | ||
Index | |||
Library configuration | (New Config) |
Scope: This patch release will create a test system involving a number of Stand-Alone Sierra systems which will be a part of the final MOBIUS network, and a number of Sierra Clusters which are currently using Sierra but will be moving to FOLIO in the final configuration. The purpose is to enable testing between member libraries, to build confidence with those libraries staying with their existing systems, and to allow libraries migrating to FOLIO to partially experience how the system will behave for themis just a new executable for dcb-service and is a drop in replacement for the current service. No deployment changes beyond the new executable are needed.
Instructions
Download and compile the tagged release sourcecode from dcb-service and dcb-locate
Fully remove existing tables from DCB Postgres schema. Take care to remove
flyway_schema_history
LAST. This is a manual operation normally completed through PGAGMIN.Fully remove the existing Elastic/OpenSearch indexes and reconfigure the new schemas - there is a “schema.sh” script in the dcb-devops repository which can be adapted for this.
Update deployment of dcb-service and dcb-locate executables with newly built artefacts - this will cause regeneration of the tables in the Postgres schema. Check tables are present after deployment.
Verify and Deploy host LMS configurations (ingest:true) for:
KCTOWERS (Cluster, Sierra)
BRIDGES (Cluster, Sierra)
AVALON (Cluster, SIerra)
COOLCAT (Standalone, SGCL, Sierra)
DM (Standalone Sierra)
WASHU (Standalone Sierra)
Optionally - SEMO IF we have creds
Verify and Load the mapping files
Local to Central Patron Types
Verify: DONE (2023-10-25 21:07)
Load: curl -X POST $TARGET/admin/cfg -H "Accept-Language: en" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" -d '{Local to Central Item Types
Verify: DONE (2023-10-25 21:07)
Load: curl -X POST $TARGET/admin/cfg -H "Accept-Language: en" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" -d '{
"profile":"numericRangeMappingImport",
"url":"https://docs.google.com/spreadsheets/d/e/2PACX-1vSID6JxZ4txA-lOCCs8Z9ld2KnjCHWWixJVrbuzxL_IoBpKOHFInayPOyFMcX2Gh5-bxYFNNBzR4l0y/pub?output=tsv&gid=375838007 "
}'
Central to Local Patron Types
Verify: DONE (2023-10-25 21:07)
Load: curl -X POST $TARGET/admin/cfg -H "Accept-Language: en" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" -d '{
"profile":"referenceValueMappingImport",
"url":"https://docs.google.com/spreadsheets/d/e/2PACX-1vSID6JxZ4txA-lOCCs8Z9ld2KnjCHWWixJVrbuzxL_IoBpKOHFInayPOyFMcX2Gh5-bxYFNNBzR4l0y/pub?gid=280712508&single=true&output=tsv "
}'
Central to Local Item Types
Verify: DONE (2023-10-25 21:07)
Load: curl -X POST $TARGET/admin/cfg -H "Accept-Language: en" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" -d '{
"profile":"referenceValueMappingImport",
"url":"https://docs.google.com/spreadsheets/d/e/2PACX-1vSID6JxZ4txA-lOCCs8Z9ld2KnjCHWWixJVrbuzxL_IoBpKOHFInayPOyFMcX2Gh5-bxYFNNBzR4l0y/pub?output=tsv&gid=1273101045 "
}'
Shelving Location to Agency Mappings
Verify: MISSING DM VALUES
Load: curl -X POST $TARGET/admin/cfg -H "Accept-Language: en" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" -d '{
"profile":"referenceValueMappingImport",
"url":"https://docs.google.com/spreadsheets/d/e/2PACX-1vTbJ3CgU6WYT4t5njNZPYHS8xjhjD8mevHVJK2oUWe5Zqwuwm_fbvv58hypPgDjXKlbr9G-8gVJz4zt/pub?gid=57428779&single=true&output=tsv "
}'
Pickup Location Mappings
Verify: Mostly complete - some duplicate location codes - need to discuss with TA
Load: curl -X POST $TARGET/admin/cfg -H "Accept-Language: en" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" -d '{
"profile":"referenceValueMappingImport",
"url":"https://docs.google.com/spreadsheets/d/e/2PACX-1vTbJ3CgU6WYT4t5njNZPYHS8xjhjD8mevHVJK2oUWe5Zqwuwm_fbvv58hypPgDjXKlbr9G-8gVJz4zt/pub?gid=523902094&single=true&output=tsv "
}'
Agencies
Verify: DONE (2023-10-25 21:07)
Load: (https://docs.google.com/spreadsheets/d/e/2PACX-1vTbJ3CgU6WYT4t5njNZPYHS8xjhjD8mevHVJK2oUWe5Zqwuwm_fbvv58hypPgDjXKlbr9G-8gVJz4zt/pub?gid=727698722&single=true&output=tsv via bash script)
Reset cfg.json - remove cursor key+value for push-to-opensearch script
"profile":"numericRangeMappingImport", "url":"https://docs.google.com/spreadsheets/d/e/2PACX-1vSID6JxZ4txA-lOCCs8Z9ld2KnjCHWWixJVrbuzxL_IoBpKOHFInayPOyFMcX2Gh5-bxYFNNBzR4l0y/pub?gid=518437160&single=true&output=tsv "
}'
Verification
- After clear down - check postgres database is EMPTYAfter deployment - check postgres tables recreated
- After deployment - check OpenSearch schema in place