Troubleshooting issues with Drupal Starter Kits upgrade

Indirect dependencies issues

When you run the composer update command to update Drupal Starter Kits, the system might not be able to update Drupal Starter Kits. The update command fails and the system displays the following error message:

To determine the root cause of the issue:

• Run the following command:

  copy

  composer why-not acquia/acquia_cms

  The system displays the following message:

  

  The message indicates that drupal/acquia_cms_starter restricts updating acquia/acquia_cms to the latest version.

• To check issues with the Drupal Starter Kits Starter module, run the following command:

  copy

  composer why-not drupal/acquia_cms_starter

  The system displays the following message:

  

• To check issues with all Drupal Starter Kits modules, run the composer why-not command for each module:

  

  You can locate indirect dependencies in the require section of the root composer.json file.

  

   

  Warning

  The require section in the composer.json file might be different for different users. Therefore, you must use your commands accordingly.

   

To resolve this issue:

• Remove all the indirect dependencies from the root composer.json file and run the composer install command.

  Alternatively, you can remove the indirect dependencies by running the following command:

  copy

  composer remove drupal/entity_clone drupal/acquia_cms_article
  drupal/acquia_connector drupal/acquia_search drupal/ctools drupal/entity_clone drupal/facets
  drupal/geofield drupal/google_tag drupal/jsonapi_extras drupal/metatag drupal/scheduler_
  content_moderation_integration

  
  

  For example, drupal/facets is a dependency of the Drupal Starter Kit Search module. Therefore, you must not have them in the root composer.json file. If they are included in the file, remove them manually or by running the following command:

  copy

  composer remove drupal/facets

• After removing all the indirect dependencies, update Drupal Starter Kits by running the following command:

  copy

  composer update acquia/acquia_cms

Minimum stability issues

If minimum stability blocks your Drupal Starter Kits upgrade, the system displays the following error message:

To resolve this issue:

• Update your root composer.json file by running the command:

  copy

  composer config minimum-stability dev

• Update Drupal Starter Kits to the latest version.

  • For Drupal Starter Kits 1.5.x or 2.x, run the following command:

    copy

    composer update acquia/acquia_cms -W

    

  • For Drupal Starter Kits composable architecture, run the following command:

    copy

    composer update drupal/acquia_cms* -W