Upgrading Drupal Starter Kits 1.x from its current version to the latest version

Use the following steps to upgrade Drupal Starter Kits 1.x from its current version to the latest version:

1. Update Drupal core to the latest version 9.5.11 with the following command:

   copy

   drupal/core:~9.4.0 acquia/cohesion:~6.9.0 drupal/core-recommended:~9.4.0

2. Update Drupal Starter Kits to its compatible version 1.5.8 with the following command:

   copy

   composer update acquia/acquia_cms -W with drupal/acquia_cms_common:~1.9.0

3. Add Page Manager and Panels modules to the codebase with the following command:

   copy

   composer require drupal/panels drupal/page_manager

   You can remove them from the codebase later, if required. With Drupal core 9.x, the Drupal Starter Kits Common module 1.9.x uses the Moderation Dashboard module 2.x, which removes the Page Manager and Panels modules from the codebase.

4. Add the Webform module to Composer dependencies with the following command:

   copy

   composer require 'drupal/webform:~6.0.0'

   You can remove it from the codebase later, if required. The latest version of the Drupal Starter Kits Starter module removes the Webform module from Composer dependencies.

5. Update your database with the following command:

   copy

   ./vendor/bin/drush updb -y

6. (Optional) On running any Drush command, if you get the Error: Class "Drupal\Driver\Database\mysql\Connection" not found error, update database specification by replacing the line 'namespace' => 'Drupal\\mysql\\Driver\\Database\\mysql' in your settings.php file:

   copy

   $databases['default']['default'] = array (
     'database' => 'drupal',
     'username' => 'drupal',
     'password' => 'drupal',
     'namespace' => 'Drupal\\mysql\\Driver\\Database\\mysql',
     'driver' => 'mysql',
   );

7. (Optional) If you use Facet accordion custom style on the site, update its configuration:

   
   1. Edit Facet accordion from: /admin/cohesion/styles/cohesion_custom_styles.

   2. Update the .collapsiblock element to .collapsiblockTitle :

      

   3. Change anchor to button under the .collapsiblockTitle (child) element:

      

   4. Change anchor to button under the .facet-item (child) element:

      

   5. Add custom CSS property to button element under the .collapsiblockTitle (child) “CSS property: width” & “CSS value: 100%”:

      
   6. Click Save and Continue to save changes to the component.
   7. Export your Site Studio configuration to retain the preceding changes in your configurations.

8. Uninstall the Acquia Telemetry module as its functionality is available in Acquia Connector from the version 4.0.0-beta4.

   copy

   ./vendor/bin/drush pmu acquia_telemetry
   ./vendor/bin/drush cex

9. Commit all changes, deploy them to your development environment, and run the following commands:

   copy

   ./vendor/bin/drush updb -y
   ./vendor/bin/drush cim -y

10. Update Drupal core to 9.5.11 along with Drupal Starter Kits and its dependencies:

    copy

    composer update "drupal/core-*" acquia/acquia_cms  -W

11. (Optional) If you use Claro as the admin theme:

    1. Install the Site Studio Claro sub-module. The Drupal Starter Kits Site Studio module 1.6.0 uses Acquia Site Studio 7.4.2, which includes the Site Studio Claro sub-module. This sub-module fixes template and style issues for media library in Page Builder. If you do not install this sub-module, you might get the following error while updating your database:

       

    2. Enable the Acquia Claro module with the following command:

       copy

       ./vendor/bin/drush en sitestudio_claro

12. Clear cache and run the database update and configuration export commands.

    copy

    ./vendor/bin/drush cr
    ./vendor/bin/drush updb -y
    ./vendor/bin/drush cex

13. Commit all the changes, deploy them to your development environment, and run the following commands:

    copy

    ./vendor/bin/drush updb -y
    ./vendor/bin/drush cim -y

14. Verify that your development site works as expected.