|
|
| (75 intermediate revisions by 12 users not shown) |
| Line 1: |
Line 1: |
| − | =Overview=
| + | #REDIRECT [[Portal:Upgrading Versions]] |
| − | 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 [[Upgrade 1.6.5 to 1.7|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=
| |
| − | {{JVer|1.6}}{{JVer|1.7}}{{JVer|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==
| |
| − | # In the back end of your Joomla site, navigate to Extensions → Extension Manager and open the Update tab.
| |
| − | # Click on the Purge Cache icon to clear out the cache.
| |
| − | # 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. [[Image:Update-screenshot-20120124-01.png|frame|center]] Note that available upgrades for extensions used in the site will also show in the list.
| |
| − | # Select the update (using the checkbox) and click on the Update icon in the toolbar.
| |
| − | # '''IMPORTANT:''' This process will take a few minutes. Wait until the process completes and the success message shows, similar to the screen shown below. [[Image:Update-screenshot-20120124-02.png|frame|center]] | |
| − | # 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 [http://forum.joomla.org/viewforum.php?f=625&sid=259a29d8e21242b6770f86026f6c9c3a Joomla! 1.6 Migrating and Upgrading Forum].
| |
| − | | |
| − | =Extension Manager: Install Method=
| |
| − | {{JVer|1.6}}{{JVer|1.7}}{{JVer|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:
| |
| − | # Install from URL
| |
| − | # Install from Directory
| |
| − | # 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.
| |
| − | [[Image:Update-screenshot-20120124-03.png|frame|center]]
| |
| − | | |
| − | ===Install from URL===
| |
| − | This option is the easiest, if the archive file is available on a website.
| |
| − | # In the Extension Manager: Install screen, enter the URL for the archive file in the Install URL field.
| |
| − | # 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.
| |
| − | # Unpack the archive file in a temporary directory on your local machine.
| |
| − | # 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 <code>/home/myuser/myjoomla/tmp/upgrade250</code>).
| |
| − | # In the Extension Manager: Install screen, enter the full path of the temporary directory (on the server) from step 2 (for example, <code>/home/myuser/myjoomla/tmp/upgrade250</code>).
| |
| − | # 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.
| |
| − | # Download the file to your local computer.
| |
| − | # In the Extension Manager: Install screen, click the Browse button next to the Package File field and browse to the archive file.
| |
| − | # 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.
| |
| − | | |
| − | =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]] | |