Joomla 2.5 to 3.10 Step by Step Migration - Revision history

M-b-o: Marked this version for translation

2021-08-09T20:04:16Z

Marked this version for translation

← Older revision		Revision as of 20:04, 9 August 2021
Line 150:		Line 150:
	=== Going Live with your Joomla! 3.x Site === <!--T:32-->		=== Going Live with your Joomla! 3.x Site === <!--T:32-->

			<!--T:43-->
	NOTE: It is recommended that you do the mini-migration to Joomla 4 at this point unless there's some really good reason not to do so. To continue to Joomla 4, see [[Planning for Mini-Migration - Joomla 2.5 to 4.x\|Planning for Mini-Migration 2.5 to 4.x]] and [[Joomla 3.x to 4.x Step by Step Migration\|3.10.x to 4.x Step by Step Migration]].		NOTE: It is recommended that you do the mini-migration to Joomla 4 at this point unless there's some really good reason not to do so. To continue to Joomla 4, see [[Planning for Mini-Migration - Joomla 2.5 to 4.x\|Planning for Mini-Migration 2.5 to 4.x]] and [[Joomla 3.x to 4.x Step by Step Migration\|3.10.x to 4.x Step by Step Migration]].

Jgress-: Add a blurb in going live section to link to planning to 4 and 3 to 4 step by step

2021-08-07T17:23:06Z

Add a blurb in going live section to link to planning to 4 and 3 to 4 step by step

← Older revision		Revision as of 17:23, 7 August 2021
Line 149:		Line 149:

	=== Going Live with your Joomla! 3.x Site === <!--T:32-->		=== Going Live with your Joomla! 3.x Site === <!--T:32-->

			NOTE: It is recommended that you do the mini-migration to Joomla 4 at this point unless there's some really good reason not to do so. To continue to Joomla 4, see [[Planning for Mini-Migration - Joomla 2.5 to 4.x\|Planning for Mini-Migration 2.5 to 4.x]] and [[Joomla 3.x to 4.x Step by Step Migration\|3.10.x to 4.x Step by Step Migration]].

	<!--T:33-->		<!--T:33-->
Line 162:		Line 164:

	<translate>		<translate>

	== Suggested Tools == <!--T:35-->		== Suggested Tools == <!--T:35-->

M-b-o: M-b-o moved page Joomla 2.5 to 3.x Step by Step Migration to Joomla 2.5 to 3.10 Step by Step Migration without leaving a redirect: Joomla 3.10 is the last 3.x version

2021-08-03T20:58:59Z

M-b-o moved page Joomla 2.5 to 3.x Step by Step Migration to Joomla 2.5 to 3.10 Step by Step Migration without leaving a redirect: Joomla 3.10 is the last 3.x version

← Older revision	Revision as of 20:58, 3 August 2021
(No difference)

Cmb: Fixed some URLs and markup.

2020-08-14T18:13:37Z

Fixed some URLs and markup.

← Older revision		Revision as of 18:13, 14 August 2020
Line 39:		Line 39:
	== Step by Step == <!--T:8-->		== Step by Step == <!--T:8-->

	=== Set up a Development Location === <!--T:9-->		=== Set Up a Development Location === <!--T:9-->
	</translate>		</translate>
	<translate>		<translate>
