Difference between revisions of "Upgrading to 1.0.15"
From Joomla! Documentation
m |
|||
| (4 intermediate revisions by 4 users not shown) | |||
| Line 2: | Line 2: | ||
{{upgrade-intro}} | {{upgrade-intro}} | ||
| − | + | ==Step 1: Download the correct patch package== | |
| − | + | {{Ambox|image=notice|text=[[Chunk:patch|What is a patch?]]|style=width:400px}} | |
| − | + | Determine the current version of your Joomla! installation. For example, if you currently have version 1.0.14 installed you will need to download the 1.0.14 to 1.0.15 patch package. The patch packages are available on [http://joomlacode.org/gf/project/joomla/frs/?action=FrsReleaseView&release_id=6829 JoomlaCode.org]. Each patch package is available in three different package formats. These are indicated by the file extension which is either .zip, .tar.gz or .tar.bz2. The contents of each of these alternative packages is identical so just choose the one most convenient for you. | |
| − | + | {{Ambox|image=notice|text=[[Unpacking a package file|More about package file formats]]|style=width:400px}} | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | } | ||
| − | . | ||
| − | . | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | . | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | . | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | } | ||
| − | + | For example, if you are upgrading from 1.0.14 to 1.0.15 and you would prefer the .tar.gz package format, then select the file named ''Joomla_1.0.14_to_1.0.15-Stable-Patch_Package.tar.gz'' | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | NOTE: Patch packages for 1.0.15 only exist going back to Joomla! version 1.0.12. If you need to upgrade from an earlier version you will need to first upgrade to 1.0.14 then upgrade to 1.0.15. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | In order to ensure that the patch package you downloaded was copied correctly it is a good idea to compare the MD5 checksum of the downloaded package to the [http://www.joomla.org/content/category/5/39/95/ published checksum] or [http://forum.joomla.org/viewtopic.php?f=7&t=445989 "Where do I find the MD5 checksum?"]. | |
| − | + | {{Ambox|image=notice|text=[[How to determine a package checksum]]|style=width:400px}} | |
| − | + | {{Ambox|type=serious|image=serious|text='''If the checksums differ then do not use the patch package'''. Repeat the download and check again. If the checksums still differ then report the problem on the [http://forum.joomla.org/index.php/board,36.0.html Joomla! 1.0 Upgrading 1.0.x Forum].}} | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
==Step 2: Make a copy of your live site== | ==Step 2: Make a copy of your live site== | ||
| Line 209: | Line 22: | ||
==Step 4: Test thoroughly== | ==Step 4: Test thoroughly== | ||
| − | {{upgrade-test}} | + | {Chunk:{upgrade-test}} |
==Step 5: Backup your live site== | ==Step 5: Backup your live site== | ||
| Line 229: | Line 42: | ||
Return to [[Upgrade Instructions]] | Return to [[Upgrade Instructions]] | ||
| + | |||
| + | [[Category:Upgrading]] | ||
Revision as of 04:20, 13 September 2011
This page has been archived. This page contains information for an unsupported Joomla! version or is no longer relevant. It exists only as a historical reference, it will not be improved and its content may be incomplete and/or contain broken links.
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 correct patch package[edit]
 |
What is a patch? |
Determine the current version of your Joomla! installation. For example, if you currently have version 1.0.14 installed you will need to download the 1.0.14 to 1.0.15 patch package. The patch packages are available on JoomlaCode.org. Each patch package is available in three different package formats. These are indicated by the file extension which is either .zip, .tar.gz or .tar.bz2. The contents of each of these alternative packages is identical so just choose the one most convenient for you.
| |
More about package file formats |
For example, if you are upgrading from 1.0.14 to 1.0.15 and you would prefer the .tar.gz package format, then select the file named Joomla_1.0.14_to_1.0.15-Stable-Patch_Package.tar.gz
NOTE: Patch packages for 1.0.15 only exist going back to Joomla! version 1.0.12. If you need to upgrade from an earlier version you will need to first upgrade to 1.0.14 then upgrade to 1.0.15.
In order to ensure that the patch package you downloaded was copied correctly it is a good idea to compare the MD5 checksum of the downloaded package to the published checksum or "Where do I find the MD5 checksum?".
| |
How to determine a package checksum |
 |
If the checksums differ then do not use the patch package. Repeat the download and check again. If the checksums still differ then report the problem on the Joomla! 1.0 Upgrading 1.0.x Forum. |
Step 2: Make a copy of your live site[edit]
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.
| |
How to copy a Joomla! website |
Step 3: Install the patch package on the copy site[edit]
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.
| |
Unpacking a package file |
- Alternative 1: Unpack the package file on your local computer then use an FTP client to upload them to your site.
| |
Using an FTP client to upload files |
- 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.
| |
Using a terminal session |
- 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.
- If you are using CPanel, there is specific information on Uploading and extracting an archive file with CPanel.
Step 4: Test thoroughly[edit]
{Chunk:{upgrade-test}}
Step 5: Backup your live site[edit]
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.
| |
How to copy a Joomla! website |
Step 6: Install the patch package on your live site[edit]
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.
| |
Unpacking a package file |
- Alternative 1: Unpack the package file on your local computer then use an FTP client to upload them to your site.
| |
Using an FTP client to upload files |
- 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.
| |
Using a terminal session |
- 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.
- If you are using CPanel, there is specific information on Uploading and extracting an archive file with CPanel.
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[edit]
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[edit]
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.0 Upgrading 1.0.x Forum.
Return to Upgrade Instructions