Information for: DEVELOPERS   PARTNERS   SUPPORT

Upgrading Acquia CMS to v2.1.0

Prerequisites

  1. Ensure that Drupal core is at least 9.5 or later. To update Drupal core, run the following command:

    composer update "drupal/core-recommended:~9.5.0" "drupal/core-composer-scaffold:~9.5.0" "drupal/core:~9.5.0" -W
    
  2. Update acquia_cms to the v2.1.0 release by running the following command:

    composer update acquia/acquia_cms -W
    
  3. After the upgrade process is complete, verify that the Acquia CMS Common module is set to 2.0.2.

    This version leverages the latest Moderation Dashboard and Config Ignore modules.

    • Moderation Dashboard: Panels, page_manager, and ctools modules are removed from Composer dependencies in the 2.x version of the Moderation Dashboard module. Therefore, Acquia recommends that you require these modules manually and remove them later, if not required.

      To add the module by using Composer, run the following command:

      composer require drupal/panels drupal/page_manager -W
      
    • Config Ignore: The config_filter module dependencies are removed in the 3.x version of the Config Ignore module. Therefore, Acquia recommends that you require the module manually and remove it later, if not required.

      To add the module by using Composer, run the following command:

      composer require drupal/config_filter
      
  4. After the upgrade process is complete, verify that Acquia CMS Starter is set to 1.4.1. Acquia removed the Webform module from Composer dependencies. Therefore, Acquia recommends that you manually require the module and remove it later, if not required.

    To add the module by using Composer, run the following command:

    composer require 'drupal/webform:^[email protected]'
    

Post-update activities

  1. Clear cache and run database updates.

    drush cr
    drush updb
    

Drupal 10 readiness

Use CKEditor5 and uninstall CKEditor4. CKEditor4 is deprecated in Drupal 9.5 or later. Therefore, Acquia recommends that you install CKEditor5 and uninstall CKEditor4. In addition, you must update all text formats to use CKEditor5.

  1. To install the CKEditor5 module, run the following command:

    drush en ckeditor5
    
  2. Click Configuration > Content authoring > Text formats and editors. Alternatively, append /admin/config/content/formats to your application name.

  3. Update each text format, such as Filtered HTML and Full HTML, to use CKEditor5. For more information, see Using the CKEditor5 text editor for the “Site Studio” text format.

  4. Uninstall the CKEditor4 module.

    drush pmu ckeditor