Line 46:		Line 46:
	#*[[S:MyLanguage/Backup_Basics_for_a_Joomla!_Web_Site\|Backup Basics for a Joomla! Web Site]]		#*[[S:MyLanguage/Backup_Basics_for_a_Joomla!_Web_Site\|Backup Basics for a Joomla! Web Site]]
	#*[[S:MyLanguage/What_are_the_best_practices_for_site_backups%3F\|What are the best practices for site backups?]]		#*[[S:MyLanguage/What_are_the_best_practices_for_site_backups%3F\|What are the best practices for site backups?]]
	# Make sure your environment meets the [~~http~~://~~www~~.joomla.org~~/about-joomla~~/technical-requirements~~.html technical requirements~~ for Joomla 3] before proceeding.		# Make sure your environment meets the [https://downloads.joomla.org/technical-requirements Technical Requirements] for Joomla 3 before proceeding.
	# Create a new database and new user to restore your 2.5 site to.		# Create a new database and new user to restore your 2.5 site to.
	# Create a testing site or build area to work in and restore the back up copy of your 2.5 site in one of the following places:		# Create a testing site or build area to work in and restore the back up copy of your 2.5 site in one of the following places:
	#* A subdomain.		#* A subdomain.
	#* A subdirectory.		#* A subdirectory.
	#* A local device via [~~http~~://www.wampserver.com/en/ WAMP], [~~http~~://www.mamp.info/en/ MAMP], [~~http~~://sourceforge.net/projects/lampas/ LAMP], [~~http~~://sourceforge.net/projects/xampp/ XAMPP].		#* A local device via [https://www.wampserver.com/en/ WAMP], [https://www.mamp.info/en/windows/ MAMP], [https://sourceforge.net/projects/lampas/ LAMP], [https://sourceforge.net/projects/xampp/ XAMPP].
	#* A new hosting account on a temporary domain in the root. (If you would like to change hosts in the process of migration).		#* A new hosting account on a temporary domain in the root. (If you would like to change hosts in the process of migration).
	#** Restoring a site on a local device. See [[S:MyLanguage/Installing Joomla locally\|Installing Joomla locally]] and [[S:MyLanguage/Setting up your workstation for Joomla development\|Setting up your workstation for Joomla development]].		#** Restoring a site on a local device. See [[S:MyLanguage/Installing Joomla locally\|Installing Joomla locally]] and [[S:MyLanguage/Setting up your workstation for Joomla development\|Setting up your workstation for Joomla development]].
	#** Restoring a site with a tool listed at bottom of page. (Read the developer documentation)		#** Restoring a site with a tool listed at bottom of page. (Read the developer documentation)
	# In your test location, update your Joomla! 2.5 instance to the latest maintenance release. (Currently 2.5.28).		# In your test location, update your Joomla! 2.5 instance to the latest maintenance release. (Currently 2.5.28).
	# Make sure you have the latest database schema updated to the latest version 2.5.28 by going to~~: '''~~Extension Manager → Database tab~~'''~~. If your schema is not up to date as in the following image, click the '''Fix''' button:</translate>{{-}}[[File:J25-admin-extension-database-fix-<translate><!--T:38-->		# Make sure you have the latest database schema updated to the latest version 2.5.28 by going to {{rarr\|Extension Manager,Database}} tab. If your schema is not up to date as in the following image, click the '''Fix''' button:</translate>{{-}}[[File:J25-admin-extension-database-fix-<translate><!--T:38-->
	en</translate>.png\|border]]		en</translate>.png\|border]]
	<translate>		<translate>
Line 71:		Line 71:
	<!--T:12-->		<!--T:12-->
	# You are going to be looking at every single extension installed on your site. You will be determining if they need to be updated to the latest version or uninstalled. In Joomla! 2.5.28 you can go to {{rarr\|Extension Manager,Update tab}} and click '''Find Updates''' which will add a tooltip in the Version column, under the Manage tab, giving some compatibility information from the backend. This functionality only supports extensions that update via the Extension Manager Update tab. If you have extensions installed that do not use the Joomla extension update then they need to be assessed manually as detailed below. The same goes for those extensions that have a tooltip. You will still need to check the type of package and migration path with the extension developer to verify how to upgrade/migrate.		# You are going to be looking at every single extension installed on your site. You will be determining if they need to be updated to the latest version or uninstalled. In Joomla! 2.5.28 you can go to {{rarr\|Extension Manager,Update tab}} and click '''Find Updates''' which will add a tooltip in the Version column, under the Manage tab, giving some compatibility information from the backend. This functionality only supports extensions that update via the Extension Manager Update tab. If you have extensions installed that do not use the Joomla extension update then they need to be assessed manually as detailed below. The same goes for those extensions that have a tooltip. You will still need to check the type of package and migration path with the extension developer to verify how to upgrade/migrate.
	# Go to {{rarr\|Extension Manager,Manage ~~tab~~}}		# Go to {{rarr\|Extension Manager,Manage}} tab.
	# Click the drop-down for Type.		# Click the drop-down for Type.
	# Select Package from the drop-down.</translate>{{-}}[[File:J25-admin-extension-manage-package-<translate><!--T:13-->		# Select Package from the drop-down.</translate>{{-}}[[File:J25-admin-extension-manage-package-<translate><!--T:13-->
