Nextcloud / LanguageTool

Upgrading Nextcloud

Before Upgrading

Before upgrading, read the Guide and Critical Changes if upgrading to the next major release.

Note that to upgrade to the next major release, first upgrade to the latest minor release of the current major release, then upgrade to the latest minor release of the next major release (do not skip major releases, upgrade by one major release only), than repeat this procedure until the latest minor release of the latest major release.

Make sure no database version upgrade is required, and if so, perform the MariaDB upgrade procedures after backup beforehand.

Upgrading NGINX

Moreover, update the nginx ConfigMap to the newest nginx.conf.

Change the following sections in nginx.conf to customize to the cluster:

Change app:9000 to 127.0.0.1:9000:

resolver 127.0.0.11 valid=2s;
upstream php-handler {
    zone backends 64k;
    server 127.0.0.1:9000 resolve;
}

Change and add the below values:

# set max upload size and increase upload timeout:
client_max_body_size 0;
client_body_timeout 86400s;
fastcgi_read_timeout 86400s;
fastcgi_send_timeout 86400s;
fastcgi_buffers 64 4K;

Deployment upgrade

NOTE: In order to run occ: use the bash shell started by runuser -u www-data -- /bin/bash or su -s /bin/bash www-data, or run runuser -u www-data -- php occ [command] or su -s /bin/sh -c 'php occ [command]' www-data inside the nextcloud container of the nextcloud-fpm pod.

Before upgrading, update all Apps on Nextcloud with php occ app:update --all beforehand, as this will lead to substantially reduced server downtime.

To upgrade, change all nextcloud images to the latest revision of the minor version (unless upgrading to the next major version, follow the major release upgrade procedures above), and wait for the pod to be restarted.

Because of database initialization, the startup for Nextcloud may take some time. Read the upgrade logs inside the pod container to conclude, and use php occ upgrade if instructed.

After the upgrade, you need to go to Settings Overview page and run the specified long running steps manually (for example, php occ db:convert-mysql-charset, php occ db:convert-filecache-bigint, php occ db:add-missing-columns, php occ db:add-missing-indices, php occ db:add-missing-primary-keys), and finally run php occ maintenance:repair --include-expensive in all cases.

Upgrading Collabora and LanguageTool

Collabora and LanguageTool should only require a restart to upgrade to the latest tag. Read https://hub.docker.com/r/collabora/code and https://hub.docker.com/r/meyay/languagetool to see if there are breaking changes if the container suddenly does not work.