Note:
Si vous avez installé DokuWiki grâce au gestionnaire de paquet de votre distribution Linux (par exemple via des paquets Debian ou Fedora), ou tout autre outil similaire, vous devriez utiliser ce même outil pour effectuer la mise à niveau de votre DokuWiki. Les instructions de cette page sont destinées à mettre à niveau une installation manuelle, standard, de DokuWiki telle que décrite sur la page Installeur de DokuWiki uniquement.

Il est très simple de mettre à niveau DokuWiki. L'organisation de ses fichiers évite tout écrasement de contenu utilisateur, ce qui signifie que mettre à niveau n'est en général pas plus compliqué que d'extraire la nouvelle version par dessus la précédente. Vous devriez d'abord essayer les instructions simples données ici, et si vous rencontrez des problèmes ou si vous trouvez que les instructions manquent de précision, alors vous reporter à la section plus bas. Les utilisateurs Mac OS devraient utiliser le Terminal : copier les fichiers par dessus l'original depuis le finder écrase les données et les médias.

• Étape 0: Veillez à ce que votre serveur réponde à la configuration requise.

• Étape 1: Effectuez une sauvegarde complète de votre wiki (mieux vaut prévenir que guérir).

  • tar zcpfv dokuwiki-backup.tar.gz /path/to/dokuwiki

• Étape 2: Lisez le Journal des modifications pour vérifier s'il existe quelque chose de spécial qui mérite votre attention.
• Étape 3: Téléchargez la dernière version depuis la page de téléchargement.

  • cd ~
    wget http://.../dokuwiki-xxxx-xx-xx.tgz

• Étape 4: Extrayez l'archive tar et copiez/téléversez les fichiers par dessus ceux de l'installation précédente. Assurez vous d'écraser tous les fichiers existants quand on vous le demande.

  • tar zxvf dokuwiki-xxxx-xx-xx.tgz
    'cp' -af dokuwiki-xxxx-xx-xx/* /path/to/dokuwiki/

    Les guillemets simple autour de cp assure assure la copie même si un alias est trouvé.

  • vérifiez les permissions et le propriétaire des fichiers. (voir permissions).
• Étape 5: Détruisez tous les fichiers inutiles.
• Étape 6: Mettez à niveau vos greffons et vos thèmes si nécessaire.
• Étape 7: Patientez un jour pour que la notification de mise-à-jour ne disparaisse, ou accélérer la manœuvre en suivant les étapes dans Vérification de mises à jour

Note:
Oui, nous recommandons explicitement d'écraser votre précédente installation. Si vous avez respecté les recommandations concernant les fichiers de configuration, qui indiquent de définir exclusivement vos options dans des fichiers *.local (le gestionnaire de configuration intégré à DokuWiki fait cela automatiquement), alors cette méthode conservera vos réglages. Le même principe s'applique à vos pages et fichiers media. Utiliser la méthode par écrasement vous garantira contre toutes sortes d'ennuis avec le mécanisme de révisions des pages, basé sur l'horodatage des modifications de fichiers.

site Suhosin
Les versions 2015-08-10 “Detritus” et postérieurs nécessitent une intervention spécifique sinon l'édition de page et l'installation et la mise à jour des greffons ne marcheront pas. Veuillez consulter la documentation détaillée installation de DokuWiki.

Les pages suivantes peuvent vous aider à résoudre les problèmes habituels de post-mise à niveau :

• La mise en cache – purger le cache si les choses paraissent étranges ou si des messages d'erreurs apparaissent
• Paramètre de configuration : updatecheck – si la notification de nouvelle version persiste
• Aucune barre d'édition – boutons d'éditions et problèmes javascript
• Problèmes d'indexation (pour la recherche de pages) – si l'outil de recherche ne fonctionne plus ou mal.

Si vous avez des messages d'erreur concernant des dossiers manquants ou non modifiables, vous n'avez probablement pas lu le journal des modifications avec assez d'attention. Lors du passage d'une version antérieure à Angua, à Angua ou une version supérieure, vous devez créer deux dossiers et les rendre modifiables par le serveur web :

• data/media_attic
• data/media_meta

Voici d'autres procédures de mise à jour, écrites par les utilisateurs. Il est possible qu'elles ne soient pas à jour, donc prudence.

• Utiliser le module externe Upgrade Plugin (en anglais)
• Mise à niveau avec un diff (en anglais)
• Mise à jour via APS (en anglais)
• Upgrading using Installatron Applications Installer (en anglais)
• Upgrading by APS (en anglais)
• Upgrading using common Linux commands (copy-paste commands) (en anglais)
• Installing and upgrading via git (en anglais)

Lors d'une mise à niveau depuis une distribution vieille de quelques années ou d'avantage, il es préférable de mettre à niveau par étape, un an à la fois, en utilisant les étapes décrites ci-dessus. Vous pouvez obtenir les vieilles distributions depuis l'archive de téléchargement.