Line 100:		Line 100:
	<translate>		<translate>
	<!--T:20-->		<!--T:20-->
	# Go to {{rarr\|Site,Global Configuration,Server ~~tab~~}} and turn Error Reporting from System Default to Maximum. Make sure to Save & Close.</translate>{{-}} [[File:j25-system-global-config-server-tab-<translate><!--T:21-->		# Go to {{rarr\|Site,Global Configuration,Server}} tab and turn Error Reporting from System Default to Maximum. Make sure to Save & Close.</translate>{{-}} [[File:j25-system-global-config-server-tab-<translate><!--T:21-->
	en</translate>.png\|border]]		en</translate>.png\|border]]
	<translate>		<translate>
	<!--T:22-->		<!--T:22-->
	# Go to {{rarr\|Extensions,Plugin Manager}} and enter Remember Me into the Filter and press enter.		# Go to {{rarr\|Extensions,Plugin Manager}} and enter ''Remember Me'' into the Filter and press enter.
	# Disable the Remember Me plugin by clicking the green check mark and making it a red circle.</translate>{{-}}[[File:j25-extension-plugin-remember-me-<translate><!--T:23-->		# Disable the Remember Me plugin by clicking the green check mark and making it a red circle.</translate>{{-}}[[File:j25-extension-plugin-remember-me-<translate><!--T:23-->
	en</translate>.png\|border]]		en</translate>.png\|border]]
Line 139:		Line 139:
	# Take a backup.		# Take a backup.
	# At this point, it would be prudent to clear your browser's cache. Some browsers, notably Firefox, will retain old version 2.5 files. That caching might prevent the operation of the Save and Save & Close buttons in the Administrator.		# At this point, it would be prudent to clear your browser's cache. Some browsers, notably Firefox, will retain old version 2.5 files. That caching might prevent the operation of the Save and Save & Close buttons in the Administrator.
	# Go to {{rarr\|Content,Article Manager,Options button,Editing Layout ~~tab~~}} and set the Enable Versions to Yes.		# Go to {{rarr\|Content,Article Manager,Options button,Editing Layout}} tab and set the Enable Versions to Yes.
	# Install your new template or other extensions if you have them to install. Back up often.		# Install your new template or other extensions if you have them to install. Back up often.
	# Configure them. Back up often.		# Configure them. Back up often.
	# Test everything. Back up often.		# Test everything. Back up often.
	# If everything works as expected, turn Error Reporting back to System Default ({{rarr\|System,Global Configuration,Server ~~tab~~}}). Make sure to Save & Close.		# If everything works as expected, turn Error Reporting back to System Default ({{rarr\|System,Global Configuration,Server}} tab). Make sure to Save & Close.
	# Now you should return to Joomla Updates in the Components menu. Install any updates offered. After the successful installation of version 3.5.1, you will likely be offered version 3.6.5 next. Finally, the Update facility will bring your site up to the current version in the 3.x series.		# Now you should return to Joomla Updates in the Components menu. Install any updates offered. After the successful installation of version 3.5.1, you will likely be offered version 3.6.5 next. Finally, the Update facility will bring your site up to the current version in the 3.x series.
	</translate>		</translate>
