Portal

Difference between revisions of "Upgrading Versions"

From Joomla! Documentation
m (link added)
 
(50 intermediate revisions by 11 users not shown)
Line 1: Line 1:
−
Before you begin, it is essential you know what version of Joomla! you are using. This is especially true if you are changing a major version. If you are already confused or don't know what a major version is, you should read more about the [[release and support cycle]] of Joomla! CMS Versions.
+
<noinclude><languages /></noinclude>
  
−
{{tip|Joomla! is released with the following version designations, '''[major].[minor].[maintenance]'''. So version 3.1.5 is Joomla! major version 3, minor 1, and maintenance release 5. Since version 1.7, the updating and upgrading of Joomla! are built into the [[Portal:Administrator|administration]] interface as a component. The terms updating and upgrading might be used interchangeably. In many ways, updating and upgrading are alike, but you should pay very close attention to the details of an upgrade. Upgrades would be defined as a major.minor(2.5) to a different major.minor(3.1) version or a major.minor(3.0) to a major.new minor(3.1).|title=A Brief Summary}}
+
<translate>
 +
<!--T:1-->
 +
Before you begin, it is essential you know [[S:MyLanguage/How to check the Joomla version?|what version of Joomla! you are using]]. This is especially true if you are changing to a major version. If you are already confused or don't know what a major version is, you should read more about the [[S:MyLanguage/release and support cycle|release and support cycle]] of Joomla CMS Versions. Joomla is released with the following version designations: '''[major].[minor].[maintenance]'''. For example, version 3.9.5 is Joomla major version 3, minor 9, and maintenance release 5.
 +
</translate>
  
−
==Simple Updating==
+
<translate>
−
Updates are an easy update to the next maintenance release, for example version 2.5.13 to version 2.5.14. This would be a maintenance release of the 2.5 version.  
+
<!--T:2-->
−
:[[J3.1:Upgrading from an existing version|Updating your version of Joomla! CMS {{CurrentSTSVer|minor}}]]
+
Since version 1.7, the updating and upgrading of Joomla is built into the [[S:MyLanguage/Administrator (Application)|administration]] interface as a component. The terms ''updating'' and ''upgrading'' might be used interchangeably. In many ways, updating and upgrading are alike since Joomla 1.7, but you will need to pay very close attention to the details. To help define them better, it is recommended you use the term ''migration'' which would be defined as a major.minor (2.5) to a different major.minor (3.1) version.
−
:[[J2.5:Upgrading from an existing version|Updating your version of Joomla! CMS 2.5]]
+
</translate>
  
−
==Upgrading==
+
<translate>
−
Upgrading from a major.minor to major.minor version can be done with the built-in core Upgrade Component. However, before upgrading you will have to do some homework. You will need to gather information which will include the following:
+
==Simple Updating== <!--T:3-->
−
*'''Template compatibility''' - Will your current [[template]] work with the new version? You will have to contact the template builder to verify this information.
+
Updates are an easy path to the next '''maintenance release''' and are backwards compatible, for example, version 2.5.13 to version 2.5.14. For Joomla CMS 3, these updates span all minor and maintenance releases. Some examples are version 3.1.2 to 3.3.6 and 3.3.1 to 3.3.6. Please see the specific pages to review version '''from''' and '''to'''.
−
*'''Installed extensions compatibility''' - Make a list of installed [[extension]]s, modules and plugins. Will they work with the new version? Does the developer have a version compatibile or at the very least is there a comparable extension.
+
*[[S:MyLanguage/J3.1:Updating from an existing version|Updating a Joomla CMS 3.x.x Installation]]
−
*'''Will the positions of modules change?''' Some template developers may have upgraded a template to the next version, but may have changed the [[module]] positions or added more.
+
**[[S:MyLanguage/J3.x:Updating Joomla (Update Method)|Updating Joomla CMS 3.x.x (Update Method)]] '''''recommended method'''''
−
*'''Should this be a 'live'(www viewable) upgrade?''' This question is a tough one and only you will know the type of upgrade you should perform. It may be better to do a 'offline'(localhost, subdomain or subfolder) upgrade, make sure your site is working fine, then move the new version to the 'live' location.
+
**[[S:MyLanguage/J3.x:Updating Joomla (Install Method)|Updating Joomla CMS 3.x.x (Install Method)]]
 +
*[[S:MyLanguage/J2.5:Updating from an existing version|Updating a Joomla CMS 2.5.x Installation]] '''EOS'''
 +
**[[S:MyLanguage/J2.5:Updating Joomla (Update Method)|Updating Joomla CMS 2.5.x (Update Method)]] '''''recommended method'''''
 +
**[[S:MyLanguage/J2.5:Updating Joomla (Install Method)|Updating Joomla CMS 2.5.x (Install Method)]]
 +
</translate>
  
−
{{warning|Above all, realise without the correct preparation and knowledge, you may break your 'live' site.|title=Just Remember!}}
+
<translate>
 +
== Migration == <!--T:4-->
 +
The documentation below is a funnel starting with Why Migrate. Simply follow the buttons at the bottom of each page that are applicable to you. The Self Assessment will help you determine if doing the migration is within your skill set. Please don't skip the Planning pages as they include important information for your migration.
 +
</translate>
  
−
====Upgrading to {{RVer}}====
+
<translate>
 +
<!--T:5-->
 +
*[[S:MyLanguage/Why Migrate|Why Migrate]]
 +
*[[S:MyLanguage/Migration Step by Step Self Assessment|Migration Step by Step Self Assessment]]
 +
*[[S:MyLanguage/Planning for Migration|Planning for Migration]]
 +
</translate>
 +
 
 +
<translate>
 +
=== Migration 1.5 to 3.x === <!--T:6-->
 +
*[[S:MyLanguage/Planning Migration - Joomla 1.5 to 3|Planning Migration - Joomla 1.5 to 3]]
 +
*[[S:MyLanguage/Joomla 1.5 to 3.x Step by Step Migration|Joomla 1.5 to 3.x Step by Step Migration]]
 +
*[[S:MyLanguage/Migrating a Template from Joomla 1.5 to 3.x|Migrating a Template from Joomla 1.5 to 3.x]]
 +
</translate>
 +
 
 +
<translate>
 +
=== Migration 2.5 to 3.x === <!--T:7-->
 +
*[[S:MyLanguage/Planning for Mini-Migration - Joomla 2.5 to 3.x|Planning for Mini-Migration - Joomla 2.5 to 3.x]]
 +
*[[S:MyLanguage/Joomla 2.5 to 3.x Step by Step Migration|Joomla 2.5 to 3.x Step by Step Migration]]
 +
*[[S:MyLanguage/Joomla 2.5 to 3.x Common Migration Errors|Joomla 2.5 to 3.x Common Migration Errors]]
 +
</translate>
 +
 
 +
<translate>
 +
=== Migration 3.10 to 4.x=== <!--T:18-->
 +
*[[S:MyLanguage/Planning for Mini-Migration - Joomla 3.10.x to 4.x|Planning for Mini-Migration - Joomla 3.10 to 4.x]]
 +
*[[S:MyLanguage/Joomla_3.x_to_4.x_Step_by_Step_Migration|Joomla 3.10 to 4.x Step by Step Migration]]
 +
*[[S:MyLanguage/Joomla 3.10 to 4.x Common Migration Errors|Joomla 3.10 to 4.x Common Migration Errors]]
 +
</translate>
 +
 
 +
<translate>
 +
=== Update 4.4 to 5.x (new)=== <!--T:19-->
 +
* [[S:MyLanguage/J4.x:Pre-Update_Check|Pre-Update Check]]
 +
* [[S:MyLanguage/Joomla_4.4.x_to_5.x_Planning_and_Upgrade_Step_by_Step|Planning for Update - Joomla 4.4.x to 5.x]]
 +
</translate>
 +
 
 +
<translate>
 +
 
 +
=== Other Migration Considerations === <!--T:8-->
 +
*[[S:MyLanguage/Template Considerations During Migration|Template Considerations During Migration]]
 +
</translate>
 +
 
 +
{{note|<translate><!--T:9-->
 +
Above all, realise without the correct preparation and knowledge, you may break your ''live'' site.</translate>|title=Just Remember!|type=serious}}
 +
 
 +
<translate>
 +
=== Legacy Migration === <!--T:17-->
 +
Documentation on migration of a legacy version to another legacy version, for example from 1.0 to 1.5 or 1.5 to 2.5.
 +
*[[S:MyLanguage/Planning Migration and Step by Step- Joomla 1.0 to 1.5|Planning Migration and Step by Step- Joomla 1.0 to 1.5]]
 +
*[[S:MyLanguage/Migrating from Joomla 1.5 to Joomla 2.5|Migrating from Joomla 1.5 to Joomla 2.5]]
 +
</translate>
 +
 
 +
<translate>
 +
== Historical Legacy Documentation == <!--T:10-->
 +
 
 +
<!--T:11-->
 +
Use the links below for legacy documentation for older versions of Joomla! or lesser-used versions of Joomla! You are encouraged to search the [https://forum.joomla.org/ Joomla! Community forum] for even more information and education prior to starting your upgrades/migrations.
 +
</translate>
 +
 
 +
<translate>
 +
====Upgrading to {{CurrentSTSVer|minor}}==== <!--T:12-->
 
Upgrading 1.6.5, 1.6.6, 1.7.x, 2.5.x to 3.x is covered by the following page.
 
Upgrading 1.6.5, 1.6.6, 1.7.x, 2.5.x to 3.x is covered by the following page.
−
:[[J3.1:Upgrading from an existing version|Upgrading to Joomla! CMS version {{CurrentSTSVer|minor}}]]
+
:[[S:MyLanguage/J3.x:Updating from an existing version|Updating from an existing version - {{CurrentSTSVer|minor}}]]
 +
</translate>
  
−
====Upgrading to J2.5====
+
<translate>
 +
====Upgrading to J2.5==== <!--T:13-->
 
Upgrading 1.6.5, 1.6.6, 1.7.x, to 2.5 is covered by the following page.
 
Upgrading 1.6.5, 1.6.6, 1.7.x, to 2.5 is covered by the following page.
−
:[[J2.5:Upgrading from an existing version|Upgrading to Joomla! CMS version 2.5]]
+
:[[S:MyLanguage/J2.5:Updating from an existing version|Upgrading to Joomla CMS version 2.5]]
 +
</translate>
  
−
====Upgrading from 1.6.x(not 1.6.5 or 1.6.6 Versions)====
+
<translate>
 +
====Upgrading from 1.6.x(not 1.6.5 or 1.6.6 Versions)==== <!--T:14-->
 
You must upgrade to Version 1.7 first if you are on version of 1.6 below the maintenance release of 1.6.5.
 
You must upgrade to Version 1.7 first if you are on version of 1.6 below the maintenance release of 1.6.5.
−
:[[Upgrading 1.6.5 to 1.7|Upgrading Version 1.6.5 or 1.6.6 to Version 1.7]]
+
:[[S:MyLanguage/Upgrading 1.6.5 to 1.7|Upgrading Version 1.6.5 or 1.6.6 to Version 1.7]]
−
 
+
</translate>
−
==Migrating (Version 1.5)==
 
−
A lot of Joomla! CMS version 2.5 was based off of the 1.5 version, but at the same time there was a massive effort put into advancing Joomla CMS version 2.5 to where it is today. This effort required many core code and database changes.  These changes from the Joomla! CMS version 1.5 to version 2.5 were so large and sweeping, there is no core upgrade path. If you are using a Joomla! CMS version 1.5 this will requires a migration to upgrade.
 
−
 
 
−
:[[Migrating from Joomla 1.5 to Joomla 2.5]]
 
  
 +
<translate>
 +
<!--T:16-->
 
[[Category:Upgrading]]
 
[[Category:Upgrading]]
 
[[Category:Migration]]
 
[[Category:Migration]]
 
[[Category:Landing Pages]]
 
[[Category:Landing Pages]]
 +
[[Category:Update Working Group]]
 +
[[Category:Needs_content]]
 +
</translate>

Latest revision as of 13:48, 21 October 2023

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Nederlands • ‎català • ‎español • ‎français • ‎italiano • ‎português • ‎български • ‎русский • ‎فارسی • ‎ไทย • ‎中文（中国大陆）‎ • ‎中文（台灣）‎ • ‎日本語

Before you begin, it is essential you know what version of Joomla! you are using. This is especially true if you are changing to a major version. If you are already confused or don't know what a major version is, you should read more about the release and support cycle of Joomla CMS Versions. Joomla is released with the following version designations: [major].[minor].[maintenance]. For example, version 3.9.5 is Joomla major version 3, minor 9, and maintenance release 5.

Since version 1.7, the updating and upgrading of Joomla is built into the administration interface as a component. The terms updating and upgrading might be used interchangeably. In many ways, updating and upgrading are alike since Joomla 1.7, but you will need to pay very close attention to the details. To help define them better, it is recommended you use the term migration which would be defined as a major.minor (2.5) to a different major.minor (3.1) version.

Simple Updating[edit]

Updates are an easy path to the next maintenance release and are backwards compatible, for example, version 2.5.13 to version 2.5.14. For Joomla CMS 3, these updates span all minor and maintenance releases. Some examples are version 3.1.2 to 3.3.6 and 3.3.1 to 3.3.6. Please see the specific pages to review version from and to.

Migration[edit]

The documentation below is a funnel starting with Why Migrate. Simply follow the buttons at the bottom of each page that are applicable to you. The Self Assessment will help you determine if doing the migration is within your skill set. Please don't skip the Planning pages as they include important information for your migration.

Migration 1.5 to 3.x[edit]

Migration 2.5 to 3.x[edit]

Migration 3.10 to 4.x[edit]

Update 4.4 to 5.x (new)[edit]


Other Migration Considerations[edit]

Above all, realise without the correct preparation and knowledge, you may break your live site.

Legacy Migration[edit]

Documentation on migration of a legacy version to another legacy version, for example from 1.0 to 1.5 or 1.5 to 2.5.

Historical Legacy Documentation[edit]

Use the links below for legacy documentation for older versions of Joomla! or lesser-used versions of Joomla! You are encouraged to search the Joomla! Community forum for even more information and education prior to starting your upgrades/migrations.

Upgrading to 3.10[edit]

Upgrading 1.6.5, 1.6.6, 1.7.x, 2.5.x to 3.x is covered by the following page.

Updating from an existing version - 3.10

Upgrading to J2.5[edit]

Upgrading 1.6.5, 1.6.6, 1.7.x, to 2.5 is covered by the following page.

Upgrading to Joomla CMS version 2.5

Upgrading from 1.6.x(not 1.6.5 or 1.6.6 Versions)[edit]

You must upgrade to Version 1.7 first if you are on version of 1.6 below the maintenance release of 1.6.5.

Upgrading Version 1.6.5 or 1.6.6 to Version 1.7
Retrieved from "https://docs.joomla.org/index.php?title=Portal:Upgrading_Versions&oldid=1015616"