OwnCloud Update 10.0.0

De EjnTricks
Révision de 22 décembre 2019 à 15:41 par Etienne (discussion | contributions)

(diff) ← Version précédente | Voir la version courante (diff) | Version suivante → (diff)

Cet article présente la mise à jour de OwnCloud en version 10.0.0.

Dans le cadre de cet article, la mise à jour est effectuée manuellement avec le même principe que pour l'installation initiale. Théoriquement, la mise à jour est simple. Cependant il est nécessaire de n'oublier aucune étape.


Hand-icon.png Votre avis

Nobody voted on this yet

 You need to enable JavaScript to vote


Warning-icon.png Incompatibilités

Cette mise à jour s'effectue sur une version majeure et beaucoup d'applications tierces ne sont plus supportées. Dans le cadre de cette installation, il a été nécessaire de les désactiver comme indiqué lors de la mise à disposition.

Si un annuaire LDAP est mis en place, celui-ci ne sera plus accessible et il devient impossible de se connecter avec les comptes LDAP.


Download-icon.png Téléchargement

L'application est téléchargée dans le répertoire /var/opt/owncloud.


System-Install-icon.png Installation

L'application va être installée sous /var/opt/owncloud, avec modification de l'emplacement racine pour être 10.0.0.

#sudo tar --transform 's/^owncloud/10.0.0/' -C /var/opt/owncloud -xjvf /var/opt/owncloud/owncloud-10.0.0.tar.bz2

Le fichier téléchargé peut être supprimé.

#sudo rm /var/opt/owncloud/owncloud-10.0.0.tar.bz2


Icon File Owner.png Propriétaire fichiers

L'installation a été réalisée avec le compte root. Il est préférable de donner la propriété au compte de démarrage du serveur web, soit www-data dans le cadre de cette installation.

#sudo chown -R www-data:www-data /var/opt/owncloud/10.0.0


Icon ACL.png Sécurisation

Après avoir modifié le propriétaire des fichiers, il est conseillé de positionner des droits restrictifs afin que seul le propriétaire puisse accéder à ceux-ci.

#sudo chmod -R go-rwx /var/opt/owncloud/10.0.0


Icon-Configuration-Settings.png Configurations complémentaires

Process-icon.png Fichier de configuration

OwnCloud est configuré avec le fichier config/config.php dans le répertoire d'installation. Celui-ci a été externalisé sous /var/opt/owncloud/common/config. Le lien doit être mis en place pour la nouvelle instance.

#sudo rm -rf /var/opt/owncloud/10.0.0/config
#sudo ln -s /var/opt/owncloud/common/config /var/opt/owncloud/10.0.0/config
#sudo chown -h www-data:www-data /var/opt/owncloud/10.0.0/config

Plugin-icon.png Emplacements applications tierces

Sur la documentation officielle, il est recommandé de démarrer la nouvelle version sans les applications tierces activées. Cependant dans le cadre de cette mise à jour, elles sont référencées tout de suite.

Les applications tierces sont externalisées afin de ne pas avoir à les recopier dans le répertoire de l'instance à chaque montée de version, comme décrit dans l'article d'ajout d'applications.

Le répertoire /var/opt/owncloud/common/apps-enabled est utilisé pour référencer les applications mises à dispositions, comme décrit dans le paragraphe d'activation des applications tierces.

#sudo ln -s /var/opt/owncloud/common/apps-enabled /var/opt/owncloud/10.0.0/exapps
#sudo chown -h www-data:www-data /var/opt/owncloud/10.0.0/exapps


Run-icon.png Activation

Robot-icon.png Mode maintenance

Dans la documentation officielle, il est recommandé de passer en mode maintenance durant la mise à jour. Ceci peut s'effectuer à l'aide de la commande occ.

#sudo -u www-data php /var/opt/owncloud/installed/occ maintenance:mode --on

Cette commande entraîne la modification du fichier config.php, emplacement /var/opt/owncloud/common/config/config.php dans le cadre de cette installation, en ajoutant la configuration suivante.

 'maintenance' => true

Cette modification peut également être réalisée manuellement.

Une fois le mode activé, il n'est plus possible de se connecter à l'application. Un message est présenté aux utilisateurs indiquant que le site est en maintenance.


Une fois l'installation terminée, il faut désactiver le mode en positionnant la valeur à false sur maintenance. Cependant, dans le cadre de cette mise à jour, cette étape n'est pas nécessaire. En effet, l'activation sera réalisée en modifiant le lien mis à disposition pour Apache.

Configuration-icon.png Publication sous Apache

Lors de l'installation initiale, la publication sous Apache pointait sur le lien /var/opt/owncloud/installed. Ce principe permet d'activer la nouvelle version rapidement, sans toucher au paramétrage de Apache. Il est juste nécessaire de modifier le répertoire pointé par le lien.

#sudo rm /var/opt/owncloud/installed
#sudo ln -s /var/opt/owncloud/10.0.0 /var/opt/owncloud/installed
#sudo chown -h www-data:www-data /var/opt/owncloud/installed

Lors du premier accès après installation de la nouvelle version, l'utilisateur est informé de la nécessité de mettre à jour la base de données.


Cependant, l'installation en cours est trop volumineuse pour être mise à jour depuis l'interface. Ceci doit être réalisé en ligne de commande comme indiqué dans procédure officielle