Line 154:		Line 154:
	# Back up your Joomla! 3.x site and move or restore your Joomla! 3.x site to the root (or change nameservers if you were building on a temporary domain at a new hosting account root).		# Back up your Joomla! 3.x site and move or restore your Joomla! 3.x site to the root (or change nameservers if you were building on a temporary domain at a new hosting account root).
	# Test again.		# Test again.
	# Remove the Joomla! 2.5 site from the server within a couple of days unless you have edited your robots.txt file to block the search engine spiders.		# Remove the Joomla! 2.5 site from the server within a couple of days unless you have edited your ''robots.txt'' file to block the search engine spiders.
	# Remove all development sites you may have been working with or keep them up-to-date if they are running a current version in order to ward off hack attempts on your server.		# Remove all development sites you may have been working with or keep them up-to-date if they are running a current version in order to ward off hack attempts on your server.

	<!--T:34-->		<!--T:34-->
	If you had data change on the 2.5 site while you were migrating to 3.x, you will want to get that data moved over to the 3.x site before going live. You can do this manually (make sure you keep the same user IDs - go in order) or by using a [~~http~~://extensions.joomla.org/category/migration-a-conversion/data-import-a-export ~~transfer tool~~/~~third-party~~ extension].		If you had data change on the 2.5 site while you were migrating to 3.x, you will want to get that data moved over to the 3.x site before going live. You can do this manually (make sure you keep the same user IDs - go in order) or by using a [https://extensions.joomla.org/category/migration-a-conversion/data-import-a-export/ Data Import and Export] extension.
	</translate>		</translate>

	<translate>		<translate>

	== Suggested Tools == <!--T:35-->		== Suggested Tools == <!--T:35-->

Wilsonge: Add link to a different page on migrations

2020-03-30T11:46:52Z

Add link to a different page on migrations

← Older revision		Revision as of 11:46, 30 March 2020
Line 88:		Line 88:
	#* The extension has separate packages but upon upgrading to 3.x, they automatically detect this and still work. Make sure the developer confirms this.		#* The extension has separate packages but upon upgrading to 3.x, they automatically detect this and still work. Make sure the developer confirms this.
	#* The extension has separate packages that need to be uninstalled in 2.5 and then installed with the Joomla 3.x version once the site is migrated. An example of this might be a content plugin. It is very simple to uninstall it in 2.5 and then install it again in 3.x.		#* The extension has separate packages that need to be uninstalled in 2.5 and then installed with the Joomla 3.x version once the site is migrated. An example of this might be a content plugin. It is very simple to uninstall it in 2.5 and then install it again in 3.x.
	#* See [[S:MyLanguage/Template_Considerations_During_Migration\|Template Considerations]] for more specific information on templates.</translate>		#* See [[S:MyLanguage/Template_Considerations_During_Migration\|Template Considerations]] for more specific information on templates and [[S:MyLanguage/J3.x:Converting_A_Previous_Joomla!_Version_Template\|Converting a previous Joomla! Version template]]</translate>
	{{-}}{{note\|'''<translate><!--T:18-->		{{-}}{{note\|'''<translate><!--T:18-->
	Note on Core Supported Extensions:''' If you are using a Core Supported Extension (Banners, Contacts, Messaging, Newsfeeds, Redirect, Search, Smart Search, or Weblinks) in Joomla! 2.5 and it has been decoupled in Joomla! 3.4+, Joomla will detect their use during the upgrade and install those Core Supported Extensions automatically.</translate>\|type=notice}}		Note on Core Supported Extensions:''' If you are using a Core Supported Extension (Banners, Contacts, Messaging, Newsfeeds, Redirect, Search, Smart Search, or Weblinks) in Joomla! 2.5 and it has been decoupled in Joomla! 3.4+, Joomla will detect their use during the upgrade and install those Core Supported Extensions automatically.</translate>\|type=notice}}

Cmb: Removed the ''Download the Joomla! 3.5.1 Upgrade Package'' paragraph. The Joomla installer downloads it.

2018-04-18T21:17:37Z

Removed the ''Download the Joomla! 3.5.1 Upgrade Package'' paragraph. The Joomla installer downloads it.

← Older revision		Revision as of 21:17, 18 April 2018
Line 93:		Line 93:
	<translate>		<translate>
	=== Going to Joomla! 3.x === <!--T:19-->		=== Going to Joomla! 3.x === <!--T:19-->
	Joomla! 2.5.28 can only be migrated to the latest Joomla 3.x in two steps. First migrate to version 3.5.1.		Joomla! 2.5.28 can only be migrated to the latest Joomla 3.x in two or more steps. First migrate to version 3.5.1. Then you will be offered version 3.6.5. Finally the current version will be available in the Joomla Updates page of the Components menu.

	~~<!--T:41-->~~
	~~Download the Joomla!~~ 3.~~5.1 Upgrade Package (.zip) package at the [https://downloads.joomla.org/us/cms/joomla3/3-5-1 Joomla! 3~~.5.~~1 download page]. You'll find~~ the ~~package~~ in the ~~Update Existing~~ Joomla~~! Installations section. Scroll down to near the bottom~~ of the ~~page. The description reads, "This package is for performing updates from Joomla! 2.5 and previous 3.x releases to 3.5.1." Be sure that you get the Upgrade package and not the Patch package~~.

	<!--T:42-->		<!--T:42-->

Cmb: Added notes about updates to Joomla versions after 3.5.1.

2018-04-18T21:02:53Z

Added notes about updates to Joomla versions after 3.5.1.

← Older revision		Revision as of 21:02, 18 April 2018
Line 132:		Line 132:
	<translate>		<translate>
	<!--T:30-->		<!--T:30-->
	# Click the Clear Cache button.		# Click the Clear Cache button. You will now see a ''A Joomla update was found'' notice for a later version of Joomla. Postpone this update temporarily.
	# Go to {{rarr\|Extensions,Manage,Database}} and click Fix.		# Go to {{rarr\|Extensions,Manage,Database}} and click Fix.
	# In the Extension Manager, go to Discover and see if there are any extensions to install.		# In the Extension Manager, go to Discover and see if there are any extensions to install.
Line 147:		Line 147:
	# Test everything. Back up often.		# Test everything. Back up often.
	# If everything works as expected, turn Error Reporting back to System Default ({{rarr\|System,Global Configuration,Server tab}}). Make sure to Save & Close.		# If everything works as expected, turn Error Reporting back to System Default ({{rarr\|System,Global Configuration,Server tab}}). Make sure to Save & Close.
			# Now you should return to Joomla Updates in the Components menu. Install any updates offered. After the successful installation of version 3.5.1, you will likely be offered version 3.6.5 next. Finally, the Update facility will bring your site up to the current version in the 3.x series.
	</translate>		</translate>
	<translate>		<translate>

Cmb: Added a note about logging in again when the update to version 3.5.1 is complete.

2018-04-18T20:51:58Z

Added a note about logging in again when the update to version 3.5.1 is complete.

← Older revision		Revision as of 20:51, 18 April 2018
Line 127:		Line 127:
	# Cross your fingers, make sure you turned off Remember Me and that you have a backup from just before this point.		# Cross your fingers, make sure you turned off Remember Me and that you have a backup from just before this point.
	# Click the Install the Update button.		# Click the Install the Update button.
	# Watch the spinning circle go round and round ~~and feel the anxiety building. No, just kidding~~. The amount of time the wheel spins is dependent on your site, Internet connection and server speed.		# Watch the spinning circle go round and round. The amount of time the wheel spins is dependent on your site, Internet connection and server speed. The process takes about two minutes. When the update is finished, you will probably be logged out of the Administrator. Sign in again.
	# If all goes well, you will get to a totally new look to the backend administrator panel.</translate>{{-}}[[File:j32-administrator-overview-<translate><!--T:29-->		# If all goes well, you will get to a totally new look to the backend administrator panel.</translate>{{-}}[[File:j32-administrator-overview-<translate><!--T:29-->
	en</translate>.png\|border]]		en</translate>.png\|border]]

