Upgrading DX8

    If you are using or have installed the dx8_deployment module and are upgrading to version 5.0 from an earlier version, you will need to uninstall it before updating to the latest version of DX8 as the dx8_deployment module is no longer included in the repository.

    You can upgrade the DX8 module using composer or manually. 

    Step 1a - Upgrade using composer

    Using composer is the preferred way to upgrade DX8. 

    Open your composer.json file that is in your project root directory and find the "require" section, which will look like the following:

    "require": {
            "cohesion/dx8": "^3.11", 
            "cohesion/dx8-theme": "^3.11"
        },

     Now change the version you currently have to the version you want to upgrade DX8 to, like so:

    "require": {
            "cohesion/dx8": "^5.1", 
            "cohesion/dx8-theme": "^5.1"
        },

    Save and close your composer.json file.
    Open your terminal and browse to the directory containing your composer.json file and run: composer update. This will then update your DX8 module 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 will need to do an entity update. This will update entity type schemas.

    drush entup -y

    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. 

    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. 

    Cohesion DX8 Help center

    Launch our Help center to raise a support ticket or search our knowledge base of common questions and answers.

    DX8 knowledge base icon

    Knowledge base

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

    Find answers

    Raise a ticket icon

    Raise a support ticket

    Log in to the Help center to raise an issue. Available Monday - Friday, 09:00 - 17:00 GMT.

    Raise ticket