2026-03-04 Sys Ops & Management SIG Agenda and Meeting Notes

Eureka Deployment Techniques

Florian

Florian: We started with Eureka now. How to get the version numbers of a release ?

Jason: It is a three step process. There is platform-lsp. This gives you the application versions. The list of applications is not complete, yet, technically. FOLIO+Eureka+Applications in the Wiki gives you all of the applications that can in theory be a part of the LSP.

For example app-platform-minimal. Go to that repo. There is an application-descriptor.json.

Some have an url. You can make it “null” for the backend modules “mod-”. Those who have a url in the ui modules don’t match the specifications.

No good way, yet, to organize this robotically.

platform-lsp/package.json

We had github actions to build the Frontend (Jason). I have combined them and named the descriptors. I have them in my own repo. I have one place for all to live.

Shelley has a repo with the application descriptors. [sul-dlss/folio-k8s] on github.com

Florian: Need to have a single source of thruth. There should be only one Secret with a specified value, otherwise one can not handle it.

Shelley: We deploy using ArgoCD. Using Vault. Not using ephemeral storage. You have to unseal the Vault.

“Install Vault in the cluster namespace if there are issues with ArgoCD app”

“vault put” vs. “vault update”

Create Entitlements

Create keycloak system users - mod-users-keycloak and mod-login-keycloak ---- may be not needed

You have to entitle app-platform-minimal before you entitle anything else.

Reinstall application will entitle and do database upgrades.

Recommended: Delete Entitlement and Post new entitlement.

You cannot have two versions of the same application.

Florian: Want to not use the Bitnami Charts.

Shelley: There is a way to start up Keycloak that does not configure the Realm. There is a “configure realm” script. It seems weird.

Last Week’s Notes:

Flux CD
Argo CD
Flo: Rolling out Developer Enviroment; One Repository for each Developer
YAML Files hosted on Repositories
Florian: Presentation to Developers (2,5 h) ; a prototype of how to use Argo CD

Florian offers to do the presentation in English in one of the next sessions here!

BiblioCon vs. Bib Commons Conference
Eureka Deployments
Argo CD

WolfCon
More structured - short talks
depict infrastructure requirements

Local installation strategy:
3 or 4 installations dev - prod - demo - test
multi-tenancy on the installations
split up installations by Name space;
Jason host single Name spaces (liable to pay costs)
others share 1 Namespace with 10 tenants
each Namespace has their own infrastructure (postgres, elastic, kafka, okapi / Kong)
2 versions of FOLIO deployed in each Namespace
in Okapi you can use the same Gateway for tenant X and Y ; Kafka needs to be a different Installation / In Eureka, you would use different Gateways (Kong) for each tenant.
Kafka has a different Name for each version: kafka-ramsons, kafka-sunflower
different secrects that have KAFKA_HOST

Ingolf (permission upgrade issue):
the admin user needs a freshly generated list of permissions after each release upgrade ; can still use bootstrap-user.pl

You have to add new permissions after the fact.

Better would be global permission sets (admin, circ desk, order etc.) which would be maintained by FOLIO and updated for each release.

The situation will get even more complicated in Eureka. Permissons will be replaced by Capabilities and Roles.

Josh: an issue in mod-source-record-storage partitions "give it 12 partitions"
in Quesnelia we had more Problems with data Import

Jason: an issue in EDI Imports

Chat Log

Heute

Shelley Doljack 18:19
https://github.com/sul-dlss/folio-platform-complete/blob/4ebab48b6952f9bc14f3f2fee8c6fe6bd6d65185/package.json#L106-L107

https://github.com/sul-dlss/folio-eureka

Shelley Doljack 18:25
https://github.com/sul-dlss/folio-eureka/blob/main/folio-test/application-descriptor-z3950.json

Shelley Doljack 18:45
KC_HTTPS_KEY_STORE_PASSWORD

Shelley Doljack 18:54
https://folio-org.atlassian.net/browse/MODSET-43

Topics for next meetings

Ingolf

Using FOLIO as a local system in a library union environnement

FOLIO to interact with a union catalogue, which is NOT FOLIO

1. Use case: Download: Creation and Updating of bib records in the union catalog, then import/update to FOLIO SRS (Format: MARC-XML)

   1. Requirements for FOLIO: Import interface. Merging external records to existing records in SRS (matching via external id). Subsequently updating the FOLIO inventory records accordingly.

2. Use case: Location Upload: When FOLIO creates a location (Holding) for a bib record, the union catalogue needs to get knowledge of the new Holding (because the holdings will be listed in the union catalog).

   1. Requirements on FOLIO: Export of the whole record, bib + holdings, in a single MARC-XML record.

   2. Requirements on union catalog: Import facility, Match & Merge of Holings records.

3. Use case (optional) : Creating new bib records in FOLIO (quick marc) and exporting them to the union catalogue.

   1. Requirements: FOLIO bib export inteface

   2. Requirements on union catalog: Import facility for new records !