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:

1. 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.

2. 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:

   

3. 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:

1. 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

2. 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:

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

   copy

   composer config minimum-stability dev

2. 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