Skip to main content
Advanced Settings

Step 1 supportive article: The list of advanced settings for the XC4 to XC5 migration procedure.

Olga Tereshina avatar
Written by Olga Tereshina
Updated over 2 years ago

The migration of data from X-Cart 4 to X-Cart 5 is based on model importing. The data is processed in chunks. The process may take a while, depending on the volume of data to be transferred.

To fine-tune the process, use the following settings available in the <X‑Cart>/etc/config.local.php config file in your X-Cart 5 installation:

  • migration_chunk_length defines the number of records to be processed during one iteration. The greater the value, the faster the process will go, but it will be more likely that the server will time out. You need to find a sweet spot in this setting’s value if you do care about minimizing the time of data transfer;

  • disable_secret_check disables blowfish key check while connecting to DB. Useful when you need to save time and do not care if user passwords are not migrated;

  • disable_ssl_check disables SSL check for URL-related operations. Set it to true if your SSL certificate causes any problems while opening pages via HTTPS;

  • disable_follow_redirects disables following HTTP redirects when processing URLs. You can redirect the URLs to other addresses, and the migration wizard will follow these redirects to access the actual content of the URL. If you want to disable such following, set this option to true;

  • disable_images_import disables import of all images;

  • enable_copy_ext_images enables the copying of external images to the X-Cart 5 location. If your X‑Cart 5 is on one server, X‑Cart 4 is on another, and this option is enabled, X‑Cart 5 will copy images to its server by downloading it.

If the <X-Cart>/etc/config.local.php file does not exist in your X-Cart 5 store, you must create it to use the settings above. Below is an example of such a file.

; <?php /* 
; WARNING: Do not change the line above
;
; ---------------------------------
; | X-Cart 5 configuration file |
; ---------------------------------

[migration_wizard]
;migration_chunk_length = 20
;disable_secret_check = true
;disable_ssl_check = true
;disable_follow_redirects = true
;disable_images_import = true
;enable_copy_ext_images = true

; WARNING: Do not change the line below
; */ ?>

Uncomment the settings you want to use by removing the ‘;’ symbol in front of it.

Related pages:

Did this answer your question?