From: Galen Charlton <gmc@equinoxOLI.org>
Date: Wed, 3 May 2023 14:25:23 +0000 (-0400)
Subject: LP#1901932: (follow-up) update release notes
X-Git-Url: https://old-git.evergreen-ils.org/?a=commitdiff_plain;h=67c4a67349c5c0e4b65f267cea1e07e194dc5441;p=Evergreen.git

LP#1901932: (follow-up) update release notes

Signed-off-by: Galen Charlton <gmc@equinoxOLI.org>
---

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 <user> --password <password> --hostname <hostname> --port <port> \
+       --database <dbname> --admin-user <admin-user> --admin-pass <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 <user> --password <password> --hostname <hostname> --port <port> \
-       --database <dbname> --admin-user <admin-user> --admin-pass <admin-pass> \
-       --load-concerto-enhanced
-----
\ No newline at end of file