Actions

J1.5

Difference between revisions of "Upgrading 1.5 from an existing 1.5x version"

From Joomla! Documentation

(Step 1: Download the patch package)
m (Unprotected "Upgrading 1.5 from an existing 1.5x version": Lock to prevent MD5 hash values from being updated.)

Revision as of 19:02, 22 March 2008

Replacement filing cabinet.png
This Namespace has been archived - Please Do Not Edit or Create Pages in this namespace. Pages contain information for a Joomla! version which is no longer supported. It exists only as a historical reference, will not be improved and its content may be incomplete.

It is risky to upgrade a live site without testing the upgrade process first. So before upgrading the live site you need to set up a test site which is as close as possible to the configuration of your live site, then test the upgrade on that. When you are happy with the process you can apply it to the live site (having taken a fresh backup of the live site first, of course).

Step 1: Download the patch package

The Joomla! 1.5 patch packages are listed below. Locate the row that matches your current installation version. Next, select the package (zip, tar.gz and tar.bz2) that is most convenient for you. Verify the download using the MD5 hash listed beneath the package. If you have questions about these instructions, read the Additional Information below this table.

Joomla! 1.5.2 Update Files
Find your current version (listed in most to least current order) .zip file / MD5 hash .tar.gz file / MD5 hash .tar.bz2 file / MD5 hash
v 1.5.1 .zip 51c2c5dbd4af4869eb14893fbee5495d .tar.gz 9e0a8fa4bf7ba2bdcde298bc41ca1255 .tar.bz2 46f9685626fa49c55303a2bd5887fba2
v 1.5.0 .zip 2672c7f6ae0b28b7c82e192ce121ce81 .tar.gz f4cd738e053fc778a18210e23945ab64 .tar.bz2 9e94e457ce6f4125bc705fa49621fa9e

Additional information:



Step 2: Make a copy of your live site

Ideally this should be on the same platform (operating system, PHP and database version) as the live site, but don't worry if this is not possible. Making a working copy of a Joomla! website involves copying the files and the database (these are separate activities). You will then need to amend the configuration.php to reflect the new location. Check that your test site is fully functional.

Step 3: Install the patch package on the copy site

There are different ways of installing a package file depending on your particular circumstances. If you have difficulty with one of these methods, then simply try another.

  • Alternative 1: Unpack the package file on your local computer then use an FTP client to upload them to your site.
  • Alternative 2: Use an FTP client to upload the package to your site, then use a terminal session (eg. SSH) to connect to your site and unpack the files there.
  • Alternative 3: If your hosting provider gives you access to your site via some sort of web control panel like CPanel or Plesk, you can use the control panel file manager to upload the package, then use a terminal session (which might also be available via the control panel) to unpack the package file and overwrite all changed files on the server.

Step 4: Test thoroughly

Check out as much of the functionality on your test site as possible. If there are any problems that will affect the way that you will need to handle the live upgrade then make a written note of them for later.

If you find errors you might check out the following possibilities:

  • Ensure that all of the files were properly transferred. There have been verified reports of some FTP clients not properly transferring files across to a server without notifying the user of such a problem. One possible cause of this problem is that under certain circumstances the web server locks the files it is using and the FTP-server can't update those files. If this is the case you might try taking the site offline shortly during the FTP transfer.

Step 5: Backup your live site

Take a full backup copy of your live site immediately prior to upgrading. You may want to take your site offline prior to doing this so that updates are not lost.

Step 6: Install the patch package on your live site

There are different ways of installing a package file depending on your particular circumstances. If you have difficulty with one of these methods, then simply try another.

  • Alternative 1: Unpack the package file on your local computer then use an FTP client to upload them to your site.
  • Alternative 2: Use an FTP client to upload the package to your site, then use a terminal session (eg. SSH) to connect to your site and unpack the files there.
  • Alternative 3: If your hosting provider gives you access to your site via some sort of web control panel like CPanel or Plesk, you can use the control panel file manager to upload the package, then use a terminal session (which might also be available via the control panel) to unpack the package file and overwrite all changed files on the server.

The alternative selected may be different from that used in step 3 if the hosting platform for the site is different.

Step 7: Make any other changes required

Referring to your notes from step 4, make any other changes that are required to bring the site into operation following the patch installation.

Step 8: Check your live site to make sure it is working correctly

Don't assume that the upgrade will work flawlessly just because the test upgrade worked. Check to make sure that nothing untoward has happened. It could be that differences between the live site and test site platforms will bring out a problem that you did not notice during testing. If you find a problem and it cannot be resolved quickly you might have to rollback the upgrade using the backup copy you created in step 5.

Hopefully all will be well and you can relax. If you have any questions before, during, or after the upgrade then please ask them on the Joomla! 1.5 Migrating and Upgrading Forum.

Return to Upgrade Instructions