From 67c4a67349c5c0e4b65f267cea1e07e194dc5441 Mon Sep 17 00:00:00 2001 From: Galen Charlton Date: Wed, 3 May 2023 10:25:23 -0400 Subject: [PATCH] LP#1901932: (follow-up) update release notes Signed-off-by: Galen Charlton --- .../Enhanced_Concerto_Dataset.adoc | 44 +++++++++++++++++++ ...Wish List - Enhanced Concerto dataset.adoc | 15 ------- 2 files changed, 44 insertions(+), 15 deletions(-) create mode 100644 docs/RELEASE_NOTES_NEXT/Administration/Enhanced_Concerto_Dataset.adoc delete mode 100644 docs/RELEASE_NOTES_NEXT/Administration/lp1901932 Wish List - Enhanced Concerto dataset.adoc diff --git a/docs/RELEASE_NOTES_NEXT/Administration/Enhanced_Concerto_Dataset.adoc b/docs/RELEASE_NOTES_NEXT/Administration/Enhanced_Concerto_Dataset.adoc new file mode 100644 index 0000000000..d142a25684 --- /dev/null +++ b/docs/RELEASE_NOTES_NEXT/Administration/Enhanced_Concerto_Dataset.adoc @@ -0,0 +1,44 @@ +== Enhanced Concerto dataset == + +An alternative sample dataset called "Enhanced Concerto" is now +available. This dataset includes a more realistic organizational +unit structure and additional data with which to test Evergreen +functionality. + +The "Enhanced Concerto" dataset supports human-driven testing +and community demonstrations. However, at present, automated +tests, particularly the ones found in `Open-ILS/src/sql/Pg/live_t` +and `Open-ILS/src/perlmods/live_t`, are not guaranteed to pass +with the "Enhanced Concerto" dataset; instead, they remain targeted +to working with the original "Concerto" dataset. + +=== Installing the dataset === + +The dataset can be loaded when installing Evergreen by using the +`--load-concerto-enhanced` option of `eg_db_config`. For example: + +[source,bash] +---- +perl Open-ILS/src/support-scripts/eg_db_config --update-config \ + --service all --create-database --create-schema --create-offline \ + --user --password --hostname --port \ + --database --admin-user --admin-pass \ + --load-concerto-enhanced +---- + +The `--load-concerto-enhanced` switch is mutually exclusive with the +`--load-all-sample` switch to load the full original "Concerto" dataset +and the `--load-concerto` switch to load just the bibs, items, and +authorities from the original "Concerto" dataset. + +=== Updating the dataset === + +An experimental script called `make_concerto_from_evergreen_db.pl` is +included to support + +* updating the dataset as Evergreen's schema evolves +* incorporating changes to the dataset from a running Evergreen system + +The script compares data between different versions of an +Evergreen database depending on how it is invoked. This script has known +bugs and its output *must* be manually reviewed before being committed. diff --git a/docs/RELEASE_NOTES_NEXT/Administration/lp1901932 Wish List - Enhanced Concerto dataset.adoc b/docs/RELEASE_NOTES_NEXT/Administration/lp1901932 Wish List - Enhanced Concerto dataset.adoc deleted file mode 100644 index a15aa9fa26..0000000000 --- a/docs/RELEASE_NOTES_NEXT/Administration/lp1901932 Wish List - Enhanced Concerto dataset.adoc +++ /dev/null @@ -1,15 +0,0 @@ -= Wish List - Enhanced Concerto dataset = - -== New option for eg_db_config == - -Introducing a new _enhanced_ Evergreen dataset. You can setup a test server with this -new dataset by issuing this command: - -[source,bash] ----- -perl Open-ILS/src/support-scripts/eg_db_config --update-config \ - --service all --create-database --create-schema --create-offline \ - --user --password --hostname --port \ - --database --admin-user --admin-pass \ - --load-concerto-enhanced ----- \ No newline at end of file -- 2.43.2