...
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
Manual update
| Info |
|---|
Doing a manual update is a long and detailed process, which should only be use out of necessity – for instance, if you cannot make an automatic update. Therefore, manual updates should be reserved to experts. |
Quick instructions
This small section is aimed at those who are already familiar with installing and updating PHP-MySQL web applications on a server. Should you not feel comfortable with their lack of details, you will find detailed instructions in the section following this one.
- Save and Backup Your Current Store
- Deactivate your store ("Preferences" tab).
- Back up your files to your desktop, using your FTP client.
- Back up your database ("Tools/DB Backup" tab, or phpMyAdmin).
- Back up your customized translation ("Export a language" section in "Tools/Translations" tab).
- Getting ready for the new version
- Download and unzip the latest version of PrestaShop: http://www.prestashop.com/en/download.
- Copy the files that you backed up during Step 1 to the "prestashop" folder in your desktop.
- Transfer the "prestashop" folder from your desktop to your FTP server (keeping your original files intact for now).
- Checking before going further:
- Edit
config/settings.inc.phpand change the__PS_BASE_URI__to match to the/prestashop/folder that you just uploaded. Change others settings as needed. - Access the
/prestashop/folder with your browser and check that everything works fine before going to the next step. - Access the administration folder (you might have to rename it).
- Edit
- Starting the Update
- Launch the update script : access the
/prestashop/installfolder, and choose "Update" instead of "Installation".by accessing it with your browser. In version 1.5, it is located at/install/upgrade/upgrade.php. - Verification of all parameters before the update: follow the instructions on screen and make sure your server conforms to the new version technical requirements.
- Finishing the update: once the updater has finished, delete the
/prestashop/installfolder and access both your front and back-office to make sure it works.
- Launch the update script : access the
- QA and Testing
- Import your translations ("Import a language pack manually section in "Tools/Translations" tab).
- Check that the main domain name is correct ("Shops/Shop URLs" tab).
- Regenerate your .htaccess and robots.txt files ("Tools/Generators" tab).
- Check that your theme 's compatibility: http://validator.prestashop.com/still works as expected. If not, you will have to edit its files.
- Tests your shop throughlythoroughly: create accounts, buy products, cancel orders, check invoices, etc...
- Going live with your up-to-date store
- Swapping your updated store and your production store: your shop is updated and fully functional in the
/prestashopfolder, and your older store is deactivated at its normal URL. They both have the same content: products, pages, images, theme, modules, etc. It is time to swap the two. Either:- Move all files from
/prestashopto the normal URL, replacing the old files with the new ones. - Upload your files from your desktop to the old version's URL, replacing the old files with the new ones.
- Move the old files to a new folder (iei.e.
/oldshop) and move the updated shop from the/prestashopfolder to the normal one.
- Move all files from
- Activate your shop ("Preferences" tab).
- Swapping your updated store and your production store: your shop is updated and fully functional in the
...
- Ask your hosting company to back up your files.
Making sure that this backup is fully functional, recent, and more importantly that it reflects the content of your current store.
...
- Copy all of your files from your server to your local computer using an FTP client.
This method is only possible if your hosting provider has provided you with an FTP access to your server. Create a "Backup" folder on your computer, then, using an FTP client (such as the free FileZilla client, which you can download at http://filezilla-project.org/), select all the PrestaShop files and folders on your server (use the Ctrl-A command) and copy them to your "Backup" folder.
Deactivating Your Store
| Warning | ||
|---|---|---|
| ||
Disabling your store is very important. |
Go to your store's back-office, click on the "Preference" tab, then select "No" for the "Enable Shop" option.
In the "Maintenance IP" field, located just below the "Enable Shop" one, enter your own IP address, so that you can keep on using your store during the update. This will allow you to test the store, while still making sure visitors cannot access the website.
In order to find out your IP address, visit this page: http://whatismyipaddress.com/
Backing Up Your Database
You must absolutely back up the whole database for your PrestaShop store.
...
- Ask you hosting provider to back up your database.
Be sure that your database backup is functional, recent, and especially that it contains all of your data for your PrestaShop Store.
...
- Download a copy of your database via phpMyAdmin.
Be sure that your database backup is functional, recent, and especially that it contains all of your data for your PrestaShop Store. If your database is too big, you might receive an error. If that is the case, you will need to contact your hosting provider.
...or...
- Download a Database Backup from your PrestaShop Back-Office.
Visit the "Tools" tab, then the "DB backup" sub-tab. This process will take between 1 and 20 minutes depending on the size of your database. Make sure this backup is functional, recent, and especially that it contains of all the data of your website. Open the zip file and make sure that there are absolutely NO ERRORS before proceeding to the next step.
...
Save the downloaded file into a backup folder of your choice, on your local computer…
Do this for all your custom languages, both those you created/added and those you modified/corrected.
...
| Warning | ||
|---|---|---|
| ||
You will be copying files from your "Backup" directory to the " |
The following folders must be copied from your backup to the recently unzipped /prestashop folder:
...
Using your FTP client, upload the "prestashop" folder to your server.
Checking before going further
...
Step 3 – Starting the Update
Launching the update script
Visit your shop's install script URL; for instance: http://www.myprestashop.com/prestashop/install (Replace "myprestashop.com" with the actual URL of your store, and "prestashop" with the name of the folder that you have just transferred to your FTP).
That URL should show:
- Select "Update" instead of "Installation".
- Read the license agreement, then select the option "I agree to the above terms and conditions".
- Click on the "Next" button.
If you did follow the first step of this guide concerning back-ups, you can click "I certify that I backed up my database and application files. I assume all responsibility for any data loss or damage related to this upgrade." If you did not do the required back-ups or if you did not have a chance to verify the data's integrity and that these backups are functional and recent, please go back to step 1 of this guide.
Verification of all parameters before the update
...
If sufficient rights are assigned to your files and folders, the following page will show:
If not, make sure that the folders' rights are properly configured: change the access rights of the folders marked in red in the install/update tool, directly on your FTP server (make a CHMOD 755 or 775, depending on your hosting provider) then click the "Refresh these settings" button.
In order to perform a CHMOD, using your FTP client, find the folders that have the wrong permission settings, right-click on each of them in order to display their properties (or even better, their access rights), and tick the boxes that are not yet ticked, until a refresh of the "System and Permissions" page gives you only green folder.
...
| Warning | ||||
|---|---|---|---|---|
| ||||
You can check if the update has started in the upper right part of the screen, thanks to the progress bar. Do not leave the page or close your browser; wait for the update to be completed. |
Launching the update script
Visit your shop's install script URL; for instance: http://www.myprestashop.com/prestashop/install/upgrade/upgrade.php (Replace "myprestashop.com" with the actual URL of your store, and "prestashop" with the name of the folder that you have just transferred to your FTP).
That URL should show:
Finishing the update
Once the update is finished, you should see the following screen:
On your FTP server, inside the "prestashop" folder, you should delete:
...
If you did export your custom translations during step 1 (Backups), import them back into your new store by going to the "Tools" tab, then the "Translations" sub-tab.
Verification of the main Domain Name and regeneration of your .htaccess
You should verify that the domain name assigned in the database is indeed the one that you are working with. To do so, visit the "Preferences" tab, then the "SEO & URLs" sub-tab.
You must check the following information:
...
| Tip |
|---|
Testing To-Do List (this is not a complete list, you should do as much testing as possible):
If every test is successful, congratulations! Proceed to step 5. |
Step 5 - Going live with your Up-to-Date Store
...
Swapping your updated store and your production store
...
Congratulations, you have achieved all the essential steps to update your store!
...
- On your FTP Server, select the entire content of the "prestashop" folder and drag'n'-and-drop it to the folder of your production store. This option is fast. If your FTP client offers to do it, ask to have it overwrite all existing files
...
Visit the "Preference" tab in the back-office of your production (now up-to-date) store and click "Yes" for the option "Enable Shop".