Migration d’un Pydio de production V6.4.2 vers V8.0

Voici les étapes que j’ai réalisé pour la migration d’un Pydio de production. Pour rappel Pydio est un dropbox like à la française très utilisé dans les administrations. Même si le terme de dropbox like est un peu réducteur au vu des dernières fonctionnalités. Il existe une version communautaire et une version pro pour créer un cloud bien à soi.

Contexte.

Nous avons une machine Pydio qui tourne sur une VM (Debian Wheezy). Donc avant la mise à jour, je vous conseille de cloner votre VM de production pour valider les différentes étapes de migration. (Cette étape ne sera pas détaillée ici).

cloner une VM avec Vsphere

Vous pouvez aisément le faire avant votre gestionnaire de VM comme Vsphere par exemple.

cloner une VM avec Vsphere

Sélectionner votre VM, puis bouton droit de la souris -> Cloner.

Prendre un snapshot de sa VM.

Astuce!! Maintenant que vous avez votre machine test avec les IP provisoires, les accès SSH de valider, je vous conseille de faire un snapshot pour revenir en arrière si la mise à jour se passe mal.

Faire un snapshot avec Vsphere

Pour faire un snapshot avec Vsphère, c’est très simple, sélectionner votre VM Snapshot -> Prendre un snapshot.

Liste des snapshot pour une VM avec Vsphere

Si vous voulez gérer plusieurs snapshot lors de vos étapes de mise à jour, vous utiliserez alors le Gestionnaire de snapshot.

Mise à jour de la distribution linux.

Vous devez mettre à jour votre distribution avec les outils idoines. Pare exemple ici pour une Debian

#apt-get update
#apt-get upgrade

mise à jour de debian avec la commande apt-get

Mise à jour de Pydio.

modification de l'adresse de mise à jour de Pydio dans Pydio

Attention !!! Si vous avez une ancienne version de Pydio, vous pourriez avoir une erreur sur l’adresse de mise à jour. La nouvelle adresse est : https://update.pydio.com/pub. Vous pouvez la modifier dans Configurations Globales -> Extensions Importantes -> Plugins d’Actions -> Mise à jour (Pour la version 6.4). Une fois la distribution mise à jour, connectez-vous sur l’interface web en Administrateur sur Pydio.

Liste des mises à jour disponibles sous Pydio

Puis aller dans Administrator -> Paramètres -> Mise à jour. Cliquer sur Démarrer et laisser les mises se faire.

erreur lors de la mise à jour de Pydio à cause de PHP

En fonction de votre version de PHP, vous aurez cette erreur lors des premières mises à jour. Si votre version de PHP est inférieure à la 5.5.9, vous devrez mettre à jour PHP.

Nous allons maintenant procéder à l’installation de PHP V5.6, sur notre Debian, afin de pouvoir effectuer les mises à jour. Ouvrez avec Vim, par exemple, le fichier sources.list

#vim /etc/apt/sources.list

Puis rajouter les deux dépôts suivant :

#deb http://packages.dotdeb.org wheezy-php56-zts all
#deb-src http://packages.dotdeb.org wheezy-php56-zts all

installer PHP 5.6 sur Debian

Ensuite faites une mise à jour avec la commande suivante :

#apt-get update

Si vous obtenez une erreur de signature de ce style :

GPG error: http://packages.dotdeb.org wheezy-php56 Release: The following signatures couldn’t be verified because the public key is not available: NO_PUBKEY E9C74FEEA2098A6E

Vous devrez ajouter les clés avec les commandes suivantes :

#wget http://www.dotdeb.org/dotdeb.gpg
#apt-key add dotdeb.gpg

ajout des clés d'un dépôt pour installer PHP 5.6

Pour installer PHP 5.6.x, utiliser la commande suivante :

#apt-get install php5

Installer PHP 5.6 sur Debian

Une fois l’installation terminée, utiliser la commande suivante pour vérifier la version de PHP :

#php -v

connaitre sa version de php avec la commande php -v

Normalement à la fin de l’installation de PHP, le service apache2 est redémarré. Si non vous pouvez utiliser la commande ci-dessous :

#service apache2 restart

redémarrer le service apache sur Debian

Maintenant reconnectez-vous sur Pydio et relancer la mise à jour.

Attention !!! Si vous avez cette erreur lors de la mise à jour, il va falloir changer les droits du fichier plugins_queries.ser

message: erreur d'analyse XML: données incompréhensibles après l'élément de document dans Pydio

