Skip to content

Commit 22e60d2

Browse files
authored
Merge pull request #1901 from M0rgan01/remove-manual-upgrade
Remove manual upgrade part
2 parents ba7a988 + 86db6b9 commit 22e60d2

File tree

2 files changed

+0
-172
lines changed

2 files changed

+0
-172
lines changed
-14.8 KB
Binary file not shown.

basics/keeping-up-to-date/upgrade.md

Lines changed: 0 additions & 172 deletions
Original file line numberDiff line numberDiff line change
@@ -25,178 +25,6 @@ You can use provided `autoupgrade` module to upgrade your store to the newest ve
2525

2626
Upgrade assistant module (autoupgrade) is fully accessible through `cli`. You can read all the details [here]({{< ref "/8/basics/keeping-up-to-date/upgrade-module/upgrade-cli" >}}).
2727

28-
## Manual upgrade
29-
30-
{{% notice warning %}}
31-
**Important**
32-
33-
Manual upgrade without `autoupgrade` module is not possible at the moment. We recommend using [cli]({{< ref "/8/basics/keeping-up-to-date/upgrade-module/upgrade-cli" >}})
34-
mechanism from the upgrade assistant module.
35-
{{% /notice %}}
36-
37-
### Release download
38-
39-
The first step is to download the latest version on https://github.com/PrestaShop/PrestaShop/releases.
40-
41-
Download can also be done in command line, as done here with the version 8.1.7:
42-
43-
```bash
44-
wget -O prestashop-upgrade.zip https://github.com/PrestaShop/PrestaShop/releases/download/8.1.7/prestashop_8.1.7.zip
45-
```
46-
47-
### Archive extraction
48-
49-
Extract the files from the archive with a tool like 7zip
50-
51-
Note starting from PrestaShop 1.7.0.0, the release package contains a zip file itself, which must be extracted as well.
52-
53-
On a Linux terminal, you can use the command \`unzip\`:
54-
55-
```bash
56-
unzip prestashop-upgrade.zip && unzip prestashop.zip -d upgrade
57-
```
58-
59-
If asked to overwrite the index.php file, answer yes.
60-
Once you have the folders like `classes/`, `modules/`, `themes/`, etc. you may go on the next step.
61-
62-
### Sample files cleanup
63-
64-
Avoid overwrite the production resources (images, conf ...) with the default data. These files and folders can be removed from the new release:
65-
66-
- prestashop-upgrade.zip
67-
- prestashop.zip
68-
- img/
69-
- override/
70-
71-
{{% notice warning %}}
72-
All the other files present in the new release will overwrite the existing files.
73-
All changes you made on the original source code will be lost (this is not recommended, you should never modify the core files).
74-
{{% /notice %}}
75-
76-
Also, rename the “admin” folder to match your shop’s admin folder name. This will prevent an unwanted duplication of the administration content.
77-
78-
### Turning on maintenance mode
79-
80-
The shop will now be modified. As it may cause unexpected behavior for you and your customers during the upgrade, we highly recommend you to turn on maintenance mode during the upgrade.
81-
82-
This can be done in your administration panel:
83-
84-
- On PrestaShop >= 1.7, in Shop parameters > General > Maintenance tab
85-
86-
Adding your IP address will allow you to access your shop while it’s in maintenance mode.
87-
That way, you can make sure everything is working right before allowing your customers to access it again.
88-
89-
### File copy
90-
91-
In this step, we "upgrade" the PrestaShop files by copying the new release content in the existing shop.
92-
93-
### Disable cache
94-
95-
You may have activated a caching system (e.g. Memcache) on your shop. In that case, make sure to disable it in "Advanced Parameters" > "Performance". You can enable it again once the upgrade process is done. You might want to also delete the `var/cache/prod` and `var/cache/dev` folders.
96-
97-
{{% notice warning %}}
98-
**Note about `vendor` folder**: Previous upgrades of PrestaShop 1.7 showed that conflicts may occur when merging the new vendor/ folder with the old one.
99-
To avoid this problem, we recommend to delete this folder in the existing shop before copying the new one.
100-
101-
```bash
102-
rm -rf vendor/
103-
```
104-
105-
{{% /notice %}}
106-
107-
On Windows, copy the new folder content and paste it in your shop folder.
108-
You will get warnings that files already exists in the destination folder. Choose “overwrite” to continue.
109-
110-
On linux, the copy can be done in your terminal:
111-
112-
```bash
113-
cp -rf <path_to_the_new_release>/* <path_to_the_current_shop>/
114-
```
115-
116-
Example:
117-
118-
```bash
119-
cp -rf ~/Downloads/upgrade/* /var/www/html/
120-
```
121-
122-
### Database upgrade
123-
124-
Once the files have been copied, your shop database is ready to be upgraded.
125-
126-
{{% notice note %}}
127-
Some web hosting providers gives you two user accounts to access your database. One with full privileges the other for using in scripts with limited rights. To be able to use this Database upgrade script you have to use the account with full privileges.
128-
{{% /notice %}}
129-
130-
The database migration scripts are stored in the `autoupgrade` module. If not present in your modules folder, download it and unzip it there.
131-
132-
Upgrading the database is a step of the process ran by the upgrade module. It can be independantly triggered from the command line even if the module is uninstalled:
133-
134-
```bash
135-
php modules/autoupgrade/cli-upgrade.php --dir=<path_to_the_admin_folder> --channel=private --action=upgradeDb
136-
```
137-
138-
Example:
139-
```bash
140-
php modules/autoupgrade/cli-upgrade.php --dir=admin-dev --channel=private --action=upgradeDb
141-
```
142-
143-
The minimal store context will be loaded, and SQL requests will be triggered.
144-
145-
SQL requests that encountered an error will be displayed on the log with additional details which can help you understand, fix the issue then re-execute the request manually on your database. In some cases, you may need to restore your database backup and start over.
146-
147-
If successful, a command will be given to run the next step, but can be safely ignored as you did not trigger the whole upgrade process from the module.
148-
149-
#### Execution log
150-
151-
152-
```
153-
INFO - === Step upgradeDb
154-
INFO - Cleaning file cache
155-
INFO - Running opcache_reset
156-
INFO - Initializing required environment constants
157-
INFO - Checking version validity
158-
INFO - Checking connection to database
159-
INFO - Disabling all non native modules
160-
INFO - Updating database data and structure
161-
WARNING -
162-
<div class="upgradeDbError">
163-
[WARNING] SQL 8.0.0
164-
1060 in ALTER TABLE `ps_tab` ADD route_name VARCHAR(256) DEFAULT NULL: Duplicate column name 'route_name'</div>
165-
INFO - Running generic queries
166-
INFO - Database upgrade OK
167-
INFO - Upgrading languages
168-
INFO - Regenerating htaccess
169-
INFO - Cleaning XML files
170-
INFO - Keeping overrides in place
171-
INFO - Keeping current theme
172-
INFO - Cleaning file cache
173-
INFO - Running opcache_reset
174-
INFO - Database upgrade completed
175-
INFO - Database upgraded. Now upgrading your Addons modules...
176-
INFO - Restart requested. Please run the following command to continue your upgrade:
177-
[...]
178-
```
179-
180-
181-
### Cleanup
182-
183-
Before going further, a few things should now be cleaned.
184-
185-
- The `install` folder, used to run the database upgrades, is not needed anymore and can be safely deleted.
186-
- When opening your shop (in the front or back office) on your browser, you may see some visual issues. This can be due to your old assets being still served by a cache.
187-
188-
Reload them by force-refreshing the page (press ctrl+R on Windows / Linux or cmd+R on Mac OS) or clearing your browser’s cache.
189-
190-
### Modules upgrade
191-
192-
Your modules files have been upgraded during the file copy, however many of them may require additional changes on the database. Please check the module page in your Back Office to see if upgrades are waiting to be run.
193-
194-
Go to your administration panel and login. You will notice the version displayed has changed on the login page. Then in the menu, click on the module page to reach your catalog.
195-
196-
On PrestaShop >= 1.7, this page can be found in the Improve &gt;&gt; Modules page, under the tab "Updates":
197-
198-
{{< figure src="../img/image38.png" >}}
199-
20028
## Support service
20129

20230
Doing an upgrade by yourself can be risky. If you feel uncomfortable with doing it on your own, you can find support on [prestashop-project.org](https://www.prestashop-project.org/support/).

0 commit comments

Comments
 (0)