Actions

J1.5

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

From Joomla! Documentation

m (Step 1: Download the upgrade file: Edited link to update patch as 1.5.x update is not on the download page anymore)
(28 intermediate revisions by 12 users not shown)
Line 2: Line 2:
 
{{upgrade-intro}}
 
{{upgrade-intro}}
  
==Step 1: Download the patch package==
+
For some basic information on patching and migrating, see [[Upgrading and Migrating FAQs]] and [[Upgrade Instructions]].
  
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.
+
You can also use a Joomla! extension to automate the process of loading version updates. See [http://extensions.joomla.org/extensions/core-enhancements/installers/9332 Update Manager for Joomla!] for more information.  
  
{| class="wikitable" style="text-align:left"
+
Review the release notes for the new version.
|+'''Joomla! 1.5.3 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.2
+
| [http://joomlacode.org/gf/download/frsrelease/7370/25661/Joomla_1.5.2_to_1.5.3-Stable-Patch_Package.zip .zip]  7FE1A545A5C9C0AFAB4E98D1AC012C97
+
|| [http://joomlacode.org/gf/download/frsrelease/7370/25663/Joomla_1.5.2_to_1.5.3-Stable-Patch_Package.tar.gz .tar.gz] 4ED3D8E61A68803645F8D2E3A23809DF
+
|| [http://joomlacode.org/gf/download/frsrelease/7370/25662/Joomla_1.5.2_to_1.5.3-Stable-Patch_Package.tar.bz2 .tar.bz2] 44AF0593B94AAD9A06BB2158DD2EF0CF
+
|-
+
! v 1.5.1
+
| [http://joomlacode.org/gf/download/frsrelease/7370/25658/Joomla_1.5.1_to_1.5.3-Stable-Patch_Package.zip .zip]  184C1DEF3FE419898F5B611AF570BDD4
+
|| [http://joomlacode.org/gf/download/frsrelease/7370/25660/Joomla_1.5.1_to_1.5.3-Stable-Patch_Package.tar.gz .tar.gz] 41F7AED8074902FAD9B9AF5CF624F631
+
|| [http://joomlacode.org/gf/download/frsrelease/7370/25659/Joomla_1.5.1_to_1.5.3-Stable-Patch_Package.tar.bz2 .tar.bz2] BBCEB0347BBB3E9A4FB0B4CF55991BE6
+
|-
+
! v 1.5.0
+
| [http://joomlacode.org/gf/download/frsrelease/7370/25655/Joomla_1.5.0_to_1.5.3-Stable-Patch_Package.zip .zip] 046D617B9EB7D33A14D58D91F3F6D93F
+
|| [http://joomlacode.org/gf/download/frsrelease/7370/25657/Joomla_1.5.0_to_1.5.3-Stable-Patch_Package.tar.gz .tar.gz] 13CE15C3240109CB78EDAF050C76885A
+
|| [http://joomlacode.org/gf/download/frsrelease/7370/25656/Joomla_1.5.0_to_1.5.3-Stable-Patch_Package.tar.bz2 .tar.bz2] DEB7CED3DE8C61F0983593B6CF12BFCC
+
|}
+
  
'''Additional information:'''
+
When upgrading from a version that is not the most recent, review [http://www.joomla.org/announcements/release-news release notes for the prior releases.]
  
{{Ambox|image=notice|text=[[Template:patch|What is a patch?]]|style=width:400px}}
+
==Step 1: Download the upgrade file==
  
 +
To download the most recent patch package and to obtain the MD5 hash:
  
{{Ambox|image=notice|text=[[Unpacking a package file|Which package format should I use?]]|style=width:400px}}
+
*You will need the Joomla! 1.5.0 to Joomla! 1.5.25 package with file name: [http://joomlacode.org/gf/download/frsrelease/16025/69668/Joomla_1.5.0_to_1.5.25-Stable-Patch_Package.zip Joomla_1.5.0_to_1.5.25-Stable-Patch_Package.zip] < direct download link.
 +
* Click the "Download other Joomla 1.5.x packages" link
 +
* Find the correct update file.
 +
** If you are on the prior version, use the file that updates from the prior version to the current version (for example, Joomla_1.5.25_to_1.5.26-Stable-Patch_Package).
 +
** If you are on an older version, use the 1.5.0 to current version file (for example, Joomla_1.5.0_to_1.5.26-Stable-Patch_Package).
 +
** Select the archive format (zip, tar.gz or tar.bz2) that is most convenient for you.
 +
* Verify the download using the MD5 hash listed in the right column on the same line as the package you selected.
  
 +
If you have questions about these instructions, read the ''Additional Information'' below this table.
  
{{Ambox|image=notice|text=[[How to determine a package checksum|How do I use the MD5 hash to check the package?]]|style=width:400px}}
+
'''Additional information:'''
  
==Step 2: Make a copy of your live site==
+
{{Ambox|image=notice|text=[[Chunk:patch|What is a patch?]]|style=width:400px}}
{{upgrade-copysite}}
+
  
==Step 3: Install the patch package on the copy site==
 
{{installing a package file}}
 
  
==Step 4: Test thoroughly==
+
{{Ambox|image=notice|text=[[Unpacking a package file|Which package format should I use?]]|style=width:400px}}
{{upgrade-test}}
+
  
==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.
 
{{Ambox|image=notice|text=[[copying a Joomla website|How to copy a Joomla! website]]|style=width:400px}}
 
  
==Step 6: Install the patch package on your live site==
+
{{Ambox|image=notice|text=[[How to determine a package checksum|How do I use the MD5 hash to check the package?]]|style=width:400px}}
{{installing a package file}}
+
  
The alternative selected may be different from that used in step 3 if the hosting platform for the site is different.
+
==Step 2: Backup your site==
 +
Before you actually upgrade, you really should make a backup of your site. Backup your existing Joomla site files and store all the files and database in case something gets messed up, you wont have any problem reverting back.
  
==Step 7: Make any other changes required==
+
All upgrades should be first tested on a copy of your site before being applied to a live site.
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==
+
==Step 3: Install the upgrade file==
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.
+
{{installing a package file}}
 +
 
 +
==Step 4: 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 2.
  
 
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 [http://forum.joomla.org/index.php/board,430.0.html Joomla! 1.5 Migrating and Upgrading Forum].
 
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 [http://forum.joomla.org/index.php/board,430.0.html Joomla! 1.5 Migrating and Upgrading Forum].
  
 
Return to [[Upgrade Instructions]]
 
Return to [[Upgrade Instructions]]
 +
 +
[[Category:Upgrading]]

Revision as of 12:51, 3 November 2012

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).

For some basic information on patching and migrating, see Upgrading and Migrating FAQs and Upgrade Instructions.

You can also use a Joomla! extension to automate the process of loading version updates. See Update Manager for Joomla! for more information.

Review the release notes for the new version.

When upgrading from a version that is not the most recent, review release notes for the prior releases.

Step 1: Download the upgrade file

To download the most recent patch package and to obtain the MD5 hash:

  • You will need the Joomla! 1.5.0 to Joomla! 1.5.25 package with file name: Joomla_1.5.0_to_1.5.25-Stable-Patch_Package.zip < direct download link.
  • Click the "Download other Joomla 1.5.x packages" link
  • Find the correct update file.
    • If you are on the prior version, use the file that updates from the prior version to the current version (for example, Joomla_1.5.25_to_1.5.26-Stable-Patch_Package).
    • If you are on an older version, use the 1.5.0 to current version file (for example, Joomla_1.5.0_to_1.5.26-Stable-Patch_Package).
    • Select the archive format (zip, tar.gz or tar.bz2) that is most convenient for you.
  • Verify the download using the MD5 hash listed in the right column on the same line as the package you selected.

If you have questions about these instructions, read the Additional Information below this table.

Additional information:



Step 2: Backup your site

Before you actually upgrade, you really should make a backup of your site. Backup your existing Joomla site files and store all the files and database in case something gets messed up, you wont have any problem reverting back.

All upgrades should be first tested on a copy of your site before being applied to a live site.

Step 3: Install the upgrade file

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: 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 2.

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