EE 1.14 Upgrade: Running the EE or EE URL Redirect Script header

Magento 1.x Software Support Notice

For Magento Commerce 1, Magento is providing software support through June 2020. Depending on your Magento Commerce 1 version, software support may include both quality fixes and security patches. Please review our Magento Software Lifecycle Policy to see how your version of Magento Commerce 1 is supported.

For Magento Open Source 1.5 to 1.9, Magento is providing software security patches through June 2020 to ensure those sites remain secure and compliant. Visit our information page for more details about our software maintenance policy and other considerations for your business.

EE 1.14 Upgrade: Running the EE or EE URL Redirect Script

Edit this page on GitHub

This article is part of the Magento Enterprise Edition (EE) upgrade documentation. If you're looking for something else, click here to go back to the Magento Knowledge Base.

This article applies to the following Magento EE upgrades:

  • From EE to EE
  • From EE to EE
  • From EE to EE

If your upgrade is not in the preceding list, skip this article and continue with Completing the Magento Upgrade.

This article discusses how to run the URL redirect script that creates HTTP 301 (Moved Permanently) redirects for any duplicate product URL keys. This enables Previous links in your web store to work, for example.

For more information about URL changes, see the EE Release Notes. (Release Notes for the latest release are here.)

To create redirects for your URLs, perform the following tasks in the order shown:

  1. Verifying that cron is Disabled
  2. Running the Script

Verifying that cron is Disabled

It's very important to stop cron jobs from running until after the upgrade script completes. To do so, enter one of the following commands as a user with root privileges:

  • Ubuntu: service crond stop
  • CentOS: service cron stop

Running the Script

This section discusses how to run the URL redirect script to create permanent redirects for any URLs that changed in EE

Note: The time the script takes to run and the amount of memory it uses is directly proportional to the size of your database.

To run the script:

  1. Change to your Magento installation directory.
  2. As the user who owns the files (typically, either root or the web server user), enter the following command:
    php -f shell/url_migration_from_1_13_0_0_to_1_13_0_2.php
  3. Wait while the script runs.
    Messages like the following display to indicate progress:
    [INFO]: Initialization...
    [INFO]: Start url rewrites processing from to ...
    [INFO]: Start root category "Default Category" processing ...
    [INFO]: Start root category "test" processing ...
    [INFO]: Executed in time
  4. If the script succeeded, continue with Completing the Magento Upgrade.


If errors display, check [your Magento install dir]/shell/migration.log for exceptions. Following are errors that might display when you run the migration script:

  • Application is not installed yet, please complete install wizard first
  • PHP Fatal error: Uncaught exception 'PDOException' with message 'SQLSTATE[28000] [1045] Access denied for user 'name'@'hostname' (using password: YES)' in /var/www/magento/lib/Zend/Db/Adapter/Pdo/Abstract.php

If one of these displays, make sure you copied [your Magento install dir]/app/etc/local.xml from your development system to the production system. Edit it if necessary to reference the production database instance. After you copy and edit local.xml, run the URL redirect script again.

Continue your upgrade with Completing the Magento Upgrade.