Difference between revisions of "Upgrading to 1.0.14 RC1"

From Joomla! Documentation

m
Line 5: Line 5:
 
Determine the current version of your Joomla! installation.  For example, if you currently have version 1.0.13 installed you will need to download the 1.0.13 to 1.0.14 RC1 patch package.  The patch packages are available on [http://joomlacode.org/gf/project/joomla/frs/?action=FrsReleaseView&release_id=6465 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.  There is more information on [[package formats]] if you are not sure which to select.
 
Determine the current version of your Joomla! installation.  For example, if you currently have version 1.0.13 installed you will need to download the 1.0.13 to 1.0.14 RC1 patch package.  The patch packages are available on [http://joomlacode.org/gf/project/joomla/frs/?action=FrsReleaseView&release_id=6465 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.  There is more information on [[package formats]] if you are not sure which to select.
  
For example, if you are upgrading from 1.0.12 to 1.0.14 RC1 and you would prefer the .tar.gz package format, then select the file named Joomla-upgrade-1.0.12-to.1.0.14RC1.tar.gz
+
For example, if you are upgrading from 1.0.13 to 1.0.14 RC1 and you would prefer the .tar.gz package format, then select the file named ''Joomla_1.0.12_to_1.0.14RC1-Patch_Package.tar.gz''
 +
 
 +
Please note that for the Release Candidate(s) we are not providing patch packages for versions prior to 1.0.12. The full range of patch packages will be provided when 1.0.14 Stable is released.
  
 
==Step 2: Make a copy of your live site==
 
==Step 2: Make a copy of your live site==
Line 16: Line 18:
  
 
==Step 4: Test thoroughly==
 
==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.
  
 
==Step 5: Backup your live site==
 
==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.  If you are not familiar with the process of copying a Joomla! website then refer to the [[copying a Joomla website|copying instructions]].
  
 
==Step 6: Install the patch package on your live site==
 
==Step 6: Install the patch package on your live site==
 +
As with step 3 there are different ways of doing this depending on your particular circumstances.  The alternative selected may be different from that used in step 3 if the hosting platform for the site is different.  If you have difficulty with one of these methods, then simply try another.  There is further information on [[unpacking a patch package]] and [[using an FTP client to upload files]] if you need it.
 +
* Alternative 1: Unpack the patch package on your local computer then use an FTP client to upload them to your test site.
 +
* Alternative 2: Use an FTP client to upload the patch package to your test site, then use a terminal session (eg. SSH) to connect to your test site and unpack the files there.  There is further information on [[using a terminal session]] if you need it.
  
 
==Step 7: Make any other changes required==
 
==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==
 
==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.
  
TO BE COMPLETED
+
Hopefully all will be well and you can relax.  If you need assistance with this upgrade then please ask on [[our upgrade forum]].

Revision as of 18:13, 13 January 2008

Documentation all together tranparent small.png
Under Construction

This article or section is in the process of an expansion or major restructuring. You are welcome to assist in its construction by editing it as well. If this article or section has not been edited in several days, please remove this template.
This article was last edited by Chris Davenport (talk| contribs) 16 years ago. (Purge)

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]

Determine the current version of your Joomla! installation. For example, if you currently have version 1.0.13 installed you will need to download the 1.0.13 to 1.0.14 RC1 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. There is more information on package formats if you are not sure which to select.

For example, if you are upgrading from 1.0.13 to 1.0.14 RC1 and you would prefer the .tar.gz package format, then select the file named Joomla_1.0.12_to_1.0.14RC1-Patch_Package.tar.gz

Please note that for the Release Candidate(s) we are not providing patch packages for versions prior to 1.0.12. The full range of patch packages will be provided when 1.0.14 Stable is released.

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. If you are not familiar with the process of copying a Joomla! website then refer to the copying instructions.

Step 3: Install the patch package on the copy site[edit]

There are different ways of doing this depending on your particular circumstances. If you have difficulty with one of these methods, then simply try another. There is further information on unpacking a patch package and using an FTP client to upload files if you need it.

  • Alternative 1: Unpack the patch package on your local computer then use an FTP client to upload them to your test site.
  • Alternative 2: Use an FTP client to upload the patch package to your test site, then use a terminal session (eg. SSH) to connect to your test site and unpack the files there. There is further information on using a terminal session if you need it.

Step 4: Test thoroughly[edit]

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.

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. If you are not familiar with the process of copying a Joomla! website then refer to the copying instructions.

Step 6: Install the patch package on your live site[edit]

As with step 3 there are different ways of doing this depending on your particular circumstances. The alternative selected may be different from that used in step 3 if the hosting platform for the site is different. If you have difficulty with one of these methods, then simply try another. There is further information on unpacking a patch package and using an FTP client to upload files if you need it.

  • Alternative 1: Unpack the patch package on your local computer then use an FTP client to upload them to your test site.
  • Alternative 2: Use an FTP client to upload the patch package to your test site, then use a terminal session (eg. SSH) to connect to your test site and unpack the files there. There is further information on using a terminal session if you need it.

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.

Hopefully all will be well and you can relax. If you need assistance with this upgrade then please ask on our upgrade forum.