59 lines
1.3 KiB
Markdown
59 lines
1.3 KiB
Markdown
# Nextcloud Upgrade
|
|
|
|
Description of the Nextcloud upgrade process.
|
|
|
|
## Upgrade major release
|
|
|
|
Define config.
|
|
|
|
```
|
|
export NEXTCLOUD_CONTAINER=nextcloud01
|
|
export DATABASE_CONTAINER=postgres02
|
|
```
|
|
|
|
Backup volumes and database.
|
|
|
|
```
|
|
docker-volume-backup -a -c $NEXTCLOUD_CONTAINER
|
|
docker-postgres-backup -a -c $DATABASE_CONTAINER
|
|
```
|
|
|
|
Update Nextcloud image tag and deploy.
|
|
|
|
`nextcloud_image: nextcloud:21.0.5-apache`
|
|
|
|
Tail the log while the upgrade is performed
|
|
|
|
```
|
|
docker logs -f $NEXTCLOUD_CONTAINER
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
### Update fails - major versions unsupported
|
|
|
|
**Problem**
|
|
|
|
While upgrading this error occurs.
|
|
|
|
```
|
|
Configuring Redis as session handler
|
|
Initializing nextcloud 22.1.0.1 ...
|
|
Upgrading nextcloud from 20.0.8.1 ...
|
|
Initializing finished
|
|
Nextcloud or one of the apps require upgrade - only a limited number of commands are available
|
|
You may use your browser or the occ upgrade command to do the upgrade
|
|
Setting log level to debug
|
|
Turned on maintenance mode
|
|
Exception: Updates between multiple major versions and downgrades are unsupported.
|
|
Update failed
|
|
Maintenance mode is kept active
|
|
Resetting log level
|
|
```
|
|
|
|
**Solution**
|
|
|
|
You are not allowed to skip a major version while upgrading. Make sure to upgrade incrementally.
|
|
|
|
Further you have to restore the inital state as the config has been changed. Use `docker-volume-restore` to perform this action.
|