====== DokuWiki のアップグレード ======

注：Linuxディストリビューションのパッケージマネージャ
（例えば [[install:Debian|Debian]] や [[install:Fedora|Fedora]] パッケージの使用）
や似たようなツールによって Dokuwiki をインストールした場合、
Dokuwiki のアップグレード時にも同じツールを使用する必要があります。
このページの説明は、[[ja:install|インストール]] ページで説明したように、
標準的な手動インストールされた Dokuwiki を対象としています。

DokuWikiのアップグレードは非常に簡単です。
ファイル構成は、ユーザーコンテンツの上書きを回避するように編成されています。
これは、アップグレードが単純に新しいバージョンを解凍して古いものを上書きすることを意味します。
まず最初に、ここの簡単な手順を試してみてください。
問題が発生した場合、手順に対する説明が不十分な場合、下の章で詳細を読んで下さい。

  * **手順１：** DokuWikiのバックアップを作成する。必須ではありませんが、推奨です。

  * **手順２：** 特別な考慮事項がある場合、[[ja:changes|更新履歴]] を読む。

  * **手順３：** [[http://download.dokuwiki.org|ダウンロードサイト]]から最新リリース版をダウンロードする。

  * **手順４：** 配布用の圧縮ファイルを [[ja:install:unpacking|展開]]  し、以前のインストール先にアップロード・コピーする。プロンプトが表示された時、**全てのファイルの上書き**を確認する。

  * **手順５：** [[ja:install:unused files|未使用ファイル]]を全て削除する。

  * **手順６：** 必要であれば [[ja:template|テンプレート]] と [[ja:plugins|プラグイン]] をアップグレードする。

  * **手順７：** 更新通知がなくなるまで一日待つか、[[ja:update_check|アップデートの確認]]の手順に従って進行を早めます。

注：古いインストールへの上書きをはっきりと推奨します。
*.local ファイルのみに設定オプションを定義するという助言を順守している場合
（管理ツールは自動的に順守しています）以前の設定は上書き**されない**はずです。
あなたのページとメディアファイルにも同じことが当てはまります。
上書き方法は、ファイル修正時刻に依存しているページリビジョンを正しく保つことによって多くの問題を回避します。

===== suhosin PHP 拡張モジュールの落とし穴 =====

DokuWiki の新しいバージョンの場合、[[https://​suhosin.org/​stories/​index.html|suhosin PHP 拡張モジュール]]（インストールされている場合）に対する設定が必要です。
そうでない場合、ページ編集やプラグインの更新・インストールが動作しません。
詳細については、[[ja:install|DokuWiki のインストール]]を参照して下さい。

===== トラブルシューティング =====

一般的なアップグレード後の問題のヒントは以下のページにあります：

  * [[ja:caching|キャッシュ]] -- 見た目がおかしいかエラーメッセージが表示される場合、キャッシュを削除して下さい。
  * [[ja:config:updatecheck|設定項目: updatecheck]] -- 更新通知が残る場合
  * [[ja:faq:toolbar|ツールバーが表示されない]] -- ツールバーのボタンとJavaScriptの問題
  * [[ja:changes|更新履歴]] -- 検索ボックスの結果がない場合

missing/non-writable directories のエラーの場合、[[ja:changes|更新履歴]] を十分に読んでいない。
Anguaにアップグレードする際には、2つの新しいディレクトリを作成し、それらを書き込み可能にする必要があります：

  * ''data/media_attic''
  * ''data/media_meta''

===== 代替方法 =====

ユーザーから提供された、異なるアップグレード方法の説明です。
これらは少し古くなっているかもしれません。

  * [[ja:plugin:upgrade|アップグレードプラグイン]]を使用する
  * [[install:diffupgrade|差分を作成してアップグレード]]
  * [[http://installatron.com/dokuwiki|Installatronのアプリケーションインストーラを使用したアップグレード]]
  * [[http://apscatalog.com/1/splitbrain.org/dokuwiki/|APSでのアップグレード]]
  * [[http://​home.komsys.org/​~jocke/​upgrade-dokuwiki.txt|一般的なLinuxコマンド (コピー＆ペースト)を使用したアップグレード]]
  * [[http://​falstaff.agner.ch/​2010/​08/​12/​using-git-to-install-dokuwiki/​|Git を使用したインストールとアップグレード]]

===== 古い配布物からのアップグレード =====

数年以上古い配布物からアップグレードする場合、上記の手順を使用して、一度に一年分ずつ段階的にアップグレードすることをお勧めします。
[[http://download.dokuwiki.org/archive|ダウンロード用書庫]]から古い配布物を取得できます。