Piwik Update 1.11.1

De EjnTricks

Cet article présente la mise à jour de Piwik en version 1.11.1. Sur le site officiel, deux méthodes sont présentées:

  • Mise à jour directement depuis l'application.
  • Mise à jour par déploiement de la nouvelle version.

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


Download-icon.png Téléchargement

L'application est téléchargée, en version 1.11.1, dans le répertoire /var/opt/piwik.

#sudo wget -O /var/opt/piwik/piwik-1.11.1.tar.gz http://builds.piwik.org/piwik-1.11.1.tar.gz


System-Install-icon.png Installation

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

#sudo tar --transform 's/^piwik/1.11.1/' -C /var/opt/piwik -xzvf /var/opt/piwik/piwik-1.11.1.tar.gz

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

#sudo rm /var/opt/piwik/piwik-1.11.1.tar.gz


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/piwik/1.11.1


Icon ACL.png Sécurisation

Au niveau de la procédure d'installation, il est indiqué de placer les permissions pour tous les comptes. Cependant, cela présente un problème évident de sécurité. Les droits mis en place seront uniquement pour le compte d'exécution du serveur Web, soit www-data dans le cadre de cet article.

#sudo chmod -R go-rwx /var/opt/piwik/1.11.1


Icon-Configuration-Settings.png Configuration

Sur la procédure de mise à jour officielle, il est recommandée de sauvegarder le fichier de configuration. Du fait de cette procédure de mise à jour, il suffit de copier depuis le précédent emplacement, dans la nouvelle instance.

#sudo cp /var/opt/piwik/1.11/config/config.ini.php /var/opt/piwik/1.11.1/config/config.ini.php
#sudo chown www-data:www-data /var/opt/piwik/1.11.1/config/config.ini.php
#sudo cp /var/opt/piwik/1.11/config/.htaccess /var/opt/piwik/1.11.1/config/.htaccess
#sudo chown www-data:www-data /var/opt/piwik/1.11.1/config/.htaccess

Dans le cadre de cette étude, un logo personnalisé avait été mis en place. Il faut donc le recopier dans la nouvelle instance.

#sudo cp /var/opt/piwik/1.11/themes/.htaccess /var/opt/piwik/1.11.1/themes/.htaccess
#sudo cp /var/opt/piwik/1.11/themes/logo-header.png /var/opt/piwik/1.11.1/themes/logo-header.png
#sudo cp /var/opt/piwik/1.11/themes/logo.png /var/opt/piwik/1.11.1/themes/logo.png
#sudo chown www-data:www-data /var/opt/piwik/1.11.1/themes/.htaccess
#sudo chown www-data:www-data /var/opt/piwik/1.11.1/themes/logo-header.png
#sudo chown www-data:www-data /var/opt/piwik/1.11.1/themes/logo.png


Plugin-icon.png Plugins

Sur la précédente version, des plugins ont été mis en place. Etant référencé dans la base de données, il est impératif que ceux-ci soient de nouveau disponibles dans la nouvelle instance. Il n'est pas nécessaire de les installer de nouveau, mais tout simplement de mettre en place les différents liens. En effet, lors de leur installation, il a été choisi de les externaliser. Trois plugins avaient été mis en place:

Les liens sont donc placés dans le répertoire extensions de piwik.

#sudo ln -s /var/datas/piwik/extensions/GeoIPMap /var/opt/piwik/1.11.1/plugins/GeoIPMap
#sudo chown -h www-data:www-data /var/opt/piwik/1.11.1/plugins/GeoIPMap
#sudo ln -s /var/datas/piwik/extensions/UserSettingsExt /var/opt/piwik/1.11.1/plugins/UserSettingsExt
#sudo chown -h www-data:www-data /var/opt/piwik/1.11.1/plugins/UserSettingsExt

Le plugin GeoIp, inclus dans l'application depuis la version 1.9, nécessite un accès au fichier GeoLiteCity.dat dans le répertoire misc. Lors de la mise à jour de la version 1.9, il a été expliqué la mise en place d'un lien pour accéder à ce fichier. En effet, les données sont téléchargées et mutualisées avec d'autre application. Ce lien est donc reproduit.

#sudo ln -s /var/datas/maxmind/GeoLiteCity.dat /var/opt/piwik/1.11.1/misc/GeoLiteCity.dat
#sudo chown -h www-data:www-data /var/opt/piwik/1.11.1/misc/GeoLiteCity.dat

Une restriction d'accès était mise en place dans la précédente version. Celle-ci est reproduite.

#sudo cp /var/opt/piwik/1.11/plugins/.htaccess /var/opt/piwik/1.11.1/plugins/
#sudo chown www-data:www-data /var/opt/piwik/1.11.1/plugins/.htaccess


Configuration-icon.png Publication sous Apache

Lors de l'installation initiale, la publication sous Apache pointait sur le lien /var/opt/piwik/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/piwik/installed
#sudo ln -s /var/opt/piwik/1.11.1 /var/opt/piwik/installed
#sudo chown -h www-data:www-data /var/opt/piwik/installed


Des fichiers ne sont pas nécessaires et donc supprimés.

#sudo rm /var/opt/piwik/1.11.1/How\ to\ install\ Piwik.html
#sudo rm /var/opt/piwik/1.11.1/README.md
#sudo rm /var/opt/piwik/1.11.1/misc/How\ to\ install\ Piwik.html


Bug-icon.png Label sur locale Française

Lors de l'installation initiale, des erreurs ont été constatés dans les messages. Certains ont été corrigés mais pas tous. Le message Le mot clef %1$s a été a été noté %2$s dans la page de résultats de recherche %3$s pour ce visiteur est toujours erroné.

Tous les messages sont externalisés dans des dictionnaires de langue, placés dans le sous répertoire lang de l'installation. Dans le cas de la locale Française, le fichier modifié est fr.php.

Patch des traductions: fr.php

Attention, dans cette version, il y a un outil de contrôle d'intégrité des fichiers. Et celui-ci va indiquer une différence sur la taille du fichier fr.php attendue et celle suite à la modification.


Viewer icon.png Voir aussi

Documentation officielle: https://matomo.org/docs/update

Release Notes: https://matomo.org/changelog/piwik-1-11/ }