|
|
| (81 intermediate revisions by 12 users not shown) |
| Line 1: |
Line 1: |
| − | __NOTOC__
| + | #REDIRECT [[Portal:Upgrading Versions]] |
| − | 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.
| |
| − | | |
| − | Starting with version 1.6, there is a new option for upgrading your site from within Joomla. The old method of upgrading from an archive file still works as well. Both methods are documented here.
| |
| − | | |
| − | =Simple Upgrade from Joomla Extension Manager=
| |
| − | {{JVer|1.6}}{{JVer|1.7}}{{JVer|2.5}}
| |
| − | | |
| − | To upgrade from version 1.6.x to Joomla 1.7 please follow this [[Upgrade 1.6.5 to 1.7|guide]]
| |
| − | | |
| − | ==Step 1: Make sure you have a current backup of your site==
| |
| − | | |
| − | ==Step 2: Find and install uppdates==
| |
| − | # 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_20110417-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_20110417-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].
| |
| − | | |
| − | =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]] | |