Aller dans /usr/share/pydio/data/cache/. Puis pour le fichier plugins_queries.ser il faudra affecter comme propriétaire et nom de groupe www-data et non root. Ainsi que pour tous les autres fichiers en root.

modification des droits sur des fichiers dans une instalaltion de Pydio

Pour changer le propriétaire d’un fichier, il faut utiliser la commande : chown.

Pour changer le groupe propriétaire d’un fichier, il faut utiliser la commande : chgrp.

Ce qui donne par exemple pour le fichier plugins_queries.ser :

modification du fichier plugins_queries.ser sous Pydio

Dans le répertoire cache de votre installation Pydio, vous devriez avoir des droits semblables :

modification des fichiers Pydio dans le répertoire cache

Vous devriez pouvoir vous connectez sur l’interface Web et poursuivre les mises à jour.

Si tout se passe bien, vous arrivez sur cette page, la mise à jour est terminée :

fin de la mise à jour de Pydio de la V6.4 vers la V8.0

Cliquer sur OK et faites un rafraîchissement de la page, vous devriez découvrir avec stupéfaction la nouvelle interface Pydio V8.0.

nouvelle interface Pydio V8

Erreurs courantes lors d’une migration d’un Pydio.

Attention !!! Une fois sur cette page je vous conseille de vous déconnectez et vous reconnectez pour recharger sa nouvelle interface. Si vous avez des menus incomplets de ce style :

le nom des menu ne s'affiche pas dans Pydio 8 après une mise à jour

Ce problème d’affichage vient du cache de la librairie i18n qu’il faut supprimer.

Pour vider le cache de la librairie i18n, il faut aller dans /usr/share/pydio/data/cache/i18n et supprimer le fichier fr_plugins_messages.ser.

#rm fr_plugins_messages.ser

Déconnectez-vous de votre session et connectez-vous, les menus apparaitrons normalement.

le nom des menu ne s'affiche pas dans Pydio 8 après une mise à jour

Autre problème avec l’envoi de mails. Vous pourriez avoir ce message d’erreur :

erreur d'envoi de mail sous Pydio, failed to open stream: No such file or directory

Pour résoudre ce problème, vous devez installer Composer à l’aide des commandes ci-dessous :

#cd /usr/src
#sudo apt-get install curl php5-cli
#curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

installer composer sous Debian pour Pydio 8

Aller dans ce répertoire /usr/share/pydio/plugins/mailer.phpmailer-lite puis taper la commande suivante en root :

#composer install

installer composer en root avec Debian

Vous devriez ne plus avoir le message d’erreur, lors de l’envoi d’un mail depuis Pydio.

Vérifications.

Viens maintenant le temps de faire quelques points de vérifications sur notre installation.

  • Test1 : vérifier si vos utilisateurs sont toujours présents, pour cela aller dans Dépôts & Utilisateurs -> Utilisateurs

vérifier si les utilisateurs de Pydio sont toujours présents après une mise à jour

  • Test2 : Si votre Pydio est lié à votre Active Directory, vérifier que l’authentification fonctionne correctement. Aller dans Configurations globales -> Options principales -> Authentification -> Driver principal -> Schéma des utilisateurs -> Tester la connexion.

tester la connexion LDAP entre Pydio et votre AD après une mise à jour

Une fois toutes vos modifications de finalisées, je vous conseille de faire un reboot du serveur.

Lors de la mise à jour en V8.0, vous pouvez avoir cette erreur :
file_get_contents(): SSL operation failed with code 1. OpenSSL Error messages: error:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE:certificate verify failed.

Pour résoudre cette erreur, vous devez réaliser ces étapes :

  • Etape 1 : Télécharger le CA à cette adresse avec cette commande : wget http://curl.haxx.se/ca/cacert.pem
  • Etape 2 : Ensuite copier le fichier cacert.pem dans le répertoire suivant avec cette commande : cp cacert.pem /usr/lib/ssl/cert.pem

Impossible d’afficher les caractères avec des accents.

Lors de la mise à jour vers des versions supérieurs le fichier bootstrap_conf.php est remplacé. Si vous rencontrez des problèmes d’affichage avec des noms accentués il faut modifier l’encodage de caractère.

modifier l'encodage des caractères dans le fichier bootstrap_conf.php

Pour cela vous devez éditer le fichier /usr/share/pydio/conf/bootstrap_conf.php et modifier la propriété AJXP_LOCALE et mettre fr_FR.UTF-8 .

Source : https://pydio.com/fr

That’s All.

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *