From a60abd9e3ab2d177774bcde17870ce79e179fe67 Mon Sep 17 00:00:00 2001 From: Eli Zoller Date: Mon, 15 Mar 2021 11:06:13 -0700 Subject: [PATCH 1/3] a start at documenting release notes --- docs/release_notes/8.x-2.0.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 docs/release_notes/8.x-2.0.md diff --git a/docs/release_notes/8.x-2.0.md b/docs/release_notes/8.x-2.0.md new file mode 100644 index 000000000..634371156 --- /dev/null +++ b/docs/release_notes/8.x-2.0.md @@ -0,0 +1,30 @@ +# 8.x-2.0 Release Notes + +## Removing Gemini +It is recommended to test this method in a staging/development environment before running in your production environment. +1. Update islandora core (likely through a command like `composer update islandora/islandora`) +2. Import two new Islandora views + i. This can be done by coping the views into a new directory and using drush such as + ``` + mkdir /var/www/html/drupal/config/1time + cp /var/www/html/drupal/web/modules/contrib/islandora/modules/islandora_core_feature/config/install/views.view.all_taxonomy_terms.yml /var/www/html/drupal/config/1time/ + cp /var/www/html/drupal/web/modules/contrib/islandora/modules/islandora_core_feature/config/install/views.view.non_fedora_files.yml /var/www/html/drupal/config/1time/ + drush config:import --partial --source /var/www/html/drupal/config/1time + ``` + ii. It can also be done through the UI at `/admin/config/development/configuration/single/import` +3. Update crayfish-commons for drupal with something like `cd /var/www/html/drupal && composer update islandora/crayfish-commons` +4. Update Crayfish code (likely by traversing to your crayfish installation and doing a git pull `cd /var/www/html/Crayfish && git pull`) +5. Run composer install for Milliner such as `cd /var/www/html/Crayfish/Milliner && composer install` +6. Run composer install for Recast such as `cd /var/www/html/Crayfish/Recast && composer install` +7. Update the Recast config + i. `cd /var/www/html/Crayfish/Recast/cfg` + ii. open `config.yaml` + iii. Remove `gemini_base_url` + iv. Update `base_url` in `fedora_resource` section. It should contain a value something like `http://localhost:8080/fcrepo/rest` +8. Clear your cache in Drupal. Potentially like `cd /var/www/html/drupal && drush cr` +9. Restart apache (not 100% sure if this is necesssary) `sudo systemctl restart apache2` +9. Test to make sure you can view existing objects in Fedora by going to the Drupal UI and clicking one of the Fedora URI links +10. Create a new object and make sure it persists to Fedora and the Fedora URI likn resolves correctly. Make sure that no new entries get added to Gemini. +11. If you're feeling brave, you can then remove Gemini like + i. `rm /var/www/html/Crayfish/Gemini` + ii. Remove the gemini database and the associated mysql user \ No newline at end of file From f3a2f93c758cf91ad1dc5eda42b47a8d0ac7e261 Mon Sep 17 00:00:00 2001 From: Eli Zoller Date: Mon, 15 Mar 2021 11:10:46 -0700 Subject: [PATCH 2/3] update spacing --- docs/release_notes/8.x-2.0.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/release_notes/8.x-2.0.md b/docs/release_notes/8.x-2.0.md index 634371156..35a7cfa2e 100644 --- a/docs/release_notes/8.x-2.0.md +++ b/docs/release_notes/8.x-2.0.md @@ -4,6 +4,7 @@ It is recommended to test this method in a staging/development environment before running in your production environment. 1. Update islandora core (likely through a command like `composer update islandora/islandora`) 2. Import two new Islandora views + i. This can be done by coping the views into a new directory and using drush such as ``` mkdir /var/www/html/drupal/config/1time @@ -17,6 +18,7 @@ It is recommended to test this method in a staging/development environment befor 5. Run composer install for Milliner such as `cd /var/www/html/Crayfish/Milliner && composer install` 6. Run composer install for Recast such as `cd /var/www/html/Crayfish/Recast && composer install` 7. Update the Recast config + i. `cd /var/www/html/Crayfish/Recast/cfg` ii. open `config.yaml` iii. Remove `gemini_base_url` From 17837b37201dde3a0511f179dd0eca3b572d5b11 Mon Sep 17 00:00:00 2001 From: Eli Zoller Date: Thu, 18 Mar 2021 09:24:21 -0700 Subject: [PATCH 3/3] add release notes for captions --- docs/release_notes/8.x-2.0.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/docs/release_notes/8.x-2.0.md b/docs/release_notes/8.x-2.0.md index 35a7cfa2e..e0d727c5f 100644 --- a/docs/release_notes/8.x-2.0.md +++ b/docs/release_notes/8.x-2.0.md @@ -29,4 +29,20 @@ It is recommended to test this method in a staging/development environment befor 10. Create a new object and make sure it persists to Fedora and the Fedora URI likn resolves correctly. Make sure that no new entries get added to Gemini. 11. If you're feeling brave, you can then remove Gemini like i. `rm /var/www/html/Crayfish/Gemini` - ii. Remove the gemini database and the associated mysql user \ No newline at end of file + ii. Remove the gemini database and the associated mysql user + + +## Adding Captions +1. Make sure you are on the most recent code of islandora and islandora_defaults (`composer update islandora/islandora islandora/islandora_defaults`) +2. Do a config import on the `config/install` directory of `islandora_defaults` or copy the changed files into another directory and import those (if you are on an existing install, i'd recommend the partial config import). The changed files are: + i. core.entity_form_display.media.audio.default + ii. core.entity_form_display.media.video.default + iii. core.entity_view_display.media.audio.default + iv. core.entity_view_display.media.audio.source + v. core.entity_view_display.media.video.default + vi. core.entity_view_display.media.video.source + vii. field.field.media.audio.field_track + viii. field.field.media.video.field_track + ix. field.storage.media.field_track +3. clear your drupal cache `drush cr` +4. You should now see a "track" field on audio and video media objects \ No newline at end of file