• Stub
  • DCB MOBIUS Beta 2.4 Update 5 - 22 Nov 2023

    Component

    Version

    New Version for Release?

    dcb-service

    v2.5.1

    dcb-locate

    v2.2.3

    dcb-admin-ui

    v1.0.3

    dcb-devops

    v1.0.2 | head

    Use head


    Changes

    Additionally, in dcb-service

    • v.2.4.0

      • Create a new transaction for each of the tracking events

      • Add logger when subscribe complete for tracking calls

      • Indexing tweaks, including

        • added reindex job to admin controller

        • create index for OS or ES on startup

      • Case insensitivity

    • v2.4.1: Use correct local_request_status when seeking patron requests on the borrowing side to track

    • v2.5.0

      • Set default sort order when getting locations without parameters to “name”

      • Added authentication for Search Index

      • Shout when cert verification is disabled

      • Enable metrics implementation

      • Enable generation of jacoco test coverage report as CSV

      • Enable workflow actions to clean up cancelled requests to take through to finalised state

      • Add messaging to cancellation handler when missing borrower request

      • Refine data fetching for patron requests

      • GraphQL: Add patronRequest to supplierRequest type

    • v2.5.1

      • Add requesterNote to patron requests

      • Fix misspelled data fetcher for patron request joins

      • Improve badResumption token handling

    Deployment

    Summary

    Change Category

    Required

    Recommended

    Not Required

    Change Category

    Required

    Recommended

    Not Required

    Complete reset

     

     

    Environment configuration

     

     

    Host LMS configuration or setup

    (instructions #1 & #3 below)

     

     

    Service configuration

     

     

    Ingest

     

     

    Index

    (instructions #3 below)

     

     

    Library configuration

     

     

    Deploy new Executables

     

     

    Instructions - Before deploying the new version

    1. A breaking change has been introduced for Polaris configuration. The lmsClientClass class for Polaris has changed to org.olf.dcb.core.interaction.polaris.PolarisLmsClient from the previous value org.olf.dcb.core.interaction.polaris.papi.PAPILmsClient

    2. The Polaris config block has been extended substantially and now needs to be

      "clientConfig": { "ingest": "false", "base-url": "https://stlouis-training.polarislibrary.com ", "page-size":100, "staff-username": "...", "staff-password": "...", "domain-id": "...", "access-id": "...", "access-key": "...", "papi": { "papi-version": "v1", "lang-id": "1033", "app-id": "100", "org-id": "1" }, "services": { "services-version": "v1", "language": "eng", "product-id": "20", "site-domain": "polaris", "organisation-id": "73", "workstation-id": "1" }, "item": { "renewal-limit": "0", "fine-code-id": "1", "history-action-id": "6", "loan-period-code-id": "9", "shelving-scheme-id": "3", "barcode-prefix": "test" } }

      After changing - re-post the json to the hostlmss endpoint to commit the change.

    3. This release adds direct support for dcb-service pushing records from the canonical shared index aggregation into a downstream discovery index (ES/OS in this case). This means DISABLING the existing script based ETL approach to populating the shared index and configuring a number of new environment variables in accordance with https://openlibraryenvironment.github.io/dcb-service/#environment-variables .

     

    DCB_INDEX_NAME

    Name of the index representing the shared index

    no

    si-index

    DCB_INDEX_USERNAME

    Username to communicate with the index service

    no

    si-user

    DCB_INDEX_PASSWORD

    Password to communicate with the index service

    no

    si-pass

    Choose 1 of the below

     

     

     

    ELASTICSEARCH_HTTP_HOSTS

    1 or more Elasticsearch hosts (Comma separated)

    no (See note)

    http://localhost:9200

    OPENSEARCH_HTTP_HOSTS

    1 or more OpenSearch hosts (Comma separated)

    no (See note)

    http://localhost:9200

    Afterwards, DELETE the existing ES/OS index. It will be recreated when dcb restarts, and then POST to the /admin/reindex endpoint to request that DCB re-populates the newly initialised ES/OS index.

    Verification

    After clear down

    After deployment

    Be sure to disable the old style push to ES/OS script
    Check logs for proper configuraiton of ES/OS push

     

     

    Operated as a Community Resource by the Open Library Foundation