...
- Module version up-to-date (0.6.1-dev). Indicates whether you need to update the update module itself. If you have just installed it, there is little chance you will need to update it.
If you do not have the latest version of the module, a button appears below this field, marked "Install the latest by clicking 'Add from my computer'". Clicking it takes you to the "Modules" page. From there, click on the "Add a module from my computer" link to reveal the pre-filled form. Click the "Download this module" button to start updating the module. Finally, go back to the 1-Click Upgrade configuration page to continue performing pre-upgrade checks. - Root directory is fully writable. Indicates if the read/write permissions are correctly set. If not, you will have to change them, using your FTP client, such as FilezillaFileZilla.
See the Getting Started guide for a quick explanation of how to perform a CHMOD. - Shop deactivated. Indicates if your shop is active or in maintenance mode. You must put your shop in maintenance mode during the whole process (file backup, database backup, automatic upgrade, verification), so as to prevent customers from losing orders... and you from losing clients. The module will not disable your shop for you, but does provide a button leading to the shop preference page:
- PrestaShop 1.4: enable/disable the shop in the main "Preferences" tab.
- PrestaShop 1.5: enable/disable the shop in the "Maintenance" page, under the "Preferences" menu.
- Cache deactivated. Indicates whether your shop's cache is enabled or disabled. You must disable it during the whole process. The module will not do it for you.
- PrestaShop 1.4: enable/disable the cache in the "Performances" page, under the "Preferences" tab.
- PrestaShop 1.5: enable/disable the cache in the "Performance " page, under the "Advanced parameters" menu.
- PHP time limit : disabled. The automatic upgrade can be a lengthy process, as it needs to download the archive from prestashop.com, unzip it on the server, replace the currently installed files, then trigger the update itself. Hence, the PHP settings might be too low, and break the upgrade altogether, mid-process at worse. In this field, PrestaShop gives you an indication of the current PHP settings. Ideally, it should indicate "disabled".
- Options chosen. Before launching the upgrade, you must make sure that you understand the settings. The "Backup options" and "Upgrade options" sections are available at the bottom of the page, and if the settings have not yet been saved, a button takes you to them.
...
Once all the indicators are green, the update button appears in the "Upgrade" section.Wiki Markup
Click the "Upgrade PrestaShop now !" triggers the whole process.
Once the upgrade process is launched, the whole configuration is replaced by two sections: "Activity Log" and "Rollback".
The activity log gives you a detailed journal of what the updater is doing, in a screen you can scroll through:
- Removed files: only the sample files are removed, such as empty override classes and controllers.
- Name of the backup archive: the name follows the
auto-backupfiles_V1.4.8.2_20120627-100310-798d3a69.zipform. - Files added to the backup archive: all the remaining files of your current installation are put into the Zip archive.
- Database tables added to the backup archive: your files are important, but your whole catalog is stored in your database, and is therefore saved in the same archive.
- Removed files: mostly modules, controllers, classes, CSS and JavaScript files. Now that all the files have been saved in the backup archive, they can be safely removed.
- Files copied from the new archive: all the existing files are replaced by their new version.
- Merged translation files.
- Created, deleted, altered and updated database tables.
- Emptied temporary folders: if possible, the upgrader will try and delete the content of the cache folders.
A lot of files are mentioned during the whole process. You do not need to read all the notifications, it's only there for you to peruse in case of error.
You'll know the upgrade is over when the message "upgrade complete. Please check your front-office theme is functional (try to make an order, check theme)" appears in green, along with the following status updatefinal log entry: "Upgrade End of process done. Congratulations! You can now reactive your shop."Indeed, the auto-update does deactivate ".
The upgrader also indicates that you should re-enable your shop, but does not re-activate it automatically. Until you have checked that everything is okay before you do that, you should first check that everything is working in your back-office (everything is functioning correctly: no errors, all your products and images are there...)categories are in place with their images and attached files, etc. Until you have checked that everything is okay in your shop, it is better to keep your shop it from the public eye.
| Tip |
|---|
On first load, pages might look wonky: because your web browser caches files, it is probably using the old CSS files instead of the new ones. Do not hesitate to reload the page several times, or even empty your browser's cache, in order to get the correct interface. |
Once you have made sure your install is still correct, active PrestaShop installation is up and running, you can re-enable your shop using the option in the "Preferences" tab, at the top of the options list, menu, then make tests on your front-office: browse products, sort them, try to order one, etc. In short, go through the entire buying process , in order to make sure that you won't miss a sale.
...
Sadly, not all upgrades are successful – which is the very reason why you should always backup back-up all your files and data, and why PrestaShop performs an additional backup of said files and data by itself (which you should not always count on, obviously. Make your own backup first).
PrestaShop's own backup files are saved on your server, and if it turns out your update has gone badly, you can find them in the "Rollback" section of the "Upgrade" sub-tab.
Backup files are created as soon as the upgrade process is started, and are available immediately in the "Choose your backup" drop-down list.
The "Rollback" button triggers two actions:
- Takes the files from the latest backup, and re-installs them in place of those from the current installed version.
- Takes the data from the latest backup, and re-installs it in place of that from the current database.
The rollback's status is indicated at the same location as the one for the upgrade process.Select the backup archive to which you want to roll back to, and click the "Rollback" button. As with the upgrade process, the whole interface disappears to only leave the "Activity Log" section and the "Rollback" section. You can follow the rollback process in the scrolling journal, and once it is finished, reload the page in order to check that everything is indeed back in place.