#sudo -u www-data php /var/opt/owncloud/installed/occ upgrade
ownCloud 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
Set log level to debug
Turned on maintenance mode
Repair warning: You have incompatible or missing apps enabled that could not be found or updated via the marketplace.
Repair warning: please install app manually with tarball or disable them with:
occ app:disable apporder
occ app:disable calendarplus
occ app:disable direct_menu
occ app:disable logreader
occ app:disable ownnote
occ app:disable quicknotes
occ app:disable serverinfo
occ app:disable tasksplus
occ app:disable user_ldap
OC\RepairException: Upgrade is not possible
Update failed
Maintenance mode is kept active
Reset log level

Dans le cadre de cette installation, des extensions ne sont plus supportées. Il faut les désactiver comme indiqué dans la trace d'exécution.

#sudo -u www-data php /var/opt/owncloud/installed/occ app:disable apporder
apporder disabled
#sudo -u www-data php /var/opt/owncloud/installed/occ app:disable calendarplus
calendarplus disabled
#sudo -u www-data php /var/opt/owncloud/installed/occ app:disable direct_menu
direct_menu disabled
#sudo -u www-data php /var/opt/owncloud/installed/occ app:disable logreader
logreader disabled
#sudo -u www-data php /var/opt/owncloud/installed/occ app:disable ownnote
ownnote disabled
#sudo -u www-data php /var/opt/owncloud/installed/occ app:disable quicknotes
quicknotes disabled
#sudo -u www-data php /var/opt/owncloud/installed/occ app:disable serverinfo
serverinfo disabled
#sudo -u www-data php /var/opt/owncloud/installed/occ app:disable tasksplus
tasksplus disabled
#sudo -u www-data php /var/opt/owncloud/installed/occ app:disable user_ldap
user_ldap disabled

Une fois désactivées, la mise à jour peut être réalisée sans erreur.

#sudo -u www-data php /var/opt/owncloud/installed/occ upgrade
ownCloud 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
Set log level to debug
Updating database schema
Updated database
Updating <activity> ...
Updated <activity> to 2.3.3
Updating <dav> ...
Updated <dav> to 0.2.8
Updating <files_external> ...
Updated <files_external> to 0.7.0
Drop old database tables

 Done
 28/28 [============================] 100%
Remove old (< 9.0) calendar/contact shares
 Done
 4/4 [============================] 100%
Fix permissions so avatars can be stored again
 Done
 2/2 [============================] 100%
Move user avatars outside the homes to the new location
 Done
 1/1 [============================] 100%
Starting code integrity check...
Finished code integrity check
Update successful
Maintenance mode is kept active
Reset log level

Warning-icon.png Attention, le message de fin indique clairement que l'instance reste en mode maintenance. Elle n'est donc pas disponible tout de suite.


Copy-icon.png Déclaration types mimes

Dans le cadre de l'utilisation de l'application GPX Viewer, le type mime GPX devait être ajouté sur les précédentes versions. Or cette application est désactivée, car incompatible. IL n'est donc pas nécessaire de modifier le fichier /var/opt/owncloud/10.0.0/resources/config/mimetypemapping.dist.json.


Plugin-icon.png Applications tierces

A partir de cette version, les applications tierces sont disponibles sous un "Marketplace" https://marketplace.owncloud.com.

Pour cette version, une application utilisée doit être migrée.

Logo Files external ftp.jpg Files external FTP

Copy-icon.png Déclaration types mimes

Dans le cadre de l'utilisation de l'application GPX Viewer, le type mime GPX doit être ajouté afin de déclencher les fonctionnalités. Il faut modifier le fichier pour y ajouter le nouveau format.

        "gif": ["image/gif"],
        "gpx": ["application/gpx"],
        "gz": ["application/x-gzip"],
#sudo rm /var/opt/owncloud/common/resources/config/mimetypemapping.dist.json
#sudo mv /var/opt/owncloud/installed/resources/config/mimetypemapping.dist.json /var/opt/owncloud/common/resources/config/mimetypemapping.dist.json
#sudo ln -s /var/opt/owncloud/common/resources/config/mimetypemapping.dist.json /var/opt/owncloud/installed/resources/config/mimetypemapping.dist.json
#sudo chown -h www-data:www-data /var/opt/owncloud/installed/resources/config/mimetypemapping.dist.json

Attention, suite à la mise à jour, les types mime des fichiers peuvent être modifiés et ne sont plus valides dans le cas des GPX. Si tel est le cas, il faut modifier la table oc_filecache comme explicité dans l'article suivant.

Icon ACL.png Sécurisation post install

Il se peut que des applications tierces soient mises à jour automatiquement. Dans ce cas, elles sont déployées dans le répertoires apps de l'instance mais avec les permissions par défaut, qi ne sont pas forcément celles mises en place, à savoir.

  • 700 pour les répertoires;
  • 600 pour les fichiers.

Il est donc préférable de relancer la mise à jour des droits.

#sudo chmod -R go-rwx /var/opt/owncloud/10.0.0/apps


Robot-icon.png Mise en ligne

Il faut ensuite désactiver le mode maintenance.

#sudo -u www-data php /var/opt/owncloud/installed/occ maintenance:mode --off
ownCloud is in maintenance mode - no app have been loaded

Maintenance mode disabled


Viewer icon.png Voir aussi

Documentation officielle: https://doc.owncloud.org/server/10.0/admin_manual/maintenance/upgrade.html

https://doc.owncloud.org/server/10.0/admin_manual/configuration_server/occ_command.html#command-line-upgrade