This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Important versions for upgrade path

    YMCA Website Services development moves quickly and in this document, we flag important versions that should not be skipped while you upgrade your sites.

    Determining your upgrade path

    For example: If you are on YMCA Website Services 8.1.2 and want to upgrade to YMCA Website Services 8.2.8.5 you should make it in a couple of steps

    1. Upgrade 8.1.2 to 8.1.13.1
    2. Upgrade 8.1.13.1 to 8.2.2.1
    3. Upgrade 8.2.2.1 to 8.2.7.3
    4. Upgrade 8.2.7.3 …

    These supplemental documents elaborate on a few specific cases:

    Important versions

    • 8.1.13.1 - Optional, when you have a lot of customized code and 8.2.2.1 is failing in most places.

    • 8.2.2.1 - This is a very important step everyone should have. After this version, drush entup stops working. In this version, we finally migrated to the core media subsystem, and before going further it is important to upgrade media by upgrading your site to this version first.

    • 8.2.7.3 - This is a very stable Drupal 8 based YMCA Website Services with a bunch of contrib module updates. This is one of the last Drupal 8 based YMCA Website Services versions before the upgrade to Drupal 9 core. Also, in 8.2.7.0 and 8.2.7.1 we started to introduce multiple version constraints in composer.json to allow developers to choose between the minimum or latest dependency versions. This is for securing the upgrade path as well as adding flexibility for version selection if needed.

    • 9.2.8.0 - Drupal 9 version which must be used in the upgrade path before going to 9.2.8.1+. This version added 9.0-9.1 Drupal Core and disabled deprecated components.

    • 9.2.10.0 - Removed a bunch of unused modules from distribution.

    • 9.2.11.3 - Last Open Y Drupal core 9.3.* release

    • 9.2.11.4 - Technical release of YMCA Website Services ( no diff with 9.2.11.3 )

    • 9.2.13.0 - Pre Drupal 10 release, latest Drupal 9 release. Before going into Layout Builder era it is recommended to uninstall geysir, openy_inline_editing, quickedit, rdf modules.

    • 10.2.14 - Drupal 10|9 release, where you may follow the recommendations below:

      1. Upgrade to the latest Drupal 9 core (using version 10.2.14 of the distribution, released in June 2023).
      2. Upgrade all contrib modules and libraries to their latest Drupal 9-compatible versions (with composer update).
      3. Use drupal-rector, drupal-check, and PHPCS to prepare custom modules and themes for Drupal 10.
      4. Upgrade to Drupal 10 and run regression testing to search for hard-to-find bugs (update drupal/core-* projects in composer.json, then run compuser update).
      5. Upgrade all contrib modules on the Drupal 10 site to their latest versions (composer update).

    • 10.3.0.1 - Drupal 10|9 release, before New Demo Content and Initial Replacement Paragraphs to Blocks for Native Layout Builder Experience

    • 10.3.1 - Drupal 10|9 release, New Demo Content and Initial Replacement Paragraphs to Blocks for Native Layout Builder Experience. In this release we bumped a lot of dependencies to become up to date

    • 10.3.2 - Introduced recurring event support in the Event Content Type which requires an automated migration between date_range and smart_date fields. If possible, update to this version during the upgrade process.

    • 10.3.2.3 - Introduced before 10.1 and 10.2 Drupal core. Also upgraded openy_map.This version ensures we support removed modules pre 10.1 for contrib modules

    See Version Constraints practices for YMCA Website Services

    Known issues

    If you are faced with an issue when composer installs an improper version of drupal/core for the chosen version of YMCA Website Services from the list above, please use this trick in order to downgrade:

    composer require drupal/core-recommended:9.5.9

    Run the above command where your docroot is. Use the current core version instead of 9.5.9.