Przed dokonaniem aktualizacji, powinieneś zawsze zajrzeć do listy zmian by dowiedzieć się o ewentualnych problemach, które możesz napotkać.

Informacja o wersji DokuWiki jaką używasz można znaleźć w kodzie źródłowym na każdej wygenerowanej przez niego stronie - powinno tam występować wyrażenie podobne do tego <meta name=„generator” content=„DokuWiki 2005-02-06” />.

Najprostszym sposobem aktualizacji jest wykonanie następujących kroków:

1. Stwórz kopię zapasową całego wiki (lepiej być przezornym, niż później żałować)
2. Pobierz i Rozpakuj nową wersję
3. Przegraj wszystkie pliki do katalogu ze starą instalacją DokuWiki, nadpisując już istniejące
4. Usuń stare pliki, które nie będą już potrzebne (Zobacz niżej listę plików)
5. Jeżeli zajdzie potrzeba, napraw uprawnienia
6. Zaktualizuj wtyczki

Wskazówka: Jeżeli dokonano aktualizacji ze starszej wersji i zauważono brak logowania, należy sprawdzić czy przypadkiem w pliku conf/local.php nie brakuje linii

$conf['useacl'] = 1;

. Najczęściej zdarza się to gdy modyfikowany jest plik conf/dokuwiki.php w celu zapisania lokalnych ustawień zamiast conf/local.php. Zalecane jest również przejrzenie innych wpisów w starym conf/dokuwiki.php.

Poniżej znajduje się lista plików, które zostały usunięte w aktualnych wydaniach. Zalecane jest ich usunięcie w razie gdy występują one nadal.

# removed in 2007-06-26
inc/parser/wiki.php
lib/images/interwiki/bug.gif
lib/plugins/base.php
lib/plugins/plugin/inc
lib/plugins/plugin/inc/tarlib.class.php
lib/plugins/plugin/inc/zip.lib.php
lib/scripts/domLib.js
lib/scripts/domTT.js

Można użyć poniższego kodu powłoki bash do ich usunięcia:

#!/bin/sh
poistuneet="
inc/parser/wiki.php 
lib/images/interwiki/bug.gif 
lib/plugins/base.php 
lib/plugins/plugin/inc 
lib/plugins/plugin/inc/tarlib.class.php 
lib/plugins/plugin/inc/zip.lib.php 
lib/scripts/domLib.js 
lib/scripts/domTT.js
"
 
for tiedosto in $poistuneet; do
  if [ -f ./$tiedosto ]; then
      echo "Will delete $tiedosto";
      rm $tiedosto
  fi
done

# removed in 2006-11-06
inc/admin_acl.php
inc/lang/lt/stopwords.txt
inc/magpie
inc/magpie/rss_cache.inc
inc/magpie/rss_fetch.inc
inc/magpie/rss_parse.inc
inc/magpie/rss_utils.inc
lib/exe/media.php
lib/tpl/default/mediaedit.php
lib/tpl/default/media.php
lib/tpl/default/mediaref.php
 
# removed in 2006-03-09
data/pages/wiki/playground.txt
inc/auth/ldap.php
inc/auth/mysql.php
inc/auth/pgsql.php
inc/auth/plain.php
inc/lang/ca/admin_acl.txt
inc/lang/cs/admin_acl.txt
inc/lang/da/admin_acl.txt
inc/lang/de/admin_acl.txt
inc/lang/en/admin_acl.txt
inc/lang/et/admin_acl.txt
inc/lang/eu/admin_acl.txt
inc/lang/fr/admin_acl.txt
inc/lang/it/admin_acl.txt
inc/lang/ja/admin_acl.txt
inc/lang/lt/admin_acl.txt
inc/lang/lv/admin_acl.txt
inc/lang/nl/admin_acl.txt
inc/lang/no/admin_acl.txt
inc/lang/pl/admin_acl.txt
inc/lang/pt/admin_acl.txt
inc/lang/vi/admin_acl.txt
inc/lang/zh-tw/admin_acl.txt
inc/parser/spamcheck.php
lib/images/favicon.ico
lib/images/thumbup.gif
lib/images/toolbar/code.png
lib/images/toolbar/empty.png
lib/images/toolbar/extlink.png
lib/images/toolbar/fonth1.png
lib/images/toolbar/fonth2.png
lib/images/toolbar/fonth3.png
lib/images/toolbar/fonth4.png
lib/images/toolbar/fonth5.png
lib/images/toolbar/list.png
lib/images/toolbar/list_ul.png
lib/images/toolbar/rule.png
lib/tpl/default/images/interwiki.png

Gdy napotkane zostaną problemy w zachowaniu DokuWiki po dokonaniu aktualizacji, powinno się usunąć pliki z bufora w data/cache/. Należy również sprawdzić czy przeglądarka internetowa nie buforuje starych arkuszy styli lub plików JavaScript poprzez ich przeładowanie (Shift-F5 lub Shift-R w większości przeglądarek).

Powiązane strony:

• update_check – gdy nadal występuje powiadomienie o nowej wersji
• toolbar – problemy z JavaScript i skrótami klawiszowymi

Poniżej znajduje się kilka innych opisów aktualizacji, spisanych przez użytkowników. Mogą one być już nieaktualne.

• Aktualizacja poprzez stworzenie diff-ów