You are here

Home » API reference » CDN 6.2

UPGRADE.txt in CDN 6.2

Same filename and directory in other branches
  1. 7.2 UPGRADE.txt
From 1.x to 2.x
---------------
Upgrading from CDN integration 1.x to 2.x requires applying a new core patch.
Alternatively, there is now a new type of CDN integration that does not
require a core patch, instead it relies on the theme layer to alter file URLs.
It is slower and won't be able to alter *all* file URLs, but it is easier to
use. When the module detects that the patch is not applied, it will
automatically fall back to this mechanism.
Also note that the core patch is already included in Pressflow and Cocomore
Drupal!

The recommended steps to update your Drupal site are:
1) Copy the 1.x core patch (patches/drupal6.patch) to the Drupal root directory.
2) Revert the 1.x core patch:
    patch -p0 -R < drupal6.patch
3) Disable CDN integration at admin/settings/cdn.
4) Update the CDN integration module code.
5) Copy the 2.x core patch (patches/drupal6.patch) to the Drupal root directory.
6) Apply the 2.x core patch:
    patch -p0 < drupal6.patch
7) Re-enable CDN integration at admin/settings/cdn.

The ImageCache module patch has remained unchanged since version 1.x. When you
did not apply the core patch and thus want to rely on the theme layer fallback
mechanism, you don't have to apply the ImageCache module patch either.
But when you update to an ImageCache version that's newer than 2.0 beta 10,
you will have to apply the alternative patch: patches/imagecache_6--2.patch.
Even better: if you update to an ImageCache version that's newer than 2.0 beta
12, you won't have to apply any patch at all!


From the Parallel module (1.0) to the CDN module (>=2.1)
--------------------------------------------------------
In February 2011, the Parallel module was merged with the CDN module since the
CDN module had received a superset of the Parallel module's functionality.
Hence it no longer made sense to maintain the Parallel module.
This is a guide on how to migrate from the Parallel module to the CDN module.

1) Download and install CDN module version 2.1 or newer.
2) Download Parallel module version 1.0 (its latest release).
3) Run update.php. This will migrate the Parallel module's settings to the CDN
   module.
4) Visit admin/settings/cdn/details. You should see a translation of your
   Parallel module settings to the CDN module's format here.
5) Visit admin/settings/cdn. You can enable the CDN module here, or run it in
   debug mode to give it a try.
6) Disable the Parallel module at admin/build/modules.
7) Uninstall the Parallel module at admin/build/modules/uninstall.
   
If you'd prefer to stay in control and would like to enter your settings
yourself into the CDN module, that's also possible. Then you only need to
perform steps 1, 6 and 7 and finally go to admin/settings/cdn, where you can
then  enter your desired configuration.

File

UPGRADE.txt
View source 
  1. From 1.x to 2.x

  2. ---------------

  3. Upgrading from CDN integration 1.x to 2.x requires applying a new core patch.

  4. Alternatively, there is now a new type of CDN integration that does not

  5. require a core patch, instead it relies on the theme layer to alter file URLs.

  6. It is slower and won't be able to alter *all* file URLs, but it is easier to

  7. use. When the module detects that the patch is not applied, it will

  8. automatically fall back to this mechanism.

  9. Also note that the core patch is already included in Pressflow and Cocomore

  10. Drupal!

  11. 

  12. The recommended steps to update your Drupal site are:

  13. 1) Copy the 1.x core patch (patches/drupal6.patch) to the Drupal root directory.

  14. 2) Revert the 1.x core patch:

  15.     patch -p0 -R < drupal6.patch

  16. 3) Disable CDN integration at admin/settings/cdn.

  17. 4) Update the CDN integration module code.

  18. 5) Copy the 2.x core patch (patches/drupal6.patch) to the Drupal root directory.

  19. 6) Apply the 2.x core patch:

  20.     patch -p0 < drupal6.patch

  21. 7) Re-enable CDN integration at admin/settings/cdn.

  22. 

  23. The ImageCache module patch has remained unchanged since version 1.x. When you

  24. did not apply the core patch and thus want to rely on the theme layer fallback

  25. mechanism, you don't have to apply the ImageCache module patch either.

  26. But when you update to an ImageCache version that's newer than 2.0 beta 10,

  27. you will have to apply the alternative patch: patches/imagecache_6--2.patch.

  28. Even better: if you update to an ImageCache version that's newer than 2.0 beta

  29. 12, you won't have to apply any patch at all!

  30. 

  31. 

  32. From the Parallel module (1.0) to the CDN module (>=2.1)

  33. --------------------------------------------------------

  34. In February 2011, the Parallel module was merged with the CDN module since the

  35. CDN module had received a superset of the Parallel module's functionality.

  36. Hence it no longer made sense to maintain the Parallel module.

  37. This is a guide on how to migrate from the Parallel module to the CDN module.

  38. 

  39. 1) Download and install CDN module version 2.1 or newer.

  40. 2) Download Parallel module version 1.0 (its latest release).

  41. 3) Run update.php. This will migrate the Parallel module's settings to the CDN

  42.    module.

  43. 4) Visit admin/settings/cdn/details. You should see a translation of your

  44.    Parallel module settings to the CDN module's format here.

  45. 5) Visit admin/settings/cdn. You can enable the CDN module here, or run it in

  46.    debug mode to give it a try.

  47. 6) Disable the Parallel module at admin/build/modules.

  48. 7) Uninstall the Parallel module at admin/build/modules/uninstall.

  49.    

  50. If you'd prefer to stay in control and would like to enter your settings

  51. yourself into the CDN module, that's also possible. Then you only need to

  52. perform steps 1, 6 and 7 and finally go to admin/settings/cdn, where you can

  53. then  enter your desired configuration.