Files
Wiki/OpenUpgrade.md
T

140 lines
3.1 KiB
Markdown

# OpenUpgrade
Website: <https://oca.github.io/OpenUpgrade/>
A step by step guide to upgrade an [[Odoo Community Edition]] using [[Odoo Development]].
## Upgrade from 13.0 to 14.0
* Define settings
```bash
DATABASE=janikv
FROM=13.0
TARGET=14.0
```
* Start local development environment
```bash
task checkout $FROM
# with docker
task start
# or native
task start db,native
```
* Clear the local filestore and database
```bash
# with docker
docker-odoo-drop $DATABASE
# or native
task drop-db $DATABASE
task clear-filestore $DATABASE
```
* Export remote database to local folder and restore it
```bash
odoo-backup -d $DATABASE -o tmp/$DATABASE.zip ...
# with docker
docker-odoo-restore -r -f tmp/$DATABASE.zip
# or native
odoo-restore -r -f tmp/$DATABASE.zip
```
* Stop the server, checkout target and clone openupgrade scripts
```bash
task checkout $TARGET
git clone git@github.com:OCA/OpenUpgrade.git tmp/openupgrade
cd tmp/openupgrade && git checkout $TARGET && ../..
echo "\ntmp/openupgrade" >> config/addons_path
task update-config
```
* Remove unsupported modules
```bash
# WIP: with docker
# or native
task remove-module $DATABASE web_diagram
task remove-module $DATABASE auth_oauth_multi_token
```
* Run the upgrade scripts
```
# WIP: with docker
docker exec odoo odoo-bin -d $DATABASE --config /etc/odoo/odoo.conf --update=all --stop-after-init --load=base,web,openupgrade_framework
# or native
source task source
./odoo/odoo-bin -d $DATABASE --config config/odoo-native.conf --update=all --stop-after-init --load=base,web,openupgrade_framework
```
* Clear the assets, run the server and check the log
```
docker-odoo-clear-assets -c db -d $DATABASE
task start db,native
```
* Remove unsupported views
```bash
task start-shell $DATABASE
```
See [[Odoo Shell Scripts]] for details
* Backup the new database
```bash
odoo-backup -d $DATABASE -o tmp/$DATABASE-$TARGET.zip
```
* Deploy the Odoo 14 instance
* Drop the current database, restore the new dabase and tail the server log
```bash
odoo-drop -d $DATABASE ...
odoo-restore -f tmp/$DATABASE-$TARGET.zip -r -d $DATABASE ...
```
### Troubleshooting
#### Style error
**Problem**
After restoring the database, the assets cannot be loaded.
```
Style error
The style compilation failed, see the error below. Your recent actions may be the cause, please try reverting the changes you made.
Could not get content for /web_responsive/static/src/css/search_view_mobile.scss defined in bundle 'web.assets_backend'.
Could not get content for /web_responsive/static/src/css/kanban_view_mobile.scss defined in bundle 'web.assets_backend'.
Error: no mixin named o-search-options-dropdown-custom-item
on line 18239 of /stdin
>> @include o-search-options-dropdown-custom-item;
---------------------^
This error occured while compiling the bundle 'web.assets_backend' containing:
- /web/static/lib/bootstrap/scss/_functions.scss
- /web/static/lib/bootstrap/scss/_mixins.scss
- /web/static/src/scss/bs_mixins_overrides.scss
```
**Solution**
Make sure the same version of `web_responsive` is deployed as locally.