Cmb: Corrected page position for the Upgrade package. Added warning note to avoid the Patch package.

2018-04-16T22:08:41Z

Corrected page position for the Upgrade package. Added warning note to avoid the Patch package.

← Older revision		Revision as of 22:08, 16 April 2018
Line 96:		Line 96:

	<!--T:41-->		<!--T:41-->
	Download the Joomla! 3.5.1 Upgrade Package (.zip) package at the [https://downloads.joomla.org/us/cms/joomla3/3-5-1 Joomla! 3.5.1 download page]. You'll find the package in the Update Existing Joomla! Installations section. Scroll ~~about half-way~~ down the page. The description reads, "This package is for performing updates from Joomla! 2.5 and previous 3.x releases to 3.5.1."		Download the Joomla! 3.5.1 Upgrade Package (.zip) package at the [https://downloads.joomla.org/us/cms/joomla3/3-5-1 Joomla! 3.5.1 download page]. You'll find the package in the Update Existing Joomla! Installations section. Scroll down to near the bottom of the page. The description reads, "This package is for performing updates from Joomla! 2.5 and previous 3.x releases to 3.5.1." Be sure that you get the Upgrade package and not the Patch package.

	<!--T:42-->		<!--T:42-->

Sandra97: Marked this version for translation

2017-11-05T08:25:06Z

Marked this version for translation

← Older revision		Revision as of 08:25, 5 November 2017
Line 95:		Line 95:
	Joomla! 2.5.28 can only be migrated to the latest Joomla 3.x in two steps. First migrate to version 3.5.1.		Joomla! 2.5.28 can only be migrated to the latest Joomla 3.x in two steps. First migrate to version 3.5.1.

			<!--T:41-->
	Download the Joomla! 3.5.1 Upgrade Package (.zip) package at the [https://downloads.joomla.org/us/cms/joomla3/3-5-1 Joomla! 3.5.1 download page]. You'll find the package in the Update Existing Joomla! Installations section. Scroll about half-way down the page. The description reads, "This package is for performing updates from Joomla! 2.5 and previous 3.x releases to 3.5.1."		Download the Joomla! 3.5.1 Upgrade Package (.zip) package at the [https://downloads.joomla.org/us/cms/joomla3/3-5-1 Joomla! 3.5.1 download page]. You'll find the package in the Update Existing Joomla! Installations section. Scroll about half-way down the page. The description reads, "This package is for performing updates from Joomla! 2.5 and previous 3.x releases to 3.5.1."

			<!--T:42-->
	Once you have either updated or uninstalled your third-party extensions so that only those compatible with Joomla! 3 remain in your installation, continue with the following steps:		Once you have either updated or uninstalled your third-party extensions so that only those compatible with Joomla! 3 remain in your installation, continue with the following steps:
	</translate>		</translate>