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..e0d727c5f --- /dev/null +++ b/docs/release_notes/8.x-2.0.md @@ -0,0 +1,48 @@ +# 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 + + +## 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