Actions

J2.5

Difference between revisions of "Upgrading from an existing version"

From Joomla! Documentation

(clarify language)
(remove obsolete text. this method is now obsolete and users should use one of the methods above.)
Line 70: Line 70:
 
The system will work for a period of time, up to two minutes or more for a full version update. Then a message indicating a successful installation will display.
 
The system will work for a period of time, up to two minutes or more for a full version update. Then a message indicating a successful installation will display.
  
=Manual Unpack Archive Method=
 
{{JVer|1.5}}{{JVer|1.6}}{{JVer|1.7}}
 
==Step 1: Download the upgrade file==
 
  
To download the most recent patch package and to obtain the MD5 hash:
 
 
* Proceed to the [http://www.joomla.org/download.html Joomla Download] page.
 
* Click the "Download other Joomla 1.6.x packages" link
 
* Click the "Joomla1.6.XUpdates" link under the "Packages" heading to go to the detail page about the current package
 
* Click the "Files" tab to view the various patch files.
 
*  Locate the row that matches your current installation version and patch  package (zip, tar.gz and tar.bz2) that is most convenient for you.
 
 
If you have questions about these instructions, read the ''Additional Information'' below this table.
 
 
'''Additional information:'''
 
 
{{Ambox|image=notice|text=[[Chunk:patch|What is a patch?]]|style=width:400px}}
 
 
 
{{Ambox|image=notice|text=[[Unpacking a package file|Which package format should I use?]]|style=width:400px}}
 
 
 
{{Ambox|image=notice|text=[[How to determine a package checksum|How do I use the MD5 hash to check the package?]]|style=width:400px}}
 
 
==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==
 
With the 1.7.0 to 1.7.1 upgrade, there are some database changes that need to be made.
 
 
If you use one of these manual methods to copy the files, you also need to manually update your site's database. To do so locate the six files  beginning with 1.7.1 in the folder <tt>/administrator/components/com_admin/sql/updates/mysql</tt>.
 
 
Inside these files you will find parts like <code>#__modules</code> and <code>#__categories</code>. Replace the pound sign and the first underscore (<code>#_</code>) with your [[Database Table Prefix|database tables prefix]]. By default this is <code>jos</code>. If you didn't get the prefix before starting, open your site's <tt>configuration.php</tt> and search for <code>$dbprefix</code>. The string inside the single quotes behind it is what you're looking for. So you need to change <code>#__languages</code> to <code>jos_languages</code> and so on.
 
 
Once you've done this go to your site's phpmyadmin (or any way you usually manage your database) and open the database your site uses. There will be a tab called SQL, open this. Paste the content of your modified sql files inside the text area and press go.
 
 
{{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/viewforum.php?f=625&sid=259a29d8e21242b6770f86026f6c9c3a Joomla! 1.6 Migrating and Upgrading Forum].
 
 
Return to [[Upgrade Instructions]]
 
  
 
[[Category:Upgrading]]
 
[[Category:Upgrading]]

Revision as of 19:58, 25 January 2012

Contents

Overview

Starting with version 1.6, there are two recommended ways to update your Joomla website.

  • Extension Manager: Update
  • Extension Manager: Install

Each of these is discussed below. Note: To upgrade from version 1.6.x to Joomla 1.7 please follow this guide.

It is recommended that you back up your site before upgrading to a new version. That way, if something goes wrong during the upgrade process, you can easily restore your site to the earlier version. Also, it is a good idea to review the release notes for the new version to be familiar with what was changed.

Extension Manager: Update Method

Joomla 1.6Joomla 1.7Joomla 2.5

Step 1: Make sure you have a current backup of your site

In many cases, your host will make periodic site backups.

Step 2: Find and install updates

  1. In the back end of your Joomla site, navigate to Extensions → Extension Manager and open the Update tab.
  2. Click on the Purge Cache icon to clear out the cache.
  3. Click on the Find Updates icon in the toolbar. If there is an available update, the screen will list it, similar to the screen shown below.
    Update-screenshot-20120124-01.png
    Note that available upgrades for extensions used in the site will also show in the list.
  4. Select the update (using the checkbox) and click on the Update icon in the toolbar.
  5. IMPORTANT: This process will take a few minutes. Wait until the process completes and the success message shows, similar to the screen shown below.
    Update-screenshot-20120124-02.png
  6. Congratulations! At this point, your site is updated. Check that your site is working correctly. If you have any questions before, during, or after the upgrade then please ask them on the Joomla! 1.6 Migrating and Upgrading Forum.

Extension Manager: Install Method

Joomla 1.6Joomla 1.7Joomla 2.5 In some cases it may not be possible to use the Extension Manager: Update method to update your site. One reason for this might be that you are using a non-standard distribution (for example, a distribution with a different default language installed). Another reason might be that your don't have a reliable enough internet connection to support automatic installation.

In this case, you can still do an easy installation using the Extension Manager: Install screen. Like the Update screen, this method will do the database updates automatically and will completely update your system without any further steps.

Step 1: Make sure you have a current backup of your site

In many cases, your host will make periodic site backups.

Step 2: Locate the update file

Locate the required archive file (for example, .zip, .tag.gz, or tar.bz2 archive) for your version. If you are updating to an x.x.0 release (for example, from 1.7.3 to 2.5.0), this will normally be a file like Joomla_2.5.0-Stable-Update_Package.zip. If you are updating within the same release series (for example, 2.5.0 to 2.5.1), then the file will be named something like Joomla_2.5.0_to_2.5.1-Stable-Patch_Package.zip.

At this point, you have three options:

  1. Install from URL
  2. Install from Directory
  3. Upload Package File

Install from URL is the easiest to do. With this option, the upgrade archive is loaded directly by the server, so it works well even if your local computer has a slow or unreliable internet connection.

Install from Directory is the safest method if the server itself has a slow internet connection. With this method, you use FTP to load the unpacked update files into a temporary folder on the server. Then you point to that directory on the server for the installation.

Upload Package File is fairly simple, but it requires that you have a good connection between your local computer and the server.

The screen below shows the Extension Manager: Install screen with the three options labeled.

Update-screenshot-20120124-03.png

Install from URL

This option is the easiest, if the archive file is available on a website.

  1. In the Extension Manager: Install screen, enter the URL for the archive file in the Install URL field.
  2. Press the Install button.

The system will work for a period of time, up to two minutes or more for a full version update. Then a message indicating a successful installation will display.

Install from Directory

This option requires that you unpack the archive file in a directory on your server. This is the best method if you have a slow internet connection or you are experiencing timeouts during the update process.

  1. Unpack the archive file in a temporary directory on your local machine.
  2. Upload all of the files in this directory (for example, using FTP) to a temporary directory that is visible to the web server. For example, you can create a sub-directory under the tmp directory in your Joomla root. For this example, let's say the directory on the server is /home/myuser/myjoomla/tmp/upgrade250).
  3. In the Extension Manager: Install screen, enter the full path of the temporary directory (on the server) from step 2 (for example, /home/myuser/myjoomla/tmp/upgrade250).
  4. Press the Install button.

The system will work for a short time (perhaps a minute or less, depending on your server). Then a message indicating a successful installation will display.

Upload Package File

This option requires that you first download the archive file to your local machine.

  1. Download the file to your local computer.
  2. In the Extension Manager: Install screen, click the Browse button next to the Package File field and browse to the archive file.
  3. Press the Install button.

The system will work for a period of time, up to two minutes or more for a full version update. Then a message indicating a successful installation will display.