Upgrading contributed modules

We're now ready to update our contributed modules to their 6.x versions. Follow these steps:

1. Download all of the contributed module tar.gz files corresponding to the latest 6.x stable releases to a folder on your desktop. You may want to create a folder called contrib._module_upgrades to put the new releases in.

2. Once you have downloaded all the tar.gz files, extract them into your contributed modules folder. This will create all of your module folders (one for each module).

If you are using CCK and Imagefield, you'll also need to download the Filefield module — this is a dependency of Imagefield in Drupal 6.x.

3. Also, make sure you download and extract the Advanced Help module, so you can add advanced help documentation to your Drupal site (this is a large scale Drupal 6.x enhancement). The project page is here: http://drupal. org/project/advanced_help h

4. You should by now have extracted all of your modules ready to upload via FTP:

Name T Ext

Size Type

Changed

Parent directory

8/18/2009

11

46:23 AH

ir^lyie'A's bonus

File Folder

8/18/2009

11

45:58 AM

[reviews

File Folder

8/18/2009

11

45:59 AM

panels

File Folder

8/18/2009

11

46:23 AM

(Ë|lightbox2

File Folder

8/18/2009

11

46:21 AM

Ir^lini ipry nlnnin

File Folder

8/18/2009

11

46:19 AM

Ir^limce

File Folder

8/18/2009

11

46:17 AM

[¿limagefield

File Folder

8/18/2009

11

46:15 AM

Ir^limaaecache

File Folder

8/18/2009

11

46:13 AM

Ir^limageapi

File Folder

8/18/2009

11

46:11 AM

Qfilefield

File Folder

8/18/2009

11

46:09 AM

Ir^lFrkarllhnr

File Folder

8/18/2009

11

46:07 AM

devel

File Folder

8/18/2009

11

46:06 AM

fr^lrhnnk

File Folder

8/18/2009

11

46:04 AM

ËDcck

File Folder

8/18/2009

11

45:54 AM

Ir^ladvariced help

File Folder

8/18/2009

11

46:01 AM

Ir^ladmiri menu

File Folder

8/18/2009

11

45:59 AM

^ views-6. x-2.6, tar, gz

1,534,198

WinRAR archive

8/18/2009

11

44:10 AM

§ views_bonus-6. x-1.0-beta4. tar. gz

15,011

WinRAR archive

8/18/2009

11

44:20 AM

^ panels-6, x-3,0-r c 1. tar, gz

355,424

WinRAR archive

8/18/2009

11

43:23 AM

§ lightbox2-6. x-1.9. tar. gz

101,435

WinRAR archive

8/18/2009

11

43:11 AM

§jquery_plugin-6,x-l, 10, tar.gz

32,011

WinRAR archive

8/18/2009

11

43:57 AM

^imce-6.x-l .2.tar.gz

69,523

WinRAR archive

8/18/2009

11

42:58 AM

imagef ield-6, x-3,1, tar, gz

27,258

WinRAR archive

8/18/2009

11

41:39 AM

§ ¡magecache-6.x-2.0-beta9.tar.gz

63,999

WinRAR archive

8/18/2009

11

42:28 AM

^ imageapi-6. x-1.6. tar. gz

23,769

WinRAR archive

8/18/2009

11

42:15 AM

§fllefield-6.x-3.1.tar.gz

77,310

WinRAR archive

8/18/2009

11

41:49 AM

§ f ckeditor-6. x-1.4-rc 1. tar. gz

182,883

WinRAR archive

8/18/2009

11

42:46 AM

|§devel-6.x-l. 16. tar.gz

163,998

WinRAR archive

8/18/2009

11

42:03 AM

|§ctools-6.x-l .0-rcl .tar.gz

216,456

WinRAR archive

8/18/2009

11

43:30 AM

§cck-6.x-2.5.tar.gz

417,417

WinRAR archive

8/18/2009

11

41:21 AM

|§advanced_help-6.x-l. 2. tar.gz

79,326

WinRAR archive

8/18/2009

11

44:44 AM

admin_menu-6. x-1.5, tar, gz

45,284

WinRAR archive

8/18/2009

11

5. Move your new contributed modules using FTP to your /sites/all/ modules directory.

6. Go to your Modules admin list and re-enable the 6.x versions of the modules you just installed through their respective groups. For example, re-enable all of the Views modules and then run your update.php script. Then come back to the modules admin list and re-enable your Panels modules. Doing it in this way by enabling the modules as groups will help you to identify problems with your module upgrades and more easily diagnose problems than if you just re-enable all your contributed modules at the same time.

7. The only module you do not need to enable at this time is the Devel module. We're going to look at that module in detail in Chapter 3, so leave it disabled for now. Be sure to enable the Advanced Help module as well. Click on Save configuration.

8. You may receive a Fatal Error warning about your memory_limit size (in your PHP settings). If you receive this, go ahead to the next step and run your update.php script. We'll address our memory issue immediately after running update.php.

9. If you receive parse errors, immediately run update.php again. This time the script will update all of your contributed modules database schemas.

10. You will see your Drupal database update page again (at update.php). Click on the Continue button.

11. Click on Update on the next screen (the same as our update.php during core upgrade above).

12. When I run update.php, Drupal informs that there is not enough memory to run the upgrade. This is a performance issue due to the amount of modules we've added to our site and the resources these modules require. Before continuing our update.php we'll need to upgrade our memory_limit. We can do this by editing our site's settings.php file. These are screenshots of the two types of errors which may arise at this stage of the process:

Fatal error: Allowed memoiy size of 33554432 bytes exhausted (tried to allocate 30720 bytes) in line 131

Updating

An unrecoverable error has occurred, You can find the error message below, It is advised to copy it to the clipboard for reference, Please continue to the error page

An error occurred, httpi^ariantcube.com/firs/update,php?id=2&.op=do cbr^M gb>Fatal error</b>: Allowed nnemor^i^e of 33554432 bytes exhausted (triad to allocate 240728 byteMingb>/home/vari£ntc/publ:; _html/fire/includes /database.mysql-common,inB/b> on line <b>41</bxbr^^B

0 0

Post a comment