Actions

J3.x

Difference between revisions of "Upgrading from an existing version"

From Joomla! Documentation

(Overview)
m (Step 2a: Find and install updates: fixing)
Line 1: Line 1:
{{RightTOC}}
+
{{warning|This page is only for upgrading from Joomla! versions '''"1.7''' or '''2.5"''' to '''3.x''' OR a '''3.x.x''' version to '''{{CurrentSTSVer}}'''.<br/><center><big>'''Always back up your site before updating.'''</big></center>}}
=Overview=
+
The recommended way to update installations of Joomla! is to use the Joomla Updater component found in the Components menu of your site Administrator.
+
  
==Back up your site==
+
The recommended way to update installations of Joomla! is to use the Joomla Updater component found in the Components menu of your site Administrator(Method A) introduced in J2.5.4.
  
==Browse to Components, Joomla Update==
+
Updating earlier versions? Use one of the following methods.
[[File:Componentsmenu.PNG]]
+
*Use Install Method ([[#Method B - Install Method|Method B]])
 +
*Manual Upgrade ([[#Method C - Manual Upgrade|Method C]])
  
  
 +
{{notice|You should always review '''[[:Category:Upgrading Issues|Upgrading Issues]]''' and '''[[J3.1:Known upgrading issues and solutions|Known upgrading issues and solutions]]''' before upgrading.|title=Before You Begin}}
  
If an update is available there will be a message indicating this and a button to press.
+
==Browse to Components, Joomla Update==
 +
[[File:Componentsmenu.PNG]]
  
[[File:Updatewaitingj3.PNG]]
+
If an update is available there will be a message indicating this and a button to press. Otherwise for J2.5 go to Extension manager => Update and press Purge cache.  
  
 +
[[File:Updatewaitingj3.PNG|475px]]
 +
{{-}}
 
==Click on the "Install the Update" button and allow the update to run==
 
==Click on the "Install the Update" button and allow the update to run==
  
Line 22: Line 25:
 
Note: Joomla! will notify you on your administrator home page (control panel) when an update is needed, but it will not do the update for you. You need to press the button to start the update.
 
Note: Joomla! will notify you on your administrator home page (control panel) when an update is needed, but it will not do the update for you. You need to press the button to start the update.
  
==Trouble Shooting and Advanced Techniques==
+
{{ambox|text=[[J3.1:Detailed_instructions_for_updating_from_3.1.2_to_3.1.4| Special Instructions for Version 3.1.2 Upgrades]]}}
Starting with version 1.6, there are three ways to update your Joomla Website to versions 1.6, 1.7 or 2.5.
+
If you are in an older version that did not support one click updates or are on a server that does not allow such updates you should use one of these options.  
+
  
* Extension Manager: Update
+
'''Recommended Steps and actions:'''
* Extension Manager: Install
+
* Manually Copy Program Files
+
 
+
Each of these is discussed below.
+
 
+
 
+
'''Steps and actions:'''
+
 
It is recommended that you follow these steps when updating a production site:
 
It is recommended that you follow these steps when updating a production site:
 
# 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.  
 
# 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.  
Line 49: Line 43:
 
# '''If your site is prior to 2.5.4, see Step 2b instead'''
 
# '''If your site is prior to 2.5.4, see Step 2b instead'''
 
# In the back end of your Joomla site, navigate to Components &rarr; Joomla Update.
 
# In the back end of your Joomla site, navigate to Components &rarr; Joomla Update.
# Click on Install the Update [[Image:Update-screenshot-20120618-01.png|frame|center]]
+
# Click on Install the Update {{-}}[[Image:Update-screenshot-20120618-01.png|800px]]
# '''IMPORTANT:''' This process will take a few minutes. Wait until the process completes and it tells you that you are already on the current release, similar to the screen shown below. [[Image:Update-screenshot-20120618-02.png|frame|center]]
+
# '''IMPORTANT:''' This process will take a few minutes. Wait until the process completes and it tells you that you are already on the current release, similar to the screen shown below.{{-}} [[Image:Update-screenshot-20120618-02.png|800px]]
 
# Congratulations! At this point, your site is updated.
 
# Congratulations! At this point, your site is updated.
 
'''Important:''' Clear your browser cache and check that your site is working correctly. See below Checking Your Site
 
'''Important:''' Clear your browser cache and check that your site is working correctly. See below Checking Your Site
Line 136: Line 130:
 
At this point, your site is updated. However, there is one more thing to do. The site will think it needs to be updated because a value in the #__extensions table is wrong. To fix this:
 
At this point, your site is updated. However, there is one more thing to do. The site will think it needs to be updated because a value in the #__extensions table is wrong. To fix this:
 
* Using phpMyAdmin or a similar tool, edit the row of the #__extensions table where the id column is '700'. (Note that the table prefix will be different in your site. For example, if your table prefix is "jos_", then the table will be called "jos_extensions".
 
* Using phpMyAdmin or a similar tool, edit the row of the #__extensions table where the id column is '700'. (Note that the table prefix will be different in your site. For example, if your table prefix is "jos_", then the table will be called "jos_extensions".
* In the manifest_cache column, you will see the old version in the text (for example, <code>"version":"1.7.3"</code>). Change this to the new version (for example, <code>"version":"2.5.0"</code>). Be careful to not change anything else in this column.
+
* In the manifest_cache column, you will see the old version in the text (for example, <code>"version":"1.7.3"</code>). Change this to the new version (for example, <code>"version":"3.1.4"</code>). Be careful to not change anything else in this column.
 
* To check that this was successful, navigate to Extension Manager: Update and click Check for Updates. You should '''not''' see the current Joomla version in the list.
 
* To check that this was successful, navigate to Extension Manager: Update and click Check for Updates. You should '''not''' see the current Joomla version in the list.
  
At this point, your site should be updated correctly.  
+
At this point, your site should be updated correctly.
 
+
  
 
=Checking Site=
 
=Checking Site=
Line 167: Line 160:
  
 
=Troubleshooting=
 
=Troubleshooting=
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].
+
If you have any questions before, during, or after the upgrade then please ask them on the '''[[jforum:710|Migrating and Upgrading to Joomla! 3.x Forum]]'''.
  
 
If you have problems or errors during the update process, here are some tips.
 
If you have problems or errors during the update process, here are some tips.
* Clear your browser cache as there may have been changes to the css or javascript that will need to be reloaded by your web browser.
+
* Check the following locations for more information:
 +
:*'''[[J3.1:Known upgrading issues and solutions|Known upgrading issues and solutions]]'''
 +
:*'''[[:Category:Upgrading Issues|Upgrading Issues]]'''
 +
* Sometimes a simple clearing your browser cache as there may have been changes to the css or javascript that will need to be reloaded by your web browser after an upgrade.
 
* If any database error messages show after the update, be sure to check the Extension Manager: Database tab followed by the Extension Manager: Discover tab. In some cases, if a database error occurs it will prevent all the database updates from running. In this case, you can run them from the Database tab and then use the Discover&rarr;Install method to check and install any new extensions.
 
* If any database error messages show after the update, be sure to check the Extension Manager: Database tab followed by the Extension Manager: Discover tab. In some cases, if a database error occurs it will prevent all the database updates from running. In this case, you can run them from the Database tab and then use the Discover&rarr;Install method to check and install any new extensions.
* If you encounter any errors or problems during or after the update, be sure to check the FAQ for the version you updated to. For example, for version 2.5.0, this will be an article entitled [http://docs.joomla.org/Category:Version_2.5.0_FAQ http://docs.joomla.org/Category:Version_2.5.0_FAQ].
+
* If you encounter any errors or problems during or after the update, be sure to check the FAQ for the version you updated to. For example, for version 3.1.0, this will be an category entitled [[:Category:Version_3.1.0_FAQ|Category:Version 3.1.0 FAQ]].
  
<headertabs/>
 
 
[[Category:Upgrading]]
 
[[Category:Upgrading]]
 
[[Category:Joomla! 3.0]][[Category:Joomla! 3.1]]
 
[[Category:Joomla! 3.0]][[Category:Joomla! 3.1]]

Revision as of 08:02, 17 December 2013