docs/RELEASE_NOTES_NEXT/Administration/Enhanced_Concerto_Dataset.adoc

   1 == Enhanced Concerto dataset ==
   2
   3 An alternative sample dataset called "Enhanced Concerto" is now
   4 available. This dataset includes a more realistic organizational
   5 unit structure and additional data with which to test Evergreen
   6 functionality.
   7
   8 The "Enhanced Concerto" dataset supports human-driven testing
   9 and community demonstrations. However, at present, automated
  10 tests, particularly the ones found in `Open-ILS/src/sql/Pg/live_t`
  11 and `Open-ILS/src/perlmods/live_t`, are not guaranteed to pass
  12 with the "Enhanced Concerto" dataset; instead, they remain targeted
  13 to working with the original "Concerto" dataset.
  14
  15 === Installing the dataset ===
  16
  17 The dataset can be loaded when installing Evergreen by using the
  18 `--load-concerto-enhanced` option of `eg_db_config`. For example:
  19
  20 [source,bash]
  21 ----
  22 perl Open-ILS/src/support-scripts/eg_db_config --update-config \
  23        --service all --create-database --create-schema --create-offline \
  24        --user <user> --password <password> --hostname <hostname> --port <port> \
  25        --database <dbname> --admin-user <admin-user> --admin-pass <admin-pass> \
  26        --load-concerto-enhanced
  27 ----
  28
  29 The `--load-concerto-enhanced` switch is mutually exclusive with the
  30 `--load-all-sample` switch to load the full original "Concerto" dataset
  31 and the `--load-concerto` switch to load just the bibs, items, and
  32 authorities from the original "Concerto" dataset.
  33
  34 === Updating the dataset ===
  35
  36 An experimental script called `make_concerto_from_evergreen_db.pl` is
  37 included to support
  38
  39 * updating the dataset as Evergreen's schema evolves
  40 * incorporating changes to the dataset from a running Evergreen system
  41
  42 The script compares data between different versions of an
  43 Evergreen database depending on how it is invoked. This script has known
  44 bugs and its output *must* be manually reviewed before being committed.