====== Dokuwiki 升級方式 ======

Dokuwiki 升級方式只要將新版檔案蓋掉原本檔案即可，但是因為有些是參數或設定檔案，有些是預設 Plugin 檔案，所以直接蓋掉有可能會將部份檔案恢復成預設值，所以如果只 patch 差異的部份，這樣的問題將可減低不少。

<note important>
  * 現在已經有 [[http://www.dokuwiki.org/plugin:upgrade|upgrade plugin]] 可直接透過這個 plugin 功能來升級
</note>

===== 環境說明 =====
  * 原本 dokuwiki 安裝的路徑為 /var/www/html/dokuwiki
  * 預計更新成 2009-02-14 的版本

===== 確認目前版本 =====
<code sh>
cd /var/www/html/dokuwiki
cat VERSION
</code>
<file>
2007-06-26b
</file>

===== 產生新版本與原有版本差異檔 =====
<code sh>
cd /tmp
mkdir WikiUpgrade
cd WikiUpgrade
wget http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2007-06-26b.tgz
wget http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2009-02-14.tgz
tar -xzf dokuwiki-2007-06-26b.tgz
tar -xzf dokuwiki-2009-02-14.tgz
diff -Naur dokuwiki-2007-06-26b dokuwiki-2009-02-14 > doku.diff
</code>

===== 備份原本檔案與升級 =====
==== 備份原本檔案 ====
<code sh>
cd /var/www/html
tar -cf dokuwiki.tar dokuwiki/
gzip dokuwiki.tar
</code>
  * 備份檔案就是 dokuwiki.tar.gz
==== 測試升級 ====
<code sh>
cd /var/www/html/dokuwiki
patch -p1 </tmp/WikiUpgrade/doku.diff --dry-run
</code>

==== 正式升級 ====
<code sh>
cd /var/www/html/dokuwiki
patch -p1 </tmp/WikiUpgrade/doku.diff
</code>

===== 清除更版訊息 =====
<code sh>
cd /var/www/html/dokuwiki/data/cache
echo "" >　messages.txt
</code>

這樣要求升級的訊息就會消失

===== 參考資料 =====
  * http://wiki.splitbrain.org/wiki:install:alternativeupgradedetail

{{tag>dokuwiki upgrade}}