Version:
Cohesiondx.com

Are you looking for the latest documentation?

Documentation for Acquia Cohesion V6.0 onwards has moved to https://cohesiondocs.acquia.com

    Upgrading DX8

    When upgrading your website to the latest version of DX8, database updates will be applied and therefore you can't roll back to the previous version of DX8 once upgraded.

    We recommend applying updates on your development environment and backing up your website including your database before upgrading DX8.

    You can upgrade the DX8 module using composer or manually. 

    Step 1a - Upgrade using composer

    Using composer is the preferred way to upgrade DX8. 
    It is not recommended to manually edit the composer.json file.

    Open your terminal and browse to the directory containing your project root directory. Run the following command, updating the version number to the version you want to update too:

    composer require cohesion/dx8:5.5.0
    composer require cohesion/dx8-theme:5.5.0
    
    

    This will then update your DX8 module and DX8 minimal theme to the new version you have set.

    Step 1b - Upgrade manually

    Upgrade DX8 module

    Navigate to the download page for the module: https://bitbucket.org/cohesion_dev/dx8-module/downloads/?tab=tags and click "zip" "gz" or "bz2" on the top entry to download the DX8 module. 

    Once the file has downloaded, unzip it, rename the folder to "dx8" and then copy to your /modules/contrib/ directory of project. When prompted click "replace" to replace your older version of DX8 with the new one you just downloaded.

    Upgrade DX8 minimal theme

    Navigate to the download page for the theme: https://bitbucket.org/cohesion_dev/dx8-theme/downloads/?tab=tags and click "zip", "gz" or "bz2" on the top entry to download the theme. 

    Once the file has downloaded, unzip it, rename the folder to "dx8-theme" and then copy to your /themes/contrib/ directory of project. When prompted click "replace" to replace your older version of the DX8 minimal theme with the new one you just downloaded.

    Step 2 - Run drush commands

    Next you will need to run a few drush commands, open up your terminal and browse to your project root directory. 

    First you should clear your website cache.

    drush cr


    Next, you will need to do a database update. This will apply database updates to your Drupal site that the new version may require.

    drush updb -y

    Then finally you will need to do a DX8 import and rebuild. 

    Using drush 9:

    drush dx8:import
    drush dx8:rebuild

    Using an earlier version of drush:

    drush dx8 import
    drush dx8 rebuild


    Once DX8 has finished running the import and rebuild, your DX8 version will now be up to date with the version you downloaded. 

    DX8 knowledge base icon

    Frequently asked questions

    Get instant answers to common questions. Available online 24/7.

    Find answers

    Raise a ticket icon

    Raise a support ticket

    To raise a ticket, sign into Acquia Cloud and select Help in the top menu.

    Raise support ticket

    Acquia

    Copyright © 2020 Acquia, Inc. All Rights Reserved. Drupal is a registered trademark of Dries Buytaert.