If you 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 within newer releases of 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.4.0 composer require cohesion/dx8-theme:5.4.0
Next run composer update command in your terminal:
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.
Then 